VS Code 编码智能体 g7human/dsh-vscode

dsh-vscode — DeepSeek Harness 的 VS Code 插件

License: MIT
CI
Release

仓库：

dsh-vscode 是一个类似 Codex 的 VS Code 编码智能体插件，由 DeepSeek Harness（DSH）驱动：智能体运行在插件自带的后台进程中，与侧边栏聊天面板本地直连——不监听端口、不走网络、无需单独部署。当前版本 v0.1.0。

架构

VS Code 扩展宿主 (CJS, src/.ts) │ child_process.fork + IPC ▼ DSH host 进程 (ESM, host/host-main.mjs) │ Cordis 组合：dsh-base（agent 内核 + 沙箱 + 工具） │ + cordis.vscode.yml（workspace / storage / 本扩展三个插件） │ InProcessApiClient( toFetchHandler( ctx.apiProxy ) ) ← 无 HTTP/WS ▼ webview 聊天面板 (media/main.js) └─ postMessage JSON-RPC：session. / workspace.* / host.* / 事件流 / 提问 / 审批

三个自带插件（host/plugins/，运行时复制到配置目录并作为相对 specifier 加载）：

| 插件 | 作用 |
| vscode-api-gateway.mjs | createApiProxy 包装：cwd = VS Code 工作区文件夹；openPath/openTextFile 走 VS Code API |
| vscode-directory-picker.mjs | ctx.directoryPicker（native 能力）→ vscode.window.showOpenDialog |
| vscode-approval-answerer.mjs | approval/request 瀑布监听 → 聊天面板"允许/拒绝" |

组合层顺序：dsh-base bundle → host/cordis.vscode.yml → $DSH_HOME/cordis.patch.yml（用户层，可在 ~/.dsh/cordis.patch.yml 覆盖任何行）。

前置要求

- VS Code 1.90+（推荐最新版）
- Node.js 18+（仅构建时需要；运行时用 VS Code 内置 Node）
- DeepSeek API Key（sk-…，安装后在插件里设置）

安装

0) 进入项目目录
cd dsh-vscode

1) 安装依赖（DSH 依赖树较大，约 1–3 分钟）
npm install

2) 编译扩展宿主
npm run compile

方式 A：开发调试（推荐先做一次验证）

1. 用 VS Code 打开本目录：code .
2. 按 F5 → 选择 "Run Extension"（.vscode/launch.json 见下，若提示创建则选 "VS Code Extension Development"）。
3. 新窗口辅助侧边栏出现 DeepSeek Harness 活动栏图标，点开 Chat 面板。
4. 看面板右上角状态点：绿 = 宿主就绪；红 = 启动失败（打开输出通道 "DeepSeek Harness" 看日志）。

可选 .vscode/launch.json：

{
"version": "0.2.0",
"configurations": [
{
"name": "Run Extension",
"type": "extensionHost",
"request": "launch",
"args": ["--extensionDevelopmentPath=${workspaceFolder}"],
"outFiles": ["${workspaceFolder}/dist/*/.js"]
}
]
}

方式 B：免打包安装（日常使用）

cd dsh-vscode
.\scripts\install.ps1

脚本会编译并把 dist / host / media / node_modules / package.json 复制到 %USERPROFILE%\.vscode\extensions\dsh-local.dsh-vscode-0.1.0。
完全退出并重启 VS Code 后生效（辅助侧边栏（Ctrl+Alt+B）出现 DeepSeek Harness）。

提示：VS Code 会加载 extensions 目录下任何带合法 package.json（有 main）的文件夹，这就是"解包扩展"安装方式，无需 VSIX。

方式 C：打包 VSIX（分发）

cd dsh-vscode
npm run package # = npx vsce package（依赖由 vsce 自动打入）
code --install-extension dsh-vscode-0.1.0.vsix

打包可能因本机 npm 缓存/网络策略失败；失败时使用方式 A/B 即可。

首次配置
1. 打开命令面板（Ctrl+Shift+P）→ DSH: 设置 DeepSeek API Key，粘贴 sk-…。
- Key 保存在 ~/.dsh/.credentials.yaml（与 dsh CLI 共用）。
- 也可以直接设置环境变量 DEEPSEEK_API_KEY（此时插件内的写入会被拒绝——环境变量优先级更高，属预期行为）。
2. 点击 ＋ 新会话，输入任务回车。默认模型 deepseek-official / deepseek-v4-flash。

使用

