AI 编程助手 VSCode 插件
一个集成 AI 编程助手的 VSCode 插件，将 v3_subagent.py 的功能集成到 VSCode 对话界面中。
功能特性
- 🎨 现代化的对话界面设计
- 💬 实时与 AI 编程助手对话
- 🤖 集成 v3_subagent.py 的 AI 编程能力
- 🔧 支持工具调用可视化（bash, read_file, write_file 等）
- ⏰ 消息时间戳显示
- 🎯 支持快捷键发送（Enter键）
- 🌙 自动适配 VSCode 主题
- 📊 流式输出显示
安装说明
前置要求
- Python 3.x（确保
python 或 python3 命令可用）
- 安装必要的 Python 依赖：
pip install anthropic python-dotenv
配置说明
重要：使用前必须配置 API Key！
方法一：使用命令快速打开设置（推荐）
- 按
Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板
- 输入 "AI 编程助手: 打开设置" 或 "chatInterface: 打开设置"
- 会自动打开设置页面并定位到插件配置项
方法二：手动打开设置
打开 VSCode 设置：
- 按
Ctrl+,（Windows/Linux）或 Cmd+,（Mac）打开设置
- 或使用命令面板：
Ctrl+Shift+P → 输入 "Preferences: Open Settings (UI)"
在设置搜索框中输入以下任一关键词：
chatInterfaceAI 编程助手apiKey
配置以下选项：
- Chat Interface: Api Key（必需）：您的 Anthropic API Key
- Chat Interface: Base Url（可选）：API Base URL
- 如果使用代理或自定义端点，请填写完整 URL
- 例如：
https://api.anthropic.com
- Chat Interface: Model Name（可选）：使用的 AI 模型名称
- 默认值：
claude-sonnet-4-20250514
- 其他选项：
claude-3-5-sonnet-20241022、claude-3-opus-20240229 等
- Chat Interface: Python Path（可选）：Python 可执行文件路径
- 如果 Python 不在系统 PATH 中，请填写完整路径
- 例如：
C:\Python\python.exe 或 /usr/bin/python3
- 留空则使用系统默认的
python 或 python3 命令
配置位置说明
配置项会显示在设置页面的 "AI 编程助手" 分组下，或者在搜索时直接显示。如果找不到配置项，请：
- 确保插件已正确安装并启用
- 重新加载 VSCode 窗口（
Ctrl+R 或 Cmd+R）
- 尝试使用命令面板的 "打开设置" 命令
开发模式
- 克隆或下载此项目
- 确保
v3_subagent.py 和 v3_subagent_json.py 文件在工作区根目录
- 安装依赖：
npm install
- 编译项目：
npm run compile
- 按
F5 打开扩展开发主机窗口
- 在扩展开发主机中，按
Ctrl+Shift+P（或 Cmd+Shift+P）打开命令面板
- 输入并选择 "打开对话界面" 命令
使用方法
- 首次使用：确保已按照上述说明配置 API Key
- 打开命令面板（
Ctrl+Shift+P 或 Cmd+Shift+P）
- 输入 "打开对话界面" 或 "在新窗口打开对话界面"
- AI 助手将自动启动并连接
- 在对话界面中输入您的编程需求
- AI 助手会使用工具（如读取文件、执行命令等）来帮助您完成任务
- 所有工具调用和结果都会在界面中显示
配置检查
如果遇到 "未配置 API Key" 错误：
- 检查 VSCode 设置中是否已填写
chatInterface.apiKey
- 确保 API Key 格式正确（以
sk- 开头）
- 重新打开对话界面
示例对话
- "帮我查看当前目录下的所有 Python 文件"
- "读取 src/extension.ts 文件的前 50 行"
- "创建一个新的测试文件 test.py"
- "分析代码库结构并给出改进建议"
项目结构
.
├── src/
│ └── extension.ts # 插件主入口文件
├── v3_subagent.py # AI 编程助手主程序
├── v3_subagent_json.py # JSON 协议包装器（用于与插件通信）
├── package.json # 插件配置文件
├── tsconfig.json # TypeScript 配置
└── README.md # 说明文档
开发
编译
npm run compile
监听模式
npm run watch
技术栈
- TypeScript
- VSCode Extension API
- WebView API
- Python 3.x
- Anthropic Claude API
- Node.js Child Process API（用于进程通信）
工作原理
- 进程通信：插件启动 Python 进程（
v3_subagent_json.py），通过 stdin/stdout 进行 JSON 协议通信
- 消息传递：用户输入 → 插件 → Python 进程 → AI 处理 → Python 进程 → 插件 → 界面显示
- 工具调用可视化：当 AI 调用工具（如 bash、read_file 等）时，插件会在界面中显示工具调用和结果
- 流式输出：AI 的回复会实时流式显示在界面中
许可证
MIT
| |
