侧栏会话流lonelymoon87/dsh-vscode

DeepSeek Harness for VS Code

CI
DSH 兼容性
Release
VS Code
License

这是一个独立开发、仍处于预发布阶段的 DeepSeek Harness VS Code 客户端。0.1.2 内置官方 0.1.1-rc.1 SDK runtime，把持久化会话日志流式投影到侧栏，展示工具执行过程，并用 VS Code 原生 diff 编辑器打开文件工具的结果。

本项目是社区项目，不由 DeepSeek 维护或背书。

真实模型演示

DeepSeek Harness VS Code 真实 API 演示

录屏使用发布版扩展架构、官方 VS Code 1.133.0 arm64、扩展内置的官方 DSH SDK runtime、deepseek-official / deepseek-v4-flash，并完成了一次真实 bash 工具调用；没有使用 fixture 或 mock transport。

功能

- 使用 @deepseek-ai/dsh-sdk-client 管理随扩展打包、可复用的 dsh-jsonrpc-agent 子进程。
- 流式展示根会话的助手消息和可折叠工具卡片。
- 根据持久化的 tool/result.data.meta.diffs 打开原生前后对比编辑器。
- 显示会话状态和输入、输出 token 汇总。
- 提供新建会话、重启 runtime、查看诊断输出命令。
- 权限固定为 workspace-write，需要交互审批的操作会按官方语义拒绝执行。

前置条件

- VS Code 1.100 或更新版本，并打开一个受信任的本地文件夹。
- PATH 中有 Node.js 22.19 或更新版本。runtime 必须作为独立 Node 进程运行，因为经过签名的 macOS 编辑器不能在自身 Electron 可执行文件中加载第三方原生模块。
- 与当前操作系统和 CPU 匹配的 VSIX。内置 runtime 含原生 subprocess 依赖，所以发行包按平台构建。
- 启动 VS Code 的进程环境中存在 DEEPSEEK_API_KEY。DEEPSEEK_BASE_URL 可选。扩展刻意不提供可填写密钥的设置项。

在 macOS 上，从 Dock 启动的 VS Code 可能拿不到 shell 环境变量。开发阶段最简单的方式是在已配置密钥的终端里运行 code .。

安装

下载并安装已经验证的 macOS arm64 VSIX。

curl -fLO https://github.com/lonelymoon87/dsh-vscode/releases/download/v0.1.2/dsh-vscode-darwin-arm64-0.1.2.vsix
code --install-extension dsh-vscode-darwin-arm64-0.1.2.vsix

首个版本只提供经过验证的 macOS arm64 构建，其他平台尚未提供。

也可以从源码构建。

pnpm install
pnpm run check
code --install-extension dsh-vscode-*-0.1.2.vsix

打开 Activity Bar 中的 DeepSeek Harness 视图并输入提示词。也可以用 Cmd+Enter 或 Ctrl+Enter 发送。

设置

| 设置 | 默认值 | 含义 |
|---|---:|---|
| deepseekHarness.nodePath | node | 内置 runtime 使用的 Node 22.19+ 可执行文件；若编辑器拿不到 shell 的 PATH，请填写绝对路径。 |
| deepseekHarness.runtimeCommand | 空 | 可选的外部 dsh-jsonrpc-agent 可执行文件；非空时会替代 nodePath 和内置入口。 |
| deepseekHarness.runtimeArgs | [] | 追加给 runtime 可执行文件的参数。 |
| deepseekHarness.provider | deepseek-official | initialize 请求使用的 provider route。 |
| deepseekHarness.model | deepseek-v4-flash | initialize 请求使用的模型 id。 |
| deepseekHarness.maxTokens | 49152 | 根 agent 每次请求的正整数输出 token 上限。 |

扩展通过 DSH_CORDIS_CONFIG 传入自带的 runtime/launcher/cordis.yml，通过 DSH_CWD 传入第一个工作区文件夹，通过 DSH_SESSION_ROOT 传入扩展私有存储目录。VSIX 已包含版本匹配的官方 runtime 包。runtimeArgs 会追加在内置入口或配置的外部 runtime 命令之后。

安全与失败行为

扩展不支持不受信任的工作区和虚拟工作区。runtime 只把第一个本地工作区文件夹作为可写根目录，Webview 也不会通过 innerHTML 写入内容。SDK 传输错误会保留在会话记录和 DeepSeek Harness 输出通道中；重启 runtime 会替换失败进程并重新读取设置。

当前 SDK 协议没有 server 到 client 的审批请求，也没有 client 审批回复。随扩展提供的 runtime 配置因此固定使用 workspace-write，需要 answerer 的操作会被官方审批服务拒绝。扩展不会静默扩大权限。

已知限制

- 0.1.1-rc.1 SDK 协议尚未提供中途取消、审批 UI、会话列表和会话恢复。
- 同一时间只展示一个根会话和一个工作区文件夹，子 agent 通知不会混入根会话记录。
- Markdown、图片附件和非 diff 的结构化工具展示目前会退化为纯文本。
- VS Marketplace 发布和签名发行仍待完成；GitHub Release 中的 VSIX 是未签名的社区构建。

开发

pnpm run test 覆盖事件投影，并让官方 SDK 对真实脚本化 JSON-RPC 子进程完成协议测试。pnpm run package 生成 VSIX。任何用户可见的 Pull Request 都必须附带从该分支真实扩展、runtime 和模型流程录制的 GIF；测试 fixture 不能代替发布证据。

贡献与安全报告方式见 CONTRIBUTING.md 和 SECURITY.md。

发布验证

- pnpm run check 覆盖类型检查、单元测试、生产构建和 VSIX 打包；
- CI 在 Node 22.19 与 Node 24 上运行；
- 内置的 0.1.1-rc.1 runtime 已完成真实 SDK initialize 与 shutdown 握手；v0.1.2 在加入多平台发布自动化前仍只提供 macOS arm64 构建；
- bug 与兼容性问题统一进入 GitHub Issues。