KZ-Agent AI Code Completion

VS Code 智能代码补全插件，支持多种 AI 提供商（DeepSeek、Claude、Gemini、Codex、GLM）。

快速开始

打开 VS Code 设置，搜索 KZAgent
配置 API Key（以 DeepSeek 为例）：（注意配置后，一定要选择确定选择已配置的模型，右下角有显示）
```
{
  "KZAgent.provider": "deepseek",
  "KZAgent.deepseek.apiKey": "your-api-key"
}
```
开始编码，AI 补全建议会自动出现
按 Tab 接受建议
光标补全有一定局限性，本人更喜欢选择 Ctrl+Shift+; 插入提示词模板
可选搭配 Ctrl+Shift+L 选中参考代码，最后用 Ctrl+Shift+K 会自动生成代码

支持的 AI 提供商

提供商	模型	配置项
DeepSeek	deepseek-chat	`KZAgent.deepseek.apiKey`
Claude	claude-3-haiku-20240307	`KZAgent.claude.apiKey`
Gemini	gemini-pro	`KZAgent.gemini.apiKey`
Codex	gpt-3.5-turbo-instruct	`KZAgent.codex.apiKey`
GLM	glm-4.7-flash	`KZAgent.glm.apiKey`

切换提供商：Ctrl+Shift+P → KZ-Agent: Switch AI Provider

使用方式

1. 自动补全

编写代码时，插件自动提供 inline 补全建议（300ms 防抖）。按 Tab 接受建议。

2. @KZAgent 指令

在代码中使用 @KZAgent 注释向 AI 发送指令：

// @KZAgent 为这个函数添加错误处理
function fetchData() {
  // AI 将在此生成代码
}

// @KZAgent 重构以下代码，使用 async/await lines:10-20
// AI 将处理第 10-20 行

// @KZAgent 参考 utils.ts 实现类似功能 ref:./utils.ts
// AI 将参考指定文件生成代码

// 用 ctrl shift l 选中 utils.ts 的代码片段后
// @KZAgent 参考 utils.ts 选中的代码，帮我完善这个方法
// AI 将参考指定代码段生成代码

指令参数：

参数	说明	示例
`lines:N-M`	指定目标行范围	`lines:30-60`
`ref:path`	引用文件作为上下文	`ref:./types.ts`
`mode:type`	代码应用方式	`mode:replace`、`mode:insert`、`mode:append`

写好指令后，按 Ctrl+Shift+K 执行生成。

3. 可视化行选择

按 Ctrl+Shift+L 进入行选择模式
使用方向键选择行范围
按 Enter 确认，Escape 取消

4. 多文件选区

选中代码后右键选择「KZ-Agent: Add Selection to Context」
或使用侧边栏的 KZ-Agent 面板管理选区
多个选区会作为上下文发送给 AI

快捷键

快捷键	Mac	功能
`Ctrl+Shift+K`	`Cmd+Shift+K`	执行 @KZAgent 指令生成代码
`Ctrl+Shift+;`	`Cmd+Shift+;`	插入 @KZAgent 指令模板
`Ctrl+Shift+L`	`Cmd+Shift+L`	可视化选择行范围

命令

通过 Ctrl+Shift+P 打开命令面板，输入 KZ-Agent 查看所有命令：

命令	功能
KZ-Agent: Toggle Enable/Disable	启用/禁用插件
KZ-Agent: Switch AI Provider	切换 AI 提供商
KZ-Agent: Generate Code from Directive	执行指令生成代码
KZ-Agent: Insert @KZAgent Directive	插入指令模板
KZ-Agent: Select Line Range Visually	可视化选择行范围
KZ-Agent: Add Selection to Context	添加选区到上下文
KZ-Agent: Clear All Selections	清空所有选区

配置项

{
  // 启用/禁用插件
  "KZAgent.enabled": true,

  // 选择 AI 提供商: deepseek | claude | gemini | codex | glm
  "KZAgent.provider": "deepseek",

  // 普通补全最大 token 数
  "KZAgent.maxTokens": 100,

  // DeepSeek 配置
  "KZAgent.deepseek.apiKey": "",
  "KZAgent.deepseek.baseUrl": "https://api.deepseek.com",

  // Claude 配置
  "KZAgent.claude.apiKey": "",

  // Gemini 配置
  "KZAgent.gemini.apiKey": "",

  // Codex 配置
  "KZAgent.codex.apiKey": "",

  // GLM (智谱AI) 配置
  "KZAgent.glm.apiKey": "",
  "KZAgent.glm.baseUrl": "https://open.bigmodel.cn/api/paas/v4",
  "KZAgent.glm.model": "glm-4.7-flash"
}

支持的语言

TypeScript、JavaScript、Python、Java、Go、Rust、C/C++、C#、Ruby、PHP、Swift、Kotlin、Scala、Vue、Svelte、HTML、CSS、SCSS、Less、JSON、YAML、XML、Markdown、SQL、Shell/Bash

状态栏

插件在状态栏显示当前状态：

点击可快速切换启用/禁用
显示当前使用的 AI 提供商

License

MIT

KZAgent - AI Code Completion

krrz