Vscode-Native-DSHDSH Chat for VS Code 在 VS Code 里以原生面板使用 DeepSeek Harness (DSH):不内嵌 DSH 网页,不加载 iframe,不安装 DSH 插件。扩展在后台管理一个本地
功能
环境要求
安装从 VSIX
然后重载窗口。左侧活动栏或右侧辅助侧边栏会出现 DSH 图标。 从源码
开发调试:在 VS Code 打开本目录,按 F5 启动 Extension Development Host。 使用
服务状态
设置(
|
| 设置 | 默认 | 说明 |
|---|---|---|
executablePath |
"" |
dsh/dsh.cmd 绝对路径;空则按 PATH 和 DSH Desktop 常见路径查找 |
profile |
web |
DSH profile;必须提供 Web API |
host |
127.0.0.1 |
127.0.0.1 / localhost / ::1;只支持 loopback |
port |
0 |
0 表示随机端口;固定端口按设置使用 |
startTimeoutMs |
45000 |
等待启动 URL 的超时 |
extraArgs |
[] |
追加给 dsh web 的参数 |
env |
{} |
注入子进程环境变量 |
stopOnExit |
true |
窗口关闭时停止扩展启动的 host |
workspaceRootIndex |
0 |
多根工作区默认根 |
ui.language |
auto |
auto/zh/en(跟随 VS Code 或强制) |
ui.performanceUsage |
detailed |
compact 只显示速度和缓存命中 |
ui.showWorkDetails |
false |
显示思考/工具/中间工作步骤;关闭时只保留用户消息、最终回答、错误和变更卡 |
ui.fontSize |
13.5 |
面板基础字号(11–18) |
approval.autoApprove |
false |
新对话默认自动批准;仍可在会话内开关 |
chat.maxMessages |
30 |
每次加载的历史消息数;初始只加载最近 30 条,更早消息按“加载更早”读取 |
chat.streamThrottleMs |
50 |
流式 UI 节流 |
与 DSH Desktop / 旧扩展的关系
- 本扩展不会附着到正在运行的 DSH Desktop 进程。DSH 未公开外部客户端认证接口;直接读取 Electron IPC/cookie 不安全。扩展启动自己的 host,并与 Desktop 共享
$DSH_HOME的持久化数据。 - 因此历史、列表和统计是同步的;但一个 DSH 会话同一时间只允许一个写入 host。若会话正在 Desktop 中运行,本面板可只读打开,发消息可能返回
session/writer-held,需先在 Desktop 结束该轮。 - 本扩展不修改
~/.dsh/profiles/*,不安装 bridge/客户端插件,不使用 iframe。 - 已安装的
Fengze233.dsh-vscode-panel是“嵌入 DSH 网页”的旧方案。本扩展使用dshNative.*前缀,两者可并存但会各自启动一个 DSH host;测试时建议只启用一个。 - 目前没有自动附着 Desktop 的计划;如需要,后续可通过 DSH host bridge 或外部 Web URL 模式实现。
架构概要
Webview (React) ──postMessage──► Extension Host (Node)
├─ 启动/停止 dsh web
├─ GET /connect 交换 API cookie
├─ POST /api/<endpoint> JSON-RPC
├─ WS /api/remote.mux 会话流/事件流
├─ workspace/session/control/projection stores
└─ 审批/提问 waterfall
│
dsh --profile web --no-open --port 0
│
~/.dsh(共享工作区/会话/统计)
主要端点:workspace/follow、session/list、session/follow、session/page、session/control、session/create、session/prompt、session/selectModel、session/projections、permissionPresets/catalog、commands/list、commands/execute、$events。完整细节见源码中的 docs/protocol.md。
已知限制
- DSH Web API 是内部接口;DSH 升级可能改变字段。扩展会做能力探测并显示兼容性错误,不会静默崩溃。
- 不能同时把同一个会话作为写入会话附加到 DSH Desktop;见上文 writer lock。
- 图片附件支持 PNG/JPEG/WebP/GIF(每条最多 4 张,10MB/张);通用文件附件暂未实现。
- 变更卡依赖 DSH 官方
workspace-changes:git 仓库内的 shell 改动会被追踪;非 git 工作区只追踪文件工具编辑。Host 重启后旧摘要不可用(DSH 自身限制)。新建/修改文本文件可撤销;二进制、超大、被删除或本轮后又被改动的文件会被跳过。撤销数据保存在扩展宿主内存中,重载窗口后失效。 - 不提供语音输入、DSH 设置/登录/凭据/插件市场 UI。
- 不展示 subagent/team/workflow/MCP 的完整专门视图;这些事件会以通用行或提示出现。
- Remote SSH/WSL 未专项测试;扩展声明为
workspace扩展,为远程场景留了扩展点。 - 多个 VS Code 窗口会各自启动 host;若同时打开同一会话,由 DSH 写锁裁决。
开发与测试
npm install
npm run typecheck
npm run test # 单元 + Webview smoke(不需要 DSH)
npm run test:wire # 真实 dsh web 的协议 smoke(需要 dsh)
npm run test:controller # 受管 host + controller 集成(需要 dsh)
npm run build
npm run package
开发脚本:
scripts/probe.mjs:隔离DSH_HOME下的原始协议探针。scripts/wire-smoke.cjs:真实 host 的认证/RPC/流 smoke。scripts/unit-smoke.cjs:统计与 transcript 折叠测试。scripts/build-webview-test.mjs+run-webview-test.cjs:jsdom + Rollup 的 Webview 渲染测试。scripts/controller-probe.cjs:mockvscode+ 真实 DSH host 的 controller 集成测试。
安全与隐私
- 只接受 loopback 服务地址。
/connect的启动 token 与 API cookie 仅保存在扩展宿主内存;不写 settings、不写日志。- Webview CSP:无网络、无 iframe、无远程脚本;Markdown 禁用 raw HTML,链接仅允许 http/https/mailto 和显式文件打开。
- 不读取或伪造 DSH Desktop cookie。
- 无遥测;不收集会话内容。
- 工作区不受信任时面板禁用(DSH 会执行命令)。
License
MIT
WSL2 / nvm 注意事项
扩展在 Remote - WSL 下运行时,DSH 和 node 都必须存在于 WSL 的扩展宿主环境,不能使用 Windows 宿主机上的 DSH。
如果日志出现:
/usr/bin/env: ‘node’: No such file or directory
DSH host exited (code=127)
说明 dsh 已经被找到并启动,但 VS Code 的 WSL 扩展宿主没有加载 nvm 的 shell 初始化,/usr/bin/env node 找不到 node。新版会把 dshNative.executablePath 所在目录自动加到 DSH 子进程的 PATH 最前面;因此:
"dshNative.executablePath": "/home/yanghui/.nvm/versions/node/v24.22.2/bin/dsh"
通常即可,前提是 node 和 dsh 位于同一个 nvm bin 目录。
如果 dsh 是从 /usr/local/bin/dsh 之类的 symlink 启动,或 node 不在同目录,可在 Remote [WSL: Ubuntu-24.04] 设置中显式指定 PATH:
"dshNative.executablePath": "/home/yanghui/.nvm/versions/node/v24.22.2/bin/dsh",
"dshNative.env": {
"PATH": "/home/yanghui/.nvm/versions/node/v24.22.2/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
}
dshNative.executablePath 和 dshNative.env 都是 Machine 作用域:VS Code 会把它们分别保存在 Windows 和每个 WSL Remote 中,不随 Settings Sync 同步。请在 Remote [WSL: Ubuntu-24.04] 设置里填 WSL 路径;在 Windows 本地设置里填 Windows 的 dsh.cmd 路径或留空自动检测。
如果旧版本遗留了一个全局路径,扩展会忽略明显属于另一平台的路径(Windows 上的 /home/...、WSL 里的 C:\...)并回退到自动检测;在 WSL 中还会搜索 ~/.nvm/versions/node/*/bin/dsh。Reload Window 后生效。