DeepSeek Harness (DSH) 插件介绍：`hu568/dsh-plugin-cluster-preset` 集群模式智能体编排预设

DSH 采用「一切皆插件」的理念。在开发复杂智能体工作流时，主控智能体往往需要自主编排子智能体。hu568/dsh-plugin-cluster-preset 是一个 DSH “集群模式” agent preset，它让主控智能体自主把工作分派给一组具名专家，并并行扇出、回收验证，同时引入了「智能体寿命论」阶段提示器。

核心能力¶

该预设包含以下核心组件：

5 个具名专家工具：explore（代码库检索）、librarian（外部参考检索）、oracle（只读高智顾问）、metis（规划前顾问）、momus（计划评审员）。
2 个通用委派工具：subagent（全新上下文）、subagent_fork（继承本会话）。
默认主动使用 Agent Teams：通过修改策略，将上游「必须由用户明确要求才建团队」的行为改为「默认主动建」，除非是单文件小改、纯问答或用户明确说「自己做」。
智能体寿命论阶段提示器：根据理论上下文占用折算年龄，在 20 岁、30 岁、40 岁、60 岁四个壮年阶段各提示一次，帮助智能体感知上下文压力。

安装与启用¶

本仓库是一个可分发的 DSH bundle，推荐使用官方插件管理器安装：

plugin_manager action=install_bundle target="github:hu568/dsh-plugin-cluster-preset"

桌面端用户可通过「设置 → 插件」或插件管理器 UI 添加该 spec。

注意：代码改动后需完全重启 DSH 才能生效（dsh-hmr 默认忽略 node_modules，且 Node ESM 会缓存已 import 的模块）。更新时必须 bump version，否则 DSH 会报 ambiguous-install 错误。

工作机制细节¶

1. 默认主动使用智能体团队¶

DSH 的 Agent Teams 默认策略要求用户明确说「开启智能体团队」才建立 teammate。本预设通过 cluster-preset/team-policy.js 将其改为「默认主动」，但保留了上游其余运行时约束（如共享工作目录、写作用域不重叠、任务板用法等）。

实现原理：在 DSH 中，预设 scope 是 agent scope 的父级，且段落合并遵循「越近越赢」原则。因此，在预设层通过 system-prompt/assemble 瀑布流来覆盖 agent 层的策略，而不是使用同名段落覆盖。这既覆盖了策略，又隔离了其他预设的影响。

2. 智能体寿命论阶段提示器¶

提示器将会话的理论上下文占用当成年龄，刻度为 1% 占用 = 1 岁。

20 岁（壮年 1/4）：轻量任务可以完成。提示将关键结论固化。
30 岁（壮年 2/4）：大部分任务都能完成。提示重新读细节，切小单元再委派。
40 岁（壮年 3/4）：降智明显。提示停止在同一思路加码，关键结论做独立复核。
60 岁（壮年 4/4）：只有少数复杂任务需要这么长的上下文。提示尽快收尾，别开新战线。

该提示器同时报告「理论寿命」（决定智力）与「真实寿命」（决定生命）。如果两者错位，例如真实寿命已尽而理论年龄尚轻，提示器会明确指出。

3. 叶子约束（防止无限委派）¶

每个专家都是叶子，不能再往下委派。这由两道防线保证：

maxDepth: 1：子智能体运行时校验深度。编排者深度为 0，创建的子体深度为 1；专家深度为 1，若再委派则子体深度为 2，被拒绝。
toolFilter：通过 deny 移除了所有委派工具和写工具。专家只保留 read、grep 等常规工具。

注意：通用委派行不能设 modelSelectionSettings: true。因为 subagent 工具的注册机制特殊（挂载时不在祖先层），若设该标志，deny 列表中的名字（如 subagent）会在子体创建前报错，且专家仍会持有该工具，导致「叶子」承诺失效。

注意事项¶

相对路径依赖：插件使用相对路径（如 ./cluster-preset/lifecycle-reminder.js），安装时必须确保这些文件存在于对应的子目录中，否则会导入失败。
package.json 要求：相对路径插件所在的目录必须包含一个 package.json，且 name 与 version 字段均非空。否则 DSH 会向上回溯到 profile 的清单，而 profile 清单通常只有 name 没有 version，导致挂载失败。
非法值处理：配置中的非法值会导致挂载失败并报错（fail-loud），不会静默忽略。

总结¶

hu568/dsh-plugin-cluster-preset 提供了一套完整的主控智能体编排方案，通过具名专家、默认启用 Agent Teams 和寿命论提示，帮助智能体更高效、可控地处理复杂任务。在部署时，需注意代码修改后的重启流程及相对路径文件的完整性。