urwff/deepseek-harness-vscode

适用于 VSCode 的 DeepSeek Harness

在 VS Code 侧边栏中运行 DeepSeek Harness,交互形态类似 Claude Code for VS Code:活动栏图标 → 侧边栏内嵌完整会话界面,右键选区可发起一次性任务。

本扩展是"薄壳":真正的 agent 由 DeepSeek Harness(MIT)提供,扩展只负责进程管理、界面嵌入与 IDE 上下文。

架构

VS Code 扩展(薄壳)
├─ 进程管理:启动 dsh web / 探测端口 / 健康检查 / 清理 / 崩溃重启
├─ 侧边栏 WebviewView ──(iframe)──▶ http://127.0.0.1:  ← dsh web 进程
└─ 右键"用 DeepSeek Harness 处理…" ──▶ dsh --profile headless(一次性任务)

环境要求

- VS Code ≥ 1.90
- Node.js ≥ 20(扩展本身和 dsh 都需要)
- dsh:扩展按以下顺序自动定位,优先使用本机已有的安装,不会重复下载
1. 设置 dsh.dshCommand 指定路径(最稳,支持直接填 bin.js 路径);
2. 本机已安装的 dsh 运行入口(npm i -g @deepseek-ai/dsh 后的全局目录、或 npx 缓存中的完整副本)→ 用 node 直接拉起,秒开;
3. 都没有则回退 npx --yes @deepseek-ai/dsh@0.1.0-rc.6(首次需下载,耐心等几分钟,侧边栏会有提示)。

使用

安装(推荐:GitHub Release)

1. 到 Releases 下载最新 .vsix;
2. 在 VS Code 中:扩展 面板 → … → 从 VSIX 安装…,选择下载的文件。

或命令行:

code --install-extension dsh-vscode-0.2.0.vsix

调试运行(开发)

npm install
F5,或:
npm run compile

F5 会打开一个扩展开发宿主窗口:左侧活动栏出现 DeepSeek Harness 图标,点击打开侧边栏。

打包

npm run package   # 生成 dsh-vscode-0.2.0.vsix

功能

| 入口 | 行为 |
| --- | --- |
| 活动栏图标 → 侧边栏 | 内嵌 DSH 完整界面(会话/审批/插件/设置) |
| 侧边栏标题栏按钮 | 启动 / 停止 / 重启 / 宽面板 / 浏览器打开 / 日志 |
| 编辑器右键 → "用 DeepSeek Harness 处理…" | 解释 / 审查 / 写测试 / 自定义,走 headless 一次性执行,输出到面板 |
| 状态栏 DSH : | 服务状态,点击打开侧边栏 |

设置(settings.json)

| 键 | 默认 | 说明 |
| --- | --- | --- |
| dsh.dshCommand | "" | dsh 命令或绝对路径;留空自动探测 |
| dsh.host | 127.0.0.1 | 服务绑定地址 |
| dsh.port | 0 | 端口;0 自动分配(推荐) |
| dsh.startOnActivation | true | 启动 VS Code 时自动拉起服务 |

开发

- src/manager.ts:DSH 进程生命周期(命令解析 / node 直跑 / 端口探测 / 健康检查 / 清理)
- src/sidebar.ts / src/panel.ts:侧边栏与宽面板(Webview 包装页见 src/wrapperHtml.ts)
- src/headless.ts:右键一次性任务
- test/runtime-test.js:无需 VS Code 的运行时验证(用 vscode stub 驱动编译产物,覆盖启动→健康检查→停止全链路)

npm run compile
node test/runtime-test.js

已知限制

- 多窗口:VS Code 的每个窗口会各自拉起一个 dsh 实例(端口自动分配,互不冲突);后续版本会共享同一实例。
- 侧边栏较窄:DSH 界面为浏览器全宽设计,窄侧边栏可用标题栏的"在编辑器中打开(宽面板)"。
- 未上架 VS Code Marketplace;暂以 GitHub Release 的 vsix 分发。

故障排查

1. 侧边栏一直"启动中":输出面板选择 DeepSeek Harness (server) 查看日志。常见原因:dsh 不在 PATH 且 npx 拉取失败 → 在设置里填 dsh.dshCommand。
2. 界面空白/白屏:重启服务(标题栏重启按钮);DSH 页面首次启动较慢(几十个插件),给 10–30 秒。
3. headless 任务没反应:确认终端可以手动跑 dsh --profile headless "echo 测试"。
4. 端口冲突:设置 dsh.port 为固定端口,或保持 0 自动分配。

路线图

- [x] 侧边栏 iframe 嵌入 + 进程生命周期管理 + 右键 headless 任务
- [ ] IDE 上下文实时注入侧边栏会话(当前文件/选区/诊断 → postMessage 桥)
- [ ] dsh --profile tui 终端面板(原生终端版交互)
- [ ] 审批通知与 diff 原生集成
- [ ] 多窗口共享同一 dsh 实例

License

MIT © DeepSeek Harness for VSCode contributors