- 新会话 / 目录：右上角 ＋ 新会话；📁 目录 用 VS Code 原生对话框选工作目录（生成 DSH workspace，会话文件访问、沙箱策略都落在该目录）。
- 多会话：左侧会话列表切换；标题自动生成（session/projection 的 title）。
- 模型切换：点顶部模型徽章（deepseek-official / deepseek-v4-flash ▾）弹出目录——按提供商分组、当前模型高亮、带说明；带思考力度（reasoning effort）选项的模型会显示力度按钮与“默认”。选中即切换并保存为默认（新会话沿用）。目录加载失败（provider 故障）会在弹窗顶部显示 ⚠。
- 图片附件：输入框左侧 📎 选图（PNG/JPEG/WebP/GIF，可多选），缩略图显示在输入框上方、可单独移除；自动按 host 限额校验（maxImageBytes/maxImagesPerMessage/maxMessageImageBytes），超限提示。发送后聊天与历史记录都会回显图片（经 session.attachment 按 id 拉取）。
- 提问：智能体 ask_user_question 会在面板弹出选项/自定义回答。
- 审批：沙箱升级（sandbox_permissions）等需要授权的操作会弹出 允许一次 / 拒绝。
- 停止：⏹ 停止（session.cancel）。
- 斜杠命令：以 / 开头的输入走 DSH 命令注册表（/compact、/goal 等）。

高级配置

- 用户 patch 层：~/.dsh/cordis.patch.yml（与 dsh CLI 共用）可覆盖任意组合行，例如：
- id: agent-default-model
config: { provider: deepseek-official, model: deepseek-v4-flash }
- id: sandbox-policy
config: { mode: workspace-write, workspaceRoot: 'D:/my/project' }

- 会话数据：保存在 ~/.dsh/sessions（与 dsh CLI 共用）；工作区注册表在 ~/.dsh/storages。
- DSH_HOME：设置环境变量 DSH_HOME 可整体迁移数据目录（插件启动时读取）。

已知限制（v0.1）

- 每个扩展宿主进程一个 DSH host；多窗口各起一个（会话文件共享，但进程内状态不共享）。
- 未挂 agent presets：所有会话共享 host 组合（DSH 无 preset roster 时的官方行为）。
- 事件桥按帧转发，assistant/chunk 高频率下 webview 偶有重排（可后续节流）。
- 远程（SSH/容器）场景下 host 在远端，pickDirectory/openPath 由远端 VS Code server 执行；本地窗口正常。
- 未实现：diff 预览 / apply、inline 补全、会话删除 UI、agent preset 切换（P2 路线）。

故障排查

| 现象 | 处理 |
| 状态点一直黄（启动中） | 打开输出通道 DeepSeek Harness 看 host 日志；dsh.verbose 设 true 查看更多 |
| 状态点红 | 输出通道里有 FATAL；常见原因：依赖缺失（重新 npm install）、~/.dsh/cordis.patch.yml 语法错误（boot 会 fail-loud） |
| 发送后无回复 | models 显示 （不可用） 说明模型路由未就绪：检查 API Key、llm-deepseek 设置 |
| 想重置 | 删除 ~/.dsh/sessions、~/.dsh/storages；配置目录在 %APPDATA%\Code\User\globalStorage\dsh-local.dsh-vscode-0.1.0\dsh（每次启动重建） |

目录结构

dsh-vscode/
├── package.json # 扩展清单 + DSH 依赖（全部钉 0.1.0-rc.6） ├── tsconfig.json # 扩展宿主 TS → CJS ├── src/ │ ├── extension.ts # 入口：fork host、命令、原生动作 │ ├── host-process.ts # HostProcess：IPC 请求/事件/审批/原生回调 │ └── view.ts # WebviewViewProvider ├── host/ # ESM 宿主进程（不经 TS 编译，直接 .mjs） │ ├── host-main.mjs # IPC 入口 + RPC 分发 + 事件泵 │ ├── boot.mjs # startDshHost()：boot() + InProcessApiClient │ ├── cordis.vscode.yml # VSCode overlay（组合层 2） │ └── plugins/ # 三个自带 Cordis 插件 ├── media/ # webview 聊天 UI（纯 JS + CSS） └── scripts/ ├── smoke.mjs # 独立冒烟测试（无 VS Code / 无 Key 可跑） ├── ipc-smoke.mjs # IPC 全链路冒烟测试（fork host 进程） ├── install.ps1 # 免打包安装 └── build-vsix.ps1 # 手动构建 VSIX（vsce 失败的备用方案）

冒烟测试（两条链路，均可在无 VS Code、无 API Key 的环境验证）

1) 宿主内核直连（boot → gateway → workspace → session → history → 事件流）
npm run smoke

2) IPC 全链路（以扩展宿主相同方式 fork host：ready → RPC → 事件帧 → exit）
npm run ipc-smoke

注意：如果运行环境存在文件沙箱（例如在 DSH 会话内跑），smoke 会把 DSH_HOME 临时指到系统临时目录；ipc-smoke 需要 fork 子进程，在受限沙箱中可能被拦截（属环境限制，普通终端无此问题）。

真实模型调用验证：设置 API Key 后新建会话发送“用一句话介绍你自己”，正常收到回复即全链路可用。