YichuAI/deepseek-harness-vscode

DeepSeek Harness Connector for VS Code (v0.0.4)

VS Code Marketplace
Version

DeepSeek Harness 的原生 VS Code 客户端。

连接你已在本地运行的 Harness 实例，直接在 VS Code 中继续相同的工作区和会话。

同一个 Harness。同一个工作区。同一个会话。VS Code 客户端。

这不是 Cursor 的替代品，不是 Claude Code 的替代品，也不是完整的编码 Agent。它将 VS Code 连接到你已在运行的本地 dsh web 实例：

浏览器 ─────┐
│
▼
DeepSeek Harness
▲
│
VS Code ─────┘

VS Code 读取浏览器中已有的工作区和会话，并继续同一个会话——所以浏览器刷新该会话时能看到 VS Code 发送的内容。

v0.0.3 新特性

Diff 审查、审批工作流 & 文件内容内联 —— 补齐与 Cursor/Cline 最大的体验差距：代码变更可以在 VS Code 内完成审查和审批，无需切换到 Web UI。

- Diff 审查与内联代码应用 —— Agent 写入或编辑文件时，侧边栏自动出现审查卡片，展示每个变更文件的 +新增/-删除 行数。点击 Diff 打开 VS Code 原生 diff 编辑器。支持逐文件 Accept（保留）/ Reject（通过 git checkout 安全回退），也可批量操作。
- 审批工作流集成 —— approval/requested 事件现在以内联卡片形式展示，带 Allow once / Deny 按钮。不再需要切浏览器审批。安全允许列表限制哪些工具可以在 VS Code 内审批，高风险操作仍需 Web UI。
- @file 内容内联 —— 文件引用（@file:path 或 @file:path:L10-L20）的内容现在被直接读取并内联到用户消息中，确保 agent 始终能看到文件内容。context 元数据（活动文件、选区）仅在会话首次发送时附带。
- 右键菜单集成 —— 在资源管理器中右键文件 → Add to Harness Chat。在编辑器中选中文本 → 右键 → Send Selection to Harness。均使用工作区相对路径。

详见 CHANGELOG.zh-CN.md。

历史版本

- v0.0.2 —— 对话 UX & 架构基线版：Assistant Markdown 渲染、Tool 卡片合并、System 消息折叠、惰性创建 workspace/session、流式渲染修复、架构加固。
- v0.0.1 —— 首个公开版本：验证 VS Code 与浏览器共享同一个 Harness 会话。

v0.0.3 做什么

- 连接到本地 dsh web（仅限回环地址——127.0.0.1 / localhost）。
- 将当前 VS Code 文件夹匹配到 Harness 工作区。若无匹配，工作区在首次发送时惰性创建——无弹窗。
- 列出该工作区已有的会话。
- 打开会话并渲染其历史记录。
- 向该会话发送纯文本提示。若无会话，自动创建。
- 实时流式传输助手回复，支持 Markdown 渲染（代码块、列表、表格、链接）。
- 将工具调用显示为折叠卡片，带语义化标题（Read src/foo.ts、Search "pattern"、Run npm test）。
- 审查 Agent 代码变更 —— diff 卡片支持逐文件 Accept/Reject，原生 VS Code diff 编辑器，批量 Accept All / Reject All。
- 审批或拒绝 Agent 操作 —— 内联审批卡片，Allow once / Deny 按钮（安全允许列表强制执行）。
- 附加文件上下文 —— 在提示中使用 @file:path 或 @file:path:L10-L20，文件内容自动读取并内联。右键资源管理器或编辑器可快速插入。
- 默认隐藏插件注入的系统消息；通过 SYS 按钮切换。
- 停止当前回合。
- 断线时重新打开流并重新获取历史记录。
- "在 Harness Web UI 中打开"命令。
- 通过 ⇲ 按钮将视图停靠在右侧边栏（像聊天面板一样）。

v0.0.3 刻意不做的事

为安全起见，以下仍不在范围内：

- 不调用 commands/execute，不访问 credentials 或 settings API。
- 不切换模型。
- 不做内联补全、终端/LSP 集成。
- 高风险审批（如带不可信输入的 bash）不能在 VS Code 内批准——卡片显示"Review in Web UI"。
- 不建立第二份会话数据库——Harness Session 是唯一的真相源。
- 不自动安装/启动/升级 dsh。
- 不 fork 或修改 Harness 源码。

