deepseek-harness-for-vs-code

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。

版本适配：本扩展 v0.8.34 起适配 dsh v0.1.2-rc.1 及以上版本——自动完成该版本起新增的 Web 浏览器认证（扩展受管认证代理，面板与 Copilot 桥接全程免登录、免打扰，详见下文「dsh web 浏览器认证」）；同时向下兼容未启用认证的旧版 dsh（启动参数探测、RPC 端点新旧格式自动回退）。

🙏 致谢

• Pelapis——贡献 macOS 面板剪贴板快捷键修复并迭代收敛作用域（内置插件 dsh-webview-clipboard，PR #11、#14）。
• curtainsmall——修复面板 iframe 非整数倍缩放的整页模糊（改用 CSS zoom，PR #10）。
• anupamme——报告工作区设置注入面，推动子进程调用安全加固（PR #12）。

🚀 快速安装

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

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

  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 等比缩放（CSS zoom 实现，非整数倍缩放同样清晰）；
• 发送选中内容 / 拖放文件到 DSH 对话框（自动安装配套插件 dsh-drop-caret）：把文件、文件夹、代码段以 路径:行号 引用精确插入对话框光标处——从 VS Code 资源管理器拖拽直接引用源文件本身（不产生副本）；从系统文件管理器拖入时浏览器无法取得真实路径，此时才回退为工作区 .dsh-drop/ 下的内容快照。点击 DSH 对话中的外链在系统浏览器打开（配合 DSH 插件 dsh-open-links）。
• macOS 剪贴板快捷键修复（自动安装配套插件 dsh-webview-clipboard）：修复 macOS 上面板内 ⌘C/⌘V/⌘X 失效的问题——DSH 页面以跨源 iframe 内嵌于 webview 时，浏览器的原生剪贴板默认动作不会发生。插件注入 DSH 页面后拦截这三个键并经 execCommand 显式执行。仅 macOS + 被内嵌时启用，其余环境行为不变。

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

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

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

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

   

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

   

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

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

面板相关配置

dsh web 浏览器认证（v0.8.35 起，自动完成，无需任何操作）

dsh 0.1.2-rc 起为 Web GUI 启用了浏览器认证：每次 dsh web 启动会生成一个一次性「进程启动令牌」并打印形如 dsh web: http://127.0.0.1:3080/?token=… 的认证链接，浏览器打开该链接后换取签名 Cookie，此后凭 Cookie 访问；裸地址一律返回 401。同时 /api 还有浏览器信任围栏（Host 必须回环、Origin 与 Host 一致、拒绝跨站请求）。

扩展的处理方式（不关闭 dsh 的任何安全机制，全程无感）：

• 由扩展启动 dsh 时，自动捕获其 stdout 打印的认证链接，并在本机 127.0.0.1 随机端口启动一个受管认证代理：由代理完成令牌 → Cookie 换发，之后给每个转发请求（页面、API、WebSocket）注入凭据，面板与 Copilot 桥接全部改走代理；
• 令牌会缓存到 VS Code 全局状态：其他窗口 / 重载 VS Code 后，只要 dsh 实例没变，依然静默认证；
• 启动 dsh 时默认附加 --no-open，不再弹出系统浏览器（需要旧行为时打开 dshPanel.openSystemBrowser）；
• 如果 dsh 是在本扩展之外启动的（拿不到它的令牌），首次打开面板会提示一次，二选一：「重启并自动认证（推荐）」由扩展接管 dsh，此后恢复完全静默；或把终端里 dsh web: 打印的认证链接整行粘贴进来；
• 「在浏览器中打开」按钮会自动携带当前令牌，系统浏览器可正常换取自己的 Cookie；
• Remote / 非回环地址场景不启用代理（认证须在 dsh 所在机器的浏览器完成一次），行为与旧版一致。

对旧版本 dsh 的兼容（无认证版本）

扩展对未启用 web 认证的旧版 dsh 保持完整兼容，回退路径全部自动、无感：

• 启动参数：--no-open 先经 dsh web --help 探测，老版本不支持就不传（不会因未知参数导致启动失败）；
• 认证链路：面板加载前会探测首页状态——旧版返回 200（无认证）即走原直连路径，不启用代理注入；「重启并自动认证」等引导也只在探测到 401 时出现；
• RPC 端点：扩展按新版斜杠端点（workspace/create 等）请求，收到 404 自动回退旧点号端点（workspace.create）；session/page 不可用时回退 session.history；
• 完全启动等待：以「dsh web: 打印行」为就绪信号（新旧版本都会打印）；个别从不打印的极老版本会被记忆（dsh.quietBoot），之后不再等待。

远程服务器（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 侧时间线保持完整。

常用命令

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

桥接相关配置

🧩 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、不需要编译：

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

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

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；扩展以「单活动视图」策略规避（打开标签页时侧边栏自动让位显示占位，关闭后自动恢复）。