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

package/lib/index.js

@@ -33,12 +33,14 @@
 /** 官方直连适配器拥有的 settings 命名空间。 */
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
+import z from '@deepseek-ai/schemastery'
 import { applyHarness, harnessReport } from './harness.js'
 import { detectBillingMode, sortProviders } from './sorter.js'
 import { AvailabilityStore, isDropDeadHidden, classifyFailure } from './availability-store.js'
 
 export { detectBillingMode, sortProviders } from './sorter.js'
 export { AvailabilityStore, isDropDeadHidden, classifyFailure } from './availability-store.js'
+export { Config }
 
 /**
  * 用量统计 domain 的 spec。
@@ -657,66 +659,70 @@ export const name = 'dsh-llm-hub'
  * 用量统计走的是**局部注入**：`storageDomain` 缺席时不报错，本插件其余功能照常工作
  * —— 没有 storageDomain 也能用余额/可用性/harness，只是没法跨会话记 token 用量。
  */
+/**
+ * 本插件的配置形态（DSH 0.1.7 的 settings 契约）。
+ *
+ * 0.1.7 起配置不再运行时 `settings.register()` 注册，而是由 Loader 按**条目 id**
+ * 从 profile 的 `cordis.patch.yml` 读取；插件导出这个 `Config`，`apply(ctx, config)`
+ * 收下 `config`，页面的表单与 `settings.update(ns, patch)` 也都按它生成。
+ * 字段与 1.5.0 起的段结构一一对应，所以老 settings.yaml 里的段能原样迁进 patch。
+ *
+ * note / notes：页面上写的备注。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())
+})
+// ⚠️ 三个字段都必须 .volatile()：0.1.7 的 settings.update() 拒绝「没有 volatile
+// 字段的条目」（原话：Plugin entry "dsh-llm-hub" has no volatile fields）。
+// volatile 的语义正是本插件要的行为 —— 配置改动只换值、不重跑 apply：路由组、预警
+// 阈值、别名全是**每次请求惰性重读**的（见 hubSectionOf 的注释），让切一次路由就去
+// 重新 apply 整个插件是白付代价。官方 dsh-llm-pi-ai 的 providers 段同样标了 volatile。
+const Config = z.object({
+	routing: z.object({
+		mode: z.union(['manual', 'smart']).default('manual'),
+		activeGroup: z.string().default(''),
+		groups: z.array(groupItem).default([])
+	}).default({}).volatile(),
+	warning: z.object({ cashCNY: z.number().default(10), planPercent: z.number().default(10) }).default({}).volatile(),
+	aliases: z.dict(z.string()).default({}).volatile()
+})
+
 export const inject = ['llm', 'webServer']
 
 /**
  * 注册模型发现与余额路由。
  * @param ctx - 插件上下文。
  */
