常见问题（FAQ）

FAQ#

本常见问题解答涵盖 JoyCode 的安装、登录、功能使用、智能体、Repo Wiki、MCP、远程开发、故障排查及系统要求等常见问题。

快速入门#

JoyCode 如何更新？#

您可以通过以下方式更新 JoyCode：

更新 IDE 版本

打开「设置」
点击「检查更新」
按提示完成升级

查看当前版本

打开「设置」
点击「关于」
查看当前版本号及是否为最新版本

JoyCode 支持自动更新吗？#

支持。

JoyCode 会在每次启动后的约 30 秒内自动检查更新。

如果检测到新版本：

自动下载更新包
下载完成后在右上角提示升级

如何重新导入 VS Code 配置？#

进入 JoyCode 欢迎页后，选择：

导入 VS Code 配置

即可重新同步 VS Code 的相关配置和设置。

如何切换中英文界面？#

点击右上角：

设置 → Language（语言）

选择对应语言即可切换。

上下文管理#

JoyCode 如何添加上下文？#

JoyCode 支持多种上下文引用方式。

方式一：@ 引用#

在输入框输入：@

可直接引用：

文件
文件夹
Rules 规则
Repo Wiki

同时支持：

文件路径预览
点击跳转
快速检索

方式二：拖拽文件到对话框#

支持从：

资源管理器
编辑器 Tab

直接拖拽文件到聊天窗口。

IDE 版本

直接拖拽即可。

方式三：引用代码片段#

支持选择单段或多段代码。

操作方式：

鼠标选中代码
点击添加到对话

或使用快捷键：

macOS

⌘ + L

Windows

Ctrl + L

方式四：引用终端内容#

终端日志可直接加入对话。

快捷键：

macOS

⌘ + Shift + L

Windows

Ctrl + Shift + L

如何拖拽文件到输入框？#

在项目目录中选中目标文件：

拖动文件到 JoyCode 输入框
按住 Shift
松开鼠标

即可完成引用。

智能体#

如何开启或关闭智能体？#

默认展示以下智能体：

编码
问答
规约编程

其他智能体位于：

设置 → 智能体

用户可自行勾选启用。

未启用的智能体不会出现在智能体列表中，也不会被调用。

JoyCode 如何选择模型？#

默认启用：Auto 模式。

关闭 Auto 后，可手动选择不同的大模型进行对话与开发任务。

JoyCode 是否会支持更多新模型？#

JoyCode 持续关注最新编程模型的发展。

新模型是否接入将综合评估：

用户需求
使用反馈
模型能力
稳定性表现

请关注后续版本更新公告。

Repo Wiki#

什么是 Repo Wiki？#

Repo Wiki 基于 AI 自动解析代码仓库，生成结构化项目知识库。

它能够帮助开发者快速理解大型项目结构，并为 JoyCode 的上下文引擎提供全局项目知识支持。

Repo Wiki 具备哪些能力？#

结构化文档#

自动生成：

项目架构说明
核心模块介绍
关键实现逻辑

减少阅读源码成本。

可视化架构#

自动生成：

架构图
流程图

帮助快速建立项目全局认知。

源码关联#

实现：

Wiki ↔ 代码
文档 ↔ 文件

双向追踪与定位。

如何使用 Repo Wiki？#

在输入框输入：@Repo Wiki

即可引用当前仓库 Wiki 内容。

规约编程#

什么是规约编程？#

规约编程（Contract Programming）是一种软件开发方法。

通过定义：

前置条件（Preconditions）
后置条件（Postconditions）
不变式（Invariants）

来提升程序正确性与可靠性。

如何使用规约编程？#

在 JoyCode 中选择：规约编程

然后描述需求。

智能体将结合：

项目上下文
CSR
代码结构

自动完成开发任务。

文件变更与 Diff#

如何查看和确认 AI 修改的代码？#

智能体生成代码后会自动应用到本地文件。

用户无需每次确认即可继续执行任务。

如何接受或拒绝代码修改？#

支持以下粒度：

全部文件#

