Deepseek-Harness-for-VS-CodeDeepSeek Harness plugin

DeepSeek Harness for VS Code

一个零依赖的 VS Code 扩展，把 DeepSeek Harness (DSH) 接入 VS Code 的两种形态：

1. 忠实窗口：把 DSH 的 Web GUI 原样内嵌到 VS Code 侧边栏 / 辅助侧边栏 / 编辑器标签页，自动检测、启动 DSH 服务——不注入脚本、不改写界面、不拦截交互，不影响你对 DSH 的页面组织、第三方插件装配等任何二次开发行为；
2. Copilot 桥接（v0.7.13 起，早期版本）：把 DSH 注册为 VS Code 聊天模型——模型选择器里出现 DSH (DeepSeek Harness)、DeepSeek-V4-Pro (DSH)、DeepSeek-V4-Flash (DSH)、deepseek-v4-flash-vision-exp (DSH) 等条目，选中即可在 Copilot Chat 里借助 DSH 强大的任务编排与工具调用能力解题。

Copilot 桥接不影响「忠实窗口」形态——它只是为便捷编程而做的功能提升；你不选这些模型条目时，一切与没有桥接功能时完全一样。

如果喜欢本扩展请转至 Deepseek-Harness-for-VS-Code 星标助力；对 Chrome Extension 有需求也请关注 Deepseek-Harness-for-Chrome。

---

🚀 快速安装

• Marketplace：在 VS Code 扩展市场搜索 DeepSeek Harness for VSCode 一键安装（Marketplace 页面）。

• .vsix：从 GitHub Releases 下载 deepseek-harness-vscode-<版本>.vsix，然后：

  bash
  code --install-extension deepseek-harness-vscode-<版本>.vsix

  或在 VS Code 中：Ctrl+Shift+P → Extensions: Install from VSIX...。

安装后 Ctrl+Shift+P → Reload Window。打开面板时扩展会自动检测并启动 DSH（未安装会提示并代为执行 npm install -g @deepseek-ai/dsh）。

---

🪟 忠实窗口（面板）

• 把 DSH Web GUI 原样内嵌到侧边栏 / 辅助侧边栏 / 编辑器标签页（标签页可 Pin 住；与侧边栏「单活动视图」自动让位，规避 DSH 前端 webview 单实例限制）；
• 自动检测 / 自动启动 / 自动安装 dsh，服务就绪后再渲染，避免白屏；
• 工作区自动对接：以 VS Code 当前工作区启动 dsh 并注册到 DSH 工作区列表（幂等，不覆盖你在 DSH 里的手动选择）；
• 远程支持：Remote-SSH / Dev Containers 下运行于服务器端，自动检测安装服务器端 dsh、经端口转发把面板接入本地 VS Code；
• 面板按钮：刷新（不打断运行中的任务）/ 重启 dsh web / 在浏览器中打开；字号跟随 editor.fontSize 等比缩放；
• 发送选中内容 / 拖放文件到 DSH 对话框（自动安装配套插件 dsh-drop-caret）：把文件、文件夹、代码段以 路径:行号 引用精确插入对话框光标处；点击 DSH 对话中的外链在系统浏览器打开（配合 DSH 插件 dsh-open-links）。

使用示例：发送选中内容到对话框

拖拽 / 右键发送是 dsh-drop-caret 最常用的能力，操作如下：

1. 在 VS Code 中框选住代码块 / 文字块；

2. 右键，点击 「DeepSeek Harness: 发送选中内容到对话框」：

   

3. 代码块所在行数的链接（路径:起始行-结束行）就会被发送到对话框，插入在当前光标位置：

   

4. 在 DSH 里直接发送消息即可，模型可通过引用精确定位到代码块所在文件与行号。

同样地，也可以把文件 / 文件夹从系统文件管理器或 VS Code 资源管理器直接拖进对话框，插入位置同样是拖放点对应的光标位置。

面板相关配置

配置项	默认值	说明
dshPanel.url	http://127.0.0.1:3080	面板连接的 DSH 地址
dshPanel.host / dshPanel.port	127.0.0.1 / 3080	自动启动时绑定的主机与端口
dshPanel.autoStart	true	未运行时是否自动启动 dsh
dshPanel.autoRegisterWorkspace	true	是否把当前工作区自动注册为 DSH 工作区
dshPanel.autoInstallDsh	true	未安装 dsh 时是否提示并代为安装
dshPanel.dshCommand	dsh	dsh 命令（可填完整路径）
dshPanel.killOnDispose	true	扩展停用时是否结束它启动的 dsh