-export function apply(ctx) {
+export function apply(ctx, config) {
 
 	// ── 插件自有 settings 命名空间（dsh-llm-hub）────────────────────────────
 	//
-	// 1.5.0 起：routing / warning / aliases 的真源从 `llm-deepseek` 段迁到独立
-	// 的 `dsh-llm-hub` 段 —— README 文档里写的顶层 `dsh-llm-hub:` 键此前**从未
-	// 被读到过**（没注册过命名空间，settings.get 会抛），这是 1.1.0 起的历史
-	// 缺陷，这里一起修掉。
-	//
-	// schema 尽量懒加载 `@deepseek-ai/schemastery`；失败时退回 `Object` 构造器
-	// （schemastery 接受原生构造器作为 schema）。注册失败不 fatal：配置读取退
-	// 回 legacy 路径，智能路由降级为「只建议」。
-	let hubRegistered = false
-	ctx.inject(['settings'], (settingsCtx) => {
-		void (async () => {
-			let schema
-			try {
-				const mod = await import('@deepseek-ai/schemastery')
-				const z = (mod && typeof mod === 'object' ? mod.default ?? mod : mod)
-				// 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'),
-						activeGroup: z.string().default(''),
-						groups: z.array(groupItem).default([])
-					}).default({}),
-					warning: z.object({ cashCNY: z.number().default(10), planPercent: z.number().default(10) }).default({}),
-					aliases: z.dict(z.string()).default({})
-				})
-			} catch {
-				// 零依赖环境：schemastery 没解析到 —— 用原生构造器兜底。
-				schema = Object
-			}
-			try {
-				settingsCtx.settings.register(HUB_NS, schema)
-				hubRegistered = true
-			} catch (error) {
-				ctx.logger.warn(`dsh-llm-hub: settings ns "dsh-llm-hub" register failed: ${error?.message ?? error}`)
-			}
-		})()
-	})
+	// DSH 0.1.7 把 settings 架构整个换了：`settings.register(ns, schema)` 与
+	// `settings.get(ns)` 双双消失，配置改由 Loader 按**条目 id**从 profile 的
+	// cordis.patch.yml 读，插件自己导出 `Config`，再由 `apply(ctx, config)` 收下。
+	// 老写法在 0.1.7 上是 `TypeError: settings.register is not a function`，
+	// 被下面那个 catch 吞掉 → hubRegistered 恒 false → 整个 dsh-llm-hub 段读写
+	// 全死。对外表现是「路由组凭空消失」：数据好好躺在 patch 里，只是没人读。
 
 	/**
 	 * 读 `dsh-llm-hub` 设置段（1.5.0 起的真源）。
 	 * @returns 已解析设置段；未注册 / 未配置时为 `undefined`。
 	 */
 	const hubSectionOf = () => {
-		const settings = ctx.get('settings')
-		if (settings === undefined) return undefined
+		// 0.1.7：配置由 `apply(ctx, config)` 注入，惰性 .get() 每次拿当前修订。
+		// 不再走 settings.get(HUB_NS) —— 那个方法在 0.1.7 已被移除。
+		if (config === undefined || config === null) return undefined
 		try {
-			const value = settings.get(HUB_NS)
-			return value !== null && typeof value === 'object' ? value : undefined
+			const routing = config.routing?.get?.()
+			const warning = config.warning?.get?.()
+			const aliases = config.aliases?.get?.()
+			return { routing, warning, aliases }
 		} catch {
 			return undefined
 		}
@@ -729,13 +735,31 @@ export function apply(ctx) {
 	 * @returns 已解析的设置段；不可用时为 `undefined`。
 	 */
 	const sectionOf = () => {
+		// 0.1.7：读**别的插件**的配置不再有 settings.get(ns)。改走
+		// settings.describe() —— 它返回所有条目的 ns + 实时 value。
 		const settings = ctx.get('settings')
 		if (settings === undefined) return undefined
 		try {
-			const value = settings.get(NS)
+			const row = settings.describe().find((item) => item.ns === NS)
+			const value = row?.value
+			return value !== null && typeof value === 'object' ? value : undefined
+		} catch {
+			return undefined
+		}
+	}
+
+	/**
+	 * 读任意命名空间（跨插件）在 0.1.7 的唯一途径。
+	 * @param {string} ns - profile 条目 id。
+	 * @returns {object | undefined} 该条目的实时配置值。
+	 */
+	const sectionOfNs = (ns) => {
+		const settings = ctx.get('settings')
+		if (settings === undefined) return undefined
+		try {
+			const value = settings.describe().find((item) => item.ns === ns)?.value
 			return value !== null && typeof value === 'object' ? value : undefined
 		} catch {
-			// 命名空间尚未注册时会抛 —— 那是正常启动竞态，不是失败。
 			return undefined
 		}
 	}
@@ -1025,13 +1049,13 @@ export function apply(ctx) {
 					try {
 						const raw = await getJson('/user/balance', { apiKey })
 						const shaped = shapeBalance(raw)
-						const first = shaped.balances?.[0]
+						const activeBalance = shaped.balances?.find((b) => Number(b.total) > 0) ?? shaped.balances?.[0]
 						return {
 							ref,
 							keyMasked: maskKey(apiKey),
 							isAvailable: shaped.isAvailable,
-							total: first?.total ?? '0.00',
-							currency: first?.currency ?? 'CNY',
+							total: activeBalance?.total ?? '0.00',
+							currency: activeBalance?.currency ?? 'CNY',
 							ok: true
 						}
 					} catch (e) {
@@ -1125,7 +1149,7 @@ export function apply(ctx) {
 		const settings = ctx.get('settings')
 		if (settings === undefined) return []
 		try {
-			const section = settings.get(PIAI_NS)
+			const section = sectionOfNs(PIAI_NS)
 			const providers = section !== null && typeof section === 'object' ? section.providers : undefined
 			if (providers === null || typeof providers !== 'object') return []
 			return Object.entries(providers).filter(([, profile]) => profile !== null && typeof profile === 'object')
@@ -1145,7 +1169,7 @@ export function apply(ctx) {
 		const settings = ctx.get('settings')
 		if (settings === undefined) return undefined
 		try {
-			const section = settings.get(PIAI_NS)
+			const section = sectionOfNs(PIAI_NS)
 			const providers = section !== null && typeof section === 'object' ? section.providers : undefined
 			const profile = providers !== null && typeof providers === 'object' ? providers[provider] : undefined
 			return profile !== null && typeof profile === 'object' ? profile : undefined
@@ -1849,7 +1873,25 @@ export function apply(ctx) {
 				}
 				// 已经被新一轮取代：这份结论过期了，丢掉。
 				if (generation !== probeGeneration) return
-				baseVerdicts.set(target.id, { provider: target.id, displayName: target.displayName, ns: target.ns, checkedAt: Date.now(), ...outcome })
+				let modelIds = []
+				if (target.ns === NS) {
+					const deepseek = sectionOf()
+					const models = Array.isArray(deepseek?.models) ? deepseek.models : []
+					modelIds = models.map((m) => (m !== null && typeof m === 'object' ? m.id : m)).filter((id) => typeof id === 'string')
+				} else {
+					const profile = piaiProfileOf(target.id)
+					const models = Array.isArray(profile?.models) ? profile.models : []
+					modelIds = models.map((m) => (m !== null && typeof m === 'object' ? m.id : m)).filter((id) => typeof id === 'string')
+				}
+				baseVerdicts.set(target.id, {
+					provider: target.id,
+					displayName: target.displayName,
+					ns: target.ns,
+					checkedAt: Date.now(),
+					modelCount: modelIds.length,
+					modelIds,
+					...outcome
+				})
 			}))
 			if (generation !== probeGeneration) return
 			// 清掉真正从路由表里消失的 provider。判据必须是**原始路由表**，不是本轮的
@@ -2204,10 +2246,10 @@ export function apply(ctx) {
 				// modelgo 这种 pi-ai 风格 provider 在 'llm-pi-ai' namespace 下；
 				// dsh-llm-hub 自己的 NS 是 'llm-deepseek'，但写回属于跨 namespace 兜底：
 				// plugin 不是 pi-ai 的 owner，只是借用 settings 服务给 pi-ai 段补一份目录。
-				const source = settingsCtx.settings.get(PIAI_NS)
+				const source = sectionOfNs(PIAI_NS)
 				const updates = await populateEmptyProviderModels(source)
 				if (Object.keys(updates).length === 0) return
-				const current = settingsCtx.settings.get(PIAI_NS)
+				const current = sectionOfNs(PIAI_NS)
 				for (const provider of Object.keys(updates)) {
 					const live = current?.providers?.[provider]
 					if (Array.isArray(live?.models) && live.models.length > 0) {
@@ -2812,7 +2854,7 @@ export function apply(ctx) {
 	/** 读 settings 的 routing 段并按需覆写 mode / activeGroup，持久化。 */
 	const applyRoutingSelect = async (patch) => {
 		const settings = ctx.get('settings')
-		if (settings === undefined || hubRegistered !== true) {
+		if (settings === undefined) {
 			return { ok: false, error: 'settings 命名空间 dsh-llm-hub 尚未就绪 —— 稍后重试' }
 		}
 		const current = routingObjOf()
@@ -2930,7 +2972,7 @@ export function apply(ctx) {
 	/** 写回整份路由组（设置页编辑器保存路径），并返回最新状态。 */
 	const applyRoutingConfig = async (payload) => {
 		const settings = ctx.get('settings')
-		if (settings === undefined || hubRegistered !== true) {
+		if (settings === undefined) {
 			return { ok: false, error: 'settings 命名空间 dsh-llm-hub 尚未就绪 —— 稍后重试' }
 		}
 		const normalized = normalizeRoutingGroupsInput(payload?.groups)
@@ -3173,6 +3215,18 @@ export function apply(ctx) {
 
 	// ── harness 子代理 ────────────────────────────────────────────────────────
 
+	// 把本机装好的外部 agent CLI（codex / claude / agy）注册成子代理提供方，详见
+	// `./harness.js`。
+	//
+	// 为什么用**局部注入**而不是加进模块顶部的 `inject` 数组：`inject` 是硬依赖，
+	// 少一个服务整个插件就不加载 —— 那会让「宿主没装子代理栈」的部署连余额和模型
+	// 发现一起失去。局部注入只让 harness 这一段跟着服务走，缺了就不启用。
+	ctx.inject(['subagents', 'subprocess'], (scope) => {
+		applyHarness(scope).catch((error) => {
+			scope.logger?.warn?.(`dsh-llm-hub: harness 探测失败：${error?.message ?? error}`)
+		})
+	})
+
 	// 自检路由：`GET /api/dsh-llm-hub/harness` 报告探到了什么、注册了几个。
 	//
 	// 为什么需要它：宿主的 `info` 级日志**不落盘**（实测 launchd.log 里只有

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugins/dsh-llm-hub",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "DSH 模型管理层：网关可达性探测、模型目录拉取、DeepSeek + MiniMax/智谱/Moonshot/StepFun 余额与配额、本月用量统计、余额预警、Provider 健康看板，再把本机装好的 codex / claude / agy 注册成子代理（装了才出现）。零运行时依赖，不改动 DSH 安装。",
   "type": "module",
   "main": "lib/index.js",
@@ -28,7 +28,7 @@
     }
   },
   "scripts": {
-    "deploy": "rsync -av --delete lib/ ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/lib/ && rsync -av types package.json cordis.patch.yml README.md README.en.md LICENSE ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/",
+    "deploy": "rsync -av --delete lib/ ~/.dsh/profiles/${DSH_PROFILE:-desktop}/node_modules/@dsh-plugins/dsh-llm-hub/lib/ && rsync -av types package.json cordis.patch.yml README.md README.en.md LICENSE ~/.dsh/profiles/${DSH_PROFILE:-desktop}/node_modules/@dsh-plugins/dsh-llm-hub/",
     "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",
@@ -79,5 +79,8 @@
     "lib",
     "scripts",
     "types"
-  ]
+  ],
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "3.18.4"
+  }
 }

package/scripts/gate-lib.mjs

@@ -86,3 +86,41 @@ export function detectChangedRuntime(prevRoot, curRoot, curFiles) {
   }
   return changed
 }
+
+/**
+ * 取 `npm pack --json` 的那一条结果 —— 两种 npm 大版本形状都认。
+ *
+ * **npm 11 → 12 的破坏性变更**：11 回数组 `[{ files: [...] }]`，
+ * 12 回以包名为键的对象 `{ "<name>": { files: [...] } }`。
+ * 原先写死 `JSON.parse(out)[0].files`，在 npm 12 上 `[0]` 是 undefined，
+ * 报出来的是 `Cannot read properties of undefined (reading 'files')`
+ * —— 从这句话完全看不出跟 npm 版本有任何关系。
+ *
+ * 2026-10-02 同一天咬了两次（museav-cli v3.9.2、museav-mcp 2.2.0）：各仓的
+ * publish workflow 里写着 `npm install -g npm@latest`，于是 npm 12 一发版，
+ * **所有仓的 CI 发版同时挂掉**，而本地（还是 npm 11）怎么跑都是绿的。
+ *
+ * 抽进 lib 是为了能测（门禁脚本顶层会跑 pack/连 registry，import 不进来）。
+ * 形状认不出时**抛一句能看懂的话** —— 这正是今天最缺的东西：当时那句
+ * `Cannot read properties of undefined` 让人以为是代码问题，实际是上游换了形状。
+ */
+export function packEntry(parsed) {
+  // 形状先记下来再判空：报错里要能看出 npm 回了什么，而不是只说「认不出」。
+  const shape = Array.isArray(parsed) ? 'array' : parsed === null ? 'null' : typeof parsed
+  // 先判空再 Object.values —— 否则 parsed 为 null/undefined 时
+  // Object.values 先抛「Cannot convert undefined or null to object」，
+  // 又回到那个「看不出是 npm 换了形状」的老问题上。
+  let entry
+  if (Array.isArray(parsed)) {
+    entry = parsed[0]
+  } else if (parsed && typeof parsed === 'object') {
+    entry = Object.values(parsed)[0]
+  }
+  if (!entry || !Array.isArray(entry.files)) {
+    throw new Error(
+      `npm pack --json 的返回形状认不出（顶层是 ${shape}）` +
+      `，npm 可能又换了形状 —— 见 gate-lib.mjs 的 packEntry 注释`,
+    )
+  }
+  return entry
+}

package/scripts/prepublish-gate.mjs

@@ -31,7 +31,7 @@ import { dirname, join, relative } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { tmpdir } from 'node:os'
 import { createHash } from 'node:crypto'
-import { EXCLUDE, isRuntime, collectAllFiles, detectChangedRuntime } from './gate-lib.mjs'
+import { EXCLUDE, isRuntime, collectAllFiles, detectChangedRuntime, packEntry } from './gate-lib.mjs'
 
 const GATE_VERSION = 1
 
@@ -48,7 +48,7 @@ try {
   const out = execFileSync('npm', ['pack', '--dry-run', '--json'], {
     cwd: pkgRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit']
   })
-  packFiles = JSON.parse(out)[0].files.map(f => f.path)
+  packFiles = packEntry(JSON.parse(out)).files.map(f => f.path)
 } catch (err) {
   console.error('[prepublish-gate] npm pack --dry-run 失败:', err.message)
   process.exit(2)