dsh-expert-suite

使用指南

召唤与退出专家

• 召唤：/expert ，或面板点「召唤专家」；可带一句话 /expert 消息 立即开工。
• 退出：/expert-dismiss，或状态条上的 ✕。
• 召唤成功后面板自动收起，右上角状态条显示当前专家 / 团队，可一键退出。

团队协作：会话式（默认）与批量（显式）

会话式（默认）——/team 或面板「进入专家团」：注入团长契约，你和团长对话。打招呼、问团队能力就只是对话；有实际任务时团长先澄清目标、再用 team_dispatch 按需派工给成员（每次派工 = 一次 one-shot 子代理，等待交付后整合回复你），不会一上来跑全队。随时 team_status 看派工记录，team_end 结束并把各成员交付留档供总结。

批量（显式）——team_run 工具：给定自包含总目标，团长一次拆解、按执行模式跑完所有相关成员并整合总结。适合"现在就把整件事跑完"。

批量模式的执行模式（团队定义里的 executionMode）：

• serial：按 order 串行，后续成员能看到前序交付物；
• parallel：全部成员同一波次并行（受 maxParallelMembers 限制，默认 4），团长最后整合；
• auto：团长先做结构化规划（outputSchema 校验的波次计划），按波次执行；规划失败自动回退为按 order 串行并记入日志；
• interventionMode: step：每位成员（或每个并行波次）交付后暂停，用 team_message(action=continue) 放行。

成员的「连续性」由提示词承载（后续派工带上前序交付物全文），子代理会话不做跨派工驻留——这是 v1 的刻意取舍，换取只依赖宿主最稳定的 API 面。

权限与工具白名单

• 专家召唤：toolFilter 通过宿主 tools.guard()（单调拒绝，不可撤销）按 agent 生效；白名单外的工具调用被当场拒绝并说明原因。空白名单 = 不限制。
• 团队成员：每次派工都是一次 one-shot 子代理（ctx.subagents.start('spawn')），其 persona / toolFilter / maxDepth=1 在子代理创建窗口内落地，且不能继续向下委派。
• 团长：默认 leadToolFace: 'coordinator'——只协调不执行（拒绝 bash/pwsh/write/edit）；可在 Config 改为 full。
• 指定模型：专家定义里的 model 映射到子代理 agentOptions.model，需要宿主开启「子代理模型选择」opt-in，否则派工会报错——内置专家默认不指定模型（继承会话路由）。
• 跨平台工具名：toolFilter 里的工具名会按当前部署可见工具自动清洗（例如 Windows 上没有 bash、提供 pwsh），避免未知名导致 spawn 失败。

插件配置

在 cordis.yml 的插件行里配置：

- insert:
    - id: expert-suite
      name: 'dsh-expert-suite'
      config:
        dataDir: ''              # 缺省 $DSH_HOME/expert-suite
        layPresets: true         # 自动铺设两个预设
        maxParallelMembers: 4    # 波次内最大并行子代理数
        leadToolFace: 'coordinator'  # coordinator | full