@zaofan/dsh-qqbot 1.11.8 → 1.11.9

package/client/qqbot-settings.js

@@ -2760,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)，
@@ -6718,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
@@ -7762,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
@@ -7777,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":"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"}
+{"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 {