VS Code 智能体工作台 zxlishixian/deepseek-harness-for-vscode

DeepSeek Harness for VS Code

在 VS Code 里运行 DeepSeek Harness 编程智能体。扩展自带 Harness 运行时，帮你启动和停止，并在侧边栏放了一个原生工作台——装好 VSIX，填上 API Key，就能开工。不用单独装 Harness，不用配 Node/npm，也没有内嵌的 Web UI。

快速开始

1. 从 Releases 下载对应平台的 VSIX。
2. 安装：打开扩展视图（Cmd/Ctrl+Shift+X）→ ... → Install from VSIX...。
3. 把 DeepSeek API Key 写进用户 settings.json：

{
"deepseekHarness.apiKey": "sk-..."
}

（运行 DeepSeek Harness: Set API Key 会写入同一项配置。）
4. 打开项目，点活动栏里的 DeepSeek Harness 图标，描述你的任务，然后发送。

随时可以用 Cmd+Alt+H（macOS）或 Ctrl+Alt+H（Windows/Linux）打开工作台。

功能

- 原生工作台 —— 一切都在侧边栏里完成，绝不内嵌官方 Web UI。
- 会话工作流 —— 历史记录持久保存，支持搜索、新建、切换、重命名、分叉、归档，以及返回父会话。
- 流式 Markdown —— 标题、列表、表格、代码块、复制按钮，以及经过校验的外部链接。
- 稳定的增量渲染 —— 流式更新时，折叠状态和滚动位置保持不变。
- 实时推理 —— 推理块随增量到达展开，跟随最新文本，完成后自动折叠。
- Harness 原生能力 —— 推理、工具调用、审批、结构化提问、Todos、Skills、Goals、Plan 模式，以及后台任务。
- 模型与智能体控制 —— DeepSeek V4 Flash / Pro，三档推理强度，四种 Agent Presets。
- 每轮耗时与 token 统计 —— 首 token 时间、总耗时，以及实时输入/输出 token。
- 英文与简体中文 —— 跟随 VS Code 显示语言。
- 自带运行时 —— 每个平台都随附官方 dsh 命令行、pnpm，以及独立的 Node 22.22.3。

工作台内部

工作台由三个可调整大小的窗格组成，跟随 VS Code 主题。

- 左侧 —— 会话。 浏览和切换对话，支持搜索，还有归档列表。
- 中间 —— 对话。 流式回复、实时推理，以及工具调用的递归树。
- 右侧 —— 检查器。 选中工具调用的参数（格式化 JSON）和结果。

底部的输入区是起草面板：

- 输入 / 插入斜杠命令或已注册技能。
- 输入 @ 引用子代理。
- 就地切换 Plan 模式，选择权限级别。
- 切换模型（V4 Flash / Pro）和推理强度（off / high / max）。
- 上下文环显示上下文窗口的占用情况，旁边是输入/输出 token 计数。
输入框上方有一条 plan strip，显示当前 Todo 列表和目标；session header 显示活跃的子代理和后台任务。

命令

| 命令 | 描述 |
| DeepSeek Harness: Open Workbench | 打开侧边栏工作台 |
| DeepSeek Harness: Reload Workbench | 重启运行时并重新连接 |
| DeepSeek Harness: Set API Key | 保存 API Key |
| DeepSeek Harness: Clear API Key | 清除 API Key |
| DeepSeek Harness: Show Logs | 打开诊断日志 |

配置

| 设置 | 默认值 | 描述 |
| deepseekHarness.apiKey | 空 | DeepSeek API Key，以 machine 作用域存入用户 settings.json |
| deepseekHarness.model | deepseek-v4-flash | 新会话的默认模型 |
| deepseekHarness.reasoningEffort | high | off / high / max |
| deepseekHarness.agentPreset | standard | 新会话的默认 Agent Preset |
| deepseekHarness.provider | deepseek-official | Harness 模型服务商路由 |
| deepseekHarness.baseUrl | 空 | 可选的 API base URL |
| deepseekHarness.permissionMode | workspace-write | read-only / workspace-write / danger-full-access |

API Key 绝不会写入项目级 .vscode/settings.json，但它以明文形式存在你的用户设置里——不要提交或分享包含它的设置文件。

本地化

默认语言为英文，附带简体中文语言包。命令、设置、宿主提示词、错误信息以及工作台都跟随 VS Code 显示语言。切换后，运行 Developer: Reload Window。

安全与隐私

- Harness Gateway 只监听随机的 127.0.0.1 端口。
- Webview 使用严格的 CSP——不加载远程脚本或 iframe。
- 原始 Markdown HTML 已禁用；渲染后的标记通过 DOMPurify 允许列表净化。
- 远程 Markdown 图片已禁用；http(s) 链接由扩展宿主重新校验。
- 文件和命令访问由 permissionMode 和 Harness 审批策略管控。
- API Key 绝不会发送到 Webview，也不会写入扩展日志。

平台支持

一个扩展，一个 Marketplace 产品。需要按平台提供不同的 VSIX 文件，因为打包的 Node、PTY 和沙箱包内含原生二进制文件：

- macOS — darwin-arm64、darwin-x64
- Linux — linux-arm64、linux-x64
- Windows — win32-arm64、win32-x64

托管的 GitHub Actions 矩阵构建 darwin-arm64、linux-arm64、linux-x64 和 win32-x64；其他目标需要自托管 runner 或本地打包。

开发

npm install
npm run check-types
npm run lint
npm test
npm run compile
npm run package

npm run package 为当前操作系统和架构生成 VSIX。npm ci 会运行原生依赖所需的生命周期脚本，所以只构建可信的提交和 lockfile。
提交信息用英文写。架构与安全边界见 docs/ARCHITECTURE.md。

许可证

扩展代码采用 MIT License。DeepSeek Harness、Node.js 及其他依赖，适用 THIRD_PARTY_NOTICES.md 以及各依赖随附的许可证文件。