在 VSCode 侧边栏里与 AI 结对编程：全中文界面、流式输出、上下文感知，兼容任意 OpenAI 接口，自备密钥即装即用。
✨ 特性
- 全中文界面与命令：活动栏、命令面板、右键菜单均为中文，开箱即用。
- 流式输出：边生成边显示，长回答无需等待。
- 上下文感知：发送时自动附带当前文件名与选中代码，让回答贴合你的工程现状。
- 右键快捷动作：对选中代码一键解释、优化、修复、生成测试。
- 可导出：整段对话导出为 Markdown，方便归档与分享。
- OpenAI 兼容：只要接口符合 OpenAI
/v1/chat/completions规范，即可接入各家模型与第三方网关。
🧩 内置国内服务商（开箱即用）
内置 12 家服务商预设，选中后 API 地址自动填好，你只需填 Key：
| 服务商 | 说明 | 推荐模型 |
|---|---|---|
| 硅基流动（推荐·聚合） | 一个 Key 接入 DeepSeek/Qwen/GLM 等众多开源模型，国内直连 | DeepSeek-V3、Qwen2.5-72B |
| DeepSeek | 深度求索官方 | deepseek-chat、deepseek-reasoner |
| 通义千问 | 阿里 DashScope | qwen-plus、qwen-max、qwen3-coder-plus |
| 智谱 GLM | BigModel | glm-4-flash、glm-4.5 |
| 月之暗面 Kimi | Moonshot | moonshot-v1-128k、kimi-latest |
| 百度千帆 | 文心 | ernie-3.5-8k、ernie-4.0 |
| MiniMax | abab6.5s-chat | |
| 阶跃星辰 | StepFun | step-2-16k |
| 零一万物 | Yi | yi-lightning |
| 腾讯混元 | hunyuan-standard | |
| OpenAI | 官方 | gpt-4o-mini |
| 自定义 | 手动填写地址与模型 | — |
切换方式：侧边栏顶部点「服务商」或「模型」标签即可；或命令面板运行 智码：切换模型服务商 / 智码：切换模型。
🚀 快速开始
- 安装扩展后，点击活动栏中的「智码 AI」图标打开侧边栏助手面板；也可按
Ctrl/Cmd + Shift + Z唤起。 - 配置 API Key、Base URL 与模型名（任选其一）。
- 设置界面：命令面板执行「智码：打开设置」，或在设置中搜索
zhima，填写 API Key、API 地址、模型名。 - settings.json：直接写入以下片段。
- 设置界面：命令面板执行「智码：打开设置」，或在设置中搜索
- 在输入框输入问题，回车发送即可开始对话。
{
// OpenAI 兼容接口地址，结尾不要带 /chat/completions
"zhima.apiUrl": "https://api.openai.com/v1",
// 你的 API 密钥，仅保存在本机
"zhima.apiKey": "sk-你的密钥",
// 默认模型名，可换成兼容网关提供的任意模型 ID
"zhima.model": "gpt-4o-mini"
}
⌨️ 命令与快捷键
命令面板（Ctrl/Cmd + Shift + P）中命令均归类于「智码 AI」。
| 命令 | 快捷键 | 说明 |
|---|---|---|
| 智码：打开助手 | Ctrl/Cmd + Shift + Z |
打开并聚焦侧边栏助手 |
| 智码：新建对话 | Ctrl/Cmd + Shift + Alt + N |
开始一段新对话 |
| 智码：清空当前对话 | — | 清空当前对话的全部消息 |
| 智码：停止生成 | — | 中断正在进行的流式生成 |
| 智码：解释选中的代码 | 右键菜单 | 让 AI 解释当前选中的代码 |
| 智码：优化选中的代码 | 右键菜单 | 给出更优写法并说明理由 |
| 智码：修复选中的代码 | 右键菜单 | 定位问题并给出修复建议 |
| 智码：为选中代码生成测试 | 右键菜单 | 为选中代码生成测试用例 |
| 智码：导出对话为 Markdown | — | 将当前对话导出为 .md 文件 |
| 智码：打开设置 | — | 打开插件配置页 |
⚙️ 配置项
设置分类标题为「智码 AI 编程助手」，在设置中搜索 zhima 即可定位全部项。
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
zhima.apiUrl |
string | https://api.openai.com/v1 |
OpenAI 兼容接口地址，结尾不带 /chat/completions |
zhima.apiKey |
string | "" |
API 密钥，仅存于本机；留空时启动会引导填写 |
zhima.model |
string | gpt-4o-mini |
默认模型名，可填兼容网关提供的任意模型 ID |
zhima.systemPrompt |
string | 资深全栈工程师 | 系统提示词，用于约束 AI 角色与回答风格 |
zhima.temperature |
number | 0.3 |
采样温度，范围 0–2，越大越有创造性 |
zhima.maxTokens |
number | 4096 |
单次回复的最大 token 数，最小 256 |
zhima.sendEditorContext |
boolean | true |
发送时自动附带当前文件名与选中代码作为上下文 |
🔒 隐私说明
- API Key 仅保存在本机 VSCode 设置中，不会上传到任何第三方服务。
- 对话内容经你配置的 API 地址直连模型服务商，本插件不中转、不存储你的代码与对话。
- 编辑器上下文仅在
zhima.sendEditorContext开启时附带，且只包含当前文件名与选中代码，可随时关闭。
❓ 常见问题
如何接入第三方兼容网关？
把 zhima.apiUrl 改为网关地址即可（例如官方中转、私有部署或任意 OpenAI 兼容服务）。结尾不要带 /chat/completions，插件会自动补全。
如何更换模型？
修改 zhima.model，或使用界面内的模型切换；模型 ID 取决于你的服务商支持哪些模型。
国内访问官方接口受限？
可配置任意 OpenAI 兼容的网关地址作为 zhima.apiUrl，并准备对应平台的 API Key 即可直连。
API Key 放在哪里更安全？
推荐写入 VSCode 用户设置或工作区设置。多人共享项目时若使用工作区设置，请将对应配置文件加入 .gitignore，避免随仓库泄露。
流式输出卡住或无响应？
检查 zhima.apiUrl、zhima.apiKey 是否正确，以及模型名是否被服务商支持；网络受限时改用兼容网关地址。
📝 反馈与许可证
问题与建议欢迎在仓库 Issues 中提交。本插件基于 MIT 许可证开源。