远程服务器（vscode-server）场景

扩展声明 extensionKind: ["workspace"]，在 Remote-SSH / Dev Containers 等场景下运行于服务器端：

1. 自动检测并安装服务器端的 dsh（npm install -g @deepseek-ai/dsh，要求服务器已装 Node.js 与 npm）；
2. 自动端口转发：通过 vscode.env.asExternalUri 把远程 127.0.0.1:3080 暴露到本地，iframe 直接加载，无需手动配 SSH 隧道（首次转发确认允许即可）；
3. dsh 以远程工作区为 cwd 启动并自动注册。

如果 DSH 跑在另一台机器、且不是通过 VS Code Remote 连接的，可手动建隧道：ssh -L 3080:127.0.0.1:3080 user@server，并把 dshPanel.autoStart 设为 false。

---

🧭 Copilot 桥接：操作指南

快速上手

1. 打开 Chat 面板（Ctrl+Alt+I）→ 模型选择器（Ctrl+Alt+.）里选择 DSH (DeepSeek Harness)（或直接选 DeepSeek-V4-Pro (DSH) 等固定条目）；
2. 直接提问，例如「帮我分析这个项目的数据」——DSH 用其配置的模型在工作区执行任务、调用工具解题，答案流式回写聊天框；
3. 每个 Copilot 聊天对应一个 DSH 会话：新聊天自动新建 DSH 会话，同一聊天内持续追问复用同一会话；你可以在 DSH 面板里实时看到完整执行过程。

模型与推理档位

• 模型：DSH (DeepSeek Harness) 条目默认跟随 DSH 设置里的默认模型（agent-default-model）；也可用 dshPanel.chatProvider / dshPanel.chatModel 指定（如 deepseek-official / deepseek-v4-pro，需先在 DSH 设置中配置好对应 provider）。模型选择器里的 DeepSeek-V4-Pro (DSH) 等条目则固定对应 DeepSeek 官方模型。
• 推理档位（reasoningEffort）：在聊天界面的模型配置里选择（off / low / high / max，与 DSH 会话同步生效）；dshPanel.dshReasoningEffort 作为兜底配置。

切换模型再切回

Copilot 会话中途切到其他自定义模型问答、再切回 DSH 模型时，扩展会把「其他模型产出的中间对话」打上产地标签补发给 DSH 会话；DSH 自己答过的内容不会重复回传（省 token、不占上下文）——DSH 侧时间线保持完整。

常用命令

命令	作用
DeepSeek Harness: 重置 DSH 会话映射	清空「聊天 → DSH 会话」映射，下次提问创建全新 DSH 会话
DeepSeek Harness: 检查 DSH 状态	查看 DSH 是否可达、模型提供方是否注册、当前模型配置
DeepSeek Harness: 诊断 DSH 模型注册表	导出模型注册表诊断数据（排查用）

取消等待不会杀掉 DSH 任务：任务会继续在 DSH 中运行，可到面板查看。

桥接相关配置

配置项	默认值	说明
dshPanel.enableDshModel	true	是否注册 DSH 聊天模型条目（关闭则桥接不生效，面板不受影响）
dshPanel.chatProvider / dshPanel.chatModel	空	DSH (DeepSeek Harness) 条目使用的 provider / 模型（如 deepseek-official / deepseek-v4-pro）；留空跟随 DSH 默认
dshPanel.chatAgentPreset	空	DSH 会话创建时使用的 agent 预设（如 liangshen）；留空=DSH 默认
dshPanel.dshReasoningEffort	空	推理档位兜底：off / low / high / max；界面选择优先
dshPanel.chatTimeoutMs	900000	单次任务最长等待毫秒数（15 分钟），超时后任务仍在 DSH 面板运行
dshPanel.chatSyncLookbackMin	60	聊天会话文件扫描窗口（分钟）
dshPanel.debugModelMessages	false	调试：把 VS Code 发给模型的消息结构写入 .dsh-debug/

---

🧩 Copilot 桥接：实现原理

整体数据流：

Copilot Chat（VS Code 组织好的对话）
        │  语言模型提供方协议（vscode.lm.registerLanguageModelChatProvider）
        ▼