环境要求

- VS Code ≥ 1.85
- 正在运行的本地 dsh web（默认端口 3080）。本扩展不会为你启动它。

快速开始

1. 在本地启动 Harness：

dsh web
→ http://127.0.0.1:3080/?token=

Harness ≥ 0.1.6 会打印一个带一次性 token 的启动 URL。复制它。

2. 从 VS Code Marketplace 安装，或通过命令行：

code --install-extension lucasliang.harness-connector-deepseek

或从 GitHub Releases 安装 VSIX：

code --install-extension harness-connector-deepseek-0.0.4.vsix

3. 把浏览器会话交给扩展。 在命令面板执行 DeepSeek Harness: Set Session Token from Launch URL，粘贴启动 URL（或裸 token）。扩展会用它换取 dsh-auth-… cookie，并存入 VS Code 的 secret storage（系统钥匙串，不会写入 settings.json）。

Harness ≥ 0.1.6 对所有 /api/* 强制校验该 cookie，因此这一步是必需的。跳过的话 Connect 会报"requires a browser session"，而不是一个光秃秃的 401。

4. 在 VS Code 中打开一个你想绑定到 Harness 工作区的文件夹。

5. DeepSeek Harness 活动栏图标出现；扩展自动连接。如果你的文件夹匹配到一个已有的 Harness 工作区，其会话会出现在下拉列表中。选择一个，继续对话。

6. 没有匹配的工作区？ 直接输入提示按 Send——工作区和会话会自动创建。

7. 附加文件上下文 —— 输入 @file:src/main.ts，或在资源管理器中右键文件选择 Add to Harness Chat。在编辑器中选中文本，右键选择 Send Selection to Harness 可插入带行范围的引用。

8. 在浏览器中打开 http://127.0.0.1:3080/ 的同一会话——两端看到的是同一轮对话。

需要每次都重填吗？

不用——重启不需要。启动 URL 里的 token 确实随 dsh web 进程消亡，但它换来的
cookie 是用持久化在 $DSH_HOME/.credentials.yaml 里的密钥签名的，默认有效期 30 天。
扩展保存的就是这个 cookie，所以 dsh web 可以随便重启。

只有这几种情况才需要重新执行：

| 情况 | 原因 |
| --- | --- |
| cookie 超过 30 天有效期 | expiresAt 写在被签名的 cookie 载荷里 |
| 你改了 deepseekHarness.port（或 host） | cookie 名是 dsh-auth-，绑定签发时的 authority |
| $DSH_HOME/.credentials.yaml 被删或重新生成 | 签名密钥没了，现存 cookie 全部校验失败 |

万一真过期了，扩展会明确告诉你该跑哪条命令，而不是只抛一个 401。

配置

| 设置项 | 默认值 | 说明 |
| --- | --- | --- |
| deepseekHarness.host | 127.0.0.1 | v0.0.x 仅允许 127.0.0.1 或 localhost。 其他值会被拒绝。 |
| deepseekHarness.port | 3080 | 默认 dsh web 端口。如果你用 dsh web --port  启动则需修改。 |
| deepseekHarness.showSystemMessages | false | 显示插件注入的系统消息（运行时上下文、审批通知）。默认隐藏；可通过 webview 头部的 SYS 按钮实时切换。 |

命令

- DeepSeek Harness: Connect / Disconnect（连接 / 断开）
- DeepSeek Harness: Set Session Token from Launch URL（从启动 URL 设置会话 token）——粘贴 dsh web 启动 URL 以获取浏览器会话 cookie
- DeepSeek Harness: Clear Session Token（清除会话 token）——删除已存储的 cookie（例如切换 dsh web 实例前）
- DeepSeek Harness: New Session（在当前工作区新建会话）
- DeepSeek Harness: Refresh Sessions（刷新会话列表）
- DeepSeek Harness: Move to Right Side Bar（移至右侧边栏）——将视图停靠在辅助侧边栏（像聊天面板一样），不再与文件浏览器争抢左侧空间。也可通过 webview 头部的 ⇲ 按钮触发。
- DeepSeek Harness: Toggle Plan Mode（切换计划模式）——翻转当前会话的 /plan
- DeepSeek Harness: Set Permission Preset（设置权限预设）——选择或输入预设名，如 read-only / workspace-write / danger-full-access
- DeepSeek Harness: Compact Session Context（压缩会话上下文）——请求 /compact
- DeepSeek Harness: Fork Session（分叉会话）——从当前会话分叉并切到新会话
- DeepSeek Harness: Rename Session（重命名会话）——固定标题（之后不再自动生成）
- DeepSeek Harness: Archive Session（归档会话）——从当前工作区列表归档
- DeepSeek Harness: Open Web UI（打开 Web UI）
- DeepSeek Harness: Show Logs（显示日志，即 DeepSeek Harness 输出通道）

这六个控制项同时也在侧边栏的 Controls（控制） 面板里，面板还会显示 host
下发的状态：计划模式、沙箱模式、审批策略、agent 预设、当前生效模型、待办列表、
当前目标、子代理活动和最近一次压缩摘要。

每个控制项都只在这台 host 真的提供它时才出现 —— 能力探测在连接时完成，
所以面对较旧的 dsh web，面板只会少显示几个旋钮，而不是给你点不动的按钮。

右键菜单操作

- Add to Harness Chat（资源管理器右键）—— 将 @file: 插入聊天输入框。
- Send Selection to Harness（编辑器右键，需选中文本）—— 将 @file::L-L 插入聊天输入框。

架构

见 ARCHITECTURE.zh-CN.md 了解一页式设计和协议契约。

协议固件

test/fixtures/ 存放了线缆格式的脱敏快照，用于检测上游 Harness 协议漂移：

- host-describe.json、workspace-list.json、session-list.json、session-history.json、session-prompt.json、session-event.json —— 注意： 这些是 0.1.6 之前的快照，仅作为历史漂移参考保留。host-describe / session-history / workspace-list 在上游已不存在。

不存储任何凭据、API 密钥或真实提示内容——仅保留 JSON 结构（文本字段已脱敏）。

协议测试

一个独立的 Node 脚本用真实客户端代码驱动一个假的 0.1.6 harness —— 不需要 dsh web：

npm run protocol-test    # 98 项断言：线缆协商（点分/斜杠、cookie 门禁、
事件套接字）、认证、cookie 派生、{args} payload、
审批瀑布、assistant 流、已移除端点的 404 处理、
控制面能力探测与全量值状态折叠

想让真实的 dsh web 自己报出它提供了什么（端点风格、事件套接字，以及
29 个候选方法里哪些存在）：

npm run protocol-probe            # 默认 127.0.0.1:3080
npm run protocol-probe 127.0.0.1 3080

要对真实 dsh web 做闭环验证，用集成测试（需先启动 dsh web）：

DSH_LAUNCH_URL='http://127.0.0.1:3080/?token=' npm run integration-test

开发

npm install
npm run build        # esbuild → dist/extension.js
npm run watch        # 变更时自动重建
npm run typecheck
npm run package      # → harness-connector-deepseek-0.0.4.vsix
npm run protocol-test      # 针对假 harness 的 98 项协议断言
npm run protocol-probe     # 报告真实 dsh web 暴露了什么

在 VS Code 中按 F5 启动带有该扩展的扩展开发宿主。

已验证版本

- 默认 dsh web 端口 3080，且 host 必须位于回环地址。
- 线缆是协商出来的，不是猜出来的。 端点风格（session/list 还是 session.list）、
是否需要 cookie、事件套接字是 /api/remote.mux 还是 /api/events.mux——都在连接时
自动探测，同一个构建因此能跨 host 版本工作。跑 npm run protocol-probe 可以看到
你的 host 到底提供了什么。

限制

- 仅限回环——不支持远程 / 局域网 / WSL 桥接的主机。
- 仅支持文本提示（不支持图片附件）。
- 历史记录加载最近约 50 条消息；"加载更早"是未来版本的计划。
- "Open Web UI" 中的会话深链接不做猜测——只打开 Harness 首页。
- 未知的 harness 事件类型会被忽略（协议是可合并扩展的）；它们不会导致客户端崩溃，但也不会渲染。
- Diff 审查的 Reject 使用 git checkout 回退——目标文件上未提交的本地修改会在 Reject 时丢失。

路线图（v0.0.7+）

- 由 session/selectModel 与 llm/models 驱动的模型 / 推理强度选择器
- 子代理控制（subagent/interrupt、排队消息转向）
- 历史分页「加载更早」
- 内联补全（Inline Completion）
- VS Code 文件系统提供器
- 终端集成
- LSP / ACP 集成
- 图片附件

许可证

MIT