dsh-orchestrator

使用示例

开一个会话，直接提需求即可——网格协议会自动注入提示词。

多 worker 协作：

用 agent_spawn 创建两个 worker：
- 一个 label 为 researcher，effort 设为 high，调研「A 主题」并写结论；
- 一个 label 为 checker，用便宜的模型，独立复核 researcher 的结论；
让它们通过 agent_send 互发消息交换意见，最后把结论汇总给我。

运行中要进度 / 停止跑偏任务：

给 researcher 发：agent_send(agent_id: …, message: "先汇报当前进度，然后继续执行", steer: true)
checker 方向错了：agent_interrupt(agent_id: …, reason: "方向偏了，停下")
                 然后 agent_send(…, message: "改查 B 方向") 下发新指令

把复用模式固化为模板：

agent_harness(action: "create", kind: "worker", id: "researcher",
  title: "调研 worker", content: "",
  route_model: "", summary: "…", rationale: "重复使用的调研角色")
之后一行派生：agent_spawn(label: "r2", template: "researcher")

插件配置

配置键	默认值	含义
provider	spawn	建立 worker 的 ctx.subagents continuable 后端提供者
maxDepth	2	agent_spawn 派生的绝对委派深度上限（≥ 0）
orientation	内置协议	覆盖网格协议提示词段（可引用 {{mesh_self}} / {{mesh_master}}）；注意会整体替换内置协议，包括 {{mesh_harness}} 概览行
traceMaxEvents	80	agent_trace 每次读取渲染的事件窗口上限（1 – 1000）
traceMaxCharsPerBlock	2000	agent_trace 每个内容块 / 工具参数的文字裁剪上限（100 – 20000）
traceMaxTotalChars	20000	agent_trace 整段渲染输出的文字上限，保留最新尾部（1000 – 100000）
harnessDir	$DSH_HOME/orchestrator（未设时 ~/.dsh/orchestrator）	global harness 状态目录

Web 面板（「网格」选项卡）

Web 组合下，插件自动成为双面包（宿主半 + 浏览器半）：

• 「对话」「轨迹」之后出现**「网格」选项卡**（conversation.view 开放槽位，order 20，标签 zh 网格 / en Mesh，跟随界面语言），承载插件全貌：
  • 功能说明：8 个网格工具的一句话简介 + 协议要点（回合制、steer/interrupt 例外、worker 回报守则）；
  • 网格成员：从当前会话事件折叠 agent_spawn 记录——label、childId 缩写、派生次序、路由徽章（同 id 重派取最新；实时状态以 agent_list 为准）；
  • 模板：会话模板（前端实时折叠 local 条目）与全局模板（经宿主只读路由 /plugins/orchestrator/harness.json）两区，条目卡含 id/标题/版本/路由徽章/摘要，一键复制 id 便于贴给智能体执行 agent_spawn(template: …)；
  • UI 全部走应用设计令牌（--dsh-alias-*，深浅色自适应）；
• CLI/TUI 组合不受影响（webServer 缺席时不注册路由，浏览器半不加载）；
• 开发热更：重写 lib/client.js（npm run build:client）即被宿主 client-hmr 捕获并热替换；宿主半（src/index.ts）改动需重启 dsh web。

插件配置

配置键	默认值	含义
provider	spawn	建立 worker 的 ctx.subagents continuable 后端提供者
maxDepth	2	agent_spawn 派生的绝对委派深度上限（≥ 0）
orientation	内置协议	覆盖网格协议提示词段（可引用 {{mesh_self}} / {{mesh_master}}）；注意会整体替换内置协议，包括 {{mesh_harness}} 概览行
traceMaxEvents	80	agent_trace 每次读取渲染的事件窗口上限（1 – 1000）
traceMaxCharsPerBlock	2000	agent_trace 每个内容块 / 工具参数的文字裁剪上限（100 – 20000）
traceMaxTotalChars	20000	agent_trace 整段渲染输出的文字上限，保留最新尾部（1000 – 100000）
harnessDir	$DSH_HOME/orchestrator（未设时 ~/.dsh/orchestrator）	global harness 状态目录