@dsh-plugins/dsh-llm-hub 1.6.0 → 1.7.0

package/lib/index.js

@@ -291,6 +291,35 @@ export function parseRouteEntryPure(entry) {
  * @param {object|undefined|null} routing - settings.routing 段。
  * @returns {{ groups: Array, mode: 'manual'|'smart', activeGroup: string }}
  */
+/**
+ * 备注清洗：只收字符串，去首尾空白，空串视为没有，最长 120 字。
+ * @param {unknown} value - 原始备注。
+ * @returns {string | null}
+ */
+export function cleanRouteNote(value) {
+	if (typeof value !== 'string') return null
+	const note = value.trim().slice(0, 120)
+	return note === '' ? null : note
+}
+
+/**
+ * 候选备注表：只保留键是合法 `provider/model`、且确实在本组候选里的条目 ——
+ * 删掉候选时它的备注一并消失，不在 settings 里留孤儿。
+ * @param {unknown} raw - settings 里的 notes 字典。
+ * @param {Array<{provider: string, model: string}>} entries - 本组全部候选。
+ * @returns {Record<string, string> | null}
+ */
+function cleanRouteNotes(raw, entries) {
+	if (raw === null || typeof raw !== 'object') return null
+	const keys = new Set(entries.map((entry) => `${entry.provider}/${entry.model}`))
+	const out = {}
+	for (const [key, value] of Object.entries(raw)) {
+		const note = cleanRouteNote(value)
+		if (note !== null && keys.has(key)) out[key] = note
+	}
+	return Object.keys(out).length > 0 ? out : null
+}
+
 export function parseRoutingGroups(routing) {
 	const r = routing !== null && typeof routing === 'object' ? routing : {}
 	const mode = r.mode === 'smart' ? 'smart' : 'manual'
@@ -306,11 +335,15 @@ export function parseRoutingGroups(routing) {
 			.filter((entry) => entry !== undefined)
 		if (primary === null && fallbacks.length === 0) continue
 		seen.add(id)
+		const note = cleanRouteNote(raw.note)
+		const notes = cleanRouteNotes(raw.notes, [...(primary !== null ? [primary] : []), ...fallbacks])
 		groups.push({
 			id,
 			label: typeof raw.label === 'string' && raw.label.trim() !== '' ? raw.label.trim() : null,
 			primary,
-			fallbacks
+			fallbacks,
+			...(note !== null ? { note } : {}),
+			...(notes !== null ? { notes } : {})
 		})
 	}
 	if (groups.length === 0) {
@@ -422,11 +455,22 @@ export function normalizeRoutingGroupsInput(raw) {
 		}
 		if (primary === null && fallbacks.length === 0) { dropped.push(`组 ${id} 没有任何合法候选`); continue }
 		seen.add(id)
+		// 候选备注两种来源：编辑器形态里每个候选对象自带 note；落盘形态是组上的 notes 字典。
+		const noteSource = { ...(item.notes !== null && typeof item.notes === 'object' ? item.notes : {}) }
+		for (const candidate of ordered ?? []) {
+			const entry = asEntry(candidate)
+			const note = candidate !== null && typeof candidate === 'object' ? cleanRouteNote(candidate.note) : null
+			if (entry !== undefined && note !== null) noteSource[`${entry.provider}/${entry.model}`] = note
+		}
+		const note = cleanRouteNote(item.note)
+		const notes = cleanRouteNotes(noteSource, [...(primary !== null ? [primary] : []), ...fallbacks])
 		groups.push({
 			id,
 			label: typeof item.label === 'string' && item.label.trim() !== '' ? item.label.trim().slice(0, 32) : null,
 			primary,
-			fallbacks
+			fallbacks,
+			...(note !== null ? { note } : {}),
+			...(notes !== null ? { notes } : {})
 		})
 	}
 	return { groups, dropped }
@@ -638,7 +682,9 @@ export function apply(ctx) {
 			try {
 				const mod = await import('@deepseek-ai/schemastery')
 				const z = (mod && typeof mod === 'object' ? mod.default ?? mod : mod)
-				const groupItem = z.object({ id: z.string().required(), label: z.string(), primary: z.string(), fallbacks: z.array(z.string()) })
+				// note / notes（1.7.0）：页面上写的备注。YAML 注释在页面保存时会被整段替换冲掉，
+				// 所以说明要落成字段才留得住。notes 以 'provider/model' 为键。
+				const groupItem = z.object({ id: z.string().required(), label: z.string(), note: z.string(), primary: z.string(), fallbacks: z.array(z.string()), notes: z.dict(z.string()) })
 				schema = z.object({
 					routing: z.object({
 						mode: z.union(['manual', 'smart']).default('manual'),
@@ -1294,7 +1340,12 @@ export function apply(ctx) {
 			auth: 'raw',
 			shape: (body) => {
 				if (body?.success === false || (typeof body?.code === 'number' && body.code !== 200)) {
-					return { unavailable: label(body?.msg) ?? 'quota unavailable' }
+					// 服务端用一份完整的 JSON 明确回答「你这个号没有套餐」
+					// （2026-09-29 实测：`当前用户不存在coding plan`）。
+					// 这跟 `fail()` 那几条「连不上 / 看不懂 / 没这个接口」不是一回事：
+					// 前者是确知不可用，值得判死并隐藏；后者是拿不准，必须 fail-open 保留。
+					// 不标 definitive 的话，欠费会永远停在「显示着但一用就报错」。
+					return { unavailable: label(body?.msg) ?? 'quota unavailable', definitive: true }
 				}
 				const limits = Array.isArray(body?.data?.limits) ? body.data.limits : []
 				const items = []
@@ -1361,6 +1412,13 @@ export function apply(ctx) {
 		return undefined
 	}
 
+	/**
+	 * provider -> 最近一次余额信封。排序要用它判计费模式，而排序是同步的
+	 * （`llm.listProviders` 不能 await），所以只能读探测顺手存下来的快照。
+	 * @type {Map<string, object>}
+	 */
+	const balanceSnapshot = new Map()
+
 	/**
 	 * 查询某 provider 的余额/配额。统一信封：`{ ok, kind, available, items?, reason? }`；
 	 * 匹配不到适配器给 `{ ok, supported:false }`，无 key / 上游失败都折叠成 `available:false`
@@ -1419,9 +1477,12 @@ export function apply(ctx) {
 		}
 		const shaped = adapter.shape(body)
 		if (shaped.unavailable !== undefined) {
-			return { ok: true, provider, kind: adapter.kind, available: false, reason: shaped.unavailable }
+			// definitive 只在「上游结构化回答了不可用」时为真；网络/解析失败走 fail()，没有这个字段。
+			return { ok: true, provider, kind: adapter.kind, available: false, reason: shaped.unavailable, definitive: shaped.definitive === true }
 		}
-		return { ok: true, provider, kind: adapter.kind, adapter: adapterName, meaning: adapter.meaning, level: shaped.level, items: shaped.items ?? [] }
+		const envelope = { ok: true, provider, kind: adapter.kind, adapter: adapterName, meaning: adapter.meaning, level: shaped.level, items: shaped.items ?? [] }
+		balanceSnapshot.set(provider, envelope)
+		return envelope
 	}
 
 	/**
@@ -1665,9 +1726,18 @@ export function apply(ctx) {
 			return undefined
 		}
 		if (envelope === null || typeof envelope !== 'object' || envelope.ok !== true || envelope.supported === false) return undefined
-		// available=false 只表示「这次余额查询没成功」；原因千差万别（没 key、查不通、
-		// 没有套餐），除开 key 缺失（已由凭据那步覆盖）都不构成隐藏理由。
-		if (envelope.available === false) return undefined
+		// available=false 有两种，混在一起处理会让欠费永远漏网：
+		//   · definitive —— 上游用完整 JSON 确知「这个号没有套餐」，判死并隐藏；
+		//   · 其余（没 key / 连不上 / 看不懂 / 没这个接口）—— 只是这次没查成，
+		//     按 fail-open 保留，否则一次网络抖动就把能用的模型藏了。
+		// 2026-09-29 实测智谱 coding 端点就栽在这：余额接口白纸黑字回了
+		// 「当前用户不存在coding plan」，却因为和「查不通」共用 available=false 而被放过。
+		if (envelope.available === false) {
+			if (envelope.definitive === true) {
+				return { state: 'unavailable', code: 'ACCOUNT_UNAVAILABLE', source: 'balance', reason: label(envelope.reason) ?? '账户没有可用套餐' }
+			}
+			return undefined
+		}
 		const items = Array.isArray(envelope.items) ? envelope.items : []
 		if (envelope.kind === 'cash') {
 			const amount = items[0]?.amount
@@ -1993,7 +2063,13 @@ export function apply(ctx) {
 			if (profile?.billingMode === 'usage' || profile?.billingMode === 'subscription') {
 				return profile.billingMode
 			}
-			return detectBillingMode(profile || { provider: cleanId })
+			// ⚠️ balance 必须传：少了它，`detectBillingMode` 里认 `kind: 'plan' | 'quota'`、
+			// `resetsAt`、`weeklyPercent` 的那几条分支全是死代码，最后一律落到兜底的
+			// `return 'usage'`。2026-09-29 实测：MiniMax 余额信封明明是
+			// `{kind:'plan', items:[{resetsAt:'15:00', weeklyPercent:97}]}`，下拉里却被当成
+			// 按量付费排在套餐后面 —— 配置卡片显示对了（client 传了 balance），
+			// 下拉排序却是错的（host 没传），两边对不上就是这个漏传造成的。
+			return detectBillingMode(profile || { provider: cleanId }, profile, balanceSnapshot.get(cleanId) ?? balanceSnapshot.get(id))
 		}
 
 		const filtered = function (...args) {
@@ -2707,9 +2783,11 @@ export function apply(ctx) {
 			return {
 				id: group.id,
 				label: group.label,
+				note: group.note ?? null,
 				candidates: candidates.map((candidate) => ({
 					provider: candidate.provider,
 					model: candidate.model,
+					note: group.notes?.[`${candidate.provider}/${candidate.model}`] ?? null,
 					state: stateFor(candidate.provider, candidate.model)
 				})),
 				wouldRoute: winner.to,
@@ -2877,8 +2955,10 @@ export function apply(ctx) {
 					groups: normalized.groups.map((group) => ({
 						id: group.id,
 						...(group.label !== null ? { label: group.label } : {}),
+						...(group.note ? { note: group.note } : {}),
 						...(group.primary !== null ? { primary: `${group.primary.provider}/${group.primary.model}` } : {}),
-						fallbacks: group.fallbacks.map((entry) => `${entry.provider}/${entry.model}`)
+						fallbacks: group.fallbacks.map((entry) => `${entry.provider}/${entry.model}`),
+						...(group.notes ? { notes: group.notes } : {})
 					}))
 				}
 			})

package/package.json

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

package/scripts/prepublish-gate.mjs

@@ -85,8 +85,17 @@ const walkStrings = (v) => {
 for (const field of ['main', 'types', 'module', 'bin', 'exports']) walkStrings(pkg[field])
 if (pkg.dsh && typeof pkg.dsh === 'object') walkStrings(pkg.dsh.bundle)
 
+// exports 允许「子路径模式」：`"./styles/*": "./styles/*"`。
+// 这是 npm 官方推荐的整目录可 import 写法，不是错字 —— 2026-09-22 的 retro 记过：
+// 白名单式把每个子路径列一遍，漏一个下游构建就直接 `Missing "./styles/x.css"` 失败。
+// 所以带 * 的条目必须按 glob 去匹配 tarball，而不是要求存在一个名叫 `styles/*` 的文件。
+// 但「模式一个文件都匹配不到」仍要拦 —— 那说明目录被删了或没进 files[]，模式是死的。
+const entryGlobRe = (g) => new RegExp(
+  '^' + g.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*').replace(/\?/g, '.') + '$'
+)
 for (const p of entryPaths) {
-  if (!inPack(p)) {
+  const ok = /[*?]/.test(p) ? packFiles.some(f => entryGlobRe(p).test(f)) : inPack(p)
+  if (!ok) {
     errors.push(`package.json 的入口字段引用了 '${p}'，但 tarball 里没有\n  → 装包的人会在 require/import 时直接失败`)
   }
 }