michengai/dsh-agency-agents站内显示名「专家智能体库」是一个 DSH Web 插件——README 写明它是社区维护产品并非 DeepSeek AI 官方出品。上一篇讲怎么用这篇拆开看机制它怎么被宿主接进去、专家目录怎么加载、设置页的写入靠什么保证一致。要先对齐同类插件的整体盘子可以先翻一遍 完整插件清单与汉化避坑指南把边界摸清楚再回来看机制细节。package.json 里的三个钩子bundle.patch 是接入的入口dsh plugin --profile web add .会同时读 package metadata 与cordis.patch.yml。「直接拷lib目录」之所以不成立就因为宿主拿不到 patch接不进 Cordis 的插件图。client.inject 是加载顺序五个条目依次是连接层、本地化、api-remotes、设置 UI、输入框触发器——按钮要挂在已就绪的槽位上本地化要在渲染前可用调整数组次序等于调整浏览器侧的初始化时序。两条排障规则缺失的图条目会被跳过冻结的模块不必在 profile 里真实存在禁用auto-install-peers的 profile 可能报 unmet peers该查的是宿主版本与浏览器模块可用性。设置控件自带 UI 依赖但保留 peer 契约设置控件把 Ant Design 打进插件包、不再注入宿主原语——包体积变大换取设置页不再依赖宿主暴露的 UI 原语但dsh-client-ui-slots这类必需 peer 仍要拿到槽位才能挂载运行时契约没取消。支持宿主是一串明确列举的白名单0.1.2-rc.1、0.1.5-rc.1/rc.2/rc.3、0.1.7-rc.1/rc.2、0.2.0-rc.1/rc.2、0.2.1-alpha.2更早的 alpha0.1.6 / 0.1.7不受支持未来宿主版本需单独验证。专家目录怎么加载Key默认用途root内置专家资产外部专家根目录显式值优先providerspawn子代理 providerfork也可但需支持 persona 与工具过滤divisions22 个标准分部要扫描的顶级分部maxDepth未设置子代理深度的正绝对值上限root 与 AGENCY_AGENTS_ROOT 的语义AGENCY_AGENTS_ROOT指向外部目录时该目录里的 persona 正文会作为子进程的系统提示注入所以只能从可信来源加载另外外部 root 会替换基础名册自定义专家则是追加的——分不清就会以为「加了自己的目录内置专家反而少了一批」。四个源码入口的职责src/index.ts宿主入口目录加载、工具注册与设置从这里进。src/remote-contract.ts与src/remote.ts契约与实现分开README 讲「写入带 revision」时指向的就是契约文件。src/client/index.ts设置页、输入框按钮与触发设置页必须靠挂载的 Remote 服务因为它是契约调用。assets/agency-agents内置人格与许可署名LICENSE 与 NOTICE 必须保留——代码 Apache-2.0personas保持 MIT。revision写入的一致性保证「写入带 revision」落到行为上并发修改会拒绝过期保存并把草稿留在编辑器里处理路径是比对最新内容、保留草稿或载入该内容、然后显式保存。自定义专家存在DSH 设置的agency-agents命名空间、位置在插件目录之外所以升级会保留但降级前必须先备份——恢复数据与回滚代码是两件独立的事。删除不可撤销上限 200 个。改了源码就必须先 pnpm buildGitHub 与 npm 里带的是已构建的lib改了src或assets后必须先pnpm build再提交否则源码安装会一直用旧运行时。输出里应出现agency-agents与agency-agents-remote之后重启 DSH Web 并硬刷新浏览器。浏览器回归用pnpm test:browser默认端口18769但组件测试不取代真机 / 模型委派验收浏览器测试打的是源码包不是已发布的lib/client.js。三个容易写歪的口径版本npm latest 是1.0.18站内快照停在1.0.11已滞后安装命令写latest或add .别写死小版本。安全扫描静态扫描标记为「含敏感能力」共11 处证据尚无人工评估——所以不能对外断言它的安全性已经确认过。专家数量站内与包描述、README 开头标注321名README 名册章节写331bundled experts across22 divisionsFeatures段又回到 321——同一份 README 内两个数字并存别引死一个。总结机制并不复杂bundle.patch负责接进宿主client.inject负责浏览器侧时序专家目录由root与divisions决定加载范围完整插件清单与汉化避坑指南 里还有同类插件的对照但真正决定你踩不踩坑的是记住「改了src要先pnpm build」这类小事。适合与不适合适合准备从源码二次开发、需要先弄清 Remote 契约与目录加载顺序的人遇到 peer 报错但拿不准是依赖问题还是宿主问题的排障场景要把内置 personas 二次分发、必须搞清双许可边界的团队。不适合只想装上就用、不打算读源码的用户——机制细节对你几乎没有收益宿主版本不在白名单的人尤其还在 0.1.6 / 0.1.7 alpha 上的安装机制再清楚也装不起来指望换provider解决一切的人fork需要该 provider 支持 persona 与工具过滤不满足时换过去 persona 会直接失效。标签专家智能体库、DeepSeek Harness、插件机制、Remote 契约、源码二次开发本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。