@zaofan/dsh-qqbot 1.11.7 → 1.11.9

package/client/qqbot-settings.js

@@ -587,14 +587,11 @@ window.__ModuleLoader__.load({
         if (document.getElementById(EXT_UI_CSS_ID)) return
         var s = document.createElement('style')
         s.id = EXT_UI_CSS_ID
-        s.textContent = ''
-          + '.qqs-ext-cards{display:flex;gap:10px;overflow-x:auto;overflow-y:hidden;'
-          + '-webkit-overflow-scrolling:touch;scrollbar-width:none;'
-          + 'scroll-snap-type:x proximity;padding:2px 0 6px}'
-          + '.qqs-ext-cards::-webkit-scrollbar{display:none}'
-          + '.qqs-ext-card{flex:0 0 auto;scroll-snap-align:start;min-width:220px;max-width:320px}'
-          + '.qqs-top-tabs{scrollbar-width:none}'
+        // ★ 2026-10-27：内嵌卡片那条已删（改顶栏页签），这里只留页签/整页卡片需要的样式
+        s.textContent =
+          '.qqs-top-tabs{scrollbar-width:none}'
           + '.qqs-top-tabs::-webkit-scrollbar{display:none}'
+          + '.qqs-ext-card{flex:0 0 auto;scroll-snap-align:start;min-width:220px;max-width:320px}'
           + '.qqs-ext-page-card{display:block;min-width:260px}'
         document.head.appendChild(s)
         // 鼠标滚轮 → 横向滚动（2026-10-26 主人实测"不能横滑"）：
@@ -1226,12 +1223,7 @@ window.__ModuleLoader__.load({
       //     ② 扩展脚本报错只白自己那张卡，不整页崩
       var EXT_UI_LIST = '/api/qqbot-settings/ext-ui/list'
       var EXT_UI_FILE = '/api/qqbot-settings/ext-ui/file?f='
-      function extUiText(extId, f) {
-        return fetch(EXT_UI_FILE + encodeURIComponent(f) + '&id=' + encodeURIComponent(extId))
-          .then(function (r) { return r.json() })
-          .then(function (j) { return j && j.ok ? String(j.text || '') : '' })
-          .catch(function () { return '' })
-      }
+      // ★ 2026-10-27 删：extUiText 只被 mountExtUiCards 用过（已删），成死代码。
       function extUiApi(extId) {
         return {
           extId: extId,
@@ -1265,46 +1257,11 @@ window.__ModuleLoader__.load({
           + '.qqs-ext-page-card{display:block}'
         document.head.appendChild(s)
       }
-      function mountExtUiCards() {
-        injectExtUiCss()
-        var box = document.getElementById('qqs-ext-cards')
-        if (!box) return
-        fetch(EXT_UI_LIST).then(function (r) { return r.json() }).then(function (j) {
-          if (!j || !j.ok) return
-          var list = (j.items || []).filter(function (x) { return x.slot === 'settings' })
-          if (!list.length) { box.style.display = 'none'; return }
-          box.style.display = ''
-          // 幂等：卡片数量没变就不重挂（避免每次 setState 都把扩展的 DOM 冲掉）
-          var sig = list.map(function (x) { return x.extId }).join(',')
-          if (box.getAttribute('data-sig') === sig) return
-          box.setAttribute('data-sig', sig)
-          box.innerHTML = ''
-          list.forEach(function (it) {
-            var host = document.createElement('div')
-            host.className = 'qqs-ext-card'
-            var sr = host.attachShadow({ mode: 'open' })
-            box.appendChild(host)
-            Promise.all([
-              extUiText(it.extId, 'card.html'),
-              it.files && it.files.indexOf('card.css') >= 0 ? extUiText(it.extId, 'card.css') : Promise.resolve(''),
-              it.files && it.files.indexOf('card.js') >= 0 ? extUiText(it.extId, 'card.js') : Promise.resolve(''),
-            ]).then(function (res) {
-              sr.innerHTML = '<style>' + (res[1] || '') + '</style>' + (res[0] || '')
-              if (!res[2]) return
-              try {
-                // Function 而不是 eval：作用域干净，且把 qqbotExt 作为形参传进去
-                new Function('qqbotExt', 'shadowRoot', res[2])(extUiApi(it.extId), sr)
-              } catch (e) {
-                var d = document.createElement('div')
-                d.style.cssText = 'color:#c33;font-size:12px;padding:4px 0'
-                d.textContent = '卡片脚本出错: ' + (e && e.message ? e.message : e)
-                sr.appendChild(d)
-              }
-            })
-          })
-        }).catch(function () { /* 静默：扩展 UI 挂了不该影响设置页本体 */ })
-      }
-      setTimeout(function () { try { mountExtUiCards() } catch (e) { /* ignore */ } }, 0)
+      // ★ 2026-10-27 删：这是第一版「把扩展卡片内嵌在设置页内容区」的实现。
+      //   后来改成顶栏页签（ExtCardPage + Shadow DOM），两套并存会导致
+      //   同一张卡在设置页出现两次；而且这里用的还是闭包内那个旧 extUiApi
+      //   （没有 getConfig/setConfig）→ 卡片报 'qqbotExt.getConfig is not a function'。
+      //   统一走顶栏页签后删掉。
 
       return h('div', { style: { maxWidth: 720 } },
         h('h2', { style: { margin: '0 0 6px' } }, 'QQ 机器人设置'),
@@ -1317,8 +1274,8 @@ window.__ModuleLoader__.load({
           h(SButton, { variant: 'ghost', onClick: load }, '放弃修改(重新读取)'),
           msg ? h('span', { style: { fontSize: 13, color: T.text2 } }, msg) : null,
           close ? h(SButton, { variant: 'ghost', onClick: close }, '完成') : null),
-        // ★ 扩展卡片挂载点：横向可滑动，样式见文件末尾注入的 .qqs-ext-cards
-        h('div', { id: 'qqs-ext-cards', className: 'qqs-ext-cards' }))
+        // ★ 2026-10-27：这里原来挂 #qqs-ext-cards（内嵌卡片），已改为顶栏页签，容器不需要了
+        null)
     }
 
         // ── ⑥ QQ 群管理(单开大卡片; P3+ 设计系统版: 横排 Tab + 状态条 + 表格 + 空状态 + 预留接口位) ──
@@ -2803,6 +2760,34 @@ var QQS_THEME_CSS = [
       document.body.appendChild(wrap)
       var ball = wrap.querySelector('#qqs-dock-ball')
       var badge = wrap.querySelector('#qqs-dock-badge')
+      // ── 2026-10-28（主人定）：悬浮球**只在 QQ 会话里显示** ──
+      //   判定沿用 session-lookup（state.detectedHit 的同一个接口），未命中就不显示。
+      //   为什么还要轮询：会话切换（web 侧点开另一个会话）不会通知这里；
+      //   只比 sessionId 字符串，变了才发请求，开销可忽略。
+      var _dockSid = ''
+      var _dockHit = null
+      function refreshDockVisibility() {
+        var sid = ''
+        try { sid = curSessionId() } catch (eS) { sid = '' }
+        // 同一会话、已知结论 → 直接套用（不发请求，也不闪）
+        if (sid === _dockSid && _dockHit !== null) { wrap.style.display = _dockHit ? '' : 'none'; return }
+        _dockSid = sid
+        if (!sid) { _dockHit = false; wrap.style.display = 'none'; return }
+        // 会话变了：先按"未命中"藏起来，拿到结论再显示（宁可晚一点，也别让它乱闪）
+        _dockHit = null
+        wrap.style.display = 'none'
+        qqHitOf(sid, function (hit) {
+          if (sid !== _dockSid) return   // 查询期间又切了会话：这次结论作废
+          _dockHit = hit
+          wrap.style.display = hit ? '' : 'none'
+        })
+      }
+      try {
+        refreshDockVisibility()
+        // 事件驱动（2026-10-28，主人嫌 2s 轮询费性能）：不再 setInterval ——
+        // apply() 里的 refreshQqUi 在「sessions.list 变化 / 窗口聚焦 / 页面重新可见」时调这里。
+        window.__qqsRefreshDock = refreshDockVisibility
+      } catch (eVis) { /* 显隐失败不影响球本身 */ }
       var panel = null
       var open = false
       // ⚠️ 2026-09-27 修复「拖到屏幕外后球永久消失」：拖拽时本来有 clamp(行1749)，
@@ -6761,6 +6746,31 @@ var QQS_THEME_CSS = [
       return ''
     }
 
+    /**
+     * 当前会话是不是 QQ 会话（2026-10-28）。
+     * 同一次查询在窗口内共享 —— 悬浮球显隐、扩展页签显隐都走这里，不重复打后端。
+     * ⚠️ 否定结论只缓存 2 秒：宿主刚启动时后端可能还没就绪，长缓存会让悬浮球一直不出现。
+     */
+    function qqHitOf(sid, cb) {
+      if (!sid) { try { cb(false) } catch (e0) {} ; return }
+      var c = (window.__qqsHitCache = window.__qqsHitCache || {})
+      var e = c[sid]
+      if (e && Date.now() - e.at < (e.hit ? 10000 : 2000)) { try { cb(e.hit) } catch (e1) {} ; return }
+      try {
+        fetch('/api/qqbot-settings/session-lookup?sessionId=' + encodeURIComponent(sid))
+          .then(function (r) { return r.json() })
+          .then(function (d) {
+            var hit = !!(d && d.hits && d.hits.length)
+            c[sid] = { at: Date.now(), hit: hit }
+            try { cb(hit) } catch (e2) {}
+          })
+          .catch(function () { try { cb(false) } catch (e3) {} })
+      } catch (e4) { try { cb(false) } catch (e5) {} }
+    }
+
+    // （2026-10-28）页签显隐不用 DOM 方案了 —— 见 apply() 里的 setExtTabVisible：
+    //   `slots.inject` 的返回值是 disposer，注销后宿主自己会刷新页签列表。
+
     function curWorkspaceCwd() {
       try {
         var svc = _extSessionsSvc
@@ -7805,14 +7815,28 @@ var QQS_THEME_CSS = [
             function (props) { return h(QqbotHome, { close: props && props.close }) })
         })
       })
-      // 「QQ机器人扩展」会话页签（2026-10-24）：与「对话/轨迹/记忆/白板看板」并列
-      safe('conversation view', function () {
-        slots.inject('conversation.view', function () {
-          return slots.register(
-            { name: 'conversation.view', id: 'qqbot-ext', order: 81, label: 'QQ机器人扩展' },
-            ExtPanel)
-        })
-      })
+      // 「QQ机器人扩展」会话页签：**只在 QQ 会话里注入**（2026-10-28 主人定）
+      //   为什么不用 DOM 隐藏：`slots.inject(key, cb)` 的返回值是 disposer（已核 ui-renderer 源码：
+      //   `return () => { disposeController(); }`），注销后宿主 `slots.subscribe("conversation.view")`
+      //   会自动刷新页签列表 —— 比按文案找按钮稳得多。
+      var _extTabDisposed = null
+      function setExtTabVisible(show) {
+        if (show) {
+          if (_extTabDisposed) return
+          try {
+            _extTabDisposed = slots.inject('conversation.view', function () {
+              return slots.register(
+                { name: 'conversation.view', id: 'qqbot-ext', order: 81, label: 'QQ机器人扩展' },
+                ExtPanel)
+            }) || null
+            if (!_extTabDisposed) _extTabDisposed = function () {}
+          } catch (eTab) { _extTabDisposed = null }
+        } else {
+          if (!_extTabDisposed) return
+          try { _extTabDisposed() } catch (eTab2) {}
+          _extTabDisposed = null
+        }
+      }
       safe('approval float', startApprovalFloat)
       // sessions 服务(宿主根服务): 权威读 web 当前会话(current)与 cwd(agent id === session id)
       var sessionsSvc = null
@@ -7820,6 +7844,44 @@ var QQS_THEME_CSS = [
       if (!sessionsSvc) { try { sessionsSvc = ctx.get && ctx.get('sessions') } catch (e) {} }
       _extSessionsSvc = sessionsSvc   // 供 ExtPanel 读当前工作区 cwd
       safe('dock', function () { startQqDock(sessionsSvc) })
+      // ── 统一刷新：页签 + 悬浮球，**事件驱动，不轮询**（2026-10-28）──
+      //   信号源：`sessions.list`（ObservableSnapshot，宿主在左侧会话列表切换时就会推）
+      //          ＋ window focus / 页面可见性（兜底，切回标签页时补一次）。
+      var _qqUiRetry = 0
+      var refreshQqUi = function () {
+        // dock 球的显隐也走这同一个信号（否则切会话时页签跟走了、球还赖着不动）
+        try { if (typeof window !== 'undefined' && typeof window.__qqsRefreshDock === 'function') window.__qqsRefreshDock() } catch (eDock) {}
+        var sid = ''
+        try { sid = curSessionId() } catch (eSid) { sid = '' }
+        // 有限次重试（≈7 秒内 6 次）：宿主刚启动时"当前会话"或后端 lookup 可能还没就绪，
+        // 一次性判空就再也不显示球了（2026-10-28 主人实测）。不是长期轮询。
+        function retryLater() {
+          if (_qqUiRetry >= 6) return
+          _qqUiRetry++
+          setTimeout(function () { refreshQqUi() }, 1200)
+        }
+        if (!sid) { setExtTabVisible(false); retryLater(); return }
+        qqHitOf(sid, function (hit) {
+          var now = ''
+          try { now = curSessionId() } catch (eNow) {}
+          if (now !== sid) return   // 查询期间切走了：别把旧结论套到新会话上
+          setExtTabVisible(!!hit)
+          if (hit) { _qqUiRetry = 0; return }
+          retryLater()
+        })
+      }
+      safe('qq ui refresh', function () {
+        refreshQqUi()
+        try {
+          if (sessionsSvc && sessionsSvc.list && typeof sessionsSvc.list.subscribe === 'function') {
+            sessionsSvc.list.subscribe(function () { refreshQqUi() })
+          }
+        } catch (eSub) {}
+        try {
+          window.addEventListener('focus', refreshQqUi)
+          document.addEventListener('visibilitychange', function () { if (!document.hidden) refreshQqUi() })
+        } catch (eWin) {}
+      })
     }
 
     exports.inject = ['slots', 'sessions']

package/dist/channel-tools.d.ts

@@ -110,6 +110,24 @@ export declare function syncContextTools(agentCtx: unknown, shouldHave: boolean,
  */
 export declare function ensureExtToolsGlobal(globalCtx: unknown): void;
 export declare function ensureContextToolsGlobal(globalCtx: unknown): void;
+/**
+ * 按会话同步「上下文压缩三件套 + QQ 群管理」的**注册状态**（幂等）。
+ *
+ * @param agentCtx 该 QQ 会话的 agent 作用域（`record.agentCtx` 或 `agent.ctx`）
+ * @param opts.ctxTools   要不要 context_memo / context_compact / context_drop（跟「无上下文·智能判断」开关）
+ * @param opts.groupAdmin 要不要 qq_group_admin（跟 groupAdmin.enabled）
+ * @param opts.dataRoot   会话坐标（工具执行时反查数据根用）
+ * @param opts.sessionKey 会话坐标（备忘类工具要求非空）
+ *
+ * 失败策略：拿不到 `tools.register` 或注册抛错时**不记状态**（写 `__retry`），下一次 pre-step 重试；
+ * 绝不影响会话主流程。
+ */
+export declare function syncChannelScopedTools(agentCtx: unknown, opts: {
+    ctxTools: boolean;
+    groupAdmin: boolean;
+    dataRoot?: string;
+    sessionKey?: string;
+}): void;
 export declare function applyExtDisabledRestrict(agentCtx: unknown, dataRoot: string, extToolNames: string[]): void;
 export declare function restrictContextTools(agentCtx: unknown, shouldHave: boolean, env?: {
     dataRoot?: string;

package/dist/channel-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA8FlE,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAI1C,eAAO,MAAM,MAAM,UAAY,CAAC;AAoOhC,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAiC;AAkD5F,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAErH;AACD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE9E;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAI/D;AAkFD,mDAAmD;AACnD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAo8EvD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GAAG,KAAK,EACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BvC;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM;;;;;;;;;IAE1C;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAExF;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAKxI;AA4RD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAyI;AACzL,wBAAgB,eAAe,IAAI,MAAM,CAA2F;AA8CpI;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CA+CtJ;AA0BD;;;;;GAKG;AACH;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAkH7D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAwCjE;AA+DD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAsC1G;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0CnI"}
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"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"}

package/dist/channel-tools.js

@@ -4047,6 +4047,83 @@ function toolsOfScope(agentCtx) {
  *
  * 幂等：restrict 返回 dispose；每次 apply 先撤销上一次的，再按当前 disabled 重挂。
  */
+// ══════════════════════════════════════════════════════════════════════════
+// 2026-10-28（主人定，对应 issue #26）：上下文/群管理工具改为**按 QQ 会话注册**
+// ══════════════════════════════════════════════════════════════════════════
+// 旧做法（2026-10-09 起）：「插件根作用域全局注册一次 + pre-step 逐会话 restrict deny」。
+//   · 当初改成全局，是为了避开"每步先注销再重注册 → 工具表反复变动 → 宿主每步发
+//     「工具已更新·移除/新增」"的抖动（那批通知还进上下文，纯烧 token）。
+//   · 代价是：① 第一次 pre-step 之前，无关工作区的会话也能看到这四个名字；
+//             ② `restrict` 只过滤**继承来的**工具，全局层本身就是泄漏源，剪枝只是事后补救。
+//
+// 现在照 `mountChannelTools` 的路子（**per-agent register**），配一个幂等状态机：
+//   · 状态没变 → 一根手指都不动（不产生任何变更通知，同样不抖）；
+//   · 状态变了 → 先撤旧的、再按新状态注册（面板一改开关，下一 step 生效）。
+// 非 QQ 会话根本不经过这里 ⇒ 天生看不到，零窗口期、零 token。
+const ctxScopeState = new WeakMap();
+/**
+ * 按会话同步「上下文压缩三件套 + QQ 群管理」的**注册状态**（幂等）。
+ *
+ * @param agentCtx 该 QQ 会话的 agent 作用域（`record.agentCtx` 或 `agent.ctx`）
+ * @param opts.ctxTools   要不要 context_memo / context_compact / context_drop（跟「无上下文·智能判断」开关）
+ * @param opts.groupAdmin 要不要 qq_group_admin（跟 groupAdmin.enabled）
+ * @param opts.dataRoot   会话坐标（工具执行时反查数据根用）
+ * @param opts.sessionKey 会话坐标（备忘类工具要求非空）
+ *
+ * 失败策略：拿不到 `tools.register` 或注册抛错时**不记状态**（写 `__retry`），下一次 pre-step 重试；
+ * 绝不影响会话主流程。
+ */
+export function syncChannelScopedTools(agentCtx, opts) {
+    try {
+        if (!agentCtx || typeof agentCtx !== 'object')
+            return;
+        const key = agentCtx;
+        // 会话坐标每次都刷新（工具执行时靠它定位数据根/会话）
+        if (opts.dataRoot) {
+            ctxEnvMap.set(key, { dataRoot: String(opts.dataRoot), sessionKey: String(opts.sessionKey ?? '') });
+        }
+        const sig = `${opts.ctxTools ? '1' : '0'}${opts.groupAdmin ? '1' : '0'}`;
+        const st = ctxScopeState.get(key);
+        if (st && st.sig === sig)
+            return; // 状态一致 → 不动（这是"不抖"的关键）
+        const toolsObj = toolsOfScope(agentCtx);
+        const reg = toolsObj?.register;
+        if (!toolsObj || typeof reg !== 'function') {
+            traceToolReg('[scoped-tool] 拿不到 tools.register，跳过（下次再试）');
+            return;
+        }
+        // 先撤旧的（换开关后不能叠加）
+        if (st)
+            for (const d of st.disposers) {
+                try {
+                    d();
+                }
+                catch { /* ignore */ }
+            }
+        const want = [
+            ...(opts.ctxTools ? ctxToolsRef() : []),
+            ...(opts.groupAdmin ? qunAdminRef() : []),
+        ];
+        const disposers = [];
+        for (const t of want) {
+            try {
+                const d = reg.call(toolsObj, t);
+                if (typeof d === 'function')
+                    disposers.push(d);
+            }
+            catch { /* 单个工具失败不影响其它 */ }
+        }
+        // 全成功才认这个 sig；否则标 __retry，下一 step 重来
+        const okAll = disposers.length === want.length;
+        ctxScopeState.set(key, { sig: okAll ? sig : `__retry-${sig}`, disposers });
+        traceToolReg(`[scoped-tool] 按会话注册 ctx=${opts.ctxTools ? 1 : 0} groupAdmin=${opts.groupAdmin ? 1 : 0}`
+            + ` want=${want.length} ok=${disposers.length}`
+            + ` dataRoot=${String(opts.dataRoot ?? '')} sk=${String(opts.sessionKey ?? '')}`);
+    }
+    catch (e) {
+        traceToolReg('[scoped-tool] 异常: ' + String(e?.message ?? e).slice(0, 160));
+    }
+}
 let __extRestrictDispose;
 export function applyExtDisabledRestrict(agentCtx, dataRoot, extToolNames) {
     try {