@dsh-plugins/dsh-llm-hub 1.3.1 → 1.3.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [1.3.2] - 2026-09-24
+
+### 🐛 修复与健壮性提升
+
+- **⚡ 解决 MiniMax 等大模型临时限额导致下拉永久死锁问题**：
+  - 核心逻辑解耦：重构可用性过滤判定，严格区分「致命凭据故障（`CREDENTIAL_MISSING` / `AUTH_REJECTED`）」与「临时配额/余额状态（`QUOTA_EXHAUSTED` / `BALANCE_EMPTY` / `PAYMENT_REQUIRED`）」；
+  - 临时配额用尽（如 MiniMax 5 小时滚动配额 / 周配额达到 100% 用量）仅在设置页与状态卡片进行友好 warning 预警，**不再从 `llm.listProviders()` 下拉菜单中强行抹除**；
+  - 彻底破除「额度用尽 → 下拉消失 → 无法选择该模型发请求 → 运行期遥测恢复机制永久无法触发」的死锁链条；
+- **🔄 后台主动保鲜与自愈机制（Auto-healing Probe）**：
+  - 在插件生命周期内新增守护探针轮询（`TTL = 5m`），结合 `.unref()` 保证无副作用后台运行；
+  - 当 MiniMax 5 小时重置窗口或余额恢复后，后台探针自动感知并重置为 `available`，无需手动重启或进入设置页刷新。
+
 ## [1.3.1] - 2026-09-23
 
 ### ✨ UI 视觉升级与极客装配 Hub

package/lib/client.js

