Qoder Agent for VS Code（非官方）
在 VS Code 的侧边栏使用 Qoder 国内版或国际版账号，可在会话顶部切换版本。此扩展为独立第三方项目，不是 Qoder 官方产品，也未获得 Qoder 背书。使用本扩展需要用户自行安装并登录所选版本的 Qoder CLI。
功能
- 在右侧辅助侧边栏进行多轮对话，查看本工作区的历史会话，并可切换国际版和国内版 CLI。
- 查看 Qoder 返回的处理过程、工具调用参数及结果，并可停止当前请求。
- 读取当前账号可用模型，并在 Qoder 提供信息时显示倍率、上下文窗口和思考选项。
- 显示 Qoder 最近一次模型请求返回的上下文占用率。
- 点击回答中的文件路径和行号，在编辑器中打开对应位置。
- 在会话中查看 Qoder Edit 和 Write 工具返回的文件修改；通过 VS Code 差异编辑器对比修改前后的完整文件。
- 将 Qoder 注册为 VS Code 的文字聊天模型提供者。
使用条件
- VS Code 1.104 或更新版本，安装并启用此扩展。
- 已安装所选版本的 Qoder CLI 并登录对应账号；服务是否可用、模型以及额度以 Qoder 账号为准。
- 网络能够访问 Qoder 服务。使用项目功能时，需要打开并信任项目文件夹。
- 国际版已在 Windows x64 和 WSL（Ubuntu x64）中验证；国内版已在 Windows x64 验证，国内版 WSL、原生 Linux、macOS、容器及其他远程开发环境尚未完整验证。CLI 的平台支持以各版本官方文档为准。
国际版：安装、登录。国内版：安装、登录。本扩展不会替用户安装 CLI。
快速开始
- 完成所选版本 CLI 的安装和登录，国际版可运行
qodercli --version，国内版可运行 qodercn --version。使用 WSL 时，请在 WSL 内安装并登录对应版本。
- 在 VS Code 打开项目文件夹。
- 在右侧视图菜单打开 Qoder Agent，或从命令面板运行 Qoder: 打开右侧聊天。
- 在会话顶部选择国际版或国内版，再在输入框选择可用模型并输入任务。
Enter 发送，Shift+Enter 换行。
- 如需为支持的模型设置上下文窗口或思考参数，打开模型菜单，点击对应模型旁的设置按钮。
如果扩展无法自动找到 CLI，在 VS Code 设置中填写对应的完整路径：国际版为 qoderBridge.executable，国内版为 qoderBridge.cnExecutable。版本选择、模型缓存和会话按版本隔离；两版分别使用各自的 CLI 登录状态。
权限与限制
完整文件对比使用临时 Qoder 插件钩子捕获 Edit 和 Write 工具执行前后的 UTF-8 文本（单文件不超过 2 MiB）；捕获失败时退回 Qoder 返回的修改片段。没有修改前内容的记录只能打开文件。通过终端命令、其他工具或旧会话产生的变化不一定会显示。修改记录随会话保存在 VS Code 工作区存储中。
权限菜单提供默认、允许编辑、自动判断、完全权限和不询问模式。扩展使用 CLI 非交互模式，需确认的操作会被拒绝；完全权限会跳过大多数确认，Qoder 仍保留部分限制。非默认模式可能因 Qoder 的目录信任或策略配置而降级。权限选择保存在当前 VS Code 工作区，重新打开同一工作区后会恢复，包括完全权限。
在 VS Code 内置聊天的模型选择器中，本扩展提供文字聊天模型，不支持 VS Code 原生工具调用或图片输入，因此并非完整的 Agent 模式集成。
上下文比例来自最近一次模型请求，可能不是实时值；CLI 未返回时显示暂无数据。
只有 CLI 实际提供的工具信息才能显示；单条内容超过 512,000 字符时会截断。工具调用和最终回复取决于 CLI 的实际返回。
模型倍率与可用参数由 Qoder 服务返回并可能变化。模型目录短暂不可用时，扩展可能显示最近缓存的数据，并在界面中标明。
数据与隐私
扩展通过本机 Qoder CLI/SDK 使用 Qoder 服务；提示词、用户选择的文件内容以及 Qoder 为执行任务读取的项目上下文，可能发送给 Qoder。扩展在 VS Code 工作区状态中保存会话和工具输出，并使用 Qoder CLI 自身的本地会话记录恢复历史。模型设置和模型目录缓存在 VS Code 的扩展状态中。请根据工作内容确认这些存储和传输方式符合你的要求。
本扩展当前没有独立的开发者服务或自建遥测。Qoder 服务如何处理数据，请查看所选版本的隐私政策和服务条款。
故障排查
- 找不到 CLI：确认所选版本已安装；必要时为国际版设置
qoderBridge.executable，为国内版设置 qoderBridge.cnExecutable，然后重新加载 VS Code 窗口。
- 未登录或模型列表为空：检查 Qoder CLI 登录状态和网络；可在扩展中刷新状态。
- Webview 无法加载：保存工作并完全退出 VS Code，再重新打开；若问题仍在，请检查 VS Code Webview 错误信息。
- 历史会话不完整：扩展只能恢复 CLI 本地记录中可读取的内容，不保证恢复所有历史记录。
第三方组件
本扩展包含 Qoder 国际版和国内版 Agent SDK 及其他第三方组件，相关许可文本见扩展包中的 QODER-SDK-LICENSE.txt、QODER-CN-SDK-LICENSE.txt 和 THIRD-PARTY-NOTICES.txt。
| |
