dsh-graph-runtime

在 DeepSeek Harness 里把 LangGraph 风格的工作流图交给模型调用时，常见痛点是注册与挂载繁琐、编译时机难控、参数 schema 与校验不一致，以及路由 Agent 要自行实现选工具、重试与审计。dsh-graph-runtime 以独立 Cordis 插件形式提供图运行时，让图作者用 defineGraph 完成定义与登记，由插件在启动或后续定义时自动挂载。

插件负责扩展 StateGraph 的工厂声明、是否注册为全局 DSH 工具、是否进入 graphTools 发现列表，以及可选的 validate 语义校验；注册路径不触发 compile，首次真实调用时懒编译并缓存。工具名与描述可来自作者 compile 或结构合成，参数校验、取消信号转发、以及以可序列化 JSON 呈现的执行结果，均由插件统一处理。

GraphRoutingAgent 面向图驱动路由：将过滤后的 graphTools 交给 LLM 并要求选定工具，经存在性、JSON、执行期 schema 与作者 validate 的校验链，失败则附带原因重试；通过后执行对应图，并在 graphTools 前后置瀑布扩展点上支持门禁、审计与结果变换。未选工具时走可配置 fallback，与正常路由路径的扩展点语义在文档中有明确区分。

适合在 DSH bundle 中编写图工作流的开发者：需要模型可见、类型与枚举清晰的 parameters，又希望减少挂载与路由样板代码；也适合需要按作用域注册或运行时动态挂载的进阶用法，与 asTool、asGraphTool 及命令式 API 配合使用。