dsh-auto-model-routing 0.3.0 → 0.4.0

package/docs/routing-community-research-2026-10-24.md

@@ -0,0 +1,98 @@
+# AUTO routing 外部方案调研（2026-10-24）
+
+状态：只读调研，未采纳实现；主会话复核 + gpt-6.1-sol/high 子智能体调研。核心诉求见 routing-intent-and-gaps.md。
+
+## 先分清三类自动路由
+
+1. 服务网关选模型/供应商：对请求做能力与价格路由，可能改变主模型，不天然符合本项目主模型固定的不变量。
+2. 固定模型调推理预算：最接近本项目主会话，但需处理缓存前缀、模型支持与同回合稳定性。
+3. 编排层委派：决定是否派发、任务边界、worker能力与预算、验收升级；网关分类器无法代替主Agent完成这些决策。
+
+## 已复核的一手证据
+
+### Anthropic：强主轻子的生产案例，但不保证省token
+
+来源：https://www.anthropic.com/research/multi-agent-research-system
+
+官方研究系统使用 Opus 4 lead + Sonnet 4 workers；适合多条独立方向的并行研究与上下文压缩，强调任务目标/输出格式/边界/工具指导，以及按最终成果评估。不能将该内部研究评估的收益直接推广到所有编码任务；多agent会增加token消耗，只有收益足够时才值得。
+
+Anthropic platform effort/caching文档本次直接抓取存在地区跳转限制。仓库 eval/README.md 的2026-10-21/22来源摘要是历史依据，不能冒充本次全文复核。
+
+### OpenAI：effort不是无缓存代价的开关
+
+来源：https://developers.openai.com/api/docs/guides/prompt-caching.md
+
+官方说明 reasoning.effort 可改变隐藏模型指令；支持GPT-6+模型可以追加 configuration_update、保持顶层原值，以保存既有前缀。是否适用于DSH订阅适配器需单独检查实际协议，不能从API文档直接推断。
+
+### LiteLLM：分类 + 运行约束 + 影子评估
+
+来源：https://docs.litellm.ai/docs/auto_router
+来源：https://docs.litellm.ai/docs/auto_router/evaluate
+
+当前已经有 Auto Router add-on，不能再将LiteLLM仅归为负载均衡。最值得借鉴的是 shadow evaluation：同输入复制请求、盲评实际输出、对比多个策略；官方明确指出 tier标签匹配不等于选中模型答得好。
+
+费用核算包括classifier与下游费用，记录fallback和p95；继续回合的对照费用应采用暖缓存，切换后新增cache write应扣除。其按最昂贵配置估算的savings仍是反事实估计，不能等同本项目实测节约。
+
+### Magpie：回合稳定、缓存迟滞、可选effort更新
+
+项目确认为 https://github.com/yetone/magpie ，不是同名数据集或仅DSH连接器。
+
+固定代码：https://github.com/yetone/magpie/tree/f3eb92924e56605860f6a85a3449247c26c0bd90
+
+- internal/gateway/rules.go：用户回合开始决策，工具结果继续沿用；上下文超过模型能力等例外另处理。缓存仍暖时保留更高effort，不因新一轮简单就立刻降档；冷却或上下文显著缩短时才允许降低。
+- Pick/Wanted区分实际保留档位与新判断期望，方便展示“推荐值≠生效值”。
+- internal/gateway/effort_update.go：MAGPIE_EFFORT_UPDATES=on的preview才启用，默认关闭；限GPT-6、Responses、OpenAI/ChatGPT账户，并排除某些服务端历史管理/自动截断路径。
+- 超过初始base的升档重设顶层effort；注释声称configuration_update升到高档时实际推理不足。这是上游实测自述，非官方保证，也未由本项目复现。
+- 保存每个thread/account/model的更新位置并重放；历史不匹配、compact或重启可能导致重新缓存。不是只改一个effort字段就能实现。
+
+可借鉴：主会话调effort要有缓存意识；判档值与生效值可分离；缓存更新路径需显式支持与能力验证。不可照搬：默认启用preview、假定跨provider都支持、将所有回合只升不降当作永久最优。
+
+## Sol 补充核验：官方建议
+
+- https://claude.com/resources/articles/claude-model-and-effort-level-in-claude-code ：model是能力边界，effort也影响读文件/工具/核验/坚持程度；从模型默认起，把effort当总体偏好。认真尝试仍错可能需强model，漏读/不测/早退可能需更多effort。
+- https://code.claude.com/docs/en/model-config.md ：当前Opus/Sonnet/Haiku5.5默认medium；各模型同名effort不等价。
+- https://code.claude.com/docs/en/prompt-caching.md ：多数模型不同effort有独立cache；当前Claude Code在部分模型与直API/订阅组合可保cache，但其他后端、禁beta等不适用。这是client×backend×model组合能力，不自动适用于DSH。
+- https://developers.openai.com/api/docs/guides/model-selection.md ：用同输入比较模型和effort，选择达到质量要求的最轻配置。
+- https://developers.openai.com/api/docs/guides/reasoning.md ：Sol默认medium，high适合复杂调试，xhigh需eval收益；模型在各effort档内已会根据任务自适应。
+- https://learn.chatgpt.com/docs/agent-configuration/subagents.md ：主线程管需求/决策/最终交付，子线程做噪音探索并摘要；Sol适合歧义多步，Luna适合窄且可重复任务，显式Luna起high/Astra起low；子agent不是必定更弱。
+
+## 社区策略与维护快照
+
+2026-10-24约02:09–02:15 Asia/Shanghai，Sol读取GitHub REST repo与commits端点。stars仅关注度；last push/commit不等于质量。下表均为当时值。
+
+| 项目 | 关注/维护 | 路由与适用边界 |
+|---|---|---|
+| [Magpie](https://github.com/yetone/magpie) | 20,159 stars / 1,547 forks，HEAD f3eb929，10/23 18:05Z提交；9/23建仓，活跃但年轻，maintainers-only PR | 最接近本项目的回合判档与effort缓存问题，但网关不负责拆解/验收 |
+| [LiteLLM](https://github.com/BerriAI/litellm) | 61,909 / 12,608，HEAD 1e6dc81，10/23 18:11Z提交 | 大平台；Auto Router仍Beta/add-on。四档→模型/pool，可用heuristic/LLM/Jev/local Laya；上下文/模态约束、stall escalation、session pin。平台成熟不证明每个路由策略成熟 |
+| [RouteLLM](https://github.com/lm-sys/RouteLLM) | 5,633 / 446，HEAD 0b64fda，最后push 2024-08-10 | 强弱两模型win-rate/阈值路由；MF/Elo/BERT等，强调本域校准。影响力研究基线而非持续维护的新模型产品；旧静态benchmark非长程coding证据 |
+| [DSH Laya](https://github.com/HapyRain/dsh-router-laya) | 25 / 6，HEAD 29624e7，10/17提交 | 本地约846MB分类器+规则，默认同Flash调low/high/max，同回合锁定；故障回low。标签99%与未公开实验不能当端到端收益 |
+| [Neptune810 router](https://github.com/Neptune810/dsh-model-router) | 2 / 3，HEAD 1d1968a，10/04提交 | full/effort/model作用范围，错误/重复升级与降档迟滞；child preferCheap未经质量证明 |
+| [thedeveloper256 router](https://github.com/thedeveloper256/dsh-model-router) | 1 / 0，9/20最后push | root planner/child executor角色配置；当前两者默认均Flash，README与旧description不一致；角色分离不等于实际强主轻子 |
+| [incrhst router](https://github.com/incrhst/dsh-model-router) | 0 / 0，8/31提交 | size/tool/code/关键词分数阈值切Pro/Flash，图片vision；未见验收闭环 |
+| [superboy911 router](https://github.com/superboy911/dsh-model-router) | 4 / 1，9/11最后push | 有序关键词→model+可选effort，无匹配不改；确定规则而非学习型AUTO |
+
+社区DSH路由尚无充分证据表明已形成大规模验证的收敛方案；不能把同名repo混为一个热门项目。
+
+## OpenRouter Auto 现行策略
+
+来源：https://openrouter.ai/docs/guides/routing/routers/auto-router.md （Sol本次读取）
+
+当前是轻classifier分约30任务类→最近7日该类真实aggregate spend share排序→cost_tier区间→allow/exclude/tool/modality/ZDR约束下选模型与fallback。不是旧NotDiamond描述；市场支出份额不等于能力评分，cost_tier不等于reasoning effort，也不是纯价格上限。session stickiness有条件：原模型仍须在新任务top候选中。可借鉴约束和实际模型透明度，不能原样替换固定主模型策略。
+
+## Magpie进一步代码观察
+
+- classify.go/decide.go：普通小模型可intent+effort两个调用并行；Jev可单调用多questions；effort score 0..3映射low/medium/high/xhigh，不同于本项目choice tier再加模型offset。
+- 意图normalized confidence门槛0.4；level低confidence保前级；结果10分钟缓存与inflight合并，失败rest30秒，可保持前intent。
+- 当前上下文含最新请求前3000+后1000runes、前轮user/reply各1000，不含工具结果/推理。
+- https://usemagpie.ai/docs/intent 标记v0.1.99，仍写只看最新消息/不支持group classifier，与固定提交当前代码不同；不能只读旧文档。
+- smart/order/rotate/usage/pace大量处理账户可用性与额度，不应统称质量最优路由。
+
+## 对本项目的建议顺序
+
+1. **P0 缓存与结果基线**：固定主模型+官方默认effort，与主effort-only、child-model-only、child-effort-only、联合AUTO对照。按窄实现/探索/debug/跨系统设计分层，以独立测试与最终结果为准，计父子/分类/验收/重试/cache总费用、端到端与p95。不要只评tier。
+2. **P1 分离能力与预算**：保留强主轻子；主模型负责规划验收，子模型按任务能力和可验证性选，不因是child就便宜。小模型先用推荐effort起点测，不能未经验证再次降档。
+3. **P1 缓存感知调节**：核验当前DSH实际wire能力，再选择逐轮更新/较稳定默认/自然任务边界/冷却或compact后的降档迟滞；不照搬Magpie五分钟。
+4. **P2 验收与升级**：能力失败与429/timeout分开；根据失败原因补上下文/加effort/换model，设上限与停止条件。现有Jev失败退出AUTO/暂停委派契约不能静默换成low fallback。
+5. **P2 可观测与影子对照**：展示判档与生效配置、缓存/费用/升级原因；真实shadow output有对照价值但额外花钱，推荐值或理论估费不等实际效果。
+
+未安装外部项目、未执行付费基准、未更改运行配置。以上外部收益数字均未独立复现；实施仍需单独确认规范与验收条件。

package/docs/routing-intent-and-gaps.md

@@ -0,0 +1,56 @@
+# AUTO routing：核心诉求与待补差距
+
+记录时间：2026-10-24（Asia/Shanghai）。状态：需求回顾与调研，不是已批准实施方案；不修改现行运行规范、0.3.0 默认行为或生产配置。
+
+## 用户核心诉求（后续方案的验收方向）
+
+1. 决策配置遵循 Anthropic 与 OpenAI 对具体模型用途、effort、委派和成本优化的官方建议；区分官方支持能力、官方推荐和本项目经验策略，不将自定义四档表称为官方标准。
+2. 主会话保留用户选择的 provider/model，只调整 effort。保留主模型的理由包括行为/上下文连续性与减少缓存扰动；不承诺改变 effort 一定保留缓存，须按实际适配器核验。
+3. 强主模型承担理解、拆解、协调与验收；适宜的执行任务交给较轻量子模型。不因缺乏跨模型评估而简单退回“所有子会话默认使用强主模型”，也不把所有小事都委派。
+4. AUTO 的目标是质量、速度、总开销的平衡，避免一律最高或最低配置。总开销包括判档、上下文移交、worker 执行、主模型复核与失败重试。
+5. 用户记得曾要求“主模型让简单子模型干活”：当前环境级指令确有委派场景指导，但不是所有简单任务强制委派；后续应补齐与独立插件一致的执行边界。
+
+## 当前证据
+
+- 当前规范：../../../openspec/specs/auto-model-routing/spec.md，固定主模型、共享四档 rubric、childRoutes 与派发规则。
+- 默认主模型起点与偏移：../src/effort.ts；Claude 子表 Haiku/Sonnet/Opus/Opus；GPT 子表 Luna/Sol/Sol/Sol。
+- 子工具：../src/subagent-tool.ts，单独判断子任务；指定模型时只调 effort；校验目录与允许列表。
+- 包内指导：../skills/subagent-model-routing/SKILL.md，主要约束选模、调用与复用；是否派发的场景主要位于 ../../../instructions/dsh-home.md。历史提交 14d68627（2026-10-22）已明确加入较大编码、独立复核、大量探索、可并行工作的派发规则，以及小修复/讨论不派发；这确认用户记忆中的委派要求确实曾落地，但不是所有简单任务强制派发。
+- 来源与评估范围：../eval/README.md，现有回归是判档一致性，不是最终任务质量/速度/费用基准。
+
+## Gap 与建议（待调研校准，不是实施授权）
+
+| Gap | 影响 | 建议与验证 |
+|---|---|---|
+| 同一难度标签同时决定模型能力档与effort | simple 可能同时降到小模型与低effort，不能由“强模型轻松做”推导“小模型低预算可靠做” | 保留轻量worker；分开能力适配与推理预算，以所选模型官方起点为基线，再验证偏移；不急于增加第二次网络判档 |
+| 固定model被误当作缓存保持保证 | Claude顶层effort可能影响前缀，省下输出费用但新增缓存写入 | 检查当前Claude/GPT适配器与官方文档；记录cache read/write和总延迟；比较稳定effort与逐轮effort策略 |
+| 缺少是否值得委派的成本边界 | 一行任务派发可能比主模型直接做更慢更贵 | 主Agent依据任务独立性、工作量、移交成本与可验证性决定派发；不要“simple必委派” |
+| 独立插件与个人环境指导不完全相同 | 安装工具/skill不保证强主轻子的工作方式真正执行 | 明确包内最小派发/复核指导及尽力而为边界，真实Host验证，不宣称强制拦截 |
+| 缺少结果验收与质量失败升级闭环 | 弱配置可能持续重试，最终成本反增 | 区分工具/网络故障与推理失败；定义验收、有限重试与能力升级策略，尊重用户固定模型约束 |
+| 官方推荐与经验配置边界不清 | 默认表随模型更新失效，用户误以为有官方保障 | 维护版本化来源、适用任务、支持effort、推荐起点；将自行推导明确标注为待评估预设 |
+| 没有端到端收益证据 | 分类准确不等于任务成功或省钱 | 同任务比较固定高配置、固定推荐配置、当前AUTO及候选AUTO；记录独立通过率、全链路耗时/费用与重试次数 |
+
+## 修订后的优先级与职责边界
+
+以用户后续确认的 [策略与推进计划](routing-strategy-plan.md) 为准：
+
+1. 先明确该怎么 route，再把决策说清楚交给 Jev；不能让现有四档输出反向定义策略。
+2. Agent 保留拆解、派发、协作、验收权；AUTO 补齐资源选择与实际生效；Jev 负责有限范围的能力/深度判断。
+3. 分开子模型能力与 effort，保留强主轻子；不因轻量模型而自动再次降低其 effort。
+4. 补齐创建路径 gap：当前 subagent 暴露模型与 effort 参数，fork/teammate 未暴露。返回推荐不等于成功路由，须检查正式接入点并验证实际请求；不能把主 Agent 自选当作所有路径都可用的替代方案。
+5. 分别验证策略质量、Jev 判断忠实度、宿主接入正确性。
+
+本轮按用户范围约定排除 dsh-plugin-subscriptions 与 MANUAL 改造，缓存/适配器实验不再是前置事项。上表与下节缓存内容保留为历史证据和评估限制，不构成本轮实施要求，也不宣称固定模型必保缓存。此范围约定不表示订阅适配器在技术上只运行于 MANUAL。
+
+## 已独立核验的缓存证据
+
+- [OpenAI Prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching.md)（2026-10-24读取）：request-level reasoning.effort 可以改变模型侧指令；支持的 GPT-6+ 模型通过追加 configuration_update 并保持顶层原值来保留早先前缀。这是 API 能力，不证明当前 DSH/订阅适配器已支持。
+- [Magpie rules.go](https://github.com/yetone/magpie/blob/main/internal/gateway/rules.go)（2026-10-24读取 main，可变引用）：同回合保持决策；keepsEffort 在缓存仍暖时阻止降 effort，但允许升档，缓存过冷或上下文缩小至一半以下时允许降档；区分 Pick 与 Wanted，注释说明支持 effort updates 的路径可使用 Wanted。项目注释中的缓存命中观测是上游自述，不是本项目复现结果。它是可借鉴的缓存策略，不能直接抄作所有 provider 的普遍规律。Sol 后续对固定提交 f3eb92924e56605860f6a85a3449247c26c0bd90 的检查指出，effort_update.go 的更新通路为 MAGPIE_EFFORT_UPDATES=on 显式启用的 preview，默认关闭，限 GPT-6/OpenAI或ChatGPT账户/Responses；不能将源码出现 takesEffortUpdates 解读为所有部署默认具备缓存保持能力。
+
+## 官方强主轻子的适用边界
+
+[Anthropic 多智能体研究系统](https://www.anthropic.com/research/multi-agent-research-system)（2026-10-24全文读取）描述 Opus 4 lead + Sonnet 4 workers，在其内部研究评估优于单 Opus 4；这是特定研究系统结果，不是本项目收益证明，也不是所有 coding 都适合多agent的结论。文章强调并行独立方向、上下文压缩、清晰任务边界与最终结果评估；同时指出多agent显著增加token，编码任务往往比研究更难并行。应采用其编排与验收原则，不直接复制旧代模型组合或收益百分比。
+
+## 外部调研
+
+已由 gpt-6.1-sol/high 完成官方指引、维护/热度较高社区路由与 yetone/magpie 策略调研，主会话复核了OpenAI缓存、Anthropic研究编排、LiteLLM评估与Magpie更新路径。详见 [调研记录](routing-community-research-2026-10-24.md)。结果区分官方文档、代码事实、项目自述与未经复现的效果声明；热度不等于效果，不把调研建议直接写为现行spec。

package/docs/routing-strategy-plan.md

@@ -0,0 +1,101 @@
+# AUTO 路由策略与推进计划（修订版）
+
+日期：2026-10-24。状态：已确认职责方向的设计草案，具体规则和宿主接入待验证；不是实施或部署记录，不改变现行规范与运行行为。
+
+## 1. 核心定位
+
+尊重 Agent 的任务组织权；AUTO 补齐资源选择与实际生效能力；Jev 按明确的策略快速判断。先讨论什么决定是正确的，再设计决策问题，最后优化判断性能。不能因 Jev 支持四档就反推策略必须是四档。
+
+| 责任方 | 负责 | 不负责 |
+|---|---|---|
+| 主 Agent / Team Lead | 理解目标、决定是否派发、拆解任务、选择协作形式、定义验收、整合与失败处置 | 不要求它通过没有模型参数的接口完成资源选配 |
+| AUTO | 主会话 effort、子任务 model 与 effort 的独立选择，确定性约束，以及在支持的宿主路径实际生效 | 不重新实现团队任务调度、消息与任务板，不替代主模型验收 |
+| Jev | 按已明确的策略判断当前工作的能力需求和推理投入 | 不制定目标权衡、不拆整个项目、不判断未经执行的任务已成功 |
+| 宿主接入与确定性代码 | 模型目录/允许列表、显式选择优先级、映射、决策绑定、实际请求核验 | 不把推荐结果当作已生效结果 |
+
+## 2. 范围与不变量
+
+- 主会话保留用户选择的 provider/model，只调整 effort。
+- 适宜任务交给较轻量 worker，但不要求所有子任务都降模；复杂调查和独立审查可使用强模型。
+- 不改变 MANUAL 的继承/选择行为。本轮按用户范围约定排除 dsh-plugin-subscriptions，不调查或修改它，不以其缓存实验作为前置条件。此处是范围约定，不是宣称该适配器在技术上仅运行于 MANUAL。
+- 不替换 Jev，不引入多分类器，不改底层缓存协议，不自动发布或部署。
+- 保留同回合稳定与显式用户约束；Jev 失败沿用现有可见退出/暂停契约，不静默降档。
+- 缓存影响保留为评估限制，不承诺固定模型或调 effort 必然保缓存。
+- 本轮讨论 Teams 支持不等于授权启动团队。
+
+## 3. 策略草案
+
+### 3.1 工作组织交给 Agent
+
+任务能独立描述、执行和验收，且并行/上下文隔离收益超过移交与复核成本时考虑派发。小修复、紧密依赖当前上下文的讨论留在主线程。不另设一个 Jev“是否组队”分类器。
+
+### 3.2 主会话 effort
+
+以官方推荐起点为默认参照，按当前承担的认知工作调整，而非整个项目大小。明确低推理需求可降低；复杂取舍、原因分析和结果冲突可提高；信息不足时不强行偏移。同回合稳定。具体档位、映射和未知输入处理在后续决策契约中定义；暂不增加只升不降、固定冷却等状态机。
+
+### 3.3 子模型能力与 effort 分离
+
+先选择有合理把握胜任任务的模型能力，再确定推理投入。轻量模型先以其官方推荐 effort 起点验证，不自动再次降低 effort。可验证性越强，越可积极试用轻量模型；风险通过权限、验收和确认控制，不直接当作推理难度。
+
+- 明确、成熟、可直接验证的执行任务：优先轻量模型。
+- 范围可控但需要探索推断的任务：选择足够能力的模型。
+- 歧义大、多步推断、困难调试、独立审查：允许强模型。
+
+这不是新的三档 rubric，也不意味着必须两次调用 Jev；输出维度与请求次数分别设计。
+
+### 3.4 验收与升级
+
+主模型依据执行证据验收。描述不清先补描述，缺信息先补上下文，漏核验/浅尝辄止考虑加 effort，充分尝试仍失败考虑更强子模型。网络与限流不视为能力不足。升级有预算和停止条件，具体上限在规则确认阶段确定，不通过初始分类自动断言成功。
+
+## 4. 创建路径的真实能力差异
+
+以下仅依据当前会话暴露的工具 schema，不代表所有宿主版本，也不证明已经找到扩展点：
+
+| 路径 | 当前创建接口 | 现有“推荐后传参”是否够用 | 后续必须验证 |
+|---|---|---|---|
+| subagent | 暴露 provider/model/reasoning_effort | 接口上可表达，仍需核验实际生效 | 传参、显式指定优先级、实际请求配置 |
+| subagent_fork | 未暴露上述参数 | 不够 | 官方创建/首次请求扩展点，继承与前缀限制 |
+| spawn_teammate | 未暴露上述参数 | 不够 | 官方扩展点、任务到成员的绑定、首个请求配置 |
+
+AUTO 的关键增量是补出默认继承路径上的异构执行能力，而非仅让主 Agent 重复一次它已能表达的选择。主 Agent 能决定派发，不等于创建接口允许它选择资源。
+
+不得以 route_subagent 返回了推荐就声称 Teams/fork 已覆盖。没有可靠接入点的路径明确标为不支持；不静默绕过用户限制。长驻 teammate 的创建时选配与后续换任务重选分开设计，首版不默认每条消息重路由。
+
+## 5. 策略演练案例
+
+| 场景 | 组织方式 | 资源策略与理由 |
+|---|---|---|
+| 上下文齐全的一行修改 | 主模型直接做 | 派发成本高于收益；低推理需求可降低 effort |
+| 规则明确且有测试的批量迁移 | Agent 划分独立任务 | 轻量 worker + 推荐 effort 起点；量大不等于能力要求高 |
+| 明确字段提取并附来源 | 独立子任务 | 轻量优先，主模型核验来源与格式 |
+| 冲突资料的因果判断 | 独立调查或主模型 | 足够强的模型，按深度加 effort |
+| 未知原因的跨模块 bug | 主模型组织调查 | 不默认降模；并行假设由 Agent 决定 |
+| 复杂实现后的独立 review | 独立 reviewer | 以审查能力为先，不因子任务身份降模 |
+| 多个结果的整合 | 主模型 | 按冲突和整合难度，不继承项目总难度 |
+| 高后果的简单操作 | 主模型控制权限和验收 | 风险不直接映射高 effort |
+
+## 6. 修订后的推进顺序
+
+1. **策略定稿**：用以上案例与反例确认派发边界、模型能力、effort、未知情况与升级规则。此阶段不先改 rubric。
+2. **Jev 决策契约**：分别定义主会话与子任务的输入、问题、输出、信息不足处理及确定性映射。主回合只能依赖本轮推理前已有信号；子任务可使用主模型已经写清的目标、范围、输出和验收。
+3. **宿主能力核验**：只读检查三条创建路径的正式扩展点，明确能覆盖的路径及实现边界。此项与策略细化可并行，但不以宿主接口反推策略。
+4. **创建独立 OpenSpec change**：将确认策略、接入范围和验收条件写为提案，与既有发布 change 分开；再进入实现。
+5. **实现与分层验证**：先离线契约与路由集成测试，再经明确预算的小规模真实任务对照；验证实际模型与 effort，而非只验证推荐。
+6. **根据证据决定上线**：保留回滚与原继承行为，未通过验收不替换默认策略。
+
+## 7. 分开验证三件事
+
+- **策略质量**：假设每次都正确执行策略，任务最终质量、总消耗和耗时是否改善？保留独立任务集，包含验收与重试成本。
+- **Jev 忠实度**：是否按已确认策略作出期望判断？单独测错误类型、稳定性、分类成本与延迟。快速判断不等于正确策略。
+- **接入正确性**：每种支持的创建路径是否真正使用选定 model/effort？MANUAL、显式指定、同回合稳定、失败与不支持路径是否符合契约？
+
+Jev 的价值不仅是体验和性能；误判会损害质量。但策略质量不能用 Jev 标签一致率代替，接入正确性也不能用推荐输出代替。
+
+## 8. 参考与当前规范
+
+- [核心诉求与差距](routing-intent-and-gaps.md)
+- [外部调研](routing-community-research-2026-10-24.md)：历史调研建议，实施优先级以本修订为准。
+- [现行规范](../../../openspec/specs/auto-model-routing/spec.md)：仍描述当前行为，本稿不静默替换它。
+- [Claude Code model configuration](https://code.claude.com/docs/en/model-config.md)：opusplan 是规划阶段 Opus、执行阶段 Sonnet，不等于固定强主监督轻子。
+- [Claude Code subagents](https://code.claude.com/docs/en/sub-agents.md)：主模型根据职责描述委派。
+- [Claude Code Agent Teams](https://code.claude.com/docs/en/agent-teams.md)：Lead 组织共享任务与协作，不天然保证异构模型或低成本。

package/lib/client/control.d.ts

@@ -22,13 +22,21 @@ export interface Decision {
     confidence?: number;
     probabilities?: Record<string, number>;
     ms: number;
+    depth?: string;
+    capability?: string;
+    capabilityConfidence?: number;
+    capabilityProbabilities?: Record<string, number>;
+    decisionProvider?: string;
+    decisionModel?: string;
+    provider?: string;
+    status?: string;
 }
 export interface Toast {
     id: number;
     lines: string[];
 }
 export declare const TOAST_MS = 3000;
-/** Line 1: who judged, tier → (model) effort, duration. Line 2: the distribution in tier order, 0% tiers omitted. */
+/** Shared by the persistent hover panel and transient decision hint. */
 export declare function toastText(d: Decision): string[];
 /** A hint is shown only for a decision id not seen before (it is hidden TOAST_MS later by the chip). */
 export declare function nextToast(seen: number | undefined, d: Decision | undefined): Toast | undefined;

package/lib/client/control.js

@@ -9,8 +9,23 @@ export const panelOpenAfter = (event) => event === 'enter' || event === 'focus';
 const TIER_ORDER = ['simple', 'standard', 'complex', 'escalated'];
 const pct = (v) => `${Math.round(v * 100)}%`;
 export const TOAST_MS = 3000;
-/** Line 1: who judged, tier → (model) effort, duration. Line 2: the distribution in tier order, 0% tiers omitted. */
+const spreadText = (order, values) => {
+    const entries = order.filter(key => values?.[key] !== undefined && Number.isFinite(values[key]) && values[key] >= 0 && values[key] <= 1);
+    return entries.length ? entries.map(key => `${key} ${pct(values[key])}`).join(' / ') : '未提供';
+};
+/** Shared by the persistent hover panel and transient decision hint. */
 export function toastText(d) {
+    if (d.depth)
+        return [
+            `${d.source === 'main' ? '主会话' : '子任务'} · ${d.status === 'applied' ? '已应用' : d.status === 'failed' ? '未应用' : d.status === 'unsupported' ? '不支持调整' : '已判断/待应用'}`,
+            ...(d.capability ? [`能力 ${d.capability} · 判定确定度 ${d.capabilityConfidence === undefined ? '未提供' : pct(d.capabilityConfidence)}`] : []),
+            ...(d.capability ? [`能力分布：${spreadText(['bounded', 'analytical', 'frontier', 'insufficient_context'], d.capabilityProbabilities)}`] : []),
+            `投入 ${d.depth} · 判定确定度 ${d.confidence === undefined ? '未提供' : pct(d.confidence)}`,
+            `投入分布：${spreadText(['lower', 'baseline', 'higher'], d.probabilities)}`,
+            `${d.provider ?? ''} / ${d.model ?? '待确定'} · ${d.effort}`,
+            `${d.decisionProvider ?? '未知服务'} / ${d.decisionModel ?? '未知模型'} · ${(d.ms / 1000).toFixed(2)}s`,
+            '确定度 = (最高概率 − 1/n) ÷ (1 − 1/n)，n 为候选数；不是任务成功率',
+        ];
     const head = [
         d.source === 'main' ? '主会话判断' : '子会话判断',
         `${d.tier} → ${d.model ? `${d.model} · ` : ''}${d.effort}`,

package/lib/client/index.d.ts

@@ -3,6 +3,8 @@ import { type Decision, type Rpc, type Toast } from './control.js';
 import { type JevCategory } from '../hints.js';
 interface View {
     mode: 'AUTO' | 'MANUAL';
+    policy?: string;
+    depth?: string;
     effort?: string;
     reason?: string;
     disabled?: {

package/lib/client/index.js

@@ -24,7 +24,7 @@ const CSS = `
 .amr-latest{margin:6px 0;padding:6px 0;border-top:1px solid var(--dsw-alias-border-l1);border-bottom:1px solid var(--dsw-alias-border-l1)}
 .amr-muted{color:var(--dsw-alias-label-tertiary)}
 .amr-error{color:var(--dsw-alias-state-error-primary)}
-.amr-toast{position:fixed;z-index:1100;transform:translate(-50%,-100%);padding:4px 8px;border-radius:var(--dsw-radius-sm);background:var(--dsw-alias-bg,#fff);color:var(--dsw-alias-label-secondary);box-shadow:var(--dsw-elevation-prominent);font-size:12px;line-height:18px;white-space:nowrap}
+.amr-toast{position:fixed;z-index:1100;transform:translate(-50%,-100%);padding:4px 8px;border-radius:var(--dsw-radius-sm);background:var(--dsw-alias-bg,#fff);color:var(--dsw-alias-label-secondary);box-shadow:var(--dsw-elevation-prominent);font-size:12px;line-height:18px;white-space:normal;max-width:min(480px,calc(100vw - 24px));overflow-wrap:anywhere}
 `;
 // Left-right swap arrows at the picker chevron's size; colour follows currentColor.
 function SwapIcon() {
@@ -128,7 +128,7 @@ export function RoutingChip({ sessionId, rpc, initialView, initiallyOpen = false
         'aria-label': `推理强度模式：${view?.mode ?? '加载中'}，点击切换`,
     }, h('span', null, off ? `${view?.mode} · Jev 停用` : view?.mode ?? '…'), h(SwapIcon)), toast && !open && (typeof document === 'undefined'
         ? h('div', { className: 'amr-toast', role: 'status', style: { pointerEvents: 'none' } }, ...toast.lines.map((line, index) => h('div', { key: index, className: index ? 'amr-muted' : undefined }, line)))
-        : createPortal(h('div', { className: 'amr-toast', role: 'status', style: { pointerEvents: 'none', left: place.left, top: place.top } }, h('style', null, CSS), ...toast.lines.map((line, index) => h('div', { key: index, className: index ? 'amr-muted' : undefined }, line))), document.body)), open && h('section', { className: 'amr-panel', 'aria-label': '自动路由状态' }, h('div', { className: 'amr-card' }, h('p', null, h('strong', null, view?.mode === 'AUTO' ? '自动调整推理强度' : '手动：不自动调整')), h('p', null, `本回合插件输出：${view?.effort ?? '未改写'} · ${view?.reason ?? '尚无决定'}`), view?.decision && h('div', { className: 'amr-latest' }, h('p', null, h('strong', null, '最近决策')), ...toastText(view.decision).map((line, index) => h('p', { key: index, className: index ? 'amr-muted' : undefined }, line))), h('p', { className: 'amr-muted' }, 'AUTO 的决定会同步到右侧模型选择；要手动指定 effort，请先切到 MANUAL。'), off && h('p', { role: 'status', className: 'amr-error' }, `Jev 停用（${off.category}）：${hint}。${new Date(off.at).toLocaleString()}。点击 AUTO 重试。`), h('p', { className: 'amr-muted' }, 'AUTO 会把任务文本发送给 OpenRouter/TypeSafe 判档。'), error && h('p', { role: 'alert', className: 'amr-error' }, error))));
+        : createPortal(h('div', { className: 'amr-toast', role: 'status', style: { pointerEvents: 'none', left: place.left, top: place.top } }, h('style', null, CSS), ...toast.lines.map((line, index) => h('div', { key: index, className: index ? 'amr-muted' : undefined }, line))), document.body)), open && h('section', { className: 'amr-panel', 'aria-label': '自动路由状态' }, h('div', { className: 'amr-card' }, h('p', null, h('strong', null, view?.mode === 'AUTO' ? '自动调整推理强度' : '手动：不自动调整')), h('p', null, `本回合插件输出：${view?.effort ?? '未改写'} · ${view?.reason ?? '尚无决定'}`), view?.decision && h('div', { className: 'amr-latest' }, h('p', null, h('strong', null, '最近决策')), ...toastText(view.decision).map((line, index) => h('p', { key: index, className: index ? 'amr-muted' : undefined }, line))), h('p', { className: 'amr-muted' }, view?.policy === 'policy-v2' ? `AUTO · ${view.depth ?? '尚无判断'}；主模型不变，推理投入按请求应用；子任务自动选配。` : 'AUTO 的决定会同步到右侧模型选择；要手动指定 effort，请先切到 MANUAL。'), off && h('p', { role: 'status', className: 'amr-error' }, `Jev 停用（${off.category}）：${hint}。${new Date(off.at).toLocaleString()}。点击 AUTO 重试。`), h('p', { className: 'amr-muted' }, 'AUTO 会把脱敏任务文本发送给设置中所选的决策服务判档。'), error && h('p', { role: 'alert', className: 'amr-error' }, error))));
 }
 const labelUi = { Tooltip, Menu, Icon: IconGaugeOutlineRegular };
 export function apply(ctx) {

package/lib/client/label.d.ts

@@ -5,6 +5,10 @@ interface Labelled {
     tier: Tier;
     effort?: string;
     label?: Tier;
+    policy?: string;
+    depth?: string;
+    model?: string;
+    feedback?: string | null;
 }
 /** Official primitives, injected so the component carries no styles of its own (tests pass doubles). */
 export interface LabelUi {

package/lib/client/label.js

@@ -1,27 +1,31 @@
 import { createElement as h, useEffect, useRef, useState } from 'react';
+const FEEDBACK = { appropriate: '分配合适', 'too-high': '投入偏高', 'too-low': '投入不足', unknown: '无法判断' };
 const TIERS = ['simple', 'standard', 'complex', 'escalated'];
 const NAMES = { simple: '简单', standard: '标准', complex: '复杂', escalated: '升级' };
 const CSS = `.amr-label-action{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));border-radius:var(--dsw-radius-sm);color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;padding:6px;display:inline-flex}.amr-label-action svg{width:calc(17px + var(--dsh-content-font-delta,0px));height:calc(17px + var(--dsh-content-font-delta,0px))}.amr-label-action:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}`;
-async function callLabel(rpc, sessionId, messageId, label) {
-    const result = await rpc.call('/api', 'auto-model-routing.label', { sessionId, messageId, ...(label ? { label } : {}) });
+async function callLabel(rpc, sessionId, messageId, label, feedback) {
+    const result = await rpc.call('/api', 'auto-model-routing.label', { sessionId, messageId, ...(label ? { label } : {}), ...(feedback !== undefined ? { feedback } : {}) });
     if (!result.ok)
         throw new Error(result.error?.message ?? '标注请求失败');
     return result.value;
 }
 export function tooltipText(view) {
+    if (view.policy === 'policy-v2')
+        return `AUTO 分配：${view.depth} → ${view.effort} · ${view.model}${view.feedback ? ` · 你反馈：${FEEDBACK[view.feedback]}` : ' · 评价资源分配是否合适'}`;
     return `AUTO 判档：${NAMES[view.tier]}${view.effort ? ` → ${view.effort}` : ''}${view.label ? ` · 你标注：${NAMES[view.label]}` : ''}`;
 }
 /** Reply-bar tier button (design D13): shown only for replies of a judged turn; selecting a tier records a label. */
 export function LabelButton({ sessionId, messageId, rpc, ui }) {
     const [view, setView] = useState(undefined);
     const [open, setOpen] = useState(false);
+    const [error, setError] = useState('');
     const alive = useRef(true);
     useEffect(() => () => { alive.current = false; }, []);
     useEffect(() => {
         let active = true;
         setView(undefined);
         // One query per message; `{}` (or an error) renders nothing.
-        callLabel(rpc, sessionId, messageId).then(value => { if (active && 'tier' in value)
+        callLabel(rpc, sessionId, messageId).then(value => { if (active && ('tier' in value || value.policy === 'policy-v2'))
             setView(value); }, () => { });
         return () => { active = false; };
     }, [rpc, sessionId, messageId]);
@@ -30,17 +34,29 @@ export function LabelButton({ sessionId, messageId, rpc, ui }) {
     const choose = (label) => {
         setOpen(false);
         // A failure leaves the shown label unchanged.
-        callLabel(rpc, sessionId, messageId, label).then(value => { if (alive.current && 'tier' in value)
+        callLabel(rpc, sessionId, messageId, label).then(value => { if (alive.current && ('tier' in value || value.policy === 'policy-v2'))
             setView(value); }, () => { });
     };
+    const allocation = view.policy === 'policy-v2';
+    const chooseFeedback = (id) => {
+        setOpen(false);
+        setError('');
+        callLabel(rpc, sessionId, messageId, undefined, id === 'clear' ? null : id).then(value => { if (alive.current && value.policy === 'policy-v2')
+            setView(value); }, () => { if (alive.current)
+            setError('反馈未保存，请重试'); });
+    };
     const button = h('button', { type: 'button', className: 'amr-label-action', 'aria-label': tooltipText(view), onClick: () => setOpen(value => !value) }, h(ui.Icon));
     return h('span', null, h('style', null, CSS), h(ui.Menu, {
         open, side: 'top', portal: true, onClose: () => setOpen(false),
         // The official menu draws the check on the selected (labelled) row.
-        ...(view.label ? { selectedId: view.label } : {}),
-        items: [{ type: 'label', id: 'title', text: '这轮应该用哪档？' }, ...TIERS.map(tier => ({ id: tier, label: `${NAMES[tier]}${tier === view.tier ? ' · Jev' : ''}` }))],
-        onSelect: id => { if (TIERS.includes(id))
+        ...((allocation ? view.feedback : view.label) ? { selectedId: (allocation ? view.feedback : view.label) } : {}),
+        items: allocation ? [{ type: 'label', id: 'title', text: '这次资源分配合适吗？' }, ...Object.entries(FEEDBACK).map(([id, label]) => ({ id, label })), ...(view.feedback ? [{ id: 'clear', label: '撤销反馈' }] : [])] : [{ type: 'label', id: 'title', text: '这轮应该用哪档？' }, ...TIERS.map(tier => ({ id: tier, label: `${NAMES[tier]}${tier === view.tier ? ' · Jev' : ''}` }))],
+        onSelect: id => { if (allocation) {
+            if (Object.hasOwn(FEEDBACK, id) || id === 'clear')
+                chooseFeedback(id);
+        }
+        else if (TIERS.includes(id))
             choose(id); },
         anchor: h(ui.Tooltip, { label: tooltipText(view), side: 'bottom', children: button }),
-    }));
+    }), error && h('span', { role: 'alert' }, error));
 }

package/lib/client/settings-section.js

@@ -3,9 +3,14 @@ import { AUTO_EFFORTS, PROVIDERS } from '../settings-contract.js';
 import { selectableModels, supportedFamilyEfforts, validateChildRoute, validateFamilyMainEffort } from '../settings-validation.js';
 import { CHILD_MODELS, mapEffort, tiers } from '../effort.js';
 import { RoutePicker } from './route-picker.js';
+import { DECISION_SERVICES, resolveDecisionService } from '../decision-service.js';
+import { CATEGORY_HINTS } from '../hints.js';
+import { StrategyDetails } from './strategy-details.js';
 const CSS = `
 .amr-settings{font-size:13px;line-height:1.5;color:var(--dsw-alias-label-primary);min-width:0;container-type:inline-size}.amr-settings-section{padding:16px 0;border-bottom:.5px solid var(--dsw-alias-border-l2)}.amr-settings h3{font-size:13px;font-weight:600;margin:0 0 12px}.amr-settings p{margin:6px 0;color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere}.amr-settings-row{display:flex;align-items:center;justify-content:space-between;gap:16px;margin:14px 0}.amr-settings-row>div:first-child{min-width:0}.amr-settings-number{width:76px;text-align:right;font:inherit;font-variant-numeric:tabular-nums;border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-md);color:inherit;background:var(--dsw-alias-bg-layer-1);padding:6px}.amr-settings-number:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary)}
 .amr-settings-table{border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-lg);margin:12px 0;min-width:0}.amr-settings-tier,.amr-settings-head{display:grid;grid-template-columns:minmax(85px,.65fr) minmax(0,1fr) minmax(0,1.5fr);gap:10px;padding:12px;align-items:start}.amr-settings-tier,.amr-settings-head{border-bottom:.5px solid var(--dsw-alias-border-l2)}.amr-settings-tier:last-child{border-bottom:0}.amr-settings-head{color:var(--dsw-alias-label-secondary)}.amr-settings-tier-name{display:flex;align-items:center;gap:4px;min-height:30px}.amr-settings-info,.amr-settings-reset{border:0;background:none;color:var(--dsw-alias-label-tertiary);cursor:pointer;font:inherit;padding:2px}.amr-settings-info{display:inline-flex}.amr-settings-reset{font-size:12px;margin-top:4px}.amr-settings-reset:hover{color:var(--dsw-alias-label-primary)}.amr-settings-info:focus-visible,.amr-settings-reset:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary)}.amr-settings .amr-settings-error{color:var(--dsw-alias-state-error-primary)}.amr-settings-cell{min-width:0}.amr-settings-cell-label{display:none}.amr-settings .amr-settings-segments{display:inline-grid;flex:none;width:max-content;max-width:100%;height:28px;box-sizing:border-box;gap:2px;padding:2px;border-radius:var(--dsw-radius-md)}.amr-settings .amr-settings-segments>button{height:24px;min-width:44px;padding:0 8px;border-radius:var(--dsw-radius-sm);font-size:12px;line-height:20px}.amr-settings .amr-settings-segments>[aria-hidden=true]{top:2px;bottom:2px;left:2px;height:calc(100% - 4px);width:calc((100% - 4px - 2px * (var(--dsh-segment-count) - 1)) / var(--dsh-segment-count))}.amr-settings .amr-settings-tabs{--dsh-segment-count:2}.amr-settings .amr-settings-tabs>[aria-hidden=true]{width:calc((100% - 6px) / 2)!important;transform:translateX(calc(var(--amr-tab-index,0) * (100% + 2px)))!important}.amr-settings .amr-settings-tabs:has([aria-selected=true]:last-child){--amr-tab-index:1}
+.amr-test-row{display:flex;align-items:center;flex-wrap:wrap;gap:10px;margin:12px 0 6px}.amr-test-row>span{font-size:12px;color:var(--dsw-alias-label-secondary)}.amr-test-button{height:28px;padding:0 10px;border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-md);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;font-size:12px;cursor:pointer}.amr-test-button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.amr-test-button:disabled{opacity:.5;cursor:not-allowed}.amr-test-button:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
+.amr-service-trigger,.amr-service-input{box-sizing:border-box;min-width:0;width:240px;max-width:100%;height:32px;padding:0 10px;border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-md);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit}.amr-service-trigger{display:flex;align-items:center;justify-content:space-between;gap:12px;cursor:pointer;text-align:left}.amr-service-trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.amr-service-trigger svg{color:var(--dsw-alias-label-tertiary);flex:none}.amr-service-trigger:focus-visible,.amr-service-input:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
 @container(max-width:480px){.amr-settings-head{display:none}.amr-settings-tier{grid-template-columns:1fr;gap:8px}.amr-settings-cell{display:grid;grid-template-columns:minmax(110px,.7fr) minmax(0,1fr);align-items:center;gap:8px}.amr-settings-cell-label{display:block;color:var(--dsw-alias-label-secondary)}.amr-settings-cell p,.amr-settings-reset{grid-column:2}.amr-settings-row{flex-wrap:wrap}}
 `;
 async function request(rpc, action, payload = {}) {
@@ -24,9 +29,13 @@ export function RoutingSettings({ rpc, ui }) {
     const [patch, setPatch] = useState({});
     const [childDrafts, setChildDrafts] = useState({});
     const [provider, setProvider] = useState('claude');
+    const [serviceMenu, setServiceMenu] = useState(false);
+    const [modelMenu, setModelMenu] = useState(false);
     const [key, setKey] = useState('');
     const [removeKey, setRemoveKey] = useState(false);
     const [saving, setSaving] = useState(false);
+    const [testing, setTesting] = useState(false);
+    const [testResult, setTestResult] = useState();
     const [message, setMessage] = useState('');
     const [failed, setFailed] = useState(false);
     const [saveIssues, setSaveIssues] = useState([]);
@@ -41,6 +50,19 @@ export function RoutingSettings({ rpc, ui }) {
         return h('div', { className: 'amr-settings', role: 'status' }, message || '正在读取设置…');
     const settings = { ...view.settings, ...patch };
     const cap = settings.effortCap;
+    const serviceConfig = settings.decisionService ?? { provider: 'openrouter' };
+    const serviceProvider = serviceConfig.provider;
+    const decisionModel = serviceConfig.model ?? DECISION_SERVICES[serviceProvider].model;
+    // Preset choices are documented snapshots, not a live availability claim.
+    const decisionModels = [...new Set([...(serviceProvider === 'openrouter' ? ['typesafe/jev-1.13'] : ['jev-1.13.0', 'jev-1.14.0']), decisionModel])];
+    const changingService = serviceProvider !== (view.settings.decisionService?.provider ?? 'openrouter');
+    let invalidService = false;
+    try {
+        resolveDecisionService(serviceConfig);
+    }
+    catch {
+        invalidService = true;
+    }
     const invalidFamily = (p) => {
         const family = view.settings.mainEfforts?.[p];
         return family !== undefined && (!family || typeof family !== 'object' || Array.isArray(family) || Object.keys(family).some(key => !tiers.includes(key)));
@@ -105,7 +127,7 @@ export function RoutingSettings({ rpc, ui }) {
         let nextView = view;
         if (key || removeKey) {
             try {
-                const response = await request(rpc, 'setKey', { value: removeKey ? null : key });
+                const response = await request(rpc, 'setKey', { value: removeKey ? null : key, ...(serviceProvider !== 'openrouter' ? { provider: serviceProvider } : {}) });
                 if (response?.key)
                     nextView = { ...nextView, key: response.key };
                 setKey('');
@@ -140,8 +162,36 @@ export function RoutingSettings({ rpc, ui }) {
     const keyHint = !view.key.available ? 'DSH 凭据服务不可用。' : !view.key.writable ? '先自行保留现有 key，从启动环境（如 .env.local）删除 OPENROUTER_API_KEY 并重启，再在这里保存。' : view.key.configured ? '保存在 DSH 凭据存储，不写入设置文件；留空表示保持当前 key。' : '未配置时 AUTO 判档会停用；保存 key 后不会自动重启已停用的会话。';
     return h('div', { className: 'amr-settings' }, h('style', null, CSS), h(ui.SettingsForm, {
         labels: { unavailable: '无法读取设置', readOnly: '设置只读', saveFailed: '部分更改未保存，请检查提示', save: '保存', saving: '保存中…' },
-        state: { available: true, writable: true, dirty, invalid: conflicts.length > 0 || invalidTimeout || invalidKey, saving, failed }, onSave: () => { void save(); }, onDiscard: () => { },
-        children: h('fieldset', { disabled: saving, style: { border: 0, padding: 0, margin: 0, minWidth: 0 } }, view.configStatus === 'invalid' && h('p', { role: 'status' }, '设置文件无法解析或含无效字段，已按可解析值与默认值显示；保存会覆盖损坏部分'), message && h('p', { role: 'status', className: failed ? 'amr-settings-error' : undefined }, message), h('section', { className: 'amr-settings-section' }, h('h3', null, '判档服务'), h('p', null, 'AUTO 时每个用户回合请 Jev（经 OpenRouter）判断任务难度。'), h(ui.SettingsSecretField, { id: 'amr-key', label: 'OpenRouter API Key', hint: keyHint, text: key, disabled: saving || !view.key.available || !view.key.writable, onEdit: text => { setKey(text); setRemoveKey(false); }, configured: view.key.configured, stateLabel: keyState }), view.key.available && view.key.writable && view.key.configured && h('button', { type: 'button', className: 'amr-settings-reset', onClick: () => { setRemoveKey(!removeKey); setKey(''); } }, removeKey ? '取消删除 key' : '删除 key'), invalidKey && h('p', { className: 'amr-settings-error' }, 'API key 不能含空白，且不能超过 512 字符'), h('div', { className: 'amr-settings-row' }, h('div', null, h('label', { htmlFor: 'amr-timeout' }, '判档等待上限'), h('p', null, '1000–4500 毫秒；超时后该会话停用 AUTO。')), h('span', null, h('input', { id: 'amr-timeout', type: 'number', className: 'amr-settings-number', min: 1000, max: 4500, step: 1, value: Number.isNaN(settings.jevTimeoutMs) ? '' : settings.jevTimeoutMs, 'aria-invalid': invalidTimeout, onChange: e => setPatch(old => ({ ...old, jevTimeoutMs: e.currentTarget.value === '' ? NaN : Number(e.currentTarget.value) })) }), ' 毫秒'))), h('section', { className: 'amr-settings-section' }, h('h3', null, '会话'), h('div', { className: 'amr-settings-row' }, h('div', null, '新会话默认模式', h('p', null, settings.defaultMode === 'AUTO' ? '仅影响新会话；每个用户回合都会把消息发送给 OpenRouter/TypeSafe 请求 Jev。' : '仅影响新会话，不改变已有会话。')), h(ui.SegmentedControl, { id: 'amr-default-mode', className: 'amr-settings-segments', label: '新会话默认模式', value: settings.defaultMode, options: [{ value: 'MANUAL', label: 'MANUAL' }, { value: 'AUTO', label: 'AUTO' }], onChange: value => setPatch(old => ({ ...old, defaultMode: value })) })), h('div', { className: 'amr-settings-row' }, h('span', null, '判档提示'), h(ui.Switch, { checked: settings.decisionToast, label: '判档提示', onChange: value => setPatch(old => ({ ...old, decisionToast: value })) })), h('div', { className: 'amr-settings-row' }, h('span', null, '推理强度上限'), h(ui.SegmentedControl, { id: 'amr-cap', className: 'amr-settings-segments', label: '推理强度上限', value: cap, options: AUTO_EFFORTS.map(value => ({ value, label: value })), onChange: value => setPatch(old => ({ ...old, effortCap: value })) }))), h('section', { className: 'amr-settings-section' }, h('h3', null, '路由映射'), h(ui.SegmentedTabs, { className: 'amr-settings-segments amr-settings-tabs', label: '模型体系', value: provider, items: [{ value: 'claude', label: 'Claude', id: 'amr-tab-claude', panelId: 'amr-panel-claude' }, { value: 'codex', label: 'GPT', id: 'amr-tab-codex', panelId: 'amr-panel-codex' }], onChange: value => setProvider(value) }), h('div', { role: 'tabpanel', id: `amr-panel-${provider}`, 'aria-labelledby': `amr-tab-${provider}` }, h('p', null, '主会话推理等级适用于本体系所有模型；默认随实际模型计算。可选覆盖值为当前体系模型共同支持且不超过上限的等级。'), !supportedFamilyEfforts(view, provider, cap).length && h('p', { role: 'status' }, '当前体系没有共同支持且不超过上限的推理等级；主会话覆盖暂不可选，可恢复默认。'), familyUnresolved(provider) && h('p', { className: 'amr-settings-error', role: 'status' }, '主会话映射格式无效（含旧版按模型配置），不会按默认值执行。请重新配置或', h('button', { type: 'button', className: 'amr-settings-reset', onClick: () => setPatch(old => ({ ...old, mainEfforts: { ...old.mainEfforts, [provider]: null } })) }, '恢复本体系默认值')), h('p', null, '主会话保留当前模型，只调 effort；子会话在 route_subagent 判档后返回推荐 model + effort，不改既有子会话、不决定是否派发。'), view.childAllowlist.status !== 'enabled' || !selectableModels(view, provider, 'child').length ? h('p', { role: 'status' }, view.childAllowlist.status === 'unavailable' ? '无法读取子智能体允许列表；请检查官方子智能体设置。' : '请在官方子智能体设置启用并配置允许列表。') : null, h('div', { className: 'amr-settings-table' }, h('div', { className: 'amr-settings-head', 'aria-hidden': true }, h('span', null, '档位'), h('span', null, '主会话推理等级'), h('span', null, '子会话推荐')), ...tiers.map(tier => {
+        state: { available: true, writable: true, dirty, invalid: conflicts.length > 0 || invalidTimeout || invalidKey || invalidService, saving, failed }, onSave: () => { void save(); }, onDiscard: () => { },
+        children: h('fieldset', { disabled: saving || testing, style: { border: 0, padding: 0, margin: 0, minWidth: 0 } }, view.configStatus === 'invalid' && h('p', { role: 'status' }, '设置文件无法解析或含无效字段，已按可解析值与默认值显示；保存会覆盖损坏部分'), message && h('p', { role: 'status', className: failed ? 'amr-settings-error' : undefined }, message), h('section', { className: 'amr-settings-section' }, h('h3', null, '判档服务'), h('p', null, 'AUTO 把脱敏任务发送给所选决策服务；不跨服务自动回退。'), h('div', { className: 'amr-settings-row' }, h('span', null, '决策服务'), h(ui.Menu, { open: serviceMenu, portal: true, side: 'bottom', selectedId: serviceProvider, onClose: () => setServiceMenu(false),
+            items: Object.entries(DECISION_SERVICES).map(([id, service]) => ({ id, label: service.label })),
+            onSelect: id => { if (!Object.hasOwn(DECISION_SERVICES, id))
+                return; setKey(''); setRemoveKey(false); setPatch(old => ({ ...old, decisionService: { provider: id } })); setServiceMenu(false); },
+            anchor: h('button', { type: 'button', className: 'amr-service-trigger', 'aria-label': '决策服务', 'aria-haspopup': 'menu', 'aria-expanded': serviceMenu, onClick: () => setServiceMenu(!serviceMenu) }, h('span', null, DECISION_SERVICES[serviceProvider].label), h(ui.IconChevronDownOutlineRegular, { size: 14 })), })), h('p', null, changingService ? '切换服务后先保存，再管理该服务的独立 API key；不会沿用原服务的 key。' : `凭据引用：${DECISION_SERVICES[serviceProvider].credential}`), h('div', { className: 'amr-settings-row' }, h('span', null, '决策模型'), serviceProvider === 'custom'
+            ? h('input', { className: 'amr-service-input', 'aria-label': '决策模型', value: decisionModel, onChange: e => setPatch(old => ({ ...old, decisionService: { ...serviceConfig, model: e.currentTarget.value } })) })
+            : h(ui.Menu, { open: modelMenu, portal: true, side: 'bottom', selectedId: decisionModel, onClose: () => setModelMenu(false),
+                items: decisionModels.map(id => ({ id, label: id })),
+                onSelect: model => { if (!decisionModels.includes(model))
+                    return; setPatch(old => ({ ...old, decisionService: { ...serviceConfig, model } })); setModelMenu(false); },
+                anchor: h('button', { type: 'button', className: 'amr-service-trigger', 'aria-label': '决策模型', 'aria-haspopup': 'menu', 'aria-expanded': modelMenu, onClick: () => setModelMenu(!modelMenu) }, h('span', null, decisionModel), h(ui.IconChevronDownOutlineRegular, { size: 14 })),
+            })), serviceProvider === 'custom' && h('label', { className: 'amr-settings-row' }, '兼容端点 ', h('input', { className: 'amr-service-input', 'aria-label': '兼容端点', value: serviceConfig.endpoint ?? '', placeholder: 'https://example.com/v1/systemone', onChange: e => setPatch(old => ({ ...old, decisionService: { ...serviceConfig, endpoint: e.currentTarget.value } })) })), h('p', null, serviceProvider === 'custom' ? '仅兼容 System One state/questions → answers；HTTPS 或回环 HTTP；禁止 URL 凭据、查询参数与重定向。' : `接口：${DECISION_SERVICES[serviceProvider].endpoint}`), h('div', { className: 'amr-test-row' }, h('button', { type: 'button', className: 'amr-test-button', disabled: dirty || saving || testing, 'aria-busy': testing, onClick: async () => {
+                if (testing)
+                    return;
+                setTesting(true);
+                setTestResult(undefined);
+                try {
+                    const r = await rpc.call('/api', 'auto-model-routing.testDecision', {});
+                    const v = r.value;
+                    const ok = r.ok && v?.kind === 'ok';
+                    setTestResult({ failed: !ok, text: ok ? `连接成功 · ${v.ms} ms` : `连接失败：${v?.category ? CATEGORY_HINTS[v.category] ?? '服务不可用' : '无法连接决策服务，请重试'}` });
+                }
+                catch {
+                    setTestResult({ failed: true, text: '连接测试失败，请检查网络后重试' });
+                }
+                finally {
+                    setTesting(false);
+                }
+            } }, testing ? '测试中…' : '测试连接'), h('span', { role: 'status', 'aria-live': 'polite', className: testResult?.failed ? 'amr-settings-error' : undefined }, testing ? '正在请求所选决策服务…' : testResult?.text ?? (dirty ? '请先保存设置，再测试连接' : ''))), h('p', null, '测试会产生一次决策请求，不包含会话内容；请先保存设置。'), invalidService && h('p', { role: 'alert', className: 'amr-settings-error' }, '请填写有效模型和兼容端点'), h(ui.SettingsSecretField, { id: 'amr-key', label: `${DECISION_SERVICES[serviceProvider].label} API Key`, hint: changingService ? '请先保存服务选择' : keyHint, text: key, disabled: changingService || saving || !view.key.available || !view.key.writable, onEdit: text => { setKey(text); setRemoveKey(false); }, configured: !changingService && view.key.configured, stateLabel: changingService ? '保存后读取' : keyState }), !changingService && view.key.available && view.key.writable && view.key.configured && h('button', { type: 'button', className: 'amr-settings-reset', onClick: () => { setRemoveKey(!removeKey); setKey(''); } }, removeKey ? '取消删除 key' : '删除 key'), invalidKey && h('p', { className: 'amr-settings-error' }, 'API key 不能含空白，且不能超过 512 字符'), h('div', { className: 'amr-settings-row' }, h('div', null, h('label', { htmlFor: 'amr-timeout' }, '判档等待上限'), h('p', null, '1000–4500 毫秒；超时后该会话停用 AUTO。')), h('span', null, h('input', { id: 'amr-timeout', type: 'number', className: 'amr-settings-number', min: 1000, max: 4500, step: 1, value: Number.isNaN(settings.jevTimeoutMs) ? '' : settings.jevTimeoutMs, 'aria-invalid': invalidTimeout, onChange: e => setPatch(old => ({ ...old, jevTimeoutMs: e.currentTarget.value === '' ? NaN : Number(e.currentTarget.value) })) }), ' 毫秒'))), h('section', { className: 'amr-settings-section' }, h('h3', null, '会话'), h('p', { role: 'status' }, settings.policy === 'legacy' ? '当前使用旧策略回滚配置。' : 'AUTO 已使用新策略，无需额外启用。主模型不变；子任务独立选择模型能力与推理投入，并在创建时应用。MANUAL 不进行自动判档。'), h('div', { className: 'amr-settings-row' }, h('div', null, '新会话默认模式', h('p', null, settings.defaultMode === 'AUTO' ? '仅影响新会话；每个用户回合都会把脱敏任务发送给所选决策服务请求 Jev。' : '仅影响新会话，不改变已有会话。')), h(ui.SegmentedControl, { id: 'amr-default-mode', className: 'amr-settings-segments', label: '新会话默认模式', value: settings.defaultMode, options: [{ value: 'MANUAL', label: 'MANUAL' }, { value: 'AUTO', label: 'AUTO' }], onChange: value => setPatch(old => ({ ...old, defaultMode: value })) })), h('div', { className: 'amr-settings-row' }, h('span', null, '判档提示'), h(ui.Switch, { checked: settings.decisionToast, label: '判档提示', onChange: value => setPatch(old => ({ ...old, decisionToast: value })) })), h('div', { className: 'amr-settings-row' }, h('span', null, '推理强度上限'), h(ui.SegmentedControl, { id: 'amr-cap', className: 'amr-settings-segments', label: '推理强度上限', value: cap, options: AUTO_EFFORTS.map(value => ({ value, label: value })), onChange: value => setPatch(old => ({ ...old, effortCap: value })) }))), settings.policy !== 'legacy' && h('section', { className: 'amr-settings-section' }, h('h3', null, '自动选配'), h('p', null, '主会话仅调整推理投入；子任务按目标与范围选择合适的能力档，再确定投入。保留显式指定的模型和推理等级，不自动重试或升级。'), h('p', null, 'Magpie 使用完整模型 ID 与官方允许列表；目录不可用或目标不清楚时停止并提示。fresh 子任务受支持，fork 暂不支持。旧四档配置保留供回滚，不参与当前策略。'), h(StrategyDetails)), settings.policy === 'legacy' && h('section', { className: 'amr-settings-section' }, h('h3', null, '路由映射'), h(ui.SegmentedTabs, { className: 'amr-settings-segments amr-settings-tabs', label: '模型体系', value: provider, items: [{ value: 'claude', label: 'Claude', id: 'amr-tab-claude', panelId: 'amr-panel-claude' }, { value: 'codex', label: 'GPT', id: 'amr-tab-codex', panelId: 'amr-panel-codex' }], onChange: value => setProvider(value) }), h('div', { role: 'tabpanel', id: `amr-panel-${provider}`, 'aria-labelledby': `amr-tab-${provider}` }, h('p', null, '主会话推理等级适用于本体系所有模型；默认随实际模型计算。可选覆盖值为当前体系模型共同支持且不超过上限的等级。'), !supportedFamilyEfforts(view, provider, cap).length && h('p', { role: 'status' }, '当前体系没有共同支持且不超过上限的推理等级；主会话覆盖暂不可选，可恢复默认。'), familyUnresolved(provider) && h('p', { className: 'amr-settings-error', role: 'status' }, '主会话映射格式无效（含旧版按模型配置），不会按默认值执行。请重新配置或', h('button', { type: 'button', className: 'amr-settings-reset', onClick: () => setPatch(old => ({ ...old, mainEfforts: { ...old.mainEfforts, [provider]: null } })) }, '恢复本体系默认值')), h('p', null, '主会话保留当前模型，只调 effort；子会话在 route_subagent 判档后返回推荐 model + effort，不改既有子会话、不决定是否派发。'), view.childAllowlist.status !== 'enabled' || !selectableModels(view, provider, 'child').length ? h('p', { role: 'status' }, view.childAllowlist.status === 'unavailable' ? '无法读取子智能体允许列表；请检查官方子智能体设置。' : '请在官方子智能体设置启用并配置允许列表。') : null, h('div', { className: 'amr-settings-table' }, h('div', { className: 'amr-settings-head', 'aria-hidden': true }, h('span', null, '档位'), h('span', null, '主会话推理等级'), h('span', null, '子会话推荐')), ...tiers.map(tier => {
             const effort = mainValue(provider, tier);
             return h('div', { key: tier, className: 'amr-settings-tier', 'data-tier': tier }, h('div', { className: 'amr-settings-tier-name' }, tier, h(ui.Tooltip, { label: view.criteria[tier], side: 'top', portal: true, children: h('button', { type: 'button', className: 'amr-settings-info', 'aria-label': `${tier} 判档标准`, onFocus: () => { } }, h(ui.IconInfoOutlineRegular, { size: 14 })) })), cell('主会话推理等级', h(RoutePicker, { ui, catalog: view, provider, cap, mode: 'effort', label: `${tier} 主会话推理等级`, value: { model: '', reasoningEffort: effort === undefined ? undefined : typeof effort === 'string' ? effort : '无效配置' }, invalid: familyUnresolved(provider), disabled: saving, onChange: value => setMain(tier, value.reasoningEffort) }), mainExplicit(provider, tier), () => setMain(tier, null), issueText(`mainEfforts.${provider}.${tier}`)), cell('子会话推荐', h(RoutePicker, { ui, catalog: view, provider, cap, label: `${tier} 子会话推荐`, value: childValue(provider, tier), disabled: saving || !selectableModels(view, provider, 'child').length, onChange: value => setChild(tier, value) }), childExplicit(provider, tier), () => setChild(tier, null), issueText(`childRoutes.${provider}.${tier}`)));
         })), h('p', null, '官方允许列表是会话创建时的快照；已有会话仍可能拒绝新配置的推荐。'))), ...conflicts.filter(issue => !issue.path.startsWith(`childRoutes.${provider}.`) && !issue.path.startsWith(`mainEfforts.${provider}.`)).map(issue => h('p', { key: issue.path, role: 'status', className: 'amr-settings-error' }, `${issue.path}：${issue.message}`))),

package/lib/client/settings-ui.d.ts

@@ -1,3 +1,3 @@
 import type * as Primitives from '@deepseek-ai/dsh-client-ui-primitives';
 /** Shell-owned primitives are injected so DOM tests exercise draft behavior independently. */
-export type SettingsUi = Pick<typeof Primitives, 'SettingsForm' | 'SettingsSecretField' | 'SegmentedTabs' | 'SegmentedControl' | 'Switch' | 'Tag' | 'Tooltip' | 'IconInfoOutlineRegular' | 'IconChevronDownOutlineRegular' | 'IconChevronLeftOutlineRegular' | 'IconChevronRightOutlineRegular' | 'IconCheckOutlineRegular' | 'MenuSurface' | 'MenuGroup' | 'useAnchoredPosition' | 'focusWithoutRing'>;
+export type SettingsUi = Pick<typeof Primitives, 'Menu' | 'SettingsForm' | 'SettingsSecretField' | 'SegmentedTabs' | 'SegmentedControl' | 'Switch' | 'Tag' | 'Tooltip' | 'IconInfoOutlineRegular' | 'IconChevronDownOutlineRegular' | 'IconChevronLeftOutlineRegular' | 'IconChevronRightOutlineRegular' | 'IconCheckOutlineRegular' | 'MenuSurface' | 'MenuGroup' | 'useAnchoredPosition' | 'focusWithoutRing'>;

package/lib/client/strategy-details.d.ts

@@ -0,0 +1,4 @@
+/** Read-only: criteria and slots are imported from the executable policy, never copied. */
+export declare function StrategyDetails(): import("react").DetailedReactHTMLElement<{
+    className: string;
+}, HTMLElement>;