智码 AI 编程助手
在 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 许可证开源。
