返回目录

dsh-vscode

维护状态: 活跃

fengze233/dsh-vscode

在 VS Code 中集成 DeepSeek Harness,提供嵌入式 Web 界面、自动启动、鉴权中继和桥接功能。

前往 GitHub项目主页
$ dsh web

51

星标

16

Fork

TypeScript

语言

MIT

许可证

2026-08-15

创建于

2026-11-08

最近推送

MIT 许可的 VS Code 扩展:把 DSH web UI 嵌进编辑器,托管 `dsh web` 生命周期,在 loopback 上中继 DSH 的 token 鉴权,并把编辑器动作桥接进面板。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-20

许可证

MIT

01它能帮你完成什么?

  • 在代码旁边直接和 DeepSeek Harness 对话,不必切到终端或浏览器标签页

    完整的 DSH web UI 嵌在左侧栏或右侧副栏,服务由扩展自动复用或启动

    整天待在编辑器里、不想再为 agent 多开一个窗口的 VS Code 用户

  • 让 DSH 强制的浏览器登录在跨站 webview 里照样成立

    一次性启动 URL 换成 30 天会话 cookie,再经 loopback 中继提供给面板,iframe 不会卡在登录页或 401

    用 DSH 0.1.2 以上、否则嵌在编辑器里的面板会一直要求登录的人

  • 让嵌进来的 DSH 页面表现得像编辑器里的原生一页,而不是被困住的 iframe

    可点的文件路径、走系统浏览器打开的外链、能用的复制按钮、恢复的撤销/重做,以及给无视觉模型用的图片兜底

    每天都在 agent 面板里点文件路径、复制代码块、贴截图的开发者

02如何接入 DeepSeek Harness?

前置条件

  • PATH 上有 `dsh` CLI —— 从 DeepSeek Harness 安装;Windows 上也可以用 DSH Desktop
  • VS Code ≥ 1.91(README 的开发要求);Node.js ≥ 22 只在从源码构建扩展时才需要

安装步骤

  1. 01

    从 Marketplace 安装:`code --install-extension Fengze233.dsh-vscode-panel`

  2. 02

    或从 Releases 下载最新 `dsh-vscode.vsix`,在 VS Code 里执行 `Extensions: Install from VSIX...`,然后重载窗口

  3. 03

    点左侧活动栏或右侧副栏里的 DSH 鲸鱼图标 —— 扩展会启动(或复用)`dsh web` 并替面板完成登录

    $ dsh web

验证接入成功

  • 状态栏会显示实时服务状态:running / starting / stopping / failed / stopped
  • `DSH: Show Logs` 会打印检测到的 `dsh` 路径、来源与版本
  • 桥接自检:DSH 面板的 DevTools 控制台应出现 `[dsh-vscode-bridge] handshake ok, v0.4.4, imageFallback=true`

回滚

  • 卸载扩展:VS Code 会执行 `uninstall` 钩子,移除 `cordis.patch.yml` 里被标记的条目和桥接目录
  • 或执行 `DSH: Uninstall Bridge`,只移除桥接包并还原 `cordis.patch.yml`,扩展本身保留

03DSH 适配与能力边界

DSH 适配原生运行时

把官方 `dsh web` 服务包进 VS Code 的 webview:接管服务生命周期、在 loopback 上代理 DSH 的一次性 token 鉴权,并把 `dsh-vscode-bridge` 客户端插件装进 DSH profile

  • 服务生命周期管理

    `dsh.profile`、`dsh.port`、`dsh.launchPreference`(`auto` / `npm` / `desktop`)与 `dsh.autoStart`→复用或新起一个 `dsh web`;配置端口被占用时临时切到第一个空闲端口

    关闭最后一个窗口只会停掉扩展自己启动的那个服务
  • 鉴权中继(auth relay)

    `dsh web` 打印的一次性启动 URL→会话 cookie 存进扩展私有存储,再由监听 `127.0.0.1` 随机端口的 loopback 中继提供给 iframe

    中继握着 30 天会话,任何本机进程只要扫到那个随机端口就能驱动该会话不是扩展启动的 DSH 服务,需要粘贴一次启动 URL
  • 桥接进 DSH 页面

    `$DSH_HOME/profiles/<dsh.profile>`(默认 `~/.dsh/profiles/web`)下的 DSH 用户目录→面板内的文件跳转、外链走系统浏览器、剪贴板复制、撤销/重做与图片兜底

    在 `cordis.patch.yml` 里写入带 `# dsh-vscode-bridge: begin/end` 标记的块,并在用户 profile 下写桥接目录 —— 绝不写 DSH 安装目录捆绑版本或其 `client.js` 内容有差异时会强制重装
  • 无视觉模型的图片兜底

    粘贴的图片,加上一个已打开的工作区文件夹→图片缓存到工作区根目录,并以文件路径引用的形式发给模型,由模型用图片工具读取

    临时图片用完即删,残留由 `DSH: Clean Up Image Cache` 清理
  • 远程场景

    `dsh.remote.enabled`,并在远端主机上装好扩展→SSH Remote、Dev Containers、Codespaces 在远端跑 `dsh` 并通过隧道打开面板;WSL 不需要隧道

04适合谁?何时不该用?