本扩展（dsh 提供方）
  1. 滤除杂音：剥离系统提示词、工具定义、环境/上下文包裹（<prompt>/<userRequest>/<instructions>…），
     只保留真实问答与 Copilot 记忆正文
  2. 会话映射：以 Copilot 聊天的 sessionId 为键，映射到 DSH 会话（一聊天一会话）
  3. 增量同步：只把 DSH 尚未见过的内容发给 DSH（自己答过的不回传；其他模型的问答打产地标签补发）
  4. 档位同步：把界面选择的 reasoningEffort 传给 DSH（session.selectModel）
        │  session.create / session.prompt / session.history（DSH RPC）
        ▼
DSH：用自己的一套 harness（记忆 / 技能 / AGENTS.md / 工具 / agent 预设）二次组织，交给配置的模型执行
        │  流式事件（text-delta）
        ▼
本扩展：增量流式回写 Copilot 聊天框

要点：

• 滤除杂音：VS Code 交给模型的每条消息可能包裹 <instructions>（.copilot/instructions、AGENTS.md 引用）、<prompt> 真实提问、<userMemory>/<sessionMemory> 记忆块等。扩展只提取真实提问与记忆正文——上下文组织交给 DSH 自己的 harness，避免两套 harness 互相干扰。
• 会话映射（sessionId 直接映射）：Copilot 每个聊天在磁盘上有唯一文件 workspaceStorage/<哈希>/chatSessions/<sessionId>.jsonl（文件名即 sessionId）。扩展以 m-<sessionId> 为键建立「聊天 → DSH 会话」的一对一映射：
  • 非首轮：用「文件最后一条提问 == 当前转录的上一轮提问」认领聊天文件（上一轮必然已落盘，零竞态、零等待）；
  • 首轮：新聊天文件此刻只有元数据，直接认定「最近 60 秒内新建的空聊天文件」为当前聊天；
  • 兼容 Windows / macOS / Linux，以及 vscode-server（Remote-SSH / WSL / Dev Containers）等不同用户数据目录，并优先匹配当前工作区；
  • 兜底：请求落盘竞态等极少数情况退回首问哈希，并配合转录校验防串线。
• 增量同步（省 token）：DSH 会话自己会回放已答内容，因此扩展只发送「最后一条 DSH 答案之后的新增内容」——连续对话时只发新提问；切走再切回时，外来问答以 【Copilot 其他模型回答】 标签补发。
• 双投递去重：VS Code 会把同一次提问投递两次（裸提问 + 带上下文），扩展识别为同一问题后只执行一次，另一路直接回放同一份答案。
• 并发支持：多个聊天同时使用 DSH 模型时，各聊天独立定位、独立会话、并行返回；扩展对启动探测、文件解析做了记忆化与缓存，避免并发互相拖慢。

---

🌱 版本状态声明

Copilot 桥接是早期版本，但已经过充分测试、功能完全可用：

• 欢迎大家在不同操作系统（Windows / macOS / Linux，以及 Remote-SSH、WSL、Dev Containers 等远程场景）中测试使用；
• 如遇问题请在 GitHub Issues 提出，作者会尽快回复和改进；
• 再次强调：Copilot 桥接不影响「忠实窗口」形态——面板始终忠实呈现 DSH Web GUI，不对页面注入、改写或拦截任何东西，也不干涉你对 DSH 的插件开发与界面定制。

---

🔧 从源码安装（开发模式）

本扩展是纯 JavaScript，不需要 npm install、不需要编译：

bash
git clone https://github.com/Vithrive/Deepseek-Harness-for-VS-Code.git
code Deepseek-Harness-for-VS-Code

在 VS Code 中按 F5 打开扩展开发宿主窗口，在其中打开你的项目文件夹即可。自行打包安装：

bash
npx --yes @vscode/vsce package --allow-missing-repository
code --install-extension deepseek-harness-vscode-<版本>.vsix

前置条件与已知限制

• 前置条件：已安装 DeepSeek Harness（npm install -g @deepseek-ai/dsh 全局安装或 npx @deepseek-ai/dsh 均可，扩展自动识别两种方式，也可用 dshPanel.dshCommand 指定完整路径）；DSH 默认响应头未设置 X-Frame-Options / 严格 CSP，可被 iframe 正常内嵌。
• 已知限制：DSH 前端在 VS Code webview 多实例下退化为单例（普通浏览器多开正常，属 DSH 前端实现层面问题），因此标签页与侧边栏暂不能同时加载 DSH；扩展以「单活动视图」策略规避（打开标签页时侧边栏自动让位显示占位，关闭后自动恢复）。