qfzlm/dsh-switchyard

dsh-switchyard

面向 DeepSeek Harness 的确定性模型路由与审批基础设施。

English

dsh-switchyard 研究两个应由宿主持有的决策边界，并提供与具体版本绑定的
参考 patch。本项目是研究与参考实现，不是可安装插件。

背景

社区 Router 已经证明了按任务切换行为和模型的实际需求，但插件缺少一个能在
首次组装前修改 session-local 权威模型选择的公开入口。审批也有类似问题：
waterfall 按监听器注册顺序决定谁先给出终态答案。

这里的两个参考设计都把决策放回已经持有权威状态的宿主边界。

状态

| 研究项 | 基线 | 状态 | 验证 |
| --- | --- | --- | --- |
| Initial Model Selection | dsh-v0.1.2-alpha.2 (0a53fb55) | PASS | 34 个测试文件、427 项测试通过 |
| Approval Dispatcher | dsh-v0.1.2-alpha.2 (0a53fb55) | PASS | 17 个测试文件、200 项测试通过；resident-web live NOT TESTED |

Initial Model Selection

flowchart LR
task["首个任务内容已知"] --> decide["宿主持有的初始模型决策"]
decide --> selection["Session 权威 ModelSelection"]
selection --> assembly["首次 prompt 组装"]
assembly --> request["首次模型请求"]

- 决策只运行一次，位于首个任务内容已知之后、首次组装之前。
- 目标通过既有 LLM resolver 整体验证。
- 组装与实际请求读取同一份权威选择。
- 路由只影响当前 Session，不写全局默认。
- 并发的首条消息沿用既有 admission chain 串行化。

参见设计与证据和
参考 patch。

Approval ownership

flowchart LR
ask["ApprovalService request"] --> dispatcher["可选 dispatcher"]
dispatcher --> select{"选中 backend?"}
select -- 是 --> backend["唯一命名 backend"]
select -- delegate --> waterfall["原有 approval waterfall"]
backend --> decision["唯一终态结果"]
waterfall --> decision

- dispatcher 持有的请求不会进入 listener waterfall。
- 每个请求只交给一个命名 backend。
- backend 不存在或抛错时保持 fail closed。
- 未注册 dispatcher 时继续使用原有 waterfall。
- 当前移植不改变 sandbox、permission 或 model policy。

参见所有权分析、
当前版本证据和
参考 patch。

研究材料

- Router 生态取证
- Initial Model Selection
- Approval ownership
- Approval Dispatcher

Upstream discussions

- #5190 Task-aware main-session model selection before first assembly
- #5236 Deterministic approval backend ownership before the approval/request waterfall

兼容性

参考 patch 只适用于状态表中的精确上游 commit。应用前必须使用匹配源码并运行
git apply --check。

研究与参考实现由 @qfzlm 完成。本项目是独立社区项目，
与 DeepSeek 无隶属关系。

许可证

MIT。派生 patch 所需的上游归属见第三方声明。