Skip to content
| Marketplace
Sign in
Visual Studio Code>AI>Vscode-Native-DSHNew to Visual Studio Code? Get it now.
Vscode-Native-DSH

Vscode-Native-DSH

YangHui

|
3 installs
| (0) | Free
A native DeepSeek Harness chat panel for VS Code - workspace chats, streaming Markdown, models, permissions, approvals, file changes and token statistics.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Vscode-Native-DSH

DSH Chat for VS Code

在 VS Code 里以原生面板使用 DeepSeek Harness (DSH):不内嵌 DSH 网页,不加载 iframe,不安装 DSH 插件。扩展在后台管理一个本地 dsh --profile web 进程,通过 DSH 自己的认证 API 获取工作区、会话、流式消息、工具调用、权限、审批和 token 统计。

当前针对 DSH 0.2.1-rc.2 开发与验证;DSH 的 Web API 属于内部接口,升级 DSH 后可能需要更新适配层。

功能

  • 仅当前工作区的聊天列表:自动匹配 VS Code 工作区与 DSH 工作区,显示标题、相对时间、运行状态;支持“查看全部”和搜索。
  • 长会话性能:初始只加载最近 30 条消息,更早历史按需“加载更早”;已渲染的 Markdown 做 memo 缓存,流式输出时不会重复解析整段历史。
  • 原生会话视图:Markdown(表格、任务列表、代码高亮、KaTeX 公式)、流式思考/回答、工具调用卡片、命令行、错误/中断提示、加载更早历史。
  • 隐藏工作过程:默认只显示用户消息、每轮最终回答、错误和变更卡;顶部眼睛按钮或设置可一键显示完整思考/工具/中间步骤。DSH 注入的 runtime-context 不会显示。
  • 变更卡与撤销:以 DSH 官方 workspace/changes 为准汇总“已编辑 N 个文件 +A -R”卡片——git 工作区内由 write/edit、pwsh/shell 命令产生的改动都会列入;支持逐文件查看 diff、撤销本轮修改(工作区内、当前内容仍匹配时)。非 git 工作区只有 write/edit 会被 DSH 记录。
  • 对比审阅:变更卡的“对比审阅”在 VS Code 主编辑器标签页打开并排 Compare(不是侧栏弹层);字号可调(A−/A+);逐行点击左侧或右侧选择保留哪一边,选中侧高亮,同一行内部的差异字符会进一步高亮;右侧修改后的可见行可直接点击编辑,改完点“应用选择”写回文件;支持全部接受、单文件撤销,并可从审阅页跳到 VS Code Diff。
  • 对话分支:任意助手回复下方都有“分支”按钮,调用 DSH session/fork 在该回复处创建新 Session 并切换过去,可继续不同的后续提问。
  • 计划审查:计划审查占满会话列高度,计划正文单独滚动;下方提供“修改意见”输入框,意见会随“继续修改”反馈给模型,也可直接批准计划。
  • 可调字号:dshNative.ui.fontSize 或设置面板中的 12/13/13.5/14/15 按钮,默认 13.5px。
  • 归档/恢复会话:聊天列表行悬停出现归档按钮;“全部聊天”中可按搜索归档当前会话,并在“已归档”区恢复。归档仍在运行的会话会先确认停止其 turn/子代理/任务/计划。DSH 不提供永久删除会话的 API,因此不会删除会话日志。
  • 输入区:文本、图片粘贴/拖拽、Enter 发送、Shift+Enter 换行、运行中停止。运行中输入后点“接入”可立即 steer 当前回合;普通发送/Enter 仍排队到本轮结束。
  • 模型与思考等级:从 DSH session/modelCatalog 读取可用模型与 reasoning effort;新对话可先选后发。
  • 批准范围:读取 DSH 权限预设(只读 / 工作区写入 / 完全访问等),通过 DSH 的 /permission 命令切换;审批请求内联批准/拒绝;可开启“帮我批准”自动批准(仅当前会话,默认关闭,计划审查不会自动批准)。
  • 命令:commands/list + commands/execute;输入 / 显示命令补全;左侧栏提供命令列表。
  • 设置:字号、工作过程显示、性能统计详细度、自动批准、DSH 可执行文件/profile 等。
  • 统计:上下文占用环与构成、会话轮/步、输出 tok/s、总 token、缓存命中,公式与 DSH Web 客户端一致。
  • 与本机 DSH 同步:共享 ~/.dsh 下的工作区、会话、投影缓存和凭据;扩展不直接写 DSH 数据文件,写操作由 DSH host 完成。
  • 安全边界:仅连接 127.0.0.1;启动 token 和 API cookie 只存内存;Webview CSP 禁止网络;不信任的工作区禁用 DSH。

环境要求

  • VS Code 1.91+(在 1.143.1 上验证)。
  • 已安装并可用的 DSH,dsh 在 PATH 中,或通过 dshNative.executablePath 指定 dsh.cmd。
  • 已在 DSH 中登录/配置模型(扩展不提供 DSH 登录或凭据管理界面)。
  • Windows 为第一优先验证平台;macOS/Linux 路径查找已实现但未充分测试。

安装

从 VSIX

code --install-extension dsh-native-0.1.0.vsix

然后重载窗口。左侧活动栏或右侧辅助侧边栏会出现 DSH 图标。

从源码

npm install
npm run build
npm run package     # 生成 dsh-native-0.1.0.vsix

开发调试:在 VS Code 打开本目录,按 F5 启动 Extension Development Host。

使用

  1. 打开一个文件夹(建议与 DSH Desktop 中打开的 DSH 工作区相同)。
  2. 点击 DSH 图标;扩展在后台启动/复用 dsh --profile web --no-open --port 0。
  3. 顶部列表显示当前工作区的 DSH 会话;点击打开,或点 + 新建。
  4. 在底部输入;模型/思考等级在右下,批准范围在左下,统计在输入框下方。
  5. 左侧窄栏可打开工作区、权限、命令、服务/日志和设置浮层。

服务状态

  • 状态栏 DSH 显示运行状态;等待审批/回答时显示铃铛和数量。
  • 服务启动/认证/重连失败时,面板顶部有横幅和重试按钮。
  • DSH: Show Logs 打开脱敏后的输出日志(token、cookie、API key 不会写入)。

设置(dshNative.*)

设置 默认 说明
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:mock vscode + 真实 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 后生效。

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft