@dsh-plugins/dsh-llm-hub 1.5.4 → 1.5.6

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [1.5.6] - 2026-09-27
+
+### 📛 包装升级：首屏补齐居中标题 + 接入 README 门禁
+
+- 新增 `<h1 align="center">` 居中标题与双语 slogan
+- 8 个徽章从 `flat-square` 换成 `for-the-badge`
+- 新增 `scripts/readme-gate.mjs`，挂在 `prepublishOnly` 上
+  - 真源：`cs rule open_source_project_baseline`（README 首屏金字塔）
+  - 4 条契约：居中品牌 / `for-the-badge` 徽章 / 前 80 行有 Why This 对比表 / 有 `README.en.md`
+  - 逃生舱：`README_GATE=off`（仅限明确不需要包装的内部包）
+
+### 🛣️ 智能路由：`routableStateFor` 把"探测表里没记录"细分成 unknown / unavailable
+
+之前一刀切返回 `unavailable`，导致**冷启动 / 用户刚加 provider / 探针刚清空**时被路由跳过，
+即便 settings 里有配、key 也填了，照样不让 smart 接管。典型踩坑：zai-coding-cn 这类
+无 baseURL 的 provider，第一次请求时被 `routableStateFor` 当 unavailable 跳过去。
+
+新语义（`lib/index.js:2554-2580`）：
+
+- 探测表里有 verdict → 用 verdict.state（available / unknown / unavailable）
+- 探测表里没有 + settings 里**有**配 → `unknown`（routable，请求撞真上游，撞完探针补 verdict）
+- 探测表里没有 + settings 里**没**配 → `unavailable`（真不认识，撞 NO_ADAPTER，fail-open）
+
+测试新增 1 条（`pickSmartRoute：未探测（unknown）且候选里 → 仍接管`），全 132 项过。
+
+## [1.5.5] - 2026-09-27
+
+### 🪧 路由卡：每条候选的能力 chip（思考 + 多模态）
+
+之前 routing 卡里只把「多模态」用一个 `👁` emoji 标在 model id 后面，**思考档位完全没标** —— 用户必须查文档才能知道这个模型能思考、能用哪些 effort。这一版把这条缝上：
+
+- **`routingCatalogOf()`**（`lib/index.js:2789`）每个 model 多带一条 `reasoning: { levels: [{ id, name }, …] } | null`，从 settings 的 `reasoningEfforts` 抽出；键名是人话（`off` / `low` / `high` / `max`），值是适配器认的 effort id，`null` 值的档位（强制思考、不能关的 `off`）不进 chip 文本。
+- **`routing card`**（`lib/client.js` RoutingCard）：
+  - 每个候选后面追加两枚 chip（仅在能力存在时出现）：`💭 思考 low/high/max`、`👁 图像`；思考档位 >3 个时折成 `low/medium/high+2`。
+  - 多模态 chip 之前是裸 emoji，现在与思考 chip 共用一套样式（`.dsh-llm-hub-routing__reasoning / __multimodal`），按 `state-info` / `state-success` 主题色上边框 —— 一眼分得清「能干什么」。
+  - 添加候选的下拉 `<option>` 同步带 `💭 … 👁` 后缀（同一 catalog 数据源）。
+- **i18n**：`routeMultimodalShort` / `routeReasoningShort` / `routeReasoningTip` 加进 zh + en；思考档位的 tooltip 列出 `name → id` 的映射，方便排查 `off: null` 之类的「明明配置了 off 却不能用」的情况。
+- **测试**：`test/client-cards.test.mjs` 的多模态 chip 用例改成查新类名（`dsh-llm-hub-routing__multimodal`），`node --test` 131 项全过。
+
+数据真源仍是 settings —— 不打网关、不改路由逻辑，只是把已经在那儿的事实亮出来。
+
 ## [1.5.4] - 2026-09-27
 
 ### 🛡️ 智能路由接管的两处加固（1.5.0 的补丁）

package/README.md

@@ -2,18 +2,25 @@
   <img src="https://img.webkubor.online/oss/dsh-llm-hub/banner.png" alt="dsh-llm-hub" width="100%" />
 </p>
 
+
+<h1 align="center">🔌 dsh-llm-hub</h1>
+
+<p align="center">
+  <strong>给 DSH 模型页补上官方适配器缺的那半。</strong><br/>
+  <sub>Gateway health, model catalog, balance — the half the built-in adapter leaves out.</sub>
+</p>
 <p align="center">
-  <a href="https://www.npmjs.com/package/@dsh-plugins/dsh-llm-hub"><img src="https://img.shields.io/npm/v/%40dsh-plugins%2Fdsh-llm-hub?style=flat-square&color=4C7EF3&logo=npm&label=npm" alt="npm" /></a>
-  <a href="https://www.npmjs.com/package/@dsh-plugins/dsh-llm-hub"><img src="https://img.shields.io/npm/dm/%40dsh-plugins%2Fdsh-llm-hub?style=flat-square&color=6d7f9c&label=downloads" alt="downloads" /></a>
-  <img src="https://img.shields.io/badge/DSH-%E2%89%A50.1.1--rc.2-4d6bfe?style=flat-square" alt="DSH" />
-  <img src="https://img.shields.io/badge/runtime_deps-0-5A9E6F?style=flat-square" alt="zero deps" />
-  <img src="https://img.shields.io/badge/license-MIT-777?style=flat-square" alt="MIT" />
+  <a href="https://www.npmjs.com/package/@dsh-plugins/dsh-llm-hub"><img src="https://img.shields.io/npm/v/%40dsh-plugins%2Fdsh-llm-hub?style=for-the-badge&color=4C7EF3&logo=npm&label=npm" alt="npm" /></a>
+  <a href="https://www.npmjs.com/package/@dsh-plugins/dsh-llm-hub"><img src="https://img.shields.io/npm/dm/%40dsh-plugins%2Fdsh-llm-hub?style=for-the-badge&color=6d7f9c&label=downloads" alt="downloads" /></a>
+  <img src="https://img.shields.io/badge/DSH-%E2%89%A50.1.1--rc.2-4d6bfe?style=for-the-badge" alt="DSH" />
+  <img src="https://img.shields.io/badge/runtime_deps-0-5A9E6F?style=for-the-badge" alt="zero deps" />
+  <img src="https://img.shields.io/badge/license-MIT-777?style=for-the-badge" alt="MIT" />
 </p>
 
 <p align="center">
-  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek_Harness-Plugin-4d6bfe?style=flat-square" alt="DSH Plugin" /></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-4d6bfe?style=flat-square" alt="dsh-plugin" /></a>
-  <a href="https://github.com/topics/llm-gateway"><img src="https://img.shields.io/badge/topic-llm--gateway-4C7EF3?style=flat-square" alt="llm-gateway" /></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek_Harness-Plugin-4d6bfe?style=for-the-badge" alt="DSH Plugin" /></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-4d6bfe?style=for-the-badge" alt="dsh-plugin" /></a>
+  <a href="https://github.com/topics/llm-gateway"><img src="https://img.shields.io/badge/topic-llm--gateway-4C7EF3?style=for-the-badge" alt="llm-gateway" /></a>
   &nbsp;·&nbsp; <a href="README.en.md">English</a> · <a href="CHANGELOG.md">更新日志</a>
 </p>
 

package/lib/client.js

