dsh-state-graph

dsh 的 ReAct 调度天然是线性的——思考、行动、循环——而真正的多分支工作流往往需要条件路由、循环重试和并行扇出，过去只能靠提示词工程硬凑。dsh-state-graph 将 StateGraph 有向状态图编排引擎移植为 dsh 插件，让你用声明式的节点、静态边和条件边描述任意拓扑：多分支条件路由、循环重试、并行 Fan-out / Fan-in 全部由引擎托管，不再依赖脆弱的提示词技巧。

核心卖点是「图即运行时」。每个节点只返回一个 Partial 状态补丁，引擎负责不可变合并、迭代熔断（默认 25 轮防死循环）、取消信号透传和双向事件流观测（graph/* 事件总线）。条件边返回字符串数组即触发自动并行扇出，各分支补丁合并后在 Join 节点汇聚。审批门节点在执行前请求一次性授权；子代理节点将某一步委托给真实的 dsh 子代理——独立会话、独立工具、可路由 LLM——结构化输出自动映射回父状态。随包附带的 Graph Studio 可视化设计器（SVG 画布拖拽 + 自然语言生成图）让非图论背景的团队成员也能快速搭建和调试工作流。

适合在 dsh 中编排多步骤 Agent 工作流的团队：比如「写代码→跑测试→失败则修正，最多重试 3 次」的质量门回环、并行展开子任务再汇聚、或在图内嵌入子代理委托而非临时调用。只要 profile 已加载 dsh-base，添加此 bundle 即可使用，无额外注入依赖。