@mzzsfy/dsh-usage-panel 0.8.0 → 0.8.1

package/README.md

@@ -133,4 +133,4 @@ node scripts/dev-link.mjs dsh-usage-panel   # 仓库根执行:归一 profile 依
 
 ## dsh 版本兼容
 
-三版本全部通过:用量面板渲染、激活 live。
+三版本(0.1.2-rc.1 / 0.1.5-rc.3 / 0.1.7-rc.1)全部通过:用量面板渲染(账号卡/通知规则折叠卡全控件)、API 面(pollArmed/通知投影)、激活 live。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-usage-panel",
   "description": "多平台 LLM 账号余额与额度面板:支持 DeepSeek/OpenRouter/Kimi/智谱/MiniMax/NewApi 及自定义端点,自动定期查询,趋势图与历史快照,用量/余额阈值与窗口重置多通道通知",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "type": "module",
   "main": "src/index.js",
   "exports": {

package/src/index.js

@@ -66,6 +66,21 @@ const SETTINGS_SCHEMA = z.object({
   }).default({}),
 })
 
+// 0.1.7 宿主以静态 Config 导出生成设置节表单(maintain 同构);legacy 宿主经
+// settings.register 注册命名空间。根级 volatile 包装:整节 live 表单,节写经
+// loader 原地热更;旧宿主 schemastery 无 volatile 方法,特性检测原样返回
+export const Config = volatileWrap(SETTINGS_SCHEMA)
+
+function volatileWrap(schema) {
+  return typeof schema.volatile === 'function' ? schema.volatile() : schema
+}
+
+// volatile ref 动态解包(get 协议):0.1.7 下 apply 入参 config 为整节单 ref;
+// legacy 宿主 config 为普通对象原样透传
+function unwrapVolatile(value) {
+  return typeof value?.get === 'function' ? value.get() : value
+}
+
 const TYPE_DEEPSEEK = 'deepseek'
 const TYPE_OPENROUTER = 'openrouter'
 const TYPE_KIMI = 'kimi'
@@ -326,7 +341,7 @@ async function queryAccount(account) {
 // timer 为软依赖:不进 inject 声明,服务缺失时仅停用自动轮询,面板手动查询不受影响
 export const inject = ['webServer']
 
-export function apply(ctx) {
+export function apply(ctx, configRef) {
   let config = null
   let loadPromise = null
   let writeChain = Promise.resolve()
@@ -340,7 +355,9 @@ export function apply(ctx) {
 
   function readNotifySettings() {
     const settings = ctx.get('settings')
-    const value = settings ? settings.get(NAMESPACE) : undefined
+    // 双形读(maintain 同构):legacy settings 命名空间 get;0.1.7+ apply 入参
+    // config 整节解包。方法面守卫兼防:服务在但缺 get 时回落默认值,防路由 handler 抛错
+    const value = settings && typeof settings.get === 'function' ? settings.get(NAMESPACE) : unwrapVolatile(configRef)
     return resolvedNotifySettings(value && typeof value === 'object' ? value.notify : undefined)
   }
 
@@ -630,11 +647,21 @@ export function apply(ctx) {
           const body = JSON.parse(await readBody(req))
           const check = validateNotifyPatch(body)
           requireOk(check.ok, check.reason)
-          // 读出当前值做浅合并后整体写回,不依赖 settings.update 的嵌套合并语义
+          // 读出当前值做浅合并后整体写回,不依赖宿主写入的嵌套合并语义
           const merged = { ...readNotifySettings(), ...check.patch }
+          // 双形写(maintain 同构,判定延迟到使用点):legacy 方法面以 register 为准
+          // (0.1.7 的 settings.update 名义在场但按命名空间找条目必败,不可作判据);
+          // 0.1.7+ 走 configEditor.edit 落 profile 条目(fiber.entry,与命名空间解耦)
           const settings = ctx.get('settings')
           requireOk(settings !== undefined, 'settings 服务不可用')
-          await settings.update(NAMESPACE, { notify: merged })
+          if (typeof settings.register === 'function' && typeof settings.update === 'function') {
+            await settings.update(NAMESPACE, { notify: merged })
+          } else {
+            const editor = ctx.get('configEditor')
+            const entry = ctx.fiber?.entry
+            requireOk(editor && typeof editor.edit === 'function' && entry, 'configEditor 服务不可用')
+            await editor.edit(entry, (current) => ({ ...current, notify: merged }))
+          }
           sendJson(res, 200, { ok: true, notify: publicNotify(readNotifySettings()) })
         }),
       }),
@@ -765,6 +792,14 @@ export function apply(ctx) {
   })
 
   ctx.inject(['settings'], (settingsCtx) => {
+    // 方法面守卫:settings 服务缺 register 面(0.1.7 已移除)即走新形态分支;
+    // 0.1.7 关闭原生自动设置页,设置面由本包自带分区承担(maintain 同构)
+    if (typeof settingsCtx.settings.register !== 'function') {
+      if (typeof settingsCtx.settings?.configure === 'function') {
+        settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber))
+      }
+      return
+    }
     settingsCtx.settings.register(NAMESPACE, SETTINGS_SCHEMA)
   })
 }

package/test/notify.route.test.mjs

@@ -446,3 +446,105 @@ test('长轮询: cursor 落后当前版本时立即返回不挂起', async () =>
   assert.equal(res.payload.units.length, 2)
   assert.ok(res.payload.version > 0)
 })
+
+// --- 0.1.7 settings 面双形适配(maintain a913c2c 同构) ---
+
+test('Config 导出契约:根级 volatile 包装,validate 产整节单 ref,默认值对拍', async () => {
+  const mod = await import('../src/index.js')
+  assert.ok(mod.Config, 'Config 导出必须在场')
+  const resolved = mod.Config['~standard'].validate({})
+  assert.equal(resolved.issues, undefined)
+  const section = resolved.value.get()
+  assert.equal(section.notify.enabled, false)
+  assert.equal(section.notify.toast, true)
+  assert.equal(section.notify.imTargets.length, 0)
+})
+
+// 0.1.7 形态装配:settings 无 register/get(宿主已移除),configRef 为整节单 ref 桩
+function makeRc17Ctx({ configStore = {}, configEditorAvailable = true } = {}) {
+  const routes = new Map()
+  const editCalls = []
+  const configureCalls = []
+  const disposers = []
+  const configRef = { get: () => ({ ...configStore }) }
+  const settingsService = { configure: (presentation, owner) => { configureCalls.push({ presentation, owner }); return () => {} } }
+  const configEditor = {
+    async edit(entry, change) {
+      editCalls.push(entry)
+      const next = change({ ...configStore }, {})
+      for (const key of Object.keys(next)) configStore[key] = next[key]
+    },
+  }
+
+  const ctx = {
+    get(name) {
+      if (name === 'settings') return settingsService
+      if (name === 'configEditor') return configEditorAvailable ? configEditor : undefined
+      return undefined
+    },
+    fiber: { entry: { options: { id: 'usage-panel', name: '@mzzsfy/dsh-usage-panel' } } },
+    effect(fn) { fn() },
+    inject(_deps, fn) {
+      fn({
+        settings: settingsService,
+        interval: () => {},
+        effect(stubEffect) {
+          const disposer = stubEffect()
+          if (typeof disposer === 'function') disposers.push(disposer)
+        },
+      })
+    },
+    webServer: {
+      register(route) {
+        routes.set(route.path, route.handler)
+        return () => routes.delete(route.path)
+      },
+    },
+  }
+  return { ctx, routes, configRef, configStore, editCalls, configureCalls, disposers }
+}
+
+test('0.1.7 形态:notify-config GET 读 configRef 节值,POST 经 configEditor.edit 落 fiber.entry', async () => {
+  // Given configRef 携带用户值 + configEditor 桩
+  const { ctx, routes, configRef, configStore, editCalls } = makeRc17Ctx({
+    configStore: { notify: { enabled: true, quotaThresholdPct: 88 } },
+  })
+  apply(ctx, configRef)
+  // When GET notify-config
+  const read = await call(routes, '/api/usage-panel/notify-config', makeReq('GET'))
+  // Then 返回 configRef 节值
+  assert.equal(read.status, 200)
+  assert.equal(read.payload.notify.enabled, true)
+  assert.equal(read.payload.notify.quotaThresholdPct, 88)
+  // When POST 部分补丁
+  const saved = await call(routes, '/api/usage-panel/notify-config', makeReq('POST', { enabled: true, balanceThreshold: 12 }))
+  // Then 整节合并落本条目
+  assert.equal(saved.status, 200)
+  assert.equal(saved.payload.ok, true)
+  assert.equal(editCalls.length, 1)
+  assert.equal(editCalls[0].options.id, 'usage-panel')
+  assert.equal(configStore.notify.enabled, true)
+  assert.equal(configStore.notify.balanceThreshold, 12)
+  assert.equal(configStore.notify.quotaThresholdPct, 88, '未提交字段整节保留')
+})
+
+test('0.1.7 形态:configEditor 缺失即 400 拒写,不崩溃', async () => {
+  // Given configEditor 服务缺席
+  const { ctx, routes, configRef } = makeRc17Ctx({ configEditorAvailable: false })
+  apply(ctx, configRef)
+  // When POST 写配置
+  const denied = await call(routes, '/api/usage-panel/notify-config', makeReq('POST', { enabled: true }))
+  // Then 400 错误响应,进程存活(测试走完即证)
+  assert.equal(denied.status, 400)
+  assert.ok(denied.payload.error)
+})
+
+test('0.1.7 形态:settings.configure 在场即关闭原生自动页,register 缺失不抛错', () => {
+  // Given settingsForms 带 configure 无 register
+  const { ctx, configRef, configureCalls } = makeRc17Ctx()
+  // When apply
+  apply(ctx, configRef)
+  // Then 关闭自动页且 owner 为本插件 fiber
+  assert.equal(configureCalls.length, 1)
+  assert.deepEqual(configureCalls[0].presentation, { auto: false })
+})