vscode-copilot-chat 调试指南：快速解决扩展运行问题
vscode-copilot-chat 作为 VS Code 的 AI 辅助扩展，在开发过程中可能因环境配置、依赖冲突或 API 变更导致运行异常。本文档系统梳理调试流程，覆盖环境准备、启动配置、日志分析、常见问题解决等核心环节，帮助开发者快速定位并修复问题。
开发环境准备
基础依赖检查
确保开发环境满足最低要求：
- Node.js 22.x
- Python 3.10-3.12
- Git LFS（用于测试资源拉取）
- Windows 需安装 Visual Studio Build Tools 2019+
通过以下命令验证环境：
node -v # 应输出 v22.x.x
python --version # 应输出 3.10.x-3.12.x
git lfs install # 确保 Git LFS 正确配置
项目初始化
克隆仓库并安装依赖：
git clone <repository_url>
cd vscode-copilot-chat
npm install
npm run get_token # 获取必要的 API 令牌
调试配置与启动
VS Code 调试配置
项目提供两种调试配置，位于 .vscode/launch.json（需手动创建或通过 VS Code 生成）：
- Launch 扩展 - Watch Mode：实时监控代码变更并自动重启调试
- Launch 扩展：常规启动模式，适用于 Watch Mode 异常时的备选方案
启动步骤：
- 打开 VS Code 命令面板（Ctrl+Shift+P）
- 选择 调试：启动调试（Debug: Start Debugging）
- 从下拉菜单中选择上述任一配置
核心调试入口
扩展的调试入口点位于：
- Node.js 环境：src/extension/extension/vscode-node/extension.ts
- Web Worker 环境：src/extension/extension/vscode-worker/extension.ts
调试工具与日志分析
聊天调试视图
通过 Show Chat Debug View 命令（Ctrl+Shift+P 搜索）打开专用调试面板，可查看：
- 完整请求/响应日志
- 工具调用记录
- 模型输入参数
- 错误堆栈跟踪
开发工具控制台
通过 帮助 > 切换开发工具（Help > Toggle Developer Tools）打开浏览器风格控制台，重点关注：
- 扩展激活过程中的异常（过滤关键词
copilot-chat） - API 调用失败信息（如 401/403 状态码）
- 资源加载错误（如缺失的依赖文件）
关键日志文件路径：
- 主日志：test/simulation/baseline.json
- 缓存日志：test/simulation/cache
