VCoder — VSCode 插件（内部版）

VCoder 智能编程助手的 VSCode 插件，在编辑器内提供对话式编程、文件变更审查（diff 审批）、终端执行等能力。当前版本面向内部用户分发。

安装

1. 获取 vcoder-0.6.0.vsix 安装包（内部渠道分发）。
2. 安装方式二选一：
   • 命令行：code --install-extension vcoder-0.6.0.vsix
   • 界面：VSCode → 扩展面板 → 右上角 ... → Install from VSIX... → 选择文件
3. 安装后按提示 reload 窗口。

首次使用：配置 Voyah Token

插件默认使用 Voyah 内部 provider，需要配置 Token 才能对话：

1. 激活后若未配置 Token，会弹出引导通知，点击「设置 Token」； 也可随时通过命令面板执行 VCoder: Set API Key。
2. 在打开的设置面板中粘贴 Token，点击「保存 Token」，立即生效。

Token 保存在 ~/.vcoder/settings.json 的 env 块（写入时文件权限收紧为 600），与 CLI 共用同一份凭据——插件里配好即可直接用 vcoder 命令，反之亦然。该文件是明文，不要提交到仓库；项目级 .vcoder/settings.json 中的凭据会被忽略，避免被签入的配置劫持请求。

早期版本把 Token 存在 VSCode Secret Storage，升级后会在首次访问时自动迁移到上述文件并清除旧记录。

如果你习惯用环境变量：在启动 VSCode 前设置 VOYAH_AUTH_TOKEN（或 VOYAH_API_KEY）也可以，插件会直接使用，无需再配置。

常用命令

对话面板标题栏还提供：New Chat（新会话）、History（历史会话）、Settings（打开 VSCode 设置中的 VCoder 配置项）。

历史消息内联编辑

• 悬停任意用户消息，点击「编辑」后在消息原位置修改文本；Esc 取消，Cmd/Ctrl+Enter 保存，Enter 保留换行。
• 保存前会弹出确认框，展示将被移除的后续消息数量，并明确提示：对话上下文将回退，工作区文件修改不会回退。
• 确认后 Agent 会以编辑后的消息为新一轮输入重新作答；同一会话（sessionId）与侧边栏条目继续使用，不会创建可见分支。
• 会话运行中或存在待审文件变更时，编辑按钮不可用（悬停有原因提示）。
• 模型执行失败时不会撤销编辑分支，编辑消息旁提供「重试」。
• 首版边界：仅编辑可见文本，不编辑附件 / @ 引用结构。

常用设置项（VSCode 设置中搜索 vcoder）

• vcoder.model：具体模型 ID（例如 gpt-5.6-luna）
• vcoder.permissionMode：权限模式（default 询问高风险操作；acceptEdits 自动接受一般编辑；plan 计划模式；bypassPermissions 全部跳过，慎用）
• vcoder.uiLanguage：界面语言（auto / en-US / zh-CN）
• vcoder.mcpServers：外挂 MCP server 配置

FAQ

Q: 发送消息提示「未配置 Voyah Token」？ 按上文步骤配置 Token；若已配置仍提示，执行 VCoder: Restart Server 后重试。

Q: 如何切换模型？ 对话输入框旁的模型选择器，或修改 vcoder.model 设置。

Q: 插件会读写哪些全局配置？ 插件读写 ~/.vcoder/settings.json（与 CLI 共享）：provider、model、permissions.allow/deny 与凭据（env 块）。只写全局文件，不会改动项目级 .vcoder/settings.json。

Q: 在哪里看日志？ VSCode「输出」面板 → 下拉选择 VCoder 通道。

Q: 终端工具不工作？ 插件内置 node-pty 原生模块（随 vsix 打包）。若你的 VSCode 版本过低（要求 ^1.80.0）或平台架构不在预编译范围内，终端能力可能不可用，请升级 VSCode 后重试。

Q: 如何反馈问题？ 导出日志（输出面板 VCoder 通道内容）并联系 VCoder 团队，附上复现步骤。