前言¶
DeepSeek Harness（DSH）和社区里的 WorkBuddy 各自都能跑智能体：会话、记忆、技能往往各管各的。你在 dsh 里想查 WorkBuddy 记了什么、派活给它、或在同一控制台里跟它对线，通常得切窗口、对文件、或自己写胶水。维护者 YE-ZINAN 的 dsh-wb（GitHub：YE-ZINAN/dsh-wb，SkillHub 分类：工作流）用一个插件把两边接上：记忆与技能同步、无界面遥控、通过 CDP 驱动真实界面，以及在 dsh 里嵌入 WB 对话面板。当前实现面向 Windows，需同时安装 dsh 桌面版与 WorkBuddy 桌面版。
这是什么¶
一句话：装了 dsh-wb，在 dsh 里可以查看 WorkBuddy 的记忆与技能、把任务交给本机执行引擎、在 dsh 侧对话，以及通过 CDP 在 WorkBuddy 真实界面里操作（对话留在 WorkBuddy，走其账号额度）。
插件规模（README 与 package.json）：25 个工具、15 条 HTTP 路由、1 个对话面板；四个逻辑模块合成一个包。许可证 MIT，发布版本 v1.0.0（npm 包名 dsh-wb）。Node 引擎要求 >=20。
核心功能¶
下面四块能力在 README 中有明确对应，路径互不绑死：
| 能力 | 说明 |
|---|---|
| 记忆 / 技能可见 | 列出、搜索、读取 WorkBuddy 侧记忆、技能、计划（模块 sync，直接读写文件） |
| 无界面遥控 | 任务交给 WorkBuddy 本机执行引擎，完成后取回结果（模块 bridge，另起命令行进程） |
| dsh 内对话 | 左栏 WB 图标打开「WB 对话」面板：选会话、看内容、切模型（模块 chat） |
| 界面驱动（CDP） | 在 WorkBuddy 真实界面里切换历史、输入发送；非另起隐藏进程冒充（模块 gui，CDP 调试端口） |
「WB 界面」传输方式下，你在 dsh 面板里发的内容会出现在 WorkBuddy 窗口里，便于旁观执行过程。若只需后台执行、不碰界面，可将「传输方式」改为 无界面。
安装与启用¶
在 dsh 插件管理里任选一种方式（命令与地址均来自官方 README）：
从 release 地址安装（推荐）：
https://github.com/YE-ZINAN/dsh-wb/releases/download/v1.0.0/dsh-wb-1.0.0.tgz
在插件管理中使用「从地址安装」粘贴上述 URL；dsh 会按 npm 包方式拉依赖。
从 GitHub 仓库安装：
github:YE-ZINAN/dsh-wb
本地文件夹： 下载仓库后在插件管理中选择该文件夹。
安装完成后 刷新 dsh 页面（F5），左栏应出现 WB 图标。README 说明 npm 包名 dsh-wb 已确认可用，公开发布需维护者自行 npm login 后 npm publish；与上述三种安装方式并列，不以臆测命令替代原文。
典型用法¶
第一次使用可按 README 顺序操作：
- 点击左栏 WB 图标，打开对话面板。
- 顶部「传输方式」保持 WB 界面（对话出现在 WorkBuddy 里）；若只要后台跑任务，改为 无界面。
- 「会话」下拉选择一段历史 —— 插件会在 WorkBuddy 中切换对应会话，面板同步显示该段历史。
- 在下方输入框输入内容并回车发送。
若面板提示 「CDP 未连」：说明 WorkBuddy 未开调试端口。可点面板 「启动/重连 WB」（会重启 WorkBuddy 并带上端口，会话已落盘不丢）；或把开始菜单快捷方式启动参数改为：
--remote-debugging-port=9223 --disable-backgrounding-occluded-windows --disable-renderer-backgrounding --disable-background-timer-throttling --disable-features=CalculateNativeWinOcclusion
WorkBuddy 最小化时界面不重绘，与 Chromium 行为有关；上述参数后半段用于缓解该问题。
工作原理（简图）¶
flowchart LR
subgraph DSH["dsh · 控制台"]
P["WB 对话面板"]
T["25 个工具"]
end
subgraph WB["WorkBuddy"]
UI["界面"]
E["执行引擎"]
M["记忆 / 技能"]
end
P --> UI
T --> UI
T --> E
T --> M
- chat / 面板：经宿主 HTTP 路由读写界面内容。
- gui：CDP 在真实界面点击、输入、发送。
- bridge：headless 进程执行任务。
- sync：文件级同步记忆与技能清单。
适用场景与注意¶
适合： 已在 Windows 上同时使用 dsh 与 WorkBuddy，希望在一个控制台里对齐记忆技能、派活、对话，并可选「看着 WorkBuddy 界面被操作」的开发者。
环境与权限： 插件随 当前 dsh 进程权限 运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合本机安全策略。
安全（README 原文要点）：
- CDP 调试端口开启时，本机任意程序 可完全控制 WorkBuddy（读会话、代发消息）。端口绑定 127.0.0.1，局域网与手机无法直连，但本机无额外门槛。
- 不需长期暴露端口时，关闭 WorkBuddy 或下次不带调试参数启动即可。
- 插件 不读取、不转发 你在引擎配置中的 API key；界面模式抓取的文字仅本机流转。
- 不删、不改 WorkBuddy 原数据；同步向指定日志 追加，写前备份（
.bak-dshsync），身份类信息不自动写入。
数据与社区： DSH 生态是「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。本文事实来源为 GitHub 仓库 README 与 package.json。
结尾¶
dsh-wb 把 WorkBuddy 的记忆、执行、界面与 dsh 的工具和面板叠在同一工作流里，减少双开与手工对文件。进一步了解架构与四模块细节可见仓库内 docs/architecture.md 及 docs/sync.md、docs/bridge.md、docs/chat.md、docs/gui.md。
