dsh-workbuddy-expert

DSH WorkBuddy Expert

把 WorkBuddy 专家装进 DSH：专家市场一键导入 · 会话选择器随时切换

[English](README.en.md) · [功能](#功能) · [安装](#安装插件) · [设计文档](docs/design.md) · [MIT](LICENSE)

> DSH WorkBuddy Expert 是社区维护的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）插件，并非 DeepSeek AI 官方产品。

它是什么

一个 DSH Web 插件，让你把 [WorkBuddy](https://www.workbuddy.cn/) 专家中心的专家带进 DSH 工作流：

• 专家市场（设置 → WorkBuddy 专家）——只读扫描本地 WorkBuddy 专家目录，卡片浏览/搜索/分类，一键安装 / 更新 / 卸载，导出成标准专家文件夹；
• 会话选择器——输入框旁的专家胶囊，随时切换当前会话的专家：整组替换角色描述与 skills，保留全部会话历史，在下一个模型请求边界生效，不打断进行中的轮次；
• 完整专家体验——安装的专家自带角色描述、专属 skills 与头像，选择器列表即选即用。

专家来源

插件不联网下载专家——市场页读取的是 WorkBuddy 桌面端落盘的本地专家目录（默认 ~/.workbuddy/plugins/marketplaces/experts/plugins）。专家必须先在 WorkBuddy 的专家中心点击召唤，WorkBuddy 才会把该专家下载落盘，之后本插件才能扫描到它：

一个都没召唤过，市场页就是空列表——回专家中心召唤几个，卡片会自动出现。下文提到的"默认源目录"均指此路径。

功能

1. WorkBuddy 专家市场（设置 → WorkBuddy 专家）

• 只读扫描本地 WorkBuddy 专家目录（默认路径见「专家来源」），绝不写它，零数据外发；
• 卡片浏览/搜索/分类；操作按钮收在卡片右上角（未装 → 安装，已装 → 卸载/更新）；
• 安装 = 导出成标准专家文件夹到 ~/.dsh/experts//（expert.yml、清洗后 role.md、skills 整树，源卡有 PNG 时含头像），指纹清单落 .expert-source.json；
• 更新：源有变时卡片亮 updatable，更新 = 就地重导；卸载 = 删整个专家文件夹；

2. 会话选择器

• 输入框旁的专家胶囊展开带头像的专家列表，选中即切换；
• 切换保留全部会话历史：角色描述与 skills 整组替换，在下一个模型请求边界生效；轮次进行中则排队到边界后应用，不打断流式输出；
• 切换事务串行化：同一会话同时只允许一次切换；
• 一切注册落在 agent scope 层：只影响当前会话，会话结束自动清理；
• 创建新会话时也可先选专家，创建即生效——冷会话不存在"已选未生效"状态；
• 新增/删除专家无需重启——发现根有 watcher，选择器（输入框区域 + 创建会话入口）自动刷新。

3. 专家能力随会话生效

选中专家后，其能力即挂载到当前会话：

• 角色描述（role.md）作为 system prompt 角色段注入；
• 专属 skills（skills/ 整树）随专家注册/注销；
• 工具白名单（expert.yml tools.allow，可选）挂载作用域工具限制，切换时自动解除；
• 清单损坏的专家在选择器中列为 broken 并给出原因，不静默隐藏。

快速开始

前置条件：

• 宿主二选一：DeepSeek Harness 桌面端（Electron App）或终端 dsh web。两者使用不同的 profile（桌面端 desktop、CLI web），安装入口也不同——见下节，别装错边；
• 本机已安装 [WorkBuddy](https://www.workbuddy.cn/) 桌面端，且至少召唤过一个专家——机制与默认路径见[「专家来源」](#专家来源)；

安装插件

两种宿主用不同的 profile（桌面端 ~/.dsh/profiles/desktop，CLI ~/.dsh/profiles/web），互不相通，装错宿主读不到。桌面端的 desktop profile 由 Electron 独占——终端执行 dsh --profile desktop ... 会报 managed exclusively by the Electron application——所以桌面端用户不要照抄下面的 --profile web 命令。

桌面端（DeepSeek Harness App）——用应用内插件面板安装：

1. 打开侧栏插件（Plugins）面板，点添加插件（Add plugin）；

2. 输入插件 npm 包名 dsh-workbuddy-expert（即官方插件下载说明中"dsh plugin add 之后的部分"；也接受 Git 地址 github:pbwheel/dsh-workbuddy-expert、tarball 或本地 clone 的绝对路径）；

3. 安装完成后重启桌面 App（bundles 列表只在启动时读）。

终端（dsh web）——一行安装，npm 包名与 Git 地址均可（始终取最新版，无需手动 clone）：

dsh plugin --profile web add dsh-workbuddy-expert
# 或从 GitHub 安装：
dsh plugin --profile web add github:pbwheel/dsh-workbuddy-expert

或手动 clone 后从目录安装：

git clone --depth 1 https://github.com/pbwheel/dsh-workbuddy-expert.git
cd dsh-workbuddy-expert
dsh plugin --profile web add .
dsh --profile web --dump-config

两种方式都装主分支最新版；配置输出应出现 dsh-workbuddy-expert。然后重启 dsh web（bundles 列表只在启动时读）并强刷浏览器。零构建；运行时仅依赖宿主自己的 schema 工厂 @deepseek-ai/schemastery（精确固定）。

让 Agent 帮你安装

桌面端里，把这段话发给任意 Agent（它会走当前 profile 的应用内插件管理，无需终端）：

请把 DSH 插件 dsh-workbuddy-expert（来源 github:pbwheel/dsh-workbuddy-expert）安装到当前 profile，完成后告诉我如何重启生效并开始使用。

终端用户把这段发给能执行本机终端命令的 Agent：

请将 DSH 插件 dsh-workbuddy-expert 从本仓库安装到 web profile：git clone --depth 1 https://github.com/pbwheel/dsh-workbuddy-expert.git 后执行 dsh plugin --profile web add <目录>。安装后执行 dsh --profile web --dump-config，确认配置包含 dsh-workbuddy-expert，并告诉我如何重启 dsh web 和开始使用。

三步用上 WorkBuddy 专家

1. 打开设置 → WorkBuddy 专家（默认源路径见「专家来源」，可在顶栏修改）。列表为空？ 说明还没召唤过专家——见[「专家来源」](#专家来源)；

2. 在卡片上点安装——专家即导出到 ~/.dsh/experts/；

3. 回到会话，点输入框旁的专家胶囊，选择刚安装的专家，开始对话。

命令行也可以：/expert 列出全部专家，/expert 切换。

配置

| 配置项 | 默认值 | 作用 |

|---|---|---|

| sourcePath | ~/.workbuddy/plugins/marketplaces/experts/plugins | WorkBuddy 源目录；~ 使用时展开；允许保存暂不存在的路径（页面提示，路径就绪自动恢复） |

| roots | — | 可选追加发现根，必须显式 trust: user |