适合

  • 整天待在编辑器里、不想再为 agent 多开一个窗口的 VS Code 用户
  • 用 DSH 0.1.2 以上、否则嵌在编辑器里的面板会一直要求登录的人
  • 每天都在 agent 面板里点文件路径、复制代码块、贴截图的开发者

不适合

  • loopback 中继只监听 `127.0.0.1`,但它握着一个 30 天的会话:本机任何进程(包括本机其他用户)只要扫到那个随机端口就能驱动该 DSH 会话。README 明确写了这一暴露面,并与「0.1.1 及更早、在 `127.0.0.1:3080` 上无鉴权的服务」作对比。
  • DSH Desktop 用的是 `desktop` profile,而 VS Code 默认用 `web`:会话与设置都在 `~/.dsh` 下共享,但插件按 profile 安装,所以要用在 VS Code 面板里,得把 DSH 插件装进 `web` profile。
  • 如果模型 API 只能通过 HTTP/HTTPS 代理访问,代理变量必须传进 `dsh web` 子进程 —— 打开 `dsh.useEnvProxy: true`,或用 `dsh.env` 注入 `NODE_OPTIONS=--use-env-proxy` 并给出 `HTTPS_PROXY` / `HTTP_PROXY`。

05兼容性、维护与安全提示

  • loopback 中继只监听 `127.0.0.1`,但它握着一个 30 天的会话:本机任何进程(包括本机其他用户)只要扫到那个随机端口就能驱动该 DSH 会话。README 明确写了这一暴露面,并与「0.1.1 及更早、在 `127.0.0.1:3080` 上无鉴权的服务」作对比。
  • DSH Desktop 用的是 `desktop` profile,而 VS Code 默认用 `web`:会话与设置都在 `~/.dsh` 下共享,但插件按 profile 安装,所以要用在 VS Code 面板里,得把 DSH 插件装进 `web` profile。
  • 如果模型 API 只能通过 HTTP/HTTPS 代理访问,代理变量必须传进 `dsh web` 子进程 —— 打开 `dsh.useEnvProxy: true`,或用 `dsh.env` 注入 `NODE_OPTIONS=--use-env-proxy` 并给出 `HTTPS_PROXY` / `HTTP_PROXY`。
  • README 里记了三处已知限制:VS Code 1.140 起从资源管理器拖拽资源进 webview 不再生效(上游回归,修复仍开着),图片兜底需要已打开的工作区文件夹(缓存写在根目录下),而 SSH Remote / Dev Containers / Codespaces 在打开 `dsh.remote.enabled` 前不可用。
2026-08-152026-11-08V0.4.4

MIT · 活跃维护(最新 release V0.4.4,2026-11-08)

06常见问题

怎么把 DSH 装进 VS Code?

从 Marketplace 安装 `Fengze233.dsh-vscode-panel`,或运行 `code --install-extension Fengze233.dsh-vscode-panel`;也可以从 Releases 下 `.vsix` 用 `Extensions: Install from VSIX...` 装。前提是 PATH 上有 `dsh` CLI,Windows 上也可以用 DSH Desktop。之后点活动栏里的鲸鱼图标,扩展会启动或复用 `dsh web` 并自动登录。

面板显示登录页或 401 是怎么回事?

DSH 0.1.2 起强制浏览器鉴权。扩展自己启动的服务是自动登录的;如果 DSH 是你在 VS Code 外面起的(systemd、终端),扩展读不到那个进程的日志,就会给一个一次性登录页:把服务日志里的启动 URL 粘一次,会话最长 30 天,重启服务也不用再粘。

提示 dsh not found 怎么办?

先装 `dsh` CLI(`npm i -g @deepseek-ai/dsh`)或 DSH Desktop,并确认命令在 PATH 上。`dsh.launchPreference: auto` 时扩展优先 npm、失败回落 Desktop;Desktop 装在自定义目录就设 `dsh.desktopCommandPath`,用包装脚本就设 `dsh.executablePath`。`DSH: Copy Logs` 会打印检测到的路径、来源与版本。

我装的 DSH 插件在 VS Code 面板里看不到?

DSH Desktop 用 `desktop` profile,VS Code 默认用 `web`。会话与设置都在 `~/.dsh` 下共享,但插件按 profile 安装,所以要装进 `web` profile(或用 `dsh.profile` 指向你想用的 profile)。

这会把我的 DSH 会话暴露到网络上吗?

不会。扩展只接受 loopback 地址(`127.0.0.1` / `localhost` / `[::1]`),中继不对网络暴露。不过 README 也写明中继握着 30 天会话,本机进程扫到那个随机端口就能驱动该会话 —— 暴露面和 0.1.1 及更早、在 loopback 上无鉴权的服务相同。

08数据与来源

  • 作者声明github.comb1243baf6cda…

    Click the whale and get the full DSH web UI beside your code — the extension starts or reuses `dsh web`, handles DSH's o…

  • 作者声明github.comb1243baf6cda…

    Works with **DSH 0.1.2 and newer**, including its browser authentication (auto sign-in, no manual step).

  • 作者声明github.comb1243baf6cda…

    **Install / uninstall transparency.** The bridge is installed into `$DSH_HOME/profiles/<dsh.profile>` (default `~/.dsh/p…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。