使用 GitHub Agent + DeepSeek V4 Pro 的开发实战与本地安装指南

本指南面向工程开发者和开源贡献者说明如何在本地用 GitHub Agent基于 VS Code 的 agent 运行配合 DeepSeek V4 Pro 模型开展开发、为什么这种组合在效率与可控性上优于其它组合以及如何在本地打包并安装自定义的 deepseek-v4-copilot-custom 插件以便快速试验与分享。### 章节目录1. 场景与痛点2. 组合优势对比为什么选 GitHub Agent DeepSeek V4 Pro3. 快速上手配置与示例本地开发流程4. 统一项目导入与单次会话开发流5. 本地打包与安装6. 实战示例用 qwen 验证模型7. 结语与资源---## 1 场景与痛点在日常开发中我们常常需要把大模型能力接入代码搜索、智能提示、文档生成或对话助手。常见问题是- API provider 分散且定制化开发与测试不方便- 本地调试困难迭代慢- 团队内无法统一「模型接入规范」导致环境不一致- 发布到社区时需要兼顾合规与可复现的安装步骤。我在项目中通过把模型接入点与 VS Code 的 GitHub Agent或自定义 agent结合并在插件层支持每个模型的私有 baseUrl / apiKey 与温度等参数实现了「可配置、可本地复现、易分享」的工作流。---## 2 组合优势对比为什么选 GitHub Agent DeepSeek V4 Pro- 低摩擦的开发体验GitHub Agent 直接集成在 VS Code开发者在熟悉的编辑器内即可触发模型能力减少环境切换成本。- 企业级能力DeepSeek V4 Pro 提供更稳定的对话和知识检索能力适合做代码审阅、文档生成与语义搜索。- 可控性强在插件层暴露 per-model override私有 baseUrl / apiKey / 温度 / top_p / max_tokens可以在团队内安全地测试私有模型或代理。- 便于分享与复现将扩展打包为 VSIX 并在 Gitee 发布用户可按步骤安装并使用相同配置便于社区复现与验证。对比常见替代方案- 直接用外部 Web 控制台快速但不可复现且无法直接嵌入开发流程- 在后台服务统一调用模型灵活但调试成本高迭代慢- 本地轻量脚本curl/python便于单次验证但缺少 IDE 级体验与上下文感知。---## 3 快速上手配置与示例本地开发流程先决条件Windows / macOS / Linux 均可- Node.js 与 npm- VS Code- vsce用于打包扩展或使用 npm run package 的脚本在仓库根目录示例执行以下命令1) 安装依赖并编译npm installnpm run compile2) 打包若仓库在非 GitHub 平台请参考 package.json 中的 --baseContentUrl / --baseImagesUrl 设置npm run package生成的 VSIX 位于 dist/ 目录文件名形如 deepseek-v4-copilot-custom-0.1.0.vsix。本地安装1) 通过 VS Code GUI 打开命令面板 Extensions: Install from VSIX...2) 或使用命令行安装Windows/macOS/Linuxcode --install-extension dist/deepseek-v4-copilot-custom-0.1.0.vsix安装后打开 设置 搜索扩展配置或在 settings.json 中编辑可在 modelIdOverrides数组形式中配置每个模型的 vscodeModelId、apiModelId、baseUrl、apiKey 与温度等字段。示例[{vscodeModelId: deepseek-v4-pro,apiModelId: deepseek-v4-pro,baseUrl: https://api.deepseek.example,apiKey: xxxxxxxx,temperature: 0.2,maxTokens: 1024}]注vscodeModelId 是选择器里显示的模型名apiModelId 是实际发给 API 的模型 IDbaseUrl / apiKey 留空会回退到全局设置。若使用私有模型例如 Bailian/Qwen请按相应 API 文档填写 baseUrl 与 apiKey。---## 4 统一项目导入与单次会话开发流要让 agent 在单次会话内同时操作后端、前端和移动端开发建议将三部分作为同一工作区multi-root workspace导入 VS Code并暴露常用任务与启动脚本。要点- 在工作区文件示例名 veap.code-workspace中包含 veap-cloud/、veap-ui/、以及任何移动端目录- 在根目录提供一组 npm / powershell / scripts 用于并行启动常用服务示例脚本会在根目录调用 Maven 与 npm 命令- 为 agent 提供可读的任务清单./.vscode/tasks.json与调试配置./.vscode/launch.json以便在一次会话里通过命令面板触发编译后端、启动后端、启动前端 dev server、运行前端 lint。示例任务json{version: 2.0.0,tasks: [{ label: backend: build, command: mvn -B -f veap-cloud/pom.xml -DskipTests package },{ label: frontend: dev, command: npm --prefix veap-ui run dev },{ label: workspace: start all, command: powershell -File scripts/start-all.ps1 }]}示例 scripts/start-all.ps1 可并行启动后端与前端并写入日志agent 在会话里只需调用对应 task 即可协调多端开发与调试。该方式保证 agent 在单次对话中完成构建/部署/验证环节。---## 5 本地打包与安装本地打包走 npm run package产物在 dist/。也可以从仓库的 Releases 页取现成的 VSIX仓库地址见文末「结语与资源」。下载后在 VS Code 中通过 Extensions: Install from VSIX... 安装或使用命令bashcode --install-extension path/to/deepseek-v4-copilot-custom-0.1.0.vsix## 6 实战示例用 qwen 验证模型仓库中含有 qwen/ 目录用于存放调用千问/百炼类模型的示例脚本。实践建议1) 将敏感凭据apiKey仅放在本地设置中勿提交到仓库2) 先在 qwen 的 Python 脚本中单次调用验证模型可用性再把同样的 baseUrl/apiKey 写入扩展配置进行 IDE 内测试3) 注意模型的速率限制与并发策略调低 temperature 与 max_tokens 以节省调用量用于开发调试。---## 7 结语与资源本文档记录的是可复现的开发流程与工程实践。扩展源码、打包脚本与 Releases 都在仓库- 源码与 Releaseshttps://gitee.com/mindock/deepseek-v4-copilot-custom模型提供方的实现机制逐模型端点覆盖、视觉代理、思考模式见《在 Copilot Chat 里接入 DeepSeek V4模型提供方扩展的实现与配置》顺带做的提示词搜索与分享工程细节见《给 Copilot Chat 加一个提示词搜索与分享能力》。