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

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [1.8.0] - 2026-09-29
+
+### 🔧 适配 DSH 0.1.7 的 settings 架构（升级到 0.1.7 后配置读不到的那版）
+
+**症状**：升到 DSH 0.1.7 后，路由组「凭空消失」—— chip 不渲染，设置页路由卡是空的，
+写接口一律拒绝。数据其实好好躺在配置里，只是没人读。
+
+**根因**：0.1.7 把 settings 架构整个换掉了。`settings.register(ns, schema)` 和
+`settings.get(ns)` 双双消失（0.1.5 的 `dsh-settings` 里有 20 处 `register` 引用，
+0.1.7 是 0 处）。老代码里 `settings.register(...)` 抛 `TypeError` 被 catch 吞掉，
+`hubRegistered` 恒为 false，于是整个 `dsh-llm-hub` 段的读写全部短路。
+
+**改造**
+- 导出 `Config`，配置改由 `apply(ctx, config)` 注入（0.1.7 的官方姿势，
+  `@deepseek-ai/dsh-llm-pi-ai` 的 providers 段同款）
+- 读自己的段走 `config.routing.get()`；读**别人**的段（`llm-pi-ai` / `llm-deepseek`）
+  走 `settings.describe()` —— 0.1.7 里那是唯一的跨插件读法
+- 拆掉 `hubRegistered` 守卫（该概念已不存在）
+- 三个字段全部标 `.volatile()`：`settings.update()` 拒绝「没有 volatile 字段的条目」
+  （原话：`Plugin entry "dsh-llm-hub" has no volatile fields`），而 volatile 的语义
+  正是本插件要的 —— 路由组/预警/别名都是每次请求惰性重读的，切一次路由不该重跑 apply
+- `@deepseek-ai/schemastery` 加为 **devDependency**（静态 import 需要它才能加载；
+  运行时依赖仍是零 —— 它由 DSH 宿主提供）
+
+**配置迁移**：0.1.7 启动时把全局 `settings.yaml` 迁进 profile 的 `cordis.patch.yml`
+并把原文件改名为 `settings.yaml.imported`。本插件的段需要一条 `dsh-llm-hub` entry；
+未迁移时该段读为空，也就是上面那个症状。
+
+**验证**：157 个单测 + 门禁全过；真机确认路由组、设置页路由卡、跨插件读（balance 能
+解析出真实 key）、写路径（`routing/select` 200）全部恢复。
+
 ## [1.7.0] - 2026-09-29
 
 ### 🧭 路由设置卡：始终折叠，展开才编辑

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 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.get(NS)
+			const value = settings.describe().find((item) => item.ns === ns)?.value
 			return value !== null && typeof value === 'object' ? value : undefined
 		} catch {
-			// 命名空间尚未注册时会抛 —— 那是正常启动竞态，不是失败。
 			return undefined
 		}
 	}
@@ -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
@@ -2204,10 +2228,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 +2836,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 +2954,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)

package/package.json

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