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

package/lib/index.js

@@ -356,6 +356,20 @@ function sendJson(response, status, payload) {
 	response.end(JSON.stringify(payload))
 }
 
+/**
+ * API Key 脱敏 —— 保留首尾（前4~6位 + 后4位），中间用 •••• 掩码。
+ * @param {string|undefined|null} key - 原始 Key
+ * @returns {string|null} 脱敏后的 Key，无有效值时返回 null
+ */
+export function maskKey(key) {
+	if (typeof key !== 'string' || key.trim() === '') return null
+	const trimmed = key.trim()
+	if (trimmed.length <= 8) return '••••••••'
+	const head = trimmed.length >= 24 ? 6 : 4
+	const tail = 4
+	return `${trimmed.slice(0, head)}••••${trimmed.slice(-tail)}`
+}
+
 export const name = 'dsh-llm-hub'
 /**
  * 硬依赖：llm（注册发现 + 监听 llm/stream + 过滤 listProviders）、webServer（HTTP 路由）。
@@ -691,13 +705,14 @@ export function apply(ctx) {
 				return
 			}
 			try {
+				const { apiKey } = await connectionFacts()
 				const payload = shapeBalance(await getJson('/user/balance'))
 				if (request.method === 'HEAD') {
 					response.writeHead(200, { 'content-type': 'application/json; charset=utf-8' })
 					response.end()
 					return
 				}
-				send(200, { ok: true, ...payload })
+				send(200, { ok: true, apiKey: apiKey ?? null, keyMasked: maskKey(apiKey), ...payload })
 			} catch (error) {
 				send(502, { ok: false, error: error instanceof Error ? error.message : String(error) })
 			}
@@ -870,6 +885,8 @@ export function apply(ctx) {
 			baseURLSource: baseURL !== undefined ? 'settings' : (KNOWN_GATEWAY_BASE[String(provider ?? '')] !== undefined ? 'known' : 'none'),
 			apiKeyEnv: ref,
 			keyConfigured: apiKey !== undefined,
+			keyMasked: maskKey(apiKey),
+			apiKey: apiKey ?? null,
 			modelCount: models.length,
 			// 已配置的 id 列表：前端拉到网关目录后要据此把「已经在用的」默认勾上，
 			// 光有数量做不到这件事。
@@ -1473,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
 	}
@@ -1513,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)
 		}
 	}
 
@@ -1613,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 服务的路由表里摘掉。
 	//
@@ -2258,32 +2301,6 @@ export function apply(ctx) {
 		}
 	}), 'dsh-llm-hub: routing resolve route')
 
-	ctx.effect(() => ctx.webServer.register({
-		kind: 'exact',
-		path: ROUTING_RESOLVE_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
-			}
-			let payload
-			try {
-				const collected = []
-				for await (const chunk of request) collected.push(chunk)
-				payload = JSON.parse(Buffer.concat(collected).toString('utf8'))
-			} catch {
-				sendJson(response, 400, { ok: false, error: '请求内容不是合法 JSON' })
-				return
-			}
-			sendJson(response, 200, resolveRoute(payload?.active))
-		}
-	}), 'dsh-llm-hub: routing resolve route')
-
 	// ── 模型别名 ──────────────────────────────────────────────────────────────
 	//
 	// settings.dsh-llm-hub.aliases：把长 model id 映射成短显示名，典型场景：

package/package.json

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