Xizhi1024/deepseek-harness-dsh-for-vscode

DeepSeek Harness(dsh) for VS Code

简体中文 · English

把 Cursor 式的 AI 编程体验带进 VS Code——底层跑的是你自己的 DeepSeek Harness (DSH) Agent。

在 VS Code 辅助侧边栏嵌入完整 DSH Web UI：每个窗口自动启动并持有一个本地 dsh web 服务（cwd = 当前工作区），你的模块、技能、MCP、凭据、会话全部可用。在此之上补齐 IDE 集成层：

- 侧边栏即对话：Ctrl+Alt+B 打开；复制/粘贴/右键菜单、文件跳转、主题跟随全部原生
- 上下文附加：右键把文件 / 选区 / 文件夹 / Problems 以紧凑链接加入对话草稿，绝不粘贴源码、绝不自动发送
- DSH 变更评审：DSH 推送的工作区编辑进入专门树视图，diff / 接受 / 撤销，写文件前必须审批（默认开启）
- @dsh 聊天参与者：VS Code 原生聊天里输入 @dsh 直连本地 DSH 会话，流式回复，不占 Copilot 配额（默认开启）
- 进阶可选：Ctrl+K / Ctrl+I 内联编辑、模型路由进 VS Code 选择器、MCP 消费、终端 / UI 桥、FIM Tab 补全——全部挂在显式同意开关后

⚠️ 兼容性

| 项 | 要求 |
|---|---|
| VS Code | ≥ 1.106，仅桌面版；不支持远程 / 虚拟 / 不受信任工作区 |
| DSH CLI | npm i -g @deepseek-ai/dsh，建议 ≥ 0.1.0-rc.7（更老的运行时会自动降级重试，但部分功能受限） |
| Node.js | 自动发现；非标准位置设 dsh.local.nodePath |

📦 安装

- Marketplace（推荐）：扩展视图搜索 DeepSeek Harness（发布者 Xizhi1024），或 code --install-extension Xizhi1024.dsh-vs-sidebar
- VSIX：从 Releases 下载 → Extensions: Install from VSIX...

🚀 使用

1. 按 Ctrl+Alt+B 打开侧边栏——扩展自动启动（或复用）本地 dsh web 并加载 UI
2. 编辑器里选中代码 → 右键 添加到 DSH 对话，草稿收到 文件:行号 紧凑链接，回车发送
3. VS Code 聊天视图输入 @dsh + 问题，回复来自本地 DSH 会话
4. 让 DSH 经桥提议编辑：变更进入 DSH 变更 视图，diff / 接受 / 撤销，未批准不写文件

将 VS Code 选区以紧凑链接添加到 DSH 对话

常用命令（命令面板 DSH: 前缀）：新建/切换会话 · 打开会话历史 · 重启/停止服务 · 在浏览器打开 · 新建 DSH 实例（Ctrl+Alt+N）· 诊断 · 干净重启 · 设置 DSH FIM API Key。

⚙️ 配置

| 键 | 默认 | 说明 |
|---|---|---|
| dsh.port | 3080 | DSH Web 服务端口 |
| dsh.autoStart | true | VS Code 启动即拉起服务 |
| dsh.home.mode | shared | shared=共享官方 ~/.dsh；isolated=扩展私有目录 |
| dsh.profile | web | DSH profile 目录名 |
| dsh.executablePath | (空) | 手动指定 DSH 可执行文件/包目录/shim，优先于自动发现 |
| dsh.closePolicy | onVscodeExit | 何时停止自有服务 |
| dsh.features.changes-review | true | DSH 变更评审（写前审批） |
| dsh.changes.observe-tools | true | 工具产生的编辑归因进变更树（「工具」分组） |
| dsh.features.chat-participant | true | @dsh 聊天参与者 |
| dsh.features.ctrl-k / ctrl-i | false | 内联编辑命令（Ctrl+K / Ctrl+I） |
| dsh.features.lm-route | false | DSH 模型进 VS Code 语言模型选择器 |
| dsh.features.mcp-consume | false | DSH 消费 VS Code 侧 MCP 服务器 |
| dsh.features.tab-completion | false | FIM Tab 补全——需设置 dsh.fim.baseUrl + DSH: 设置 FIM API Key 并重启 DSH 服务 |
| dsh.fim.baseUrl | (空) | 上游 FIM 端点（OpenAI 兼容 completions API 完整 URL） |
| dsh.keybindings.ctrlL | true | Ctrl+L 把选区加入对话草稿（绝不发送） |
| dsh.bridge.terminal / editorRead / ui | false | 终端 / 编辑器读取 / UI 表面桥（同意开关） |

完整键列表见 package.json；诊断用命令 DSH: Diagnose。

License

MIT