@dsh-plugins/dsh-llm-hub 1.3.3 → 1.5.0

package/lib/client.js

@@ -73,10 +73,13 @@ window.__ModuleLoader__.load({
 		const HEALTH_URL = '/api/dsh-llm-hub/health'
 		/** 智能路由建议：当前激活 + 推荐 fallback。 */
 		const ROUTING_URL = '/api/dsh-llm-hub/routing/resolve'
+		/** 路由组状态：模式、激活组、每组候选与可用性、最近实际路由。 */
+		const ROUTING_STATE_URL = '/api/dsh-llm-hub/routing/state'
+		/** 路由组切换：POST { mode?, activeGroup? }，持久化进 settings。 */
+		const ROUTING_SELECT_URL = '/api/dsh-llm-hub/routing/select'
 		/** 模型别名：把长 id 显示成短名（人话）。 */
 		const ALIASES_URL = '/api/dsh-llm-hub/aliases'
-		/** 多账号 key 轮换：debug 路由，看每个 provider 当前轮到哪个 key。 */
-		const KEYPOOL_URL = '/api/dsh-llm-hub/keypool/status'
+		const BILLING_MODE_URL = '/api/dsh-llm-hub/billing-mode'
 
 		const LOCALES = {
 			zh: {
@@ -85,6 +88,10 @@ window.__ModuleLoader__.load({
 				refresh: '刷新余额',
 				retry: '重试',
 				noKey: '未配置 API Key',
+				billingUsage: '按量付费',
+				billingSub: '套餐',
+				billingSwitchToSub: '切换为套餐模式',
+				billingSwitchToUsage: '切换为按量付费模式',
 				noKeyHint: '在下方填入 DeepSeek API Key 后即可查询余额。',
 				granted: '赠送',
 				toppedUp: '充值',
@@ -157,11 +164,15 @@ window.__ModuleLoader__.load({
 				routingPrimary: '主力',
 				routingNoRecommendation: '全部不可用',
 				routingLoading: '路由解析中…',
+				routeChipSmart: '智能',
+				routeChipManual: '手动',
+				routeChipModeSmart: '智能路由',
+				routeChipModeManual: '手动模型',
+				routeChipWouldRoute: '将路由到',
+				routeChipLastRoute: '最近实际',
+				routeChipReasonNone: '候选全部不可用',
+				routeChipFailOpen: '路由失败时按原配置发出',
 				aliasesMissing: '尚未配置别名',
-				keypoolTitle: '多账号 key 轮换',
-				keypoolRound: 'round-robin',
-				keypoolActiveTip: '当前优先使用',
-				keypoolNextTip: '下次轮换目标',
 				heroTitle: 'LLM 矩阵概览',
 				heroProviders: '活跃提供方',
 				heroModels: '可用模型',
@@ -191,6 +202,7 @@ window.__ModuleLoader__.load({
 				suiteTitle: 'Webkubor DSH 扩展家族',
 				suiteDesc: '一键构建完整智能体开发环境',
 				suiteActive: '已激活',
+				suiteUnknown: '判定不可用',
 				suiteCopyInstall: '复制安装',
 				suiteCopied: '已复制命令'
 			},
@@ -201,6 +213,10 @@ window.__ModuleLoader__.load({
 				retry: 'Retry',
 				noKey: 'No API key',
 				noKeyHint: 'Add a DeepSeek API key below to see the balance.',
+				billingUsage: 'Pay-As-You-Go',
+				billingSub: 'Plan',
+				billingSwitchToSub: 'Switch to Plan mode',
+				billingSwitchToUsage: 'Switch to Pay-As-You-Go mode',
 				granted: 'Granted',
 				toppedUp: 'Topped up',
 				unavailable: 'Account unavailable',
@@ -272,11 +288,15 @@ window.__ModuleLoader__.load({
 				routingPrimary: 'primary',
 				routingNoRecommendation: 'none available',
 				routingLoading: 'resolving routing…',
+				routeChipSmart: 'Smart',
+				routeChipManual: 'Manual',
+				routeChipModeSmart: 'Smart routing',
+				routeChipModeManual: 'Manual model',
+				routeChipWouldRoute: 'Routes to',
+				routeChipLastRoute: 'Last used',
+				routeChipReasonNone: 'All candidates unavailable',
+				routeChipFailOpen: 'Falls back to your selection when routing fails',
 				aliasesMissing: 'no aliases configured',
-				keypoolTitle: 'Key rotation',
-				keypoolRound: 'round-robin',
-				keypoolActiveTip: 'Currently active',
-				keypoolNextTip: 'Next target',
 				heroTitle: 'LLM Matrix Overview',
 				heroProviders: 'Active providers',
 				heroModels: 'Models',
@@ -306,6 +326,7 @@ window.__ModuleLoader__.load({
 				suiteTitle: 'Webkubor DSH Plugin Suite',
 				suiteDesc: 'One-click full agent development environment',
 				suiteActive: 'Active',
+				suiteUnknown: 'Undetectable',
 				suiteCopyInstall: 'Copy install',
 				suiteCopied: 'Command copied'
 			}
@@ -388,6 +409,14 @@ window.__ModuleLoader__.load({
 				'.dsh-llm-hub-subtext{font-size:11px;color:var(--dsw-alias-label-secondary);opacity:.8}',
 				'.dsh-llm-hub-warn{color:var(--dsw-alias-state-warn-primary);font-size:11px}',
 				'.dsh-llm-hub-error{color:var(--dsw-alias-state-error-primary);font-size:11px}',
+				'.dsh-llm-hub-billing-capsule{display:inline-flex;align-items:center;background:var(--dsw-alias-fill-quaternary, rgba(125,125,125,0.08));border-radius:12px;padding:1.5px;gap:2px;user-select:none;margin-right:2px}',
+				'.dsh-llm-hub-billing-pill{font-size:10px;line-height:14px;padding:1px 6px;border-radius:10px;cursor:pointer;color:var(--dsw-alias-label-tertiary);transition:all .15s ease}',
+				'.dsh-llm-hub-billing-pill:hover{color:var(--dsw-alias-label-primary)}',
+				'.dsh-llm-hub-billing-pill.is-active{font-weight:600;background:var(--dsw-alias-fill-primary, #fff);box-shadow:0 1px 2px rgba(0,0,0,0.08)}',
+				'.dsh-llm-hub-billing-pill.is-active.is-usage{color:#2563eb}',
+				'.dsh-llm-hub-billing-pill.is-active.is-sub{color:#059669}',
+				'.dsh-llm-hub-key-chip{display:inline-flex;align-items:center;gap:3px;font-size:10.5px;padding:1px 5px;border-radius:4px;background:var(--dsw-alias-fill-quaternary, rgba(125,125,125,0.06));border:1px solid var(--dsw-alias-line-secondary, rgba(125,125,125,0.15));margin-right:4px}',
+				'.dsh-llm-hub-key-chip.is-down{opacity:.6;border-style:dashed}',
 				// 去掉粗糙灰底框，改用轻量排版标签
 				'.dsh-llm-hub-tag{display:inline-flex;align-items:center;gap:3px;padding:0 2px;',
 				'border:none;background:transparent;',
@@ -510,22 +539,34 @@ window.__ModuleLoader__.load({
 				'.dsh-llm-hub-routing__name{color:var(--dsw-alias-label-primary);font-weight:600}',
 				'.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}',
-				// 多账号 key 轮换
-				'.dsh-llm-hub-keypool{display:flex;flex-direction:column;gap:6px;margin-top:10px;',
-				'padding:8px 10px;border-radius:6px;',
-				'border:.5px solid var(--dsw-alias-border-l1);background:transparent;',
-				'font-size:11.5px;line-height:16px;color:var(--dsw-alias-label-secondary)}',
-				'.dsh-llm-hub-keypool__head{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap}',
-				'.dsh-llm-hub-keypool__title{color:var(--dsw-alias-label-primary);font-weight:600;display:inline-flex;align-items:center;gap:5px}',
-				'.dsh-llm-hub-keypool__rows{display:flex;flex-direction:column;gap:3px}',
-				'.dsh-llm-hub-keypool__row{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:4px 6px;border-radius:4px;background:var(--dsw-alias-bg-layer-2,#1c1f24);border:.5px solid var(--dsw-alias-border-l1)}',
-				'.dsh-llm-hub-keypool__row.is-active{border-color:var(--dsw-alias-state-success-primary,#10b981);box-shadow:0 0 8px rgba(16,185,129,.15)}',
-				'.dsh-llm-hub-keypool__name{color:var(--dsw-alias-label-primary);font-weight:600;min-width:120px;font-family:ui-monospace,SFMono-Regular,monospace}',
-				'.dsh-llm-hub-keypool__meta{font-size:10.5px;opacity:.7}',
-				'.dsh-llm-hub-keypool__chosen{display:flex;align-items:baseline;gap:4px;',
-				'color:var(--dsw-alias-label-primary)}',
-				'.dsh-llm-hub-keypool__chosen small{color:var(--dsw-alias-label-secondary);opacity:.75;font-size:10.5px}',
-				'.dsh-llm-hub-keypool__pending{color:var(--dsw-alias-label-secondary);opacity:.6}',
+				// composer 快切 chip（conversation.input.left）
+				'.dsh-llm-hub-route{position:relative;display:inline-flex}',
+				'.dsh-llm-hub-route__btn{box-sizing:border-box;display:inline-flex;align-items:center;gap:4px;height:22px;',
+				'padding:0 8px;border-radius:6px;border:.5px solid var(--dsw-alias-border-l1);background:transparent;cursor:pointer;',
+				'font:inherit;font-size:11px;color:var(--dsw-alias-label-secondary);transition:all .15s ease;white-space:nowrap}',
+				'.dsh-llm-hub-route__btn:hover{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);',
+				'background:var(--dsw-alias-bg-layer-2)}',
+				'.dsh-llm-hub-route__btn.is-smart{border-color:var(--dsw-alias-state-warn-primary);color:var(--dsw-alias-state-warn-primary)}',
+				'.dsh-llm-hub-route__btn.is-busy{opacity:.55;cursor:progress}',
+				'.dsh-llm-hub-route__mark{font-size:11px;line-height:1}',
+				'.dsh-llm-hub-route__menu{position:absolute;bottom:calc(100% + 6px);left:0;z-index:60;min-width:240px;',
+				'padding:8px;border-radius:8px;border:.5px solid var(--dsw-alias-border-l2);',
+				'background:var(--dsw-alias-bg-layer-1,rgba(15,15,15,.96));backdrop-filter:blur(14px);',
+				'box-shadow:0 8px 24px rgba(0,0,0,.28);display:flex;flex-direction:column;gap:8px;font-size:11px}',
+				'.dsh-llm-hub-route__modes{display:flex;gap:4px}',
+				'.dsh-llm-hub-route__mode{flex:1;padding:4px 6px;border-radius:5px;border:.5px solid var(--dsw-alias-border-l1);',
+				'background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer;font:inherit;font-size:10.5px;transition:all .15s ease}',
+				'.dsh-llm-hub-route__mode.is-on{border-color:var(--dsw-alias-state-warn-primary);color:var(--dsw-alias-state-warn-primary);',
+				'background:var(--dsw-alias-bg-layer-2)}',
+				'.dsh-llm-hub-route__group{display:flex;flex-direction:column;gap:3px;padding:6px 7px;border-radius:6px;',
+				'border:.5px solid var(--dsw-alias-border-l1);background:transparent;cursor:pointer;text-align:left;',
+				'font:inherit;color:var(--dsw-alias-label-primary);transition:all .15s ease}',
+				'.dsh-llm-hub-route__group:hover{border-color:var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2)}',
+				'.dsh-llm-hub-route__group.is-active{border-color:var(--dsw-alias-state-warn-primary)}',
+				'.dsh-llm-hub-route__group-top{display:flex;align-items:center;justify-content:space-between;gap:6px}',
+				'.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)}',
 				// 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)}',
@@ -574,6 +615,7 @@ window.__ModuleLoader__.load({
 				'.dsh-suite-card-bottom{display:flex;align-items:center;justify-content:space-between;gap:6px;margin-top:auto;font-size:10.5px}',
 				'.dsh-suite-badge-active{display:inline-flex;align-items:center;gap:4px;color:var(--dsw-alias-state-success-primary,#10b981);font-weight:600;font-size:10.5px}',
 				'.dsh-suite-badge-active-dot{width:5px;height:5px;border-radius:50%;background:#10b981;box-shadow:0 0 6px rgba(16,185,129,0.6)}',
+				'.dsh-suite-badge-unknown{display:inline-flex;align-items:center;gap:4px;color:var(--dsw-alias-label-tertiary);font-weight:550;font-size:10.5px}',
 				'.dsh-suite-btn-action{cursor:pointer;padding:2px 8px;border-radius:4px;font-size:10px;font-weight:550;background:var(--dsw-alias-interactive-bg-subtle,rgba(255,255,255,0.06));border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);transition:all .15s;text-decoration:none;display:inline-flex;align-items:center;gap:3px}',
 				'.dsh-suite-btn-action:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,0.12));border-color:var(--dsw-alias-border-l1)}',
 				'.dsh-suite-link{color:var(--dsw-alias-label-tertiary);text-decoration:none;font-size:10px;display:inline-flex;align-items:center}',
@@ -722,13 +764,15 @@ window.__ModuleLoader__.load({
 						if (body == null || body.ok !== true) {
 							throw new Error(typeof body?.error === 'string' ? body.error : `HTTP ${response.status}`)
 						}
-						setState({
+						setState((prev) => ({
 							status: 'ok',
 							isAvailable: body.isAvailable === true,
 							balances: Array.isArray(body.balances) ? body.balances : [],
 							apiKey: typeof body.apiKey === 'string' ? body.apiKey : undefined,
-							keyMasked: typeof body.keyMasked === 'string' ? body.keyMasked : undefined
-						})
+							keyMasked: typeof body.keyMasked === 'string' ? body.keyMasked : undefined,
+							keys: Array.isArray(body.keys) ? body.keys : undefined,
+							billingMode: typeof body.billingMode === 'string' ? body.billingMode : (prev.billingMode || 'usage')
+						}))
 					})
 					.catch((error) => {
 						setState({ status: 'error', error: error instanceof Error ? error.message : String(error) })
@@ -809,9 +853,31 @@ window.__ModuleLoader__.load({
 			if (primary.granted !== '0' && primary.granted !== '0.00') breakdown.push(`${t('granted')} ${symbol}${primary.granted}`)
 			if (primary.toppedUp !== '0' && primary.toppedUp !== '0.00') breakdown.push(`${t('toppedUp')} ${symbol}${primary.toppedUp}`)
 
+			const mode = state.billingMode || 'usage'
+			const switchMode = (newMode) => {
+				setState((prev) => ({ ...prev, billingMode: newMode }))
+				fetch(BILLING_MODE_URL, {
+					method: 'POST',
+					headers: { 'content-type': 'application/json' },
+					body: JSON.stringify({ provider: 'deepseek', mode: newMode })
+				}).catch(() => {})
+			}
+
 			return h('div', { className: 'dsh-llm-hub-card' },
 				h('div', { className: 'dsh-llm-hub-card__meta' },
 					h('div', { className: 'dsh-llm-hub-card__tags' },
+						h('span', { className: 'dsh-llm-hub-billing-capsule' },
+							h('span', {
+								className: 'dsh-llm-hub-billing-pill ' + (mode === 'usage' ? 'is-active is-usage' : ''),
+								title: mode === 'usage' ? t('billingSwitchToSub') : t('billingSwitchToUsage'),
+								onClick: () => switchMode('usage')
+							}, t('billingUsage')),
+							h('span', {
+								className: 'dsh-llm-hub-billing-pill ' + (mode === 'subscription' ? 'is-active is-sub' : ''),
+								title: mode === 'subscription' ? t('billingSwitchToUsage') : t('billingSwitchToSub'),
+								onClick: () => switchMode('subscription')
+							}, t('billingSub'))
+						),
 						h('span', { className: 'dsh-llm-hub-balance-label' }, t('balance')),
 						h('span', { className: 'dsh-llm-hub-amount' + (warning?.level === 'low' ? ' is-low' : '') }, `${symbol}${primary.total}`),
 						h('span', { className: 'dsh-llm-hub-meta-sep' }, '·'),
@@ -841,10 +907,64 @@ window.__ModuleLoader__.load({
 							onClick: load
 						}, h(RefreshIcon, { spinning: isRefreshing }))
 					)
-				)
+				),
+				state.keys && state.keys.length > 1
+					? h('div', { className: 'dsh-llm-hub-card__actions', style: { paddingTop: '3px' } },
+						h('div', { className: 'dsh-llm-hub-card__tags' },
+							state.keys.map((k, idx) => h('span', {
+								key: k.ref,
+								className: 'dsh-llm-hub-key-chip' + (k.isAvailable ? '' : ' is-down'),
+								title: `${k.ref}: ${k.isAvailable ? '正常' : (k.error || '不可用')}`
+							}, `Key ${idx + 1} (${k.keyMasked}): ${k.isAvailable ? (k.currency === 'USD' ? '$' : '¥') + k.total : '⚠️ 余额不足'}`))
+						)
+					)
+					: null
 			)
 		}
 
+		function detectBillingMode(profile, status, balance) {
+			if (profile?.billingMode === 'usage' || profile?.billingMode === 'subscription') {
+				return profile.billingMode
+			}
+			if (status?.billingMode === 'usage' || status?.billingMode === 'subscription') {
+				return status.billingMode
+			}
+			if (balance && typeof balance === 'object') {
+				if (balance.kind === 'plan' || balance.kind === 'quota') return 'subscription'
+				if (Array.isArray(balance.items)) {
+					for (const item of balance.items) {
+						if (item?.resetsAt) return 'subscription'
+						if (typeof item?.weeklyPercent === 'number') return 'subscription'
+						if (item?.label && /(5h|hour|hourly|week|month|day|分|时|天|周|月)/i.test(item.label)) return 'subscription'
+						if (typeof item?.percent === 'number' && balance.meaning) return 'subscription'
+					}
+				}
+			}
+			const providerName = String(profile?.provider || profile?.id || status?.provider || '').toLowerCase()
+			const baseURL = String(status?.baseURL || profile?.baseURL || '').toLowerCase()
+
+			// 特殊套餐/订阅服务商智能识别（如 OpenCode Go、各类 Coding Plan 等）
+			if (providerName.includes('opencode') || baseURL.includes('opencode.ai') || providerName.includes('coding-plan')) {
+				if (balance?.kind !== 'cash' && balance?.kind !== 'deepseek') {
+					return 'subscription'
+				}
+			}
+
+			// 中转站（无定时限额的聚合/反代如 modelgo, relay, proxy, oneapi 等）基本都是按量付费
+			if (providerName.includes('modelgo') || providerName.includes('relay') || providerName.includes('proxy') || providerName.includes('oneapi') || providerName.includes('newapi') || providerName.includes('gateway')) {
+				return 'usage'
+			}
+
+			// 厂商原厂域名或现金余额默认按量付费
+			if (baseURL.includes('deepseek.com') || baseURL.includes('bigmodel.cn') || baseURL.includes('openai.com') || baseURL.includes('anthropic.com') || baseURL.includes('volces.com') || baseURL.includes('moonshot.cn') || baseURL.includes('minimax.chat') || baseURL.includes('baichuan-ai.com')) {
+				return 'usage'
+			}
+			if (balance?.kind === 'cash' || balance?.kind === 'deepseek') {
+				return 'usage'
+			}
+			return 'usage'
+		}
+
 		/**
 		 * 把 host 半的余额信封折成一行短文本；未加载 / 不支持时返回 null。
 		 * reason 原样透传，因为 host 半保证它一定是人话（"未填写服务地址，查不了余额"、
@@ -946,6 +1066,7 @@ window.__ModuleLoader__.load({
 			const [copied, setCopied] = React.useState(false)
 			const [balance, setBalance] = React.useState(null)
 			const [warning, setWarning] = React.useState(null)
+			const [billingModeOverride, setBillingModeOverride] = React.useState(null)
 			// 被摘掉的分组，在它自己的卡片上直接标出来 —— 动作条里一枚小片，不占额外行。
 			const availability = props.availability
 			const availabilityState = availability === undefined
@@ -1068,8 +1189,30 @@ window.__ModuleLoader__.load({
 						h('span', { className: 'dsh-llm-hub-error' }, typeof status.error === 'string' ? status.error : t('statusFail'))))
 			}
 
+			const currentBillingMode = billingModeOverride || status.billingMode || detectBillingMode(props.provider, status, balance)
+			const switchBillingMode = (newMode) => {
+				setBillingModeOverride(newMode)
+				fetch(BILLING_MODE_URL, {
+					method: 'POST',
+					headers: { 'content-type': 'application/json' },
+					body: JSON.stringify({ provider, mode: newMode })
+				}).catch(() => {})
+			}
+
 			// 元信息标签组（不重复展示外层已有的大标题，只呈现核心事实）
 			const tags = []
+			tags.push(h('span', { key: 'billing-capsule', className: 'dsh-llm-hub-billing-capsule' },
+				h('span', {
+					className: 'dsh-llm-hub-billing-pill ' + (currentBillingMode === 'usage' ? 'is-active is-usage' : ''),
+					title: currentBillingMode === 'usage' ? t('billingSwitchToSub') : t('billingSwitchToUsage'),
+					onClick: () => switchBillingMode('usage')
+				}, t('billingUsage')),
+				h('span', {
+					className: 'dsh-llm-hub-billing-pill ' + (currentBillingMode === 'subscription' ? 'is-active is-sub' : ''),
+					title: currentBillingMode === 'subscription' ? t('billingSwitchToUsage') : t('billingSwitchToSub'),
+					onClick: () => switchBillingMode('subscription')
+				}, t('billingSub'))
+			))
 			tags.push(h('span', { key: 'count', className: 'dsh-llm-hub-tag' }, `${t('configuredModels')} ${status.modelCount} ${t('modelsUnit')}`))
 			if (typeof status.api === 'string' && status.api !== '') {
 				const shortApi = status.api.replace('-messages', '').replace('-completions', '')
@@ -1420,49 +1563,103 @@ window.__ModuleLoader__.load({
 		}
 
 		/**
-		 * 多账号 key 轮换卡：展示当前轮换池状态与活跃 Key
+		 * composer 路由快切 chip（1.5.0 智能路由组）。
+		 *
+		 * 挂在 `conversation.input.left`（composer 工具行左端，追加型 list slot）：
+		 *   · 未配置任何路由组时整个 chip 不渲染 —— 存在即有意义；
+		 *   · 关起时一行小字：⚡智能 · 公司（smart 模式）/ 🧭 · 公司（manual）；
+		 *   · 点开是浮层：模式二选一（智能路由 = 接管，实际路由按额度自动切；
+		 *     手动 = 尊重你在模型下拉里选的），下面是组列表（每组显示「将路由到
+		 *     哪个」与可用状态），点组即切、立即持久化。
+		 *
+		 * 数据流：GET /routing/state（挂载 + 每 30s 轮询 + 操作后重拉），
+		 * 写操作 POST /routing/select。chip 显示「最近实际路由」—— smart 模式
+		 * 下模型下拉显示什么已经不重要，这里才是事实。
 		 */
-		function KeyPoolCard(props) {
+		function SmartRouteChip(props) {
 			const t = typeof props.t === 'function' ? props.t : fallbackT
-			const [report, setReport] = React.useState(null)
-			React.useEffect(() => {
-				let alive = true
-				fetch(KEYPOOL_URL, { headers: { accept: 'application/json' } })
+			const [state, setState] = React.useState(null)
+			const [open, setOpen] = React.useState(false)
+			const [busy, setBusy] = React.useState(false)
+			const query = React.useCallback(() => {
+				fetch(ROUTING_STATE_URL, { headers: { accept: 'application/json' } })
 					.then((res) => res.json())
-					.then((body) => { if (alive) setReport(body !== null && typeof body === 'object' ? body : null) })
-					.catch(() => { if (alive) setReport(null) })
-				return () => { alive = false }
+					.then((body) => { if (body !== null && typeof body === 'object' && body.ok === true) setState(body) })
+					.catch(() => {})
 			}, [])
-			if (report === null) return null
-			const providers = Array.isArray(report.providers) ? report.providers : []
-			if (providers.length === 0) return null
+			React.useEffect(() => {
+				query()
+				const interval = setInterval(query, 30000)
+				return () => clearInterval(interval)
+			}, [query])
+			// 一个组都没有：chip 无事可做，不渲染（配置在 settings.yaml 里加）。
+			if (state === null || !Array.isArray(state.groups) || state.groups.length === 0) return null
 			ensureStyle()
-			const formatTime = (ms) => {
-				if (typeof ms !== 'number' || ms <= 0) return '—'
-				const d = new Date(ms)
-				return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}:${String(d.getSeconds()).padStart(2, '0')}`
+			const activeGroup = state.groups.find((group) => group.id === state.activeGroup) ?? state.groups[0]
+			const isSmart = state.mode === 'smart'
+			const chipClass = [
+				'dsh-llm-hub-route__btn',
+				isSmart ? 'is-smart' : '',
+				busy ? 'is-busy' : ''
+			].filter(Boolean).join(' ')
+			const label = (activeGroup && (activeGroup.label ?? activeGroup.id)) ?? ''
+			const chipTitle = isSmart
+				? `${t('routeChipModeSmart')} · ${label} —— ${state.lastDecision?.to ? `${t('routeChipLastRoute')}: ${state.lastDecision.to.provider}/${state.lastDecision.to.model}` : t('routeChipFailOpen')}`
+				: `${t('routeChipModeManual')} · ${label}`
+			const select = async (patch) => {
+				setBusy(true)
+				fetch(ROUTING_SELECT_URL, {
+					method: 'POST',
+					headers: { 'content-type': 'application/json', accept: 'application/json' },
+					body: JSON.stringify(patch)
+				})
+					.then((res) => res.json())
+					.then((body) => { if (body !== null && typeof body === 'object' && body.ok === true) setState(body) })
+					.catch(() => {})
+					.finally(() => { setBusy(false); query() })
+			}
+			const stateText = (group) => {
+				if (group.wouldRoute) {
+					const next = `${group.wouldRoute.provider}/${group.wouldRoute.model}`
+					return group.reason !== null && group.reason !== undefined ? group.reason : `${t('routeChipWouldRoute')}: ${next}`
+				}
+				return group.reason ?? t('routeChipReasonNone')
 			}
-			const rows = providers.map((entry) => {
-				const chosen = entry.lastChosen
-				const isActive = chosen !== null
-				return h('div', {
-					key: entry.provider,
-					className: 'dsh-llm-hub-keypool__row' + (isActive ? ' is-active' : '')
+			const menu = open ? h('div', { className: 'dsh-llm-hub-route__menu' },
+				h('div', { className: 'dsh-llm-hub-route__modes' },
+					h('button', {
+						type: 'button',
+						className: `dsh-llm-hub-route__mode${isSmart ? ' is-on' : ''}`,
+						onClick: () => { if (!isSmart) select({ mode: 'smart' }) }
+					}, `⚡ ${t('routeChipModeSmart')}`),
+					h('button', {
+						type: 'button',
+						className: `dsh-llm-hub-route__mode${!isSmart ? ' is-on' : ''}`,
+						onClick: () => { if (isSmart) select({ mode: 'manual' }) }
+					}, t('routeChipModeManual'))),
+				...state.groups.map((group) => h('button', {
+					key: group.id,
+					type: 'button',
+					className: `dsh-llm-hub-route__group${group.id === state.activeGroup ? ' is-active' : ''}`,
+					onClick: () => {
+						const patch = { activeGroup: group.id }
+						if (!isSmart) patch.mode = 'smart'
+						select(patch)
+					}
 				},
-					h('span', { className: 'dsh-llm-hub-health-dot ' + (isActive ? 'is-ok' : '') }),
-					h('span', { className: 'dsh-llm-hub-keypool__name' }, entry.provider),
-					h('span', { className: 'dsh-llm-hub-keypool__meta' }, `${entry.total} keys`),
-					chosen === null
-						? h('span', { className: 'dsh-llm-hub-keypool__pending' }, '—')
-						: h('span', { className: 'dsh-llm-hub-keypool__chosen' },
-							h('span', null, chosen.name),
-							h('small', null, ` #${chosen.index + 1} / ${entry.total} · ${formatTime(chosen.at)}`)))
-			})
-			return h('div', { className: 'dsh-llm-hub-keypool' },
-				h('div', { className: 'dsh-llm-hub-keypool__head' },
-					h('span', { className: 'dsh-llm-hub-keypool__title' }, '🔄 ' + t('keypoolTitle')),
-					h('span', { className: 'dsh-llm-hub-subtext' }, t('keypoolRound'))),
-				h('div', { className: 'dsh-llm-hub-keypool__rows' }, rows))
+					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
+			return h('div', { className: 'dsh-llm-hub-route' },
+				h('button', {
+					type: 'button',
+					className: chipClass,
+					title: chipTitle,
+					onClick: () => { setOpen(!open); query() }
+				},
+					h('span', { className: 'dsh-llm-hub-route__mark' }, isSmart ? '⚡' : '🧭'),
+					h('span', null, `${isSmart ? `${t('routeChipSmart')} · ` : ''}${label}`)),
+				menu)
 		}
 
 		/**
@@ -1668,11 +1865,13 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					// 别写死我自己的 profile 名，也别只给一条 npm i —— 装进 node_modules
 					// 不等于接进 boot graph，少了 bundles 那行插件根本不会加载。
+					// 第 2 步对 `dsh plugin add` 是自动的（装完会 reconcile bundles），
+					// 只有手写 package.json 或从别处搬时才需要手动补，所以标成「如果没自动加」。
 					const text = [
 						`${meta.name} —— DSH 模型页增强：网关可达性探测、余额/配额、模型目录勾选写回配置。`,
 						'装到你的 DSH（profile 名按自己的改，默认 web）：',
 						`  1) dsh plugin --profile web add ${meta.name}`,
-						`  2) 把 "${meta.name}" 加进 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles`,
+						`  2) 确认 "${meta.name}" 在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 里（dsh plugin add 会自动加）`,
 						'  3) 重启 DSH',
 						typeof meta.homepage === 'string' ? `仓库：${meta.homepage}` : ''
 					].filter((line) => line !== '').join('\n')
@@ -1707,6 +1906,38 @@ window.__ModuleLoader__.load({
 				links)
 		}
 
+		/**
+		 * 已激活的客户端插件 id 集合 —— 读宿主注入的 `window.__DSH_BOOT__.entries`。
+		 *
+		 * 为什么是这个源：`__DSH_BOOT__` 由 `dsh-client-modules` 在渲染 index 时注入，
+		 * 就是浏览器真正要拉取并执行的那份组合图。它在，插件就一定活着；它不在，
+		 * 无论 npm 装没装都不会加载。比「读 profile 的 package.json」更硬：后者只说明
+		 * 装过，**接没接进 boot graph 是另一回事**（少了 `dsh.profile.bundles` 那行，
+		 * 依赖装了也不加载），而那正是这套 Dock 想告诉人的事。
+		 *
+		 * 读不到就返回 null（不是空集合）：分不清「一个都没装」和「读不到」时，
+		 * 宁可不做判定 —— 全部显示成未安装，是把探测失败谎报成事实。
+		 * @returns 已激活的 id 集合，或 null。
+		 */
+		function readActivatedPluginIds() {
+			try {
+				const boot = typeof window === 'undefined' ? undefined : window.__DSH_BOOT__
+				if (boot === null || typeof boot !== 'object' || !Array.isArray(boot.entries)) return null
+				return new Set(boot.entries.filter((entry) => entry && typeof entry.id === 'string').map((entry) => entry.id))
+			} catch {
+				return null
+			}
+		}
+
+		/** 一个家族条目是否已激活：按 id 与 aliases 逐个比对（scope 迁移过的包名都在 aliases 里）。 */
+		function isSuiteItemActive(item, activated) {
+			if (activated === null) return null
+			for (const candidate of [item.id, ...(item.aliases ?? [])]) {
+				if (activated.has(candidate)) return true
+			}
+			return false
+		}
+
 		/**
 		 * Webkubor DSH 扩展家族互导 Dock
 		 */
@@ -1733,8 +1964,7 @@ window.__ModuleLoader__.load({
 					icon: '🎛️',
 					desc: '多模型网关、余额配额、多Key轮换与极客大屏',
 					repo: 'https://github.com/webkubor/dsh-llm-hub',
-					pkg: '@dsh-plugins/dsh-llm-hub',
-					isCurrent: true
+					pkg: '@dsh-plugins/dsh-llm-hub'
 				},
 				{
 					id: '@dsh-plugins/dsh-user-mirror',
@@ -1756,8 +1986,14 @@ window.__ModuleLoader__.load({
 				}
 			]
 
+			// 判定在 render 里现读：`__DSH_BOOT__` 是宿主渲染 index 时注入的全局，之后
+			// 不会再变（组合图变了要整页重载），所以不需要状态也不需要订阅。
+			const activated = readActivatedPluginIds()
+
 			const handleCopy = (pkg) => {
-				const cmd = `dsh plugin install ${pkg}`
+				// 命令必须带 `--profile`：`dsh plugin` 是 pnpm 的透传层，profile 是
+				// **必填**选项，漏了直接报错退出 —— 复制出去的命令得是能跑的。
+				const cmd = `dsh plugin --profile web add ${pkg}`
 				if (navigator.clipboard) {
 					navigator.clipboard.writeText(cmd)
 				}
@@ -1775,7 +2011,7 @@ window.__ModuleLoader__.load({
 				),
 				h('div', { className: 'dsh-suite-cards' },
 					...suite.map((item) => {
-						const isInstalled = item.isCurrent
+						const active = isSuiteItemActive(item, activated)
 						const isCopied = copiedPkg === item.pkg
 
 						return h('div', { key: item.id, className: 'dsh-suite-card' },
@@ -1790,17 +2026,21 @@ window.__ModuleLoader__.load({
 							),
 							h('div', { className: 'dsh-suite-card-desc' }, item.desc),
 							h('div', { className: 'dsh-suite-card-bottom' },
-								isInstalled ? (
+								active === true ? (
 									h('span', { className: 'dsh-suite-badge-active' },
 										h('span', { className: 'dsh-suite-badge-active-dot' }),
 										t('suiteActive')
 									)
+								) : active === null ? (
+									// 读不到 boot graph（老宿主 / 非 web 载体）：说「判定不了」，
+									// 不说「没装」—— 后者是把探测失败当结论。
+									h('span', { className: 'dsh-suite-badge-unknown' }, t('suiteUnknown'))
 								) : (
 									h('button', {
 										type: 'button',
 										className: 'dsh-suite-btn-action',
 										onClick: () => handleCopy(item.pkg),
-										title: `安装命令: dsh plugin install ${item.pkg}`
+										title: `安装命令: dsh plugin --profile web add ${item.pkg}`
 									}, isCopied ? `✓ ${t('suiteCopied')}` : `⚡ ${t('suiteCopyInstall')}`)
 								),
 								h('a', {
@@ -1993,13 +2233,6 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: () => ({ t, availability })
 			}, HealthCard))
-			ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
-				name: 'settings.models.footer',
-				id: 'dsh-llm-hub-keypool',
-				order: 73,
-				locale: NS,
-				inject: () => ({ t })
-			}, KeyPoolCard))
 			ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
 				name: 'settings.models.footer',
 				id: 'dsh-llm-hub-routing',
@@ -2035,6 +2268,15 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: () => ({ t })
 			}, WebkuborSuiteDock))
+			// composer 工具行左端的路由快切 chip —— 「切公司 / 切个人 + 智能开关」
+			// 的高频操作留在聊天页，不用进设置页。list slot 必须带 id（同 footer 的教训）。
+			ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
+				name: 'conversation.input.left',
+				id: 'dsh-llm-hub-route-chip',
+				order: 20,
+				locale: NS,
+				inject: () => ({ t })
+			}, SmartRouteChip))
 		}
 
 		exports.apply = apply