@@ -77,6 +77,10 @@ window.__ModuleLoader__.load({
 		const ROUTING_STATE_URL = '/api/dsh-llm-hub/routing/state'
 		/** 路由组切换：POST { mode?, activeGroup? }，持久化进 settings。 */
 		const ROUTING_SELECT_URL = '/api/dsh-llm-hub/routing/select'
+		/** 可路由目录：settings 里已配置的 provider 与模型（离线读，不打网关）。 */
+		const ROUTING_CATALOG_URL = '/api/dsh-llm-hub/routing/catalog'
+		/** 路由组编辑保存：POST { groups, mode?, activeGroup? }。 */
+		const ROUTING_CONFIG_URL = '/api/dsh-llm-hub/routing/config'
 		/** 模型别名：把长 id 显示成短名（人话）。 */
 		const ALIASES_URL = '/api/dsh-llm-hub/aliases'
 		const BILLING_MODE_URL = '/api/dsh-llm-hub/billing-mode'
@@ -172,6 +176,34 @@ window.__ModuleLoader__.load({
 				routeChipLastRoute: '最近实际',
 				routeChipReasonNone: '候选全部不可用',
 				routeChipFailOpen: '路由失败时按原配置发出',
+				routeRuleTitle: '规则',
+				routeRuleText: '按组内顺序取第一个可用；探测失败或额度耗尽的自动跳过；全不可用则保持原样（fail-open）。顺序即优先级 —— 固定成本（包月/订阅）放前面，按量付费放后面兜底。',
+				routeSmartNotice: '已接管：输入框的模型下拉只作参考，实际请求按本卡规则走（实时结果见聊天框左侧 chip）。',
+				routeManualNotice: '未接管：请求还是用你在模型下拉里选的；点「智能路由」才按本卡规则自动切。',
+				routeEditHint: '编辑后点保存写入 settings.dsh-llm-hub.routing',
+				routeSave: '保存',
+				routeSaved: '已保存',
+				routeSaveFailed: '保存失败',
+				routeAddCandidate: '+ 添加候选',
+				routeAddProvider: '提供方',
+				routeAddModel: '模型',
+				routeAdd: '添加',
+				routeNewGroup: '+ 新建组',
+				routeDeleteGroup: '删除该组',
+				routeUp: '上移',
+				routeDown: '下移',
+				routeRemove: '移除',
+				routeGroupLabelPlaceholder: '组名（公司 / 个人）',
+				routeActiveTag: '当前组',
+				routeSetActive: '设为当前组',
+				routePrimaryTag: '主力',
+				routeFallbackTag: '备',
+				routeNoCatalog: '读不到 provider 目录 —— 先在设置里配好 provider 再来加候选',
+				routeDropped: '有配置被忽略',
+				routeMultimodalTip: '多模态：输入含图像等非文本模态（来自 settings 的模态声明）',
+				routeMultimodalShort: '图像',
+				routeReasoningTip: '思考链：该模型声明的推理档位（来自 settings 的 reasoningEfforts）',
+				routeReasoningShort: '思考',
 				aliasesMissing: '尚未配置别名',
 				heroTitle: 'LLM 矩阵概览',
 				heroProviders: '活跃提供方',
@@ -296,6 +328,34 @@ window.__ModuleLoader__.load({
 				routeChipLastRoute: 'Last used',
 				routeChipReasonNone: 'All candidates unavailable',
 				routeChipFailOpen: 'Falls back to your selection when routing fails',
+				routeRuleTitle: 'Rule',
+				routeRuleText: 'First usable candidate in group order wins; failed probes and exhausted quotas are skipped; if none is usable the original selection is kept (fail-open). Order is priority — fixed-cost plans first, metered pay-as-you-go last.',
+				routeSmartNotice: 'Takeover is on: the composer model dropdown is only a reference; requests follow this card (live result shows in the chip beside the composer).',
+				routeManualNotice: 'Not taking over: requests still use the model you picked in the dropdown. Switch to Smart routing to auto-select.',
+				routeEditHint: 'Save writes settings.dsh-llm-hub.routing',
+				routeSave: 'Save',
+				routeSaved: 'Saved',
+				routeSaveFailed: 'Save failed',
+				routeAddCandidate: '+ Add candidate',
+				routeAddProvider: 'Provider',
+				routeAddModel: 'Model',
+				routeAdd: 'Add',
+				routeNewGroup: '+ New group',
+				routeDeleteGroup: 'Delete group',
+				routeUp: 'Move up',
+				routeDown: 'Move down',
+				routeRemove: 'Remove',
+				routeGroupLabelPlaceholder: 'Group name (work / personal)',
+				routeActiveTag: 'active',
+				routeSetActive: 'Set active',
+				routePrimaryTag: 'primary',
+				routeFallbackTag: 'alt',
+				routeNoCatalog: 'No provider directory — configure a provider first',
+				routeDropped: 'Some entries ignored',
+				routeMultimodalTip: 'Multimodal: accepts non-text input such as images (from the modality declared in settings)',
+				routeMultimodalShort: 'vision',
+				routeReasoningTip: 'Reasoning chain: effort levels declared by this model (from settings.reasoningEfforts)',
+				routeReasoningShort: 'think',
 				aliasesMissing: 'no aliases configured',
 				heroTitle: 'LLM Matrix Overview',
 				heroProviders: 'Active providers',
@@ -537,6 +597,21 @@ window.__ModuleLoader__.load({
 				'border-radius:3px;border:.5px solid var(--dsw-alias-border-l2);',
 				'background:transparent;font-size:10px;color:var(--dsw-alias-label-secondary)}',
 				'.dsh-llm-hub-routing__name{color:var(--dsw-alias-label-primary);font-weight:600}',
+				// capability 标识：思考 / 多模态。两枚 chip 同形，左思考、右图像；
+				// 边色走 state 提示色，跟健康状态 chip 区分开 —— 一个说「能干什么」，
+				// 一个说「能不能用」。
+				'.dsh-llm-hub-routing__reasoning,.dsh-llm-hub-routing__multimodal{',
+				'display:inline-flex;align-items:center;height:16px;padding:0 6px;',
+				'border-radius:3px;font-size:10px;line-height:14px;font-weight:500;',
+				'background:transparent;cursor:help}',
+				// 思考：走 warn 主题色（消耗更多 token、需要警觉）
+				'.dsh-llm-hub-routing__reasoning{',
+				'border:.5px solid var(--dsw-alias-state-warn-primary);',
+				'color:var(--dsw-alias-state-warn-primary)}',
+				// 多模态：走 success 主题色（输入更丰富 = 好）
+				'.dsh-llm-hub-routing__multimodal{',
+				'border:.5px solid var(--dsw-alias-state-success-primary);',
+				'color:var(--dsw-alias-state-success-primary)}',
 				'.dsh-llm-hub-routing__suggestion{color:var(--dsw-alias-state-warn-primary);padding-top:2px}',
 				'.dsh-llm-hub-routing__reason{color:var(--dsw-alias-state-error-primary);padding-top:2px}',
 				// composer 快切 chip（conversation.input.left）
@@ -567,6 +642,30 @@ window.__ModuleLoader__.load({
 				'.dsh-llm-hub-route__group-name{font-weight:600;font-size:11px}',
 				'.dsh-llm-hub-route__state{font-size:10px;color:var(--dsw-alias-label-secondary);max-width:150px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
 				'.dsh-llm-hub-route__hint{font-size:10px;color:var(--dsw-alias-label-tertiary)}',
+				'.dsh-llm-hub-route__order{font-size:10px;color:var(--dsw-alias-label-secondary);',
+				'font-family:ui-monospace,SFMono-Regular,monospace;word-break:break-all;line-height:1.4}',
+				// 智能路由编辑器（设置页路由卡）
+				'.dsh-llm-hub-routing__modes{display:flex;gap:4px;margin-left:auto}',
+				'.dsh-llm-hub-routing__rule{display:flex;gap:6px;align-items:flex-start;font-size:10.5px;line-height:1.5;',
+				'color:var(--dsw-alias-label-secondary);padding:6px 8px;border-radius:6px;background:var(--dsw-alias-bg-layer-2)}',
+				'.dsh-llm-hub-routing__rule-tag{flex:none;font-weight:600;color:var(--dsw-alias-label-primary)}',
+				'.dsh-llm-hub-routing__now{font-size:11px;color:var(--dsw-alias-label-primary);font-weight:600}',
+				'.dsh-llm-hub-routing__groups{display:flex;flex-direction:column;gap:6px;margin-top:8px}',
+				'.dsh-llm-hub-routing__group{border:.5px solid var(--dsw-alias-border-l1);border-radius:6px;padding:6px 8px;display:flex;flex-direction:column;gap:5px}',
+				'.dsh-llm-hub-routing__group.is-active{border-color:var(--dsw-alias-state-warn-primary)}',
+				'.dsh-llm-hub-routing__group-top{display:flex;align-items:center;gap:6px;flex-wrap:wrap}',
+				'.dsh-llm-hub-routing__group-toggle{border:0;background:0 0;padding:0;cursor:pointer;font:inherit;font-size:11px;color:var(--dsw-alias-label-secondary)}',
+				'.dsh-llm-hub-routing__group-label{flex:1;min-width:110px;box-sizing:border-box;height:22px;padding:0 6px;border-radius:4px;',
+				'border:.5px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:inherit;font-size:11px}',
+				'.dsh-llm-hub-routing__group-state{font-size:10.5px;color:var(--dsw-alias-label-secondary);max-width:210px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+				'.dsh-llm-hub-routing__candidates{display:flex;flex-direction:column;gap:3px;padding-top:2px}',
+				'.dsh-llm-hub-routing__add{display:flex;align-items:center;gap:5px;flex-wrap:wrap;font-size:10.5px;color:var(--dsw-alias-label-secondary);padding-top:4px}',
+				'.dsh-llm-hub-routing__select{box-sizing:border-box;height:22px;padding:0 4px;border-radius:4px;border:.5px solid var(--dsw-alias-border-l1);',
+				'background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:inherit;font-size:11px;max-width:170px}',
+				'.dsh-llm-hub-routing__actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding-top:6px;border-top:.5px solid var(--dsw-alias-border-l1);margin-top:8px}',
+				'.dsh-llm-hub-routing__hint{font-size:10px;color:var(--dsw-alias-label-tertiary)}',
+				'.dsh-llm-hub-routing__mm{display:inline-flex;align-items:center;margin-left:4px;font-size:10px;cursor:help;',
+				'color:var(--dsw-alias-state-success-primary,#10b981)}',
 				// Hero 全景统计大横条
 				'.dsh-llm-hub-hero{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:6px;margin:12px 0 6px 0}',
 				'.dsh-llm-hub-hero__card{display:flex;flex-direction:column;gap:2px;padding:8px 10px;border-radius:6px;border:.5px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2,rgba(255,255,255,.02));backdrop-filter:blur(6px)}',
@@ -1649,7 +1748,15 @@ window.__ModuleLoader__.load({
 				},
 					h('span', { className: 'dsh-llm-hub-route__group-top' },
 						h('span', { className: 'dsh-llm-hub-route__group-name' }, group.label ?? group.id),
-						h('span', { className: 'dsh-llm-hub-route__state' }, stateText(group)))))) : null
+						h('span', { className: 'dsh-llm-hub-route__state' }, stateText(group))),
+					// 顺序即优先级：把候选按组内顺序摊出来（① = 主力），让人一眼看到
+					// 「智能」到底怎么个智能法，而不是只有一个 wouldRoute 结果。
+					h('span', { className: 'dsh-llm-hub-route__order' },
+						(group.candidates ?? []).map((candidate, index) => `${index === 0 ? '①' : index === 1 ? '②' : index === 2 ? '③' : `(${index + 1})`}${candidate.provider}/${candidate.model}${candidate.state === 'unavailable' ? '✗' : ''}`).join(' → ')),
+					group.reason !== null && group.reason !== undefined && group.wouldRoute === null
+						? h('span', { className: 'dsh-llm-hub-route__hint' }, group.reason)
+						: null)),
+				h('div', { className: 'dsh-llm-hub-route__hint' }, t('routeRuleText'))) : null
 			return h('div', { className: 'dsh-llm-hub-route' },
 				h('button', {
 					type: 'button',
@@ -1685,56 +1792,314 @@ window.__ModuleLoader__.load({
 		 */
 		function RoutingCard(props) {
 			const t = typeof props.t === 'function' ? props.t : fallbackT
-			const [report, setReport] = React.useState(null)
-			const query = React.useCallback((active) => {
-				fetch(ROUTING_URL, {
-					method: 'POST',
-					headers: { 'content-type': 'application/json', accept: 'application/json' },
-					body: JSON.stringify({ active: typeof active === 'string' && active.length > 0 ? active : null })
-				})
-					.then((res) => res.json())
-					.then((body) => { setReport(body !== null && typeof body === 'object' ? body : null) })
-					.catch(() => setReport(null))
+			const [state, setState] = React.useState(null)
+			const [catalog, setCatalog] = React.useState([])
+			// draft 是编辑器的工作副本：[{ id, label, candidates: [{provider, model}] }]，
+			// candidates[0] = 主力（primary），其余是 fallback —— 与 settings 形态一一对应。
+			const [draft, setDraft] = React.useState(null)
+			const [activeGroup, setActiveGroup] = React.useState('')
+			const [expanded, setExpanded] = React.useState('')
+			const [picker, setPicker] = React.useState({ provider: '', model: '' })
+			const [busy, setBusy] = React.useState(false)
+			const [notice, setNotice] = React.useState(null)
+			// 保存过/刚拉回的 draft 指纹：用它判断「脏」，避免后台刷新把用户正在编辑的内容冲掉。
+			const [savedKey, setSavedKey] = React.useState('')
+			// label 归一成「空 = null」：草稿里是 ''，服务端回的是 null，不归一会永远显示「未保存」。
+			const draftKeyOf = (report) => JSON.stringify((report?.groups ?? []).map((group) => [
+				group.id,
+				group.label ? group.label : null,
+				(group.candidates ?? []).map((candidate) => `${candidate.provider}/${candidate.model}`)
+			]))
+			const draftFrom = (report) => (report.groups ?? []).map((group) => ({
+				id: group.id,
+				label: group.label ?? '',
+				candidates: group.candidates.map((candidate) => ({ provider: candidate.provider, model: candidate.model }))
+			}))
+			// force=true 只用在一处：保存成功后的回读 —— 那时服务端就是权威。
+			// 其余时候（挂载、切模式、轮询）保留用户正在编辑的草稿。
+			const adopt = React.useCallback((report, force) => {
+				setState(report)
+				setActiveGroup(report.activeGroup)
+				setSavedKey(draftKeyOf(report))
+				setDraft((prev) => (force === true || prev === null ? draftFrom(report) : prev))
 			}, [])
-			React.useEffect(() => { query(null) }, [query])
-			if (report === null) {
+			const loadState = React.useCallback(() => {
+				fetch(ROUTING_STATE_URL, { headers: { accept: 'application/json' } })
+					.then((res) => res.json())
+					.then((body) => { if (body !== null && typeof body === 'object' && body.ok === true) adopt(body) })
+					.catch(() => {})
+			}, [adopt])
+			React.useEffect(() => {
+				loadState()
+				fetch(ROUTING_CATALOG_URL, { headers: { accept: 'application/json' } })
+					.then((res) => res.json())
+					.then((body) => { if (body !== null && typeof body === 'object' && body.ok === true && Array.isArray(body.providers)) setCatalog(body.providers) })
+					.catch(() => {})
+			}, [loadState])
+			if (state === null) {
 				return h('div', { className: 'dsh-llm-hub-routing' },
 					h('div', { className: 'dsh-llm-hub-routing__head' },
 						h('span', { className: 'dsh-llm-hub-routing__title' }, t('routingTitle')),
 						h('span', null, t('routingLoading'))))
 			}
-			if (report.ok !== true) return null
-			const candidates = Array.isArray(report.candidates) ? report.candidates : []
-			if (candidates.length === 0) {
-				return null
-			}
 			ensureStyle()
-			const active = report.active
-			const recommendation = report.recommendation
-			const activeKey = active === null ? null : `${active.provider}/${active.model}`
-			const recKey = recommendation === null ? null : `${recommendation.provider}/${recommendation.model}`
-			const showSuggestion = recommendation !== null && recKey !== activeKey
-			const chipClass = (state) => `dsh-llm-hub-health__chip dsh-llm-hub-health__chip--${state ?? 'unknown'}`
-			const head = h('div', { className: 'dsh-llm-hub-routing__head' },
+			const isSmart = state.mode === 'smart'
+			const groups = draft ?? []
+			const isDirty = draft !== null && draftKeyOf({ groups: groups.map((group) => ({ id: group.id, label: group.label, candidates: group.candidates })) }) !== savedKey
+			const post = (url, payload) => fetch(url, {
+				method: 'POST',
+				headers: { 'content-type': 'application/json', accept: 'application/json' },
+				body: JSON.stringify(payload)
+			}).then((res) => res.json())
+			const setMode = (mode) => {
+				setNotice(null)
+				post(ROUTING_SELECT_URL, { mode })
+					.then((body) => { if (body?.ok === true) adopt(body, true) })
+					.catch(() => setNotice('fail'))
+			}
+			const markActive = (id) => {
+				setActiveGroup(id)
+				setNotice(null)
+				post(ROUTING_SELECT_URL, { activeGroup: id })
+					.then((body) => { if (body?.ok === true) adopt(body) })
+					.catch(() => setNotice('fail'))
+			}
+			const save = () => {
+				if (groups.length === 0) return
+				setBusy(true)
+				setNotice(null)
+				post(ROUTING_CONFIG_URL, { groups, activeGroup })
+					.then((body) => {
+						if (body?.ok === true) { adopt(body, true); setNotice('saved') }
+						else setNotice('fail')
+					})
+					.catch(() => setNotice('fail'))
+					.finally(() => setBusy(false))
+			}
+			// ── 草稿编辑（全部是纯函数式更新，不碰服务端；保存才落盘）──
+			const editGroup = (id, mutate) => setDraft(groups.map((group) => (group.id === id ? mutate(group) : group)))
+			const moveCandidate = (id, index, delta) => editGroup(id, (group) => {
+				const next = [...group.candidates]
+				const target = index + delta
+				if (target < 0 || target >= next.length) return group
+				const [item] = next.splice(index, 1)
+				next.splice(target, 0, item)
+				return { ...group, candidates: next }
+			})
+			const removeCandidate = (id, index) => editGroup(id, (group) => ({ ...group, candidates: group.candidates.filter((_, i) => i !== index) }))
+			const addCandidate = (id) => {
+				const provider = picker.provider
+				const model = picker.model
+				if (provider === '' || model === '') return
+				editGroup(id, (group) => ({ ...group, candidates: [...group.candidates, { provider, model }] }))
+				setPicker({ provider: '', model: '' })
+			}
+			const addGroup = () => {
+				let index = groups.length + 1
+				let id = `group-${index}`
+				while (groups.some((group) => group.id === id)) { index += 1; id = `group-${index}` }
+				setDraft([...groups, { id, label: '', candidates: [] }])
+				setExpanded(id)
+			}
+			const removeGroup = (id) => {
+				setDraft(groups.filter((group) => group.id !== id))
+				if (expanded === id) setExpanded('')
+			}
+			const stateChipClass = (value) => `dsh-llm-hub-health__chip dsh-llm-hub-health__chip--${value ?? 'unknown'}`
+			/**
+			 * 一个候选是否多模态（输入含 text 之外的模态，典型是 image）。
+			 *
+			 * 数据来自目录接口的 `input` 字段（settings 里本来就有）；目录读不到时
+			 * 返回 undefined —— UI 不标而不是瞎猜。
+			 */
+			const isMultimodal = (provider, modelId) => {
+				const entry = catalog.find((item) => item.id === provider)
+				const model = Array.isArray(entry?.models) ? entry.models.find((item) => item.id === modelId) : undefined
+				const input = Array.isArray(model?.input) ? model.input : []
+				return input.length > 0 && input.some((kind) => kind !== 'text')
+			}
+			/**
+			 * 一个候选的推理档位列表（来自 settings 的 reasoningEfforts 字段）；
+			 * 没声明推理能力时返回 undefined —— UI 不标。
+			 * 返回的是档位对象的浅拷贝（UI 用），外面别 mutate。
+			 */
+			const reasoningLevels = (provider, modelId) => {
+				const entry = catalog.find((item) => item.id === provider)
+				const model = Array.isArray(entry?.models) ? entry.models.find((item) => item.id === modelId) : undefined
+				const levels = Array.isArray(model?.reasoning?.levels) ? model.reasoning.levels : []
+				return levels.length > 0 ? levels : undefined
+			}
+			/**
+			 * 推理档位的人话短文本：超 3 个档位时压成 `a/b/c+2`，避免长列表把行挤爆。
+			 */
+			const reasoningShort = (levels) => {
+				if (levels === undefined) return ''
+				const names = levels.map((level) => level.name)
+				if (names.length <= 3) return names.join('/')
+				return `${names.slice(0, 3).join('/')}+${names.length - 3}`
+			}
+			// 「现在会路由到哪」：smart 模式看 lastDecision（真实请求），否则按组顺序的推演。
+			const resolvedText = () => {
+				if (isSmart) {
+					const decision = state.lastDecision
+					if (decision?.to) return `${t('routeChipLastRoute')}: ${decision.to.provider}/${decision.to.model}`
+					return decision?.reason ?? t('routeChipFailOpen')
+				}
+				const group = state.groups.find((item) => item.id === activeGroup) ?? state.groups[0]
+				if (group?.wouldRoute) return `${t('routeChipWouldRoute')}: ${group.wouldRoute.provider}/${group.wouldRoute.model}`
+				return group?.reason ?? t('routeChipReasonNone')
+			}
+			const header = h('div', { className: 'dsh-llm-hub-routing__head' },
 				h('span', { className: 'dsh-llm-hub-routing__title' }, t('routingTitle')),
-				active !== null
-					? h('span', { className: 'dsh-llm-hub-routing__active' },
-						`${t('routingActive')}: ${activeKey}`,
-						h('span', { className: chipClass(active.state) }, active.state === 'available' ? '可用' : '不可用'))
-					: h('span', null, t('routingUnconfigured')))
-			const rows = candidates.map((entry) => h('div', { key: `${entry.provider}/${entry.model}`, className: 'dsh-llm-hub-routing__row' },
-				h('span', { className: 'dsh-llm-hub-routing__role' }, entry.role === 'primary' ? t('routingPrimary') : t('routingFallback')),
-				h('span', { className: 'dsh-llm-hub-routing__name' }, `${entry.provider}/${entry.model}`),
-				h('span', { className: chipClass(entry.state) }, entry.state === 'available' ? '可用' : '不可用')))
+				h('div', { className: 'dsh-llm-hub-routing__modes' },
+					h('button', {
+						type: 'button',
+						className: `dsh-llm-hub-route__mode${isSmart ? ' is-on' : ''}`,
+						onClick: () => { if (!isSmart) setMode('smart') }
+					}, `⚡ ${t('routeChipModeSmart')}`),
+					h('button', {
+						type: 'button',
+						className: `dsh-llm-hub-route__mode${!isSmart ? ' is-on' : ''}`,
+						onClick: () => { if (isSmart) setMode('manual') }
+					}, t('routeChipModeManual'))))
+			const rule = h('div', { className: 'dsh-llm-hub-routing__rule' },
+				h('span', { className: 'dsh-llm-hub-routing__rule-tag' }, t('routeRuleTitle')),
+				h('span', null, t('routeRuleText')))
+			const noticeLine = h('div', { className: 'dsh-llm-hub-routing__reason' },
+				isSmart ? t('routeSmartNotice') : t('routeManualNotice'))
+			const nowLine = h('div', { className: 'dsh-llm-hub-routing__now' }, resolvedText())
+			const groupRows = groups.map((group, groupIndex) => {
+				const live = state.groups.find((item) => item.id === group.id)
+				const isOpen = expanded === group.id
+				const candidates = group.candidates
+				return h('div', { key: group.id, className: `dsh-llm-hub-routing__group${activeGroup === group.id ? ' is-active' : ''}` },
+					h('div', { className: 'dsh-llm-hub-routing__group-top' },
+						h('button', {
+							type: 'button',
+							className: 'dsh-llm-hub-routing__group-toggle',
+							onClick: () => setExpanded(isOpen ? '' : group.id)
+						}, `${isOpen ? '▾' : '▸'} ${groupIndex + 1}`),
+						h('input', {
+							className: 'dsh-llm-hub-routing__group-label',
+							value: group.label ?? '',
+							placeholder: t('routeGroupLabelPlaceholder'),
+							onChange: (event) => editGroup(group.id, (current) => ({ ...current, label: event.target.value }))
+						}),
+						live?.wouldRoute
+							? h('span', { className: 'dsh-llm-hub-routing__group-state' }, `${live.wouldRoute.provider}/${live.wouldRoute.model}`)
+							: h('span', { className: 'dsh-llm-hub-routing__group-state' }, live?.reason ?? t('routeChipReasonNone')),
+						activeGroup === group.id
+							? h('span', { className: 'dsh-llm-hub-routing__role' }, t('routeActiveTag'))
+							: h('button', {
+								type: 'button',
+								className: 'dsh-llm-hub-foot__link',
+								onClick: () => markActive(group.id)
+							}, t('routeSetActive'))),
+					isOpen
+						? h('div', { className: 'dsh-llm-hub-routing__candidates' },
+							...candidates.map((candidate, index) => {
+								const liveCandidate = live?.candidates?.find((item) => item.provider === candidate.provider && item.model === candidate.model)
+								const multimodal = isMultimodal(candidate.provider, candidate.model)
+								const reasoning = reasoningLevels(candidate.provider, candidate.model)
+								const reasoningTip = reasoning === undefined
+									? undefined
+									: `${t('routeReasoningTip')}\n${reasoning.map((level) => `  · ${level.name} → ${level.id}`).join('\n')}`
+								return h('div', { key: `${candidate.provider}/${candidate.model}/${index}`, className: 'dsh-llm-hub-routing__row' },
+									h('span', { className: 'dsh-llm-hub-routing__role' }, index === 0 ? t('routePrimaryTag') : `${t('routeFallbackTag')}${index}`),
+									h('span', { className: 'dsh-llm-hub-routing__name' }, `${candidate.provider}/${candidate.model}`),
+									reasoning !== undefined
+										? h('span', {
+											key: 'reasoning',
+											className: 'dsh-llm-hub-routing__reasoning',
+											title: reasoningTip
+										}, `💭 ${t('routeReasoningShort')} ${reasoningShort(reasoning)}`)
+										: null,
+									multimodal === true
+										? h('span', {
+											key: 'multimodal',
+											className: 'dsh-llm-hub-routing__multimodal',
+											title: t('routeMultimodalTip')
+										}, '👁 ' + t('routeMultimodalShort'))
+										: null,
+									h('span', { className: stateChipClass(liveCandidate?.state) }, liveCandidate?.state === 'available' ? '可用' : (liveCandidate?.state === 'unknown' ? '未探明' : '不可用')),
+									h('button', { type: 'button', className: 'dsh-llm-hub-foot__link', title: t('routeUp'), onClick: () => moveCandidate(group.id, index, -1) }, '↑'),
+									h('button', { type: 'button', className: 'dsh-llm-hub-foot__link', title: t('routeDown'), onClick: () => moveCandidate(group.id, index, 1) }, '↓'),
+									h('button', { type: 'button', className: 'dsh-llm-hub-foot__link', title: t('routeRemove'), onClick: () => removeCandidate(group.id, index) }, '✕'))
+							}),
+							h('div', { className: 'dsh-llm-hub-routing__add' },
+								h('span', null, t('routeAddProvider')),
+								catalog.length > 0
+									? h('select', {
+										className: 'dsh-llm-hub-routing__select',
+										value: picker.provider,
+										onChange: (event) => {
+											const provider = event.target.value
+											const entry = catalog.find((item) => item.id === provider)
+											setPicker({ provider, model: entry?.models?.[0]?.id ?? '' })
+										}
+									},
+										h('option', { value: '' }, '—'),
+										...catalog.map((entry) => h('option', { key: entry.id, value: entry.id }, `${entry.displayName ?? entry.id}`)))
+									// 目录读不到（host 还没重启 / settings 里没有 provider）时退回手输 ——
+									// 不让「拉不到目录」变成「编辑不了」。
+									: h('input', {
+										className: 'dsh-llm-hub-routing__select',
+										placeholder: 'provider',
+										value: picker.provider,
+										onChange: (event) => setPicker({ provider: event.target.value, model: picker.model })
+									}),
+								h('span', null, t('routeAddModel')),
+								catalog.find((item) => item.id === picker.provider) !== undefined
+									? h('select', {
+										className: 'dsh-llm-hub-routing__select',
+										value: picker.model,
+										onChange: (event) => setPicker({ provider: picker.provider, model: event.target.value })
+									},
+										h('option', { value: '' }, '—'),
+										...((catalog.find((item) => item.id === picker.provider)?.models) ?? []).map((model) => {
+											const multimodal = Array.isArray(model?.input) && model.input.some((kind) => kind !== 'text')
+											const reasoningLevels = Array.isArray(model?.reasoning?.levels) ? model.reasoning.levels : []
+											const flags = []
+											if (reasoningLevels.length > 0) flags.push(`💭 ${reasoningShort(reasoningLevels)}`)
+											if (multimodal === true) flags.push('👁')
+											return h('option', { key: model.id, value: model.id }, flags.length === 0 ? model.id : `${model.id}  ${flags.join(' ')}`)
+										}))
+									: h('input', {
+										className: 'dsh-llm-hub-routing__select',
+										placeholder: 'model',
+										value: picker.model,
+										onChange: (event) => setPicker({ provider: picker.provider, model: event.target.value })
+									}),
+								h('button', {
+									type: 'button',
+									className: 'dsh-llm-hub-btn',
+									onClick: () => addCandidate(group.id)
+								}, t('routeAdd'))),
+							catalog.length === 0 ? h('div', { className: 'dsh-llm-hub-routing__rule' }, t('routeNoCatalog')) : null,
+							h('button', {
+								type: 'button',
+								className: 'dsh-llm-hub-foot__link',
+								onClick: () => removeGroup(group.id)
+							}, t('routeDeleteGroup')))
+						: null)
+			})
+			const footer = h('div', { className: 'dsh-llm-hub-routing__actions' },
+				h('button', { type: 'button', className: 'dsh-llm-hub-btn', onClick: addGroup }, t('routeNewGroup')),
+				h('button', {
+					type: 'button',
+					className: 'dsh-llm-hub-btn',
+					disabled: busy || !isDirty,
+					onClick: save
+				}, isDirty ? t('routeSave') : t('routeSaved')),
+				notice === 'fail' ? h('span', { className: 'dsh-llm-hub-routing__reason' }, t('routeSaveFailed')) : null,
+				h('span', { className: 'dsh-llm-hub-routing__hint' }, t('routeEditHint')))
 			return h('div', { className: 'dsh-llm-hub-routing' },
-				head,
-				h('div', { className: 'dsh-llm-hub-routing__rows' }, rows),
-				showSuggestion
-					? h('div', { className: 'dsh-llm-hub-routing__suggestion' }, `${t('routingSuggestion')}: ${recKey}`)
-					: null,
-				recommendation === null && candidates.length > 0
-					? h('div', { className: 'dsh-llm-hub-routing__reason' }, t('routingNoRecommendation'))
-					: null)
+				header,
+				rule,
+				noticeLine,
+				nowLine,
+				h('div', { className: 'dsh-llm-hub-routing__groups' }, groupRows),
+				footer)
 		}
 
 		/**

package/lib/index.js

@@ -202,6 +202,16 @@ const ROUTING_STATE_PATH = '/api/dsh-llm-hub/routing/state'
  * `dsh-llm-hub.routing` 段 —— 状态持久化，重启不丢。
  */
 const ROUTING_SELECT_PATH = '/api/dsh-llm-hub/routing/select'
+/**
+ * 路由组编辑：`GET /api/dsh-llm-hub/routing/catalog` 列可路由的 provider 与模型，
+ * `POST /api/dsh-llm-hub/routing/config` 整体写回 `routing.groups`。
+ *
+ * 为什么要这两条：1.5.0 只给了 composer 的切组 chip，配置本身仍只能手改
+ * settings.yaml —— 「有入口、没闭环」。设置页的路由卡用 catalog 渲染候选选择器，
+ * 用 config 落盘编辑结果。
+ */
+const ROUTING_CATALOG_PATH = '/api/dsh-llm-hub/routing/catalog'
+const ROUTING_CONFIG_PATH = '/api/dsh-llm-hub/routing/config'
 /** 插件自有的 settings 命名空间（1.5.0 起注册）—— routing / warning / aliases 都住这里。 */
 const HUB_NS = 'dsh-llm-hub'
 /** 模型别名：客户端渲染 model id 时显示短名（典型场景：deepseek-reasoner → 推理）。 */
@@ -348,6 +358,80 @@ export function pickSmartRoute(entries, stateFor, active) {
 	return { to: { provider: winner.provider, model: winner.model }, reason: null, switched: true }
 }
 
+/**
+ * 校验并规范化「路由组编辑」提交的 groups（真源，供 config 路由与测试共用）。
+ *
+ * 两种输入形态都收，因为两种调用方都在：
+ *   - `candidates: [a, b, c]` —— 顺序数组，**首个即主力**。设置页编辑器提交的就是
+ *     这个形态（UI 里对用户呈现的是「有序候选列表」，不区分 primary/fallback 概念）；
+ *   - `primary: 'a/b', fallbacks: [...]` —— settings 落盘形态，手工调用方友好。
+ *   两者同时出现时以 `candidates` 为准（它是更精确的顺序表达）。
+ *
+ * 判据：
+ *   - 组 id：非空、去重（后出现的重名组丢弃）、最长 64；
+ *   - label 可选，纯空白视为没有；
+ *   - primary / fallbacks[] 必须是合法 `provider/model`；非法项**过滤**而不是
+ *     整单拒绝 —— 用户手敲错一行不应该让整次保存失败（UI 会把合法项显示出来）；
+ *   - 没有 primary 也没有 fallback 的组丢弃（空组无法路由）；
+ *   - 上限：≤ 20 组、每组 ≤ 20 个候选（防呆，手抖粘贴不会把 settings 撑爆）。
+ *
+ * @param {unknown} raw - 客户端提交的 groups 数组。
+ * @returns {{ groups: Array, dropped: string[] }} 规范化结果与被丢弃项的原因说明。
+ */
+export function normalizeRoutingGroupsInput(raw) {
+	const dropped = []
+	if (!Array.isArray(raw)) return { groups: [], dropped: ['groups 不是数组'] }
+	/**
+	 * 候选的两种写法都收：字符串 `'provider/model'`（settings 落盘形态）与对象
+	 * `{ provider, model }`（编辑器 / 状态接口形态）。对象经此折回字符串再走同一套
+	 * 正则校验 —— 只有一份合法性判据。
+	 * @param value - 一个候选。
+	 * @returns {{ provider: string, model: string } | undefined}
+	 */
+	const asEntry = (value) => {
+		if (typeof value === 'string') return parseRouteEntryPure(value)
+		if (value !== null && typeof value === 'object') {
+			const provider = typeof value.provider === 'string' ? value.provider.trim() : ''
+			const model = typeof value.model === 'string' ? value.model.trim() : ''
+			if (provider === '' || model === '') return undefined
+			return parseRouteEntryPure(`${provider}/${model}`)
+		}
+		return undefined
+	}
+	/** 非法项的说明文本：对象要展开，否则日志里只有 [object Object]。 */
+	const describe = (value) => (typeof value === 'string' ? value : JSON.stringify(value))
+	const groups = []
+	const seen = new Set()
+	for (const item of raw) {
+		if (groups.length >= 20) { dropped.push('超过 20 组，其余忽略'); break }
+		if (item === null || typeof item !== 'object') { dropped.push('组不是对象'); continue }
+		const id = typeof item.id === 'string' ? item.id.trim().slice(0, 64) : ''
+		if (id === '') { dropped.push('组缺少 id'); continue }
+		if (seen.has(id)) { dropped.push(`组 id 重复：${id}`); continue }
+		// candidates[]（编辑器形态）优先；否则读 primary + fallbacks[]（落盘形态）。
+		const ordered = Array.isArray(item.candidates) ? item.candidates : null
+		const rawPrimary = ordered === null ? item.primary : ordered[0]
+		const rawFallbacks = ordered === null ? item.fallbacks : ordered.slice(1)
+		const primary = asEntry(rawPrimary) ?? null
+		const fallbacks = []
+		for (const entry of Array.isArray(rawFallbacks) ? rawFallbacks : []) {
+			if (fallbacks.length >= 20) { dropped.push(`组 ${id} 的 fallback 超过 20 个`); break }
+			const parsed = asEntry(entry)
+			if (parsed !== undefined) fallbacks.push(parsed)
+			else dropped.push(`组 ${id} 的非法候选被忽略：${describe(entry)}`)
+		}
+		if (primary === null && fallbacks.length === 0) { dropped.push(`组 ${id} 没有任何合法候选`); continue }
+		seen.add(id)
+		groups.push({
+			id,
+			label: typeof item.label === 'string' && item.label.trim() !== '' ? item.label.trim().slice(0, 32) : null,
+			primary,
+			fallbacks
+		})
+	}
+	return { groups, dropped }
+}
+
 /** 路由配置从 settings 哪一段读 —— 顶层 dsh-llm-hub 段下，与 warning 同级。 */
 const ROUTING_KEY = 'routing'
 /** 探针结论的保鲜期；过期后下次读取顺手在后台重探，不阻塞下拉。 */
@@ -2479,12 +2563,37 @@ export function apply(ctx) {
 	}
 
 	/**
-	 * 路由目标专线的可用性：**探测表里没有的 provider 视为不可用**。
+	 * 一个 provider 是否在配置里"存在"：要么 `llm-pi-ai` 段有它的 profile，要么
+	 * `llm-deepseek` 段存在（即官方直连适配器挂上了）。
+	 *
+	 * 与 `routableStateFor` 配合用：探测表里没记录的 provider，
+	 * 若在此集合里 → 算 unknown（routable，让请求试一把）；
+	 * 不在此集合里 → 才算 unavailable（真不认识，路由过去会撞 NO_ADAPTER）。
+	 * @returns 已知 provider id 的 Set。
+	 */
+	const knownConfiguredProviders = () => {
+		const ids = new Set()
+		for (const [id, profile] of piaiProviders()) {
+			if (profile !== null && typeof profile === 'object') ids.add(id)
+		}
+		if (sectionOf() !== undefined) ids.add(DEEPSEEK_PROVIDER)
+		return ids
+	}
+
+	/**
+	 * 路由目标专线的可用性。
+	 *
+	 * 判定梯度（决定 `pickSmartRoute` 是跳过还是接管）：
+	 *   · 探测表里有 verdict：用 verdict.state（available / unknown / unavailable）
+	 *   · 探测表里没有 + provider 在 settings 里配了 → 'unknown'
+	 *     （冷启动 / 用户刚加 provider / 探针刚清空 —— 不阻塞路由，让请求发出去
+	 *     撞真上游；撞完探针会立刻补 verdict，下一轮就准了）
+	 *   · 探测表里没有 + provider **没在** settings 里 → 'unavailable'
+	 *     （典型：配置里写错名 / 该 provider 还没注册；路由过去只会撞 NO_ADAPTER，
+	 *     fail-open 保留原配置，比打挂请求更稳）
 	 *
-	 * `stateFor` 把「不认识这个 provider」和「探测结果是 unknown」都折成 unknown，
-	 * 后者可以路由，前者路由过去只会撞 NO_ADAPTER —— 请求直接失败。所以智能路由
-	 * 用这一版：配置里写错 provider 名 / 该 provider 还没注册时，候选被跳过，
-	 * 路由保持 fail-open（不动原配置），而不是把会话打挂。
+	 * `stateFor` 把前两种情况都折成 'unknown'，所以信息面板里仍是"待探明"，无歧义；
+	 * 区别只在路由**目标**的取与舍 —— 这是 routable vs stateful 的本意。
 	 * @param provider - provider id。
 	 * @returns 'available' | 'unknown' | 'unavailable'。
 	 */
@@ -2492,7 +2601,7 @@ export function apply(ctx) {
 		for (const verdict of baseVerdicts.values()) {
 			if (verdict.provider === provider) return verdict.state
 		}
-		return 'unavailable'
+		return knownConfiguredProviders().has(provider) ? 'unknown' : 'unavailable'
 	}
 
 	/**
@@ -2651,6 +2760,179 @@ export function apply(ctx) {
 		}
 	}
 
+	/**
+	 * 可路由目录：settings 里已配置的 provider 与各自的模型 id（离线，不打网关）。
+	 *
+	 * 数据源是**配置段**而不是 `ctx.llm.listProviders()`：后者会被本插件的隐藏
+	 * 过滤器影响，拿它当候选来源会「隐藏了就再也加不回来」。
+	 * @returns {{ providers: Array<{ id, displayName, ns, models: string[] }> }}
+	 */
+	/**
+	 * 从 settings 里的一个 model 条目读输入模态。
+	 *
+	 * 两种字段名都收：llm-deepseek 段写 `inputModalities: [text, image]`，
+	 * llm-pi-ai 段写 `input: [text, image]`。读不到时为空数组 —— 空数组表示
+	 * 「不知道」，UI 不标（而不是猜一个）。
+	 * @param model - settings 里的 model 条目对象。
+	 * @returns {string[]}
+	 */
+	const modalitiesOf = (model) => {
+		const raw = Array.isArray(model?.inputModalities) ? model.inputModalities : (Array.isArray(model?.input) ? model.input : [])
+		return raw.filter((item) => typeof item === 'string')
+	}
+
+	/**
+	 * 从 settings 里的一个 model 条目读推理（reasoning）能力。
+	 *
+	 * 形态是 `{ off: null, low: 'low', high: 'high', max: 'max' }`：键名 = 人类可读
+	 * 的档位名，值 = 适配器真正认的 effort id（`null` 表示「这个档位不开放」，
+	 * 比如 `off: null` 就是该模型强制思考、不能关）。模型没有这条字段时返回 null
+	 * —— UI 不标，而不是猜一个（用户没声明「能思考」就当不能）。
+	 *
+	 * 只暴露非空档位；off/null 这类「不可用」档位不进 chip 文本，免得显示「思考 · off」
+	 * 自相矛盾。
+	 * @param model - settings 里的 model 条目对象。
+	 * @returns {{ levels: Array<{ id: string, name: string }> } | null}
+	 */
+	const reasoningOf = (model) => {
+		const efforts = model?.reasoningEfforts
+		if (efforts === null || typeof efforts !== 'object') return null
+		const levels = []
+		for (const [name, id] of Object.entries(efforts)) {
+			if (id === null || id === undefined || id === '') continue
+			levels.push({ id: String(id), name: String(name) })
+		}
+		if (levels.length === 0) return null
+		return { levels }
+	}
+
+	/**
+	 * 可路由目录：settings 里已配置的 provider 与各自的模型 id（离线，不打网关）。
+	 *
+	 * 数据源是**配置段**而不是 `ctx.llm.listProviders()`：后者会被本插件的隐藏
+	 * 过滤器影响，拿它当候选来源会「隐藏了就再也加不回来」。
+	 *
+	 * 每个模型带两条 capability 事实：
+	 *   · `input: string[]` —— 输入模态（text / image …）；空数组表示「不知道」。
+	 *   · `reasoning: { levels: [{ id, name }, …] } | null` —— 推理档位；
+	 *     非空 = 模型能思考，UI 标「思考 · low/high/max」；null = 不标。
+	 * 这两条都是 settings 里原本就有的事实（2026-09-27 用户反馈），不亮出来
+	 * 用户就只能靠背 —— 「这个模型支持多模态吗」「它能思考吗」每次都得查文档。
+	 * @returns {{ providers: Array<{ id, displayName, ns, models: Array<{ id, input: string[], reasoning: object | null }> }> }}
+	 */
+	const routingCatalogOf = () => {
+		const out = []
+		for (const [id, profile] of piaiProviders()) {
+			const models = (Array.isArray(profile.models) ? profile.models : [])
+				.map((model) => (model !== null && typeof model === 'object' && typeof model.id === 'string' ? { id: model.id, input: modalitiesOf(model), reasoning: reasoningOf(model) } : undefined))
+				.filter((model) => model !== undefined)
+			out.push({
+				id,
+				displayName: typeof profile.displayName === 'string' && profile.displayName.trim() !== '' ? profile.displayName : id,
+				ns: PIAI_NS,
+				models
+			})
+		}
+		const deepseek = sectionOf()
+		if (deepseek !== undefined) {
+			const models = (Array.isArray(deepseek.models) ? deepseek.models : [])
+				.map((model) => (model !== null && typeof model === 'object' && typeof model.id === 'string' ? { id: model.id, input: modalitiesOf(model), reasoning: reasoningOf(model) } : undefined))
+				.filter((model) => model !== undefined)
+			out.push({
+				id: DEEPSEEK_PROVIDER,
+				displayName: typeof deepseek.displayName === 'string' && deepseek.displayName.trim() !== '' ? deepseek.displayName : 'DeepSeek 官方直连',
+				ns: NS,
+				models
+			})
+		}
+		out.sort((a, b) => a.id.localeCompare(b.id))
+		return { providers: out }
+	}
+
+	/** 写回整份路由组（设置页编辑器保存路径），并返回最新状态。 */
+	const applyRoutingConfig = async (payload) => {
+		const settings = ctx.get('settings')
+		if (settings === undefined || hubRegistered !== true) {
+			return { ok: false, error: 'settings 命名空间 dsh-llm-hub 尚未就绪 —— 稍后重试' }
+		}
+		const normalized = normalizeRoutingGroupsInput(payload?.groups)
+		if (normalized.groups.length === 0) {
+			return { ok: false, error: '至少需要一组有效候选（provider/model）', dropped: normalized.dropped }
+		}
+		const current = routingObjOf()
+		// 生效组若在新配置里没了，落到第一组 —— 不让 settings 里留一个悬空的 activeGroup。
+		const requested = typeof payload?.activeGroup === 'string' ? payload.activeGroup.trim() : ''
+		const fallbackActive = normalized.groups.some((group) => group.id === requested)
+			? requested
+			: (normalized.groups.some((group) => group.id === current.activeGroup) ? current.activeGroup : normalized.groups[0].id)
+		const mode = payload?.mode === 'smart' || payload?.mode === 'manual'
+			? payload.mode
+			: (current.mode === 'smart' ? 'smart' : 'manual')
+		try {
+			await settings.update(HUB_NS, {
+				routing: {
+					...current,
+					mode,
+					activeGroup: fallbackActive,
+					groups: normalized.groups.map((group) => ({
+						id: group.id,
+						...(group.label !== null ? { label: group.label } : {}),
+						...(group.primary !== null ? { primary: `${group.primary.provider}/${group.primary.model}` } : {}),
+						fallbacks: group.fallbacks.map((entry) => `${entry.provider}/${entry.model}`)
+					}))
+				}
+			})
+			return { ok: true, dropped: normalized.dropped, ...smartStateOf() }
+		} catch (error) {
+			return { ok: false, error: `写不进 settings（${error?.message ?? error}）` }
+		}
+	}
+
+	ctx.effect(() => ctx.webServer.register({
+		kind: 'exact',
+		path: ROUTING_CATALOG_PATH,
+		handler: (request, response) => {
+			if (request.method !== 'GET' && request.method !== 'HEAD') {
+				response.writeHead(405, { allow: 'GET, HEAD' })
+				response.end()
+				return
+			}
+			if (!sameOrigin(request)) {
+				sendJson(response, 403, { ok: false, error: 'cross-origin reads are refused' })
+				return
+			}
+			if (request.method === 'HEAD') {
+				response.writeHead(200, { 'content-type': 'application/json; charset=utf-8' })
+				response.end()
+				return
+			}
+			sendJson(response, 200, { ok: true, ...routingCatalogOf() })
+		}
+	}), 'dsh-llm-hub: routing catalog route')
+
+	ctx.effect(() => ctx.webServer.register({
+		kind: 'exact',
+		path: ROUTING_CONFIG_PATH,
+		handler: async (request, response) => {
+			if (request.method !== 'POST') {
+				response.writeHead(405, { allow: 'POST' })
+				response.end()
+				return
+			}
+			if (!sameOrigin(request)) {
+				sendJson(response, 403, { ok: false, error: 'cross-origin writes are refused' })
+				return
+			}
+			const payload = await readPostBody(request)
+			if (payload === null) {
+				sendJson(response, 400, { ok: false, error: '请求内容不是合法 JSON' })
+				return
+			}
+			const result = await applyRoutingConfig(payload)
+			sendJson(response, result.ok === true ? 200 : 400, result)
+		}
+	}), 'dsh-llm-hub: routing config route')
+
 	ctx.effect(() => ctx.webServer.register({
 		kind: 'exact',
 		path: ROUTING_STATE_PATH,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugins/dsh-llm-hub",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "DSH 模型管理层：网关可达性探测、模型目录拉取、DeepSeek + MiniMax/智谱/Moonshot/StepFun 余额与配额、本月用量统计、余额预警、Provider 健康看板，再把本机装好的 codex / claude / agy 注册成子代理（装了才出现）。零运行时依赖，不改动 DSH 安装。",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
     "preview": "npm run deploy && open http://127.0.0.1:3080",
     "check": "for f in lib/*.js; do node --check \"$f\" || exit 1; done",
     "test": "node --test",
-    "prepublishOnly": "npm run check && npm test && node scripts/prepublish-gate.mjs"
+    "prepublishOnly": "npm run check && npm test && node scripts/prepublish-gate.mjs && node scripts/readme-gate.mjs"
   },
   "keywords": [
     "dsh",

package/scripts/readme-gate.mjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * readme-gate —— 开源包装的首屏门禁
+ *
+ * 🔴 这个文件是**拷贝**，真源在 CortexOS：
+ *      CortexOS/scripts/release-gate/readme-gate.mjs
+ *    同步检查：node $CORTEXOS_ROOT/scripts/check-release-gate-sync.mjs
+ *    改逻辑请改真源，然后跑同步脚本把各仓拷一遍 —— 不要在各仓就地改。
+ *
+ * 为什么是门禁而不是文档：cs rule open_source_project_baseline 早就写明了
+ * README 首屏金字塔（居中品牌 → for-the-badge → Why This 对比表 → 30 秒上手），
+ * 但 2026-09-27 一查四个插件，规则说的和仓库里躺的完全是两回事：
+ *
+ *     · 徽章：四个仓全用 style=flat-square（8/10/8/7 个），规则要求 for-the-badge
+ *     · 居中标题：bloom-theme / llm-hub 用 <p align="center"> 而非 <h1 align="center">
+ *     · Why This 对比表：dsh-user-mirror 缺
+ *     · 英文 README：dsh-env-inspector 缺
+ *
+ * 共同点还是那句「约定没做成门禁」。所以把判据做成能跑的：
+ *
+ *   契约 1 居中品牌   —— 存在 <h1 align="center"> 开头且带 emoji/品牌名的标题
+ *   契约 2 徽章规格   —— 至少 1 个 for-the-badge；且不得残留 flat-square
+ *   契约 3 对比矩阵   —— 首屏（前 80 行）内有 Why This 对比表（Markdown 表格）
+ *   契约 4 双语       —— 存在 README.en.md（生态面向全球，英文是默认入场券）
+ *
+ * 逃生舱：README_GATE=off 跳过全部检查（仅限明确不需要包装的内部包）。
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const GATE_VERSION = 1
+
+const here = dirname(fileURLToPath(import.meta.url))
+const pkgRoot = dirname(here)
+
+const pkg = JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf8'))
+const errors = []
+const notes = []
+
+if (String(process.env.README_GATE).toLowerCase() === 'off') {
+  console.log('[readme-gate] ↩ README_GATE=off —— 跳过首屏包装检查')
+  process.exit(0)
+}
+
+const readmePath = join(pkgRoot, 'README.md')
+if (!existsSync(readmePath)) {
+  console.error('[readme-gate] ✖ 找不到 README.md —— 一个没有 README 的包不可能被人用起来')
+  process.exit(1)
+}
+const readme = readFileSync(readmePath, 'utf8')
+const lines = readme.split(/\r?\n/)
+
+// ── 1. 居中品牌标题 ────────────────────────────────────────────────────────
+// 接受 <h1 align="center">…</h1>；<p align="center"><h1> 也算（有些仓这么写）。
+const h1Centered =
+  /<h1[^>]*align=["']center["'][^>]*>/i.test(readme) ||
+  /<p[^>]*align=["']center["'][^>]*>\s*<h1/i.test(readme)
+
+if (!h1Centered) {
+  errors.push(
+    'README 缺少居中的 <h1 align="center"> 标题\n' +
+    '  → 首屏第一眼必须是品牌：<h1 align="center">🔐 项目名</h1>，紧跟一句居中 slogan'
+  )
+} else {
+  // 标题里带 emoji 或品牌名才像样，光 <h1 align="center"></h1> 是空的
+  const m = readme.match(/<h1[^>]*>([\s\S]*?)<\/h1>/i)
+  if (m && m[1].replace(/<[^>]+>/g, '').trim().length < 2) {
+    errors.push('README 的居中标题是空的 —— 补上 emoji + 项目名')
+  }
+}
+
+// ── 2. 徽章规格：for-the-badge，且不残留 flat-square ───────────────────────
+const badgeCount = (readme.match(/for-the-badge/g) ?? []).length
+const flatSquare = (readme.match(/flat-square/g) ?? []).length
+
+if (badgeCount === 0) {
+  errors.push(
+    'README 没有任何 style=for-the-badge 徽章\n' +
+    '  → 规则要求立体大徽章（style=for-the-badge），版本/许可证/DSH 版本/Build 这几个是基本盘'
+  )
+}
+if (flatSquare > 0) {
+  errors.push(
+    'README 里有 ' + flatSquare + ' 个 style=flat-square 徽章\n' +
+    '  → 统一换成 style=for-the-badge（把 URL 里的 flat-square 直接替换即可），' +
+    '否则首屏是细长方块，视觉重量撑不起品牌'
+  )
+}
+
+// ── 3. Why This 对比矩阵必须在首屏 ─────────────────────────────────────────
+// 「首屏」= 前 80 行。表格判定：连续的 | ... | 行，至少 3 行（表头+分隔+1 行数据）。
+const HEAD_LINES = 80
+const head = lines.slice(0, HEAD_LINES).join('\n')
+const tableBlocks = []
+let run = 0
+for (const l of lines.slice(0, HEAD_LINES)) {
+  if (/^\s*\|.*\|\s*$/.test(l)) { run++; if (run === 3) tableBlocks.push(1) }
+  else run = 0
+}
+const hasWhyTable = tableBlocks.length > 0
+
+if (!hasWhyTable) {
+  errors.push(
+    'README 首屏（前 ' + HEAD_LINES + ' 行）没有对比表格\n' +
+    '  → Why This Table 是转化率的关键：用 ✅ / ❌ 说明「为什么用你这个而不是别的」。' +
+    '同类方案、原生能力、手动配置都值得列成列'
+  )
+}
+
+// ── 4. 英文 README ─────────────────────────────────────────────────────────
+const hasEn = ['README.en.md', 'README.en-US.md', 'README.en_US.md']
+  .some((f) => existsSync(join(pkgRoot, f)))
+
+if (!hasEn) {
+  errors.push(
+    '缺少英文 README（README.en.md）\n' +
+    '  → dsh-plugin 生态面向全球，英文是默认入场券；中文 README 首行加上 [English](README.en.md) | 中文'
+  )
+}
+
+// ── 额外提示（不拦，但值得知道）───────────────────────────────────────────
+const shotCount = ['assets']
+  .flatMap((d) => {
+    const p = join(pkgRoot, d)
+    if (!existsSync(p)) return []
+    return readdirSync(p).filter((f) => /\.(png|jpe?g|webp|gif)$/i.test(f))
+  }).length
+if (shotCount === 0) {
+  notes.push('assets/ 里没有截图 —— 插件页没图等于没人点，建议至少 1 张真实界面截图')
+}
+
+// ── 汇总 ───────────────────────────────────────────────────────────────────
+if (errors.length > 0) {
+  console.error('[readme-gate] ✖ README 首屏不合规（gate v' + GATE_VERSION + '）：')
+  for (const e of errors) console.error('  · ' + e)
+  console.error('\n  真源：cs rule open_source_project_baseline（README 金字塔标准）')
+  console.error('  逃生舱：README_GATE=off（仅限内部包）')
+  process.exit(1)
+}
+
+console.log('[readme-gate] ✓ README 首屏四条契约通过（gate v' + GATE_VERSION + '）')
+console.log('  · for-the-badge 徽章 ' + badgeCount + ' 个；首屏对比表 ' + tableBlocks.length + ' 个；英文版 ✓')
+for (const n of notes) console.log('  · 提示：' + n)