全部接受
全部拒绝

单个文件#

接受当前文件
拒绝当前文件

文件局部 Diff#

支持：

接受部分修改
拒绝部分修改

文件自动修改是否意味着已经保存？#

变更会先应用到本地文件进行预览。

当您：

点击接受
或不执行拒绝操作

则默认视为接受该文件修改。

MCP#

如何使用 MCP Hub 中的 MCP 服务？#

参考官方文档：

https://joycode.jd.com/docs/functions/functions/mcp

大多数 MCP Server 作者已配置好依赖项。

通常只需复制对应 JSON 配置即可使用。

Streamable MCP 如何配置？#

本地需要安装 Node.js。

配置示例：

{  "chrome-mcp": {    "disabled": false,    "timeout": 180,    "type": "streamableHttp",    "transportType": "streamableHttp",    "url": "http://127.0.0.1:12306/mcp"  }}

登录与账户#

登录失败或验证码无响应怎么办？#

请依次检查：

网络代理#

关闭：

VPN
Host 修改
网络代理

后重新尝试登录。

浏览器插件影响#

部分浏览器插件会阻止授权跳转。

请：

允许页面跳转
更换浏览器重试

重新安装#

卸载 JoyCode 后：

删除插件目录：~/.vscode/extensions 中的 JoyCode 插件。

重新安装后再登录。

登录按钮点击无反应怎么办？#

请检查配置文件。

删除异常配置项后重启 IDE 再次尝试登录。

插件与扩展#

扩展商城搜索不到插件怎么办？#

切换扩展市场源：

https://marketplace.visualstudio.com/_apis/public/gallery

配置完成后重新搜索。

Python 开发需要额外插件吗？#

需要。

JoyCode IDE 的基础能力主要面向 JavaScript。

Python 开发需安装对应插件支持。

如安装后异常，建议：

卸载相关插件
重新安装

Java 无法 Cmd+点击跳转定义怎么办？#

请安装 Java 语言支持插件。

如搜索不到插件，请切换扩展市场源后重新安装。

C++ 无法跳转定义怎么办？#

请安装对应 C/C++ 插件支持。

安装后重新索引项目即可。

终端与日志#

升级后无法读取终端日志怎么办？#

请检查以下设置：

accessibilitySupport = false

同时启用：

terminal.integrated.shellIntegration.enabled = true

修改后重启 IDE。

为什么模型无法识别终端输出？#

开启屏幕阅读器模式可能影响终端内容采集。

关闭：accessibilitySupport

即可恢复。

Shell Integration 不生效怎么办？#

打开设置：

Terminal > Integrated > Shell Integration

确保：Enabled 已勾选。

系统要求与远程开发#

JoyCode 支持哪些系统？#

支持：

macOS
Windows
Linux（部分功能存在限制）

为什么无法连接远程开发环境？#

目前远程开发仅支持：CentOS 8 及以上系统

为什么 CentOS 7 无法远程开发？#

CentOS 7 的：GLIBC 2.17

低于 JoyCode 所需最低版本：GLIBC 2.28

因此无法安装远程开发依赖。

不建议手动升级 GLIBC。

故障排查#

如何清理 JoyCode 缓存？#

macOS：

rm -rf ~/Library/Application\ Support/JoyCode

如何彻底重置 JoyCode？#

选择：Reset User Data and Config

即可清除：

用户配置
缓存数据
本地状态

PDF 解析失败怎么办？#

当前支持：

✅ 普通 PDF

暂不支持：

❌ 二进制 PDF

建议转换为标准文本 PDF 后重新上传。

mac 启动台中找不到 JoyCode 应用怎么办？#

在终端执行：

defaults write com.apple.dock ResetLaunchPad -bool truekillall Dock

执行后重新打开启动台即可。

支持与反馈#

如果以上内容未能解决您的问题，请通过 JoyCode 官方渠道提交问题反馈，并附带：

JoyCode 版本号
操作系统版本
问题复现步骤
相关日志或截图

我们将尽快协助您定位并解决问题。