@@ -187,7 +187,12 @@ window.__ModuleLoader__.load({
 				usageClear: '清空记录',
 				usageCleared: '已清空',
 				usageClearConfirm: '确认清空？',
-				usageNoData: '本月还没有记录'
+				usageNoData: '本月还没有记录',
+				suiteTitle: 'Webkubor DSH 扩展家族',
+				suiteDesc: '一键构建完整智能体开发环境',
+				suiteActive: '已激活',
+				suiteCopyInstall: '复制安装',
+				suiteCopied: '已复制命令'
 			},
 			en: {
 				balance: 'Balance',
@@ -297,7 +302,12 @@ window.__ModuleLoader__.load({
 				usageClear: 'Clear records',
 				usageCleared: 'Cleared',
 				usageClearConfirm: 'Confirm clear?',
-				usageNoData: 'no calls this month yet'
+				usageNoData: 'no calls this month yet',
+				suiteTitle: 'Webkubor DSH Plugin Suite',
+				suiteDesc: 'One-click full agent development environment',
+				suiteActive: 'Active',
+				suiteCopyInstall: 'Copy install',
+				suiteCopied: 'Command copied'
 			}
 		}
 
@@ -537,6 +547,25 @@ window.__ModuleLoader__.load({
 				'.dsh-llm-hub-latency-badge.is-fast{background:rgba(16,185,129,.08);color:var(--dsw-alias-state-success-primary,#10b981);border:.5px solid rgba(16,185,129,.2)}',
 				'.dsh-llm-hub-latency-badge.is-normal{background:rgba(234,179,8,.08);color:var(--dsw-alias-state-warn-primary,#eab308);border:.5px solid rgba(234,179,8,.2)}',
 				'.dsh-llm-hub-latency-badge.is-slow{background:rgba(239,68,68,.08);color:var(--dsw-alias-state-error-primary,#ef4444);border:.5px solid rgba(239,68,68,.2)}',
+				// Webkubor 插件全家桶互导矩阵
+				'.dsh-suite-dock{margin-top:14px;padding:14px 16px;background:var(--dsw-alias-bg-layer-2,rgba(255,255,255,0.03));border:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,0.08));border-radius:10px;backdrop-filter:blur(10px)}',
+				'.dsh-suite-head{display:flex;align-items:center;justify-content:space-between;margin-bottom:10px;flex-wrap:wrap;gap:8px}',
+				'.dsh-suite-title{font-size:12px;font-weight:650;color:var(--dsw-alias-label-primary);margin:0;display:flex;align-items:center;gap:6px}',
+				'.dsh-suite-desc{font-size:10.5px;color:var(--dsw-alias-label-tertiary);letter-spacing:.2px}',
+				'.dsh-suite-cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:8px}',
+				'.dsh-suite-card{display:flex;flex-direction:column;justify-content:space-between;padding:10px 12px;border-radius:8px;background:var(--dsw-alias-bg-layer-3,rgba(255,255,255,0.02));border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,0.05));transition:all .2s cubic-bezier(0.16,1,0.3,1)}',
+				'.dsh-suite-card:hover{transform:translateY(-1px);border-color:var(--dsw-alias-brand-primary,#3b82f6);box-shadow:0 4px 14px rgba(0,0,0,0.15)}',
+				'.dsh-suite-card-top{display:flex;align-items:center;gap:6px;margin-bottom:4px}',
+				'.dsh-suite-card-icon{font-size:15px;line-height:1}',
+				'.dsh-suite-card-name{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary);text-decoration:none}',
+				'.dsh-suite-card-desc{font-size:10.5px;color:var(--dsw-alias-label-secondary);line-height:1.4;margin-bottom:8px;flex:1}',
+				'.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-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}',
+				'.dsh-suite-link:hover{color:var(--dsw-alias-label-primary)}'
 			].join('')
 			document.head.appendChild(style)
 		}
@@ -659,7 +688,9 @@ window.__ModuleLoader__.load({
 			const verdict = Array.isArray(availabilityState.providers)
 				? availabilityState.providers.find((entry) => entry.provider === DEEPSEEK_PROVIDER)
 				: undefined
-			const hiddenFromDropdown = verdict !== undefined && verdict.state === 'unavailable'
+			const hiddenFromDropdown = Array.isArray(availabilityState.hidden)
+				? availabilityState.hidden.includes(DEEPSEEK_PROVIDER)
+				: (verdict !== undefined && verdict.state === 'unavailable')
 
 			const load = React.useCallback(() => {
 				if (!keyConfigured) {
@@ -881,7 +912,9 @@ window.__ModuleLoader__.load({
 			const verdict = Array.isArray(availabilityState.providers)
 				? availabilityState.providers.find((entry) => entry.provider === provider)
 				: undefined
-			const hiddenFromDropdown = verdict !== undefined && verdict.state === 'unavailable'
+			const hiddenFromDropdown = Array.isArray(availabilityState.hidden)
+				? availabilityState.hidden.includes(provider)
+				: (verdict !== undefined && verdict.state === 'unavailable')
 
 			React.useEffect(() => {
 				if (provider === '' || status === null || status.ok !== true || !status.balanceAdapter) return undefined
@@ -1632,6 +1665,115 @@ window.__ModuleLoader__.load({
 				links)
 		}
 
+		/**
+		 * Webkubor DSH 扩展家族互导 Dock
+		 */
+		function WebkuborSuiteDock(props) {
+			const t = typeof props.t === 'function' ? props.t : fallbackT
+			const [copiedPkg, setCopiedPkg] = React.useState(null)
+
+			ensureStyle()
+
+			const suite = [
+				{
+					id: '@dsh-plugins/dsh-bloom-theme',
+					aliases: ['dsh-bloom-theme', '@dsh-plugins/dsh-bloom-theme'],
+					name: 'Bloom Theme',
+					icon: '🌸',
+					desc: '落霞 Bloom 极客质感毛玻璃主题与代码高亮',
+					repo: 'https://github.com/webkubor/dsh-bloom-theme',
+					pkg: '@dsh-plugins/dsh-bloom-theme'
+				},
+				{
+					id: '@dsh-plugins/dsh-llm-hub',
+					aliases: ['dsh-llm-hub', '@dsh-plugins/dsh-llm-hub'],
+					name: 'LLM Hub',
+					icon: '🎛️',
+					desc: '多模型网关、余额配额、多Key轮换与极客大屏',
+					repo: 'https://github.com/webkubor/dsh-llm-hub',
+					pkg: '@dsh-plugins/dsh-llm-hub',
+					isCurrent: true
+				},
+				{
+					id: '@dsh-plugins/dsh-user-mirror',
+					aliases: ['dsh-user-mirror', 'dsh-mirror', '@dsh-plugins/dsh-user-mirror'],
+					name: 'User Mirror',
+					icon: '🪞',
+					desc: '用户角色数字画像、习惯偏好与记忆网络',
+					repo: 'https://github.com/webkubor/dsh-mirror',
+					pkg: '@dsh-plugins/dsh-user-mirror'
+				},
+				{
+					id: '@dsh-plugins/dsh-env-inspector',
+					aliases: ['dsh-env-inspector', '@dsh-plugins/dsh-env-inspector'],
+					name: 'Env Inspector',
+					icon: '🖥️',
+					desc: '端口监听释放、CLI工具链与环境大屏',
+					repo: 'https://github.com/webkubor/dsh-env-inspector',
+					pkg: '@dsh-plugins/dsh-env-inspector'
+				}
+			]
+
+			const handleCopy = (pkg) => {
+				const cmd = `dsh plugin install ${pkg}`
+				if (navigator.clipboard) {
+					navigator.clipboard.writeText(cmd)
+				}
+				setCopiedPkg(pkg)
+				setTimeout(() => setCopiedPkg(null), 2000)
+			}
+
+			return h('div', { className: 'dsh-suite-dock' },
+				h('div', { className: 'dsh-suite-head' },
+					h('h3', { className: 'dsh-suite-title' },
+						h('span', null, '🌟'),
+						t('suiteTitle')
+					),
+					h('span', { className: 'dsh-suite-desc' }, t('suiteDesc'))
+				),
+				h('div', { className: 'dsh-suite-cards' },
+					...suite.map((item) => {
+						const isInstalled = item.isCurrent
+						const isCopied = copiedPkg === item.pkg
+
+						return h('div', { key: item.id, className: 'dsh-suite-card' },
+							h('div', { className: 'dsh-suite-card-top' },
+								h('span', { className: 'dsh-suite-card-icon' }, item.icon),
+								h('a', {
+									href: item.repo,
+									target: '_blank',
+									rel: 'noopener noreferrer',
+									className: 'dsh-suite-card-name'
+								}, item.name)
+							),
+							h('div', { className: 'dsh-suite-card-desc' }, item.desc),
+							h('div', { className: 'dsh-suite-card-bottom' },
+								isInstalled ? (
+									h('span', { className: 'dsh-suite-badge-active' },
+										h('span', { className: 'dsh-suite-badge-active-dot' }),
+										t('suiteActive')
+									)
+								) : (
+									h('button', {
+										type: 'button',
+										className: 'dsh-suite-btn-action',
+										onClick: () => handleCopy(item.pkg),
+										title: `安装命令: dsh plugin install ${item.pkg}`
+									}, isCopied ? `✓ ${t('suiteCopied')}` : `⚡ ${t('suiteCopyInstall')}`)
+								),
+								h('a', {
+									href: item.repo,
+									target: '_blank',
+									rel: 'noopener noreferrer',
+									className: 'dsh-suite-link'
+								}, 'GitHub ↗')
+							)
+						)
+					})
+				)
+			)
+		}
+
 		/**
 		 * 可用性判定缓存 —— 所有会话共用一份（同一个 host、同一份设置）。
 		 *
@@ -1844,6 +1986,13 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: () => ({ t, availability })
 			}, HubFooter))
+			ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
+				name: 'settings.models.footer',
+				id: 'dsh-llm-hub-suite',
+				order: 110,
+				locale: NS,
+				inject: () => ({ t })
+			}, WebkuborSuiteDock))
 		}
 
 		exports.apply = apply

package/lib/index.js

@@ -1490,11 +1490,29 @@ export function apply(ctx) {
 		return [...merged.values()].sort((left, right) => left.provider.localeCompare(right.provider))
 	}
 
+	/**
+	 * 判定是否属于应从模型下拉彻底摘掉的严重凭据故障。
+	 *
+	 * ⚠️ 设计原则（避免死锁）：
+	 * 只有确凿的凭据故障（CREDENTIAL_MISSING / AUTH_REJECTED / ACCOUNT_UNAVAILABLE）才从下拉框剔除。
+	 * 配额耗尽（QUOTA_EXHAUSTED）与现金余额为 0（BALANCE_EMPTY / PAYMENT_REQUIRED）属于临时限额/计费状态，
+	 * 绝不能从下拉框中剔除，否则会导致：
+	 * 1) 用户在界面上永久丢失模型入口；
+	 * 2) 5小时滚动配额或周配额恢复后，用户因无法选模型而无法触发运行期遥测恢复；
+	 * 3) 形成死锁。
+	 */
+	const isDropDeadHidden = (verdict) => {
+		if (verdict === null || typeof verdict !== 'object') return false
+		if (verdict.state !== 'unavailable') return false
+		const code = verdict.code
+		return code === 'CREDENTIAL_MISSING' || code === 'AUTH_REJECTED' || code === 'ACCOUNT_UNAVAILABLE'
+	}
+
 	/** 当前该从下拉里摘掉的 provider 集合。 */
 	const hiddenProviders = () => {
 		const hidden = new Set()
 		for (const verdict of currentAvailability()) {
-			if (verdict.state === 'unavailable') hidden.add(verdict.provider)
+			if (isDropDeadHidden(verdict)) hidden.add(verdict.provider)
 		}
 		return hidden
 	}
@@ -1530,7 +1548,7 @@ export function apply(ctx) {
 			checkedAt: lastProbeAt,
 			probing: probeAll !== null,
 			providers,
-			hidden: providers.filter((verdict) => verdict.state === 'unavailable').map((verdict) => verdict.provider)
+			hidden: providers.filter(isDropDeadHidden).map((verdict) => verdict.provider)
 		}
 	}
 
@@ -1630,8 +1648,16 @@ export function apply(ctx) {
 		const timer = setTimeout(() => {
 			refreshAvailability().catch(() => {})
 		}, 1500)
-		return () => clearTimeout(timer)
-	}, 'dsh-llm-hub: initial availability probe')
+		timer.unref?.()
+		const interval = setInterval(() => {
+			ensureAvailabilityFresh()
+		}, AVAILABILITY_TTL_MS)
+		interval.unref?.()
+		return () => {
+			clearTimeout(timer)
+			clearInterval(interval)
+		}
+	}, 'dsh-llm-hub: initial and periodic availability probe')
 
 	// 把不可用的 provider 从 llm 服务的路由表里摘掉。
 	//

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugins/dsh-llm-hub",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "DSH 模型管理层：网关可达性探测、模型目录拉取、DeepSeek + MiniMax/智谱/Moonshot/StepFun 余额与配额、本月用量统计、余额预警、Provider 健康看板，再把本机装好的 codex / claude / agy 注册成子代理（装了才出现）。零运行时依赖，不改动 DSH 安装。",
   "type": "module",
   "main": "lib/index.js",