@omdp/dsh-key-fallback 1.0.1 → 1.0.2

package/lib/client.js

@@ -14,35 +14,97 @@ window.__ModuleLoader__.load({
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
     var React = require('react')
 
-    function fetchJson(url) {
-      return fetch(url).then(function (r) { return r.json() })
+    function fetchJson(url, signal) {
+      return fetch(url, signal ? { signal: signal } : undefined).then(function (r) { return r.json() })
     }
 
+    // 卡片可见性驱动的"仅在用户观看时轮询"：
+    // 不看（页面隐藏 / 卡片滚出视口 / 组件卸载）→ 停止轮询，零网络；
+    // 重新可见 → 立即刷新并恢复每 2s 轮询，数据最多晚 2s，正常及时。
     function KeyFallbackCard() {
       var s = React.useState({ loading: true, data: null })
       var state = s[0]
       var setState = s[1]
+      var rootRef = React.useRef(null)
+      var ioRef = React.useRef(null)
+
+      // 回调 ref：卡片根元素变化（loading ↔ 列表）时先解除旧元素再观察新元素，
+      // 避免旧元素因被移除触发 isIntersecting:false 而错误停止轮询。
+      var attachRoot = React.useCallback(function (el) {
+        var prev = rootRef.current
+        var io = ioRef.current
+        if (io && prev && prev !== el) io.unobserve(prev)
+        rootRef.current = el
+        if (io && el) io.observe(el)
+      }, [])
+
       var refresh = React.useCallback(function () {
         fetchJson('/dsh-key-fallback/pools')
           .then(function (data) { setState({ loading: false, data: (data && data.pools) || {} }) })
           .catch(function () { setState({ loading: false, data: null }) })
       }, [])
+
       React.useEffect(function () {
+        var alive = true
+        var timer = null
+        var pageVisible = !document.hidden
+        var cardVisible = true
+
+        function stop() {
+          if (timer !== null) { clearInterval(timer); timer = null }
+        }
+        function start() {
+          if (!alive || timer !== null || !pageVisible || !cardVisible) return
+          refresh()
+          timer = setInterval(refresh, 2000)
+        }
+        function sync() {
+          if (!alive) return
+          if (pageVisible && cardVisible) start()
+          else stop()
+        }
+        function onVisibility() {
+          pageVisible = !document.hidden
+          sync()
+        }
+
+        document.addEventListener('visibilitychange', onVisibility)
+
+        if (typeof IntersectionObserver === 'function') {
+          var io = new IntersectionObserver(function (entries) {
+            if (!alive) return
+            for (var i = 0; i < entries.length; i++) {
+              cardVisible = entries[i].isIntersecting
+            }
+            sync()
+          }, { threshold: 0.01 })
+          ioRef.current = io
+          var el = rootRef.current
+          if (el) io.observe(el)
+        }
+
         refresh()
-        var t = setInterval(refresh, 2000)
-        return function () { clearInterval(t) }
+        start()
+
+        return function () {
+          alive = false
+          stop()
+          document.removeEventListener('visibilitychange', onVisibility)
+          if (ioRef.current) { ioRef.current.disconnect(); ioRef.current = null }
+          ioRef.current = null
+        }
       }, [refresh])
 
       if (state.loading) {
-        return React.createElement('div', { style: { fontSize: '12px', opacity: 0.6 } }, '加载中…')
+        return React.createElement('div', { ref: attachRoot, style: { fontSize: '12px', opacity: 0.6 } }, '加载中…')
       }
       var data = state.data || {}
       var providers = Object.keys(data)
       if (providers.length === 0) {
-        return React.createElement('p', { style: { fontSize: '12px', opacity: 0.6, margin: 0 } },
+        return React.createElement('p', { ref: attachRoot, style: { fontSize: '12px', opacity: 0.6, margin: 0 } },
           '未在 settings.yaml 配置 keyFallback.providers')
       }
-      return React.createElement('div', { style: { fontSize: '12px', display: 'flex', flexDirection: 'column', gap: '8px' } },
+      return React.createElement('div', { ref: attachRoot, style: { fontSize: '12px', display: 'flex', flexDirection: 'column', gap: '8px' } },
         providers.map(function (p) {
           var pd = data[p]
           return React.createElement('div', { key: p, style: { padding: '6px 0', borderTop: '1px solid var(--dsw-alias-border-l2, #eee)' } },
@@ -62,8 +124,9 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       var slots = ctx.get('slots')
       if (slots === undefined) return
-      // settings.plugin.item 是 root-scope 的 keyed slot（注册只需 key）；本卡是只读状态展示，
-      // 不需要 settingsScope 绑定可编辑配置。与 resume-stream 的 slots.inject 姿势一致。
+      // settings.plugin.item 是 root-scope 的 keyed slot，按 settings 命名空间
+      // 分发：host 端 settings.register('key-fallback', …) 让该 key 进入
+      // served 集合后，本卡片才会被渲染（参考 auto-continue 的注册姿势）。
       slots.inject('settings.plugin.item', () => slots.register({
         name: 'settings.plugin.item',
         key: 'key-fallback',

package/lib/index.js

@@ -8,6 +8,11 @@ const { load: loadYaml } = (() => {
   try { return require('js-yaml') }
   catch { return { load: (s) => { try { return JSON.parse(s) } catch { return {} } } } }
 })()
+// schemastery 用于注册 settings 命名空间占位（served 集合来源）。
+// bundle 环境解析失败时降级为 null，此时仅卡片显示受影响、轮换逻辑照常。
+const zs = (() => {
+  try { return require('@deepseek-ai/schemastery') } catch { return null }
+})()
 
 const name = 'key-fallback'
 const inject = ['llm', 'settings', 'webServer']
@@ -41,6 +46,27 @@ function readConfig() {
 }
 
 function apply(ctx) {
+  // 注册 settings 命名空间（含真实字段 schema）：让客户端 Settings → 插件
+  // 的 keyed slot（settings.plugin.item, key='key-fallback'）被 serve 并渲染状态卡。
+  // 状态卡只读；轮换逻辑仍直接读 settings.yaml（v1.0.0 原设计）。
+  // 注意：1.0.0 版写的是 `if (typeof zs !== 'undefined')` 死代码（zs 从未导入），
+  // 注册实际从未发生；这里用真实 require 修复。
+  if (zs) {
+    try {
+      ctx.inject(['settings'], (sctx) => {
+        sctx.settings.register('key-fallback', zs.object({
+          providers: zs.dict(zs.object({
+            env: zs.string(),
+            keys: zs.array(zs.string()),
+            cooldownMs: zs.natural(),
+          })),
+        }), { base: {} })
+      })
+    } catch (e) {
+      // 命名空间注册失败不影响核心轮换逻辑
+    }
+  }
+
   const pools = new Map()
   const attempts = new Map() // `${turn}:${step}` -> 已尝试次数（防止死循环）
   const lifetime = new AbortController()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@omdp/dsh-key-fallback",
   "description": "Minimal API key fallback for DeepSeek Harness: on a retryable request error, silently retry the same call with the next key in the pool.",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "type": "commonjs",
   "main": "lib/index.js",
   "exports": {