会话级专家选择器 me9rez/dsh-workbuddy-experts

dsh-workbuddy-experts

在 DeepSeek Harness（dsh）中复用 WorkBuddy 专家市场。每个会话在输入框旁边都会有一个 专家 选择器；选择一个专家后，该专家的「人设（persona）」会被注入到会话的系统提示中（合并模式——dsh 工具链保持不变），且 无需为每个专家维护单独的预设。选择状态按会话持久化，刷新和完整重启后依然保留。

本项目改编自可用的 dsh-agent-teams 插件结构（host + client 打包），并遵循 DeepSeek Harness 插件契约（dsh.bundle.patch + dsh.client）。

工作原理

| WorkBuddy 专家概念 | dsh 中的等价实现（本插件） |
| plugin.json 清单 + agents/.md 人设 | 扫描进内存的 ExpertEntry 目录（仅 agent） |
| 在会话开始时注入人设 | 全局一段 expert:persona，text 为函数：每步按 context.agent.id 读内存表返回该会话所选专家的人设（order 0，非 complete，保留 harness 身份 + 全部 dsh 工具） |
| 「切换专家」 | 更新内存人设表 + 技能 provider invalidate() → 下一次模型调用步骤生效（dsh 每个步骤都重新组装 system prompt） |
| 按会话状态在重启后保留 | SelectionStore ↔ ~/.dsh-workbuddy-experts.json，以会话 id 为键；启动时预填人设表 + 刷技能目录 |
| 技能（该专家的 skills/） | 全局 scope 门控 provider：list(options.scope) → 会话 → 所选专家 → 只返回其技能（按会话隔离，见 ） |
| Web GUI 开关 | ExpertSelect 注入 conversation.input.right，通过 /plugins/dsh-workbuddy-experts/ HTTP 路由与 host 通信 |

范围（v1）：仅支持独立专家（expertType: "agent"）。团队（teams）和连接器（connectors）会被忽略。

更多文档

- docs/architecture.md — 最终架构
- docs/layout-debug.md — UI 布局/交互排查记录（下拉定位、input 槽位、portal 外点关闭）
- docs/debug-persona-skills.md — 人设/技能"跟随切换"排障记录

目录结构

src/
├── index.ts host 入口：配置/注入/应用 + 接线 ├── catalog.ts 纯逻辑：扫描市场、解析清单、规范化人设 ├── persona.ts 按 agent 的 systemPrompt.section 注入 ├── state.ts 纯逻辑：按会话的选择持久化 └── client/ ├── index.tsx client 入口：插槽注入 ├── ExpertSelect.tsx ├── ExpertSelect.module.css └── service.ts host HTTP 客户端 cordis.patch.yml 将插件挂载进某个 profile 的 host 组合 scripts/verify.mjs 纯逻辑的离线冒烟测试

构建

要求：一份 DeepSeek Harness 源码检出，其 lib 构建产物为最新，以便 @deepseek-ai/* 对等类型可被解析。按照 dsh-agent-teams 开发指南，将你导入的包链接进 node_modules：

npm i # 或 pnpm install（devDependencies：typescript@^5.9、tsdown@0.22、lightningcss、react）
pnpm typecheck # 两个 tsc 程序：host（src）+ client（src/client）
pnpm build # tsc host → tsc client → tsdown（lib/client.js CJS 闭包工厂）
pnpm verify # 离线冒烟测试（纯逻辑，无需 dsh 运行时）

开发期的类型链接针对的是 DSH 源码检出的构建产物（packages//lib/types），而不是已安装的 staging 副本。如果没有 DSH 源码检出，你将无法对 client 包进行类型检查/构建。

安装到 profile 后重启

dsh plugin add 底层用 pnpm 安装，因此可以直接从 GitHub 仓库安装：

从 GitHub 仓库安装（pnpm 会解析 github: 说明符）
dsh plugin --profile add github:me9rez/dsh-workbuddy-experts

或指定分支：github:me9rez/dsh-workbuddy-experts#master 重启 dsh（web 或 headless）—— 新会话会显示专家选择器

本地开发/离线场景也可用本地路径：dsh plugin --profile add /absolute/path/to/dsh-workbuddy-experts。

配置（cordis.patch.yml）

| 键 | 默认值 | 含义 |
| root | ~/.workbuddy/plugins/marketplaces/experts/plugins | WorkBuddy 专家市场所在的路径 |
| stateFile | ~/.dsh-workbuddy-experts.json | 用于按会话保存选择状态的绝对/~ 文件（跨重启持久化） |
| logFile | ~/.dsh-workbuddy-experts.log | 插件自身诊断日志文件（追加写，含选择/注入/技能挂载/agent/created 重放等 [workbuddy-experts] 记录） |
| maxPersonaBytes | 65536 | 人设超过该大小会被带标记地截断 |
| personaOrder | 0 | deployment:persona 插槽的 order |

已验证内容

- ✅ pnpm build 构建通过（tsc host + tsc client + tsdown client bundle）； lib/client.js 为正确的 window.__ModuleLoader__.load(...) 形态。
- ✅ 离线：市场扫描（仅 agent 过滤、清单/agenda 解析、人设 + 技能目录发现）、人设规范化（去除 frontmatter、${CODEBUDDY_PLUGIN_ROOT} 展开、未知变量标记）、选择持久化的往返测试（scripts/verify.mjs，node scripts/verify.mjs）。
- ✅ 面向真实市场：扫描 ...\experts\plugins → 找到 5 个独立专家（aihot、fbsir-super-partner、meituan-living-assistant、 remotion-video-generator、senior-developer）；团队/不可读目录被排除。
- ✅ 已在 dsh web 实跑验证：选中专家后，会话的 system prompt 人设 与技能 均跟随切换动态更新；未选专家会话看不到他人技能（按会话隔离）。

已知边界（v1）

- 仅单专家：expertType === "agent"；专家团（team）与连接器（connectors）本期忽略。
- 人设合并注入，不 complete 接管：用一个全局段 expert:persona（order 0， text 为函数、每步按会话读内存表返回），非完整覆盖 → 保留 harness 身份与全部
dsh 工具；切换专家下一步即生效。
- 技能按会话隔离：全局 scope 门控 provider，list(options.scope) → 会话 → 所选专家 → 只返回其技能；providerControl.invalidate() 刷缓存。选中专家的技能进入该会话，其它会话不可见。
- 会话 id 作为持久化键：~/.dsh-workbuddy-experts.json，重启间会话 id 稳定。
- 输入框插槽 conversation.input.right（EXPERT_SLOT 常量，输入卡内侧右侧，紧挨模型座）；不同 profile 暴露的输入座位需自行调整。

完整设计见 docs/architecture.md。
人设/技能与 UI 的排障记录见 docs/debug-persona-skills.md、docs/layout-debug.md。