@zaofan/dsh-qqbot 1.6.1 → 1.6.3

package/README.md

@@ -30,11 +30,14 @@
 - 群消息聚合时按「价值 × 好感」**加权平均**综合判断，不会被一句话钓走
 
 **💬 悬浮球 dock：她的随身控制台**
-设置面板右下角的小球，点开就是一整个操作台：**💬 聊天**（像 QQ 一样回放群/私聊记录，气泡+头像，图能放大、本地视频能播、SILK 语音转 mp3 直接听、文件出下载卡，还能在聊天框里直接发文字/插图/发文件——长文本自动拆条连发不被吞）；**📥 入群审批**、**🔇 禁言**（机器人为群管理员时，有人申请进群她会提醒你，回句"通过/拒绝"就批）；**⚙️ 出站**（适配主动：刚收到真人消息时前几条带引用回你、连发自动转独立消息，定时/后台推送不打扰）。
+设置面板右下角的小球，点开就是一整个操作台：**💬 聊天**（像 QQ 一样回放群/私聊记录，气泡+头像，图能放大、本地视频能播、SILK 语音转 mp3 直接听、文件出下载卡，还能在聊天框里直接发文字/插图/发文件——长文本自动拆条连发不被吞）；**📥 入群审批**、**🔨 锤子**（下面分 **🔇 禁言** 和 **👢 踢人** 两页；踢人用你自己的 QQ 号管群，扫码一次之后长期免扫，登录态与 AI 共享）；**⚙️ 出站**（适配主动：刚收到真人消息时前几条带引用回你、连发自动转独立消息，定时/后台推送不打扰）。
 
 **🛡️ 群主/群管好帮手**
 入群审批 + 禁言 + 查成员，全走官方接口，出错给"人话"（不是管理员/不能禁群主……都告诉你为什么）。
 
+**👢 踢人（v1.6.3）**
+QQ 官方**没有开放踢人接口**，所以这一块走"你自己的 QQ 号 + 群官网"：面板 **🔨 锤子 → 👢 踢人** 里刷新二维码、手机扫一次就登（之后长期免扫）；登录态和 AI 共用 —— 你也可以直接在 QQ 里跟她说"把群里那个 X 踢了"。
+
 **🗂️ 归档了也会自己回家**
 不小心把她的会话点了「归档」藏进侧边栏深处？不用满世界找——那个会话**下次在 QQ 里被消息触发时**，会自己从归档里摘出来回到侧边栏（你主动归档的其它会话不受影响）。
 
@@ -270,6 +273,60 @@ dsh: disabling profile plugin row "mcp-chrome": Plugin ... is incompatible with
 
 想强行运行，可用官方提供的**确切版本例外**（`dsh plugin allow-version`，或插件管理页里授予），但官方警告"可能崩溃或数据丢失"，自行权衡。
 
+## 🔨 锤子面板：禁言 / 踢人（v1.6.3）
+
+dock 面板里的 **🔨 锤子**（原来叫「🔇 禁言」），下面分两页：
+
+| 子页 | 走哪条路 | 说明 |
+|---|---|---|
+| **🔇 禁言** | 官方 Bot 接口 | 机器人为群管理员即可用，无需任何登录 |
+| **👢 踢人** | **你自己的 QQ 号**（群官网接口） | 官方没开放踢人接口，所以这里要登一次 |
+
+### 怎么用（踢人）
+
+1. 面板 → **🔨 锤子** → **👢 踢人** → 点 **📱 刷新二维码**
+2. 页面里**直接显示二维码** —— 拿手机 QQ「扫一扫」，**摄像头对着电脑屏幕**扫
+   > 腾讯只认摄像头：用相册选图 / 长按识别会提示「本次请求不支持图片识别或长按扫描二维码授权」
+3. 扫完自动切到已登录界面：**选群 + 搜成员（uin 精确 / 昵称模糊）+ 点一下 👢 踢**
+
+![🔨 锤子 · 踢人面板：搜「鱼」的结果，每人一个 👢 踢按钮](docs/screenshots/hammer-kick-panel.png)
+
+### 免扫码是怎么做到的
+
+登录成功后凭据存在 `{dataRoot}/qun-cookie.json`。之后每次需要登录时：
+
+```
+静默起一个「无头」浏览器 → 把已存的凭据注入进去（CDP Network.setCookie）
+→ 页面直接就是已登录状态 → 读出凭据 → 关掉浏览器
+```
+
+**全程不弹窗口、不用扫码**。只有第一次（或凭据彻底过期）才要扫一次；`skey` 约 1 天后过期，重登走的也是上面这套静默流程。
+
+> 💡 实测彩蛋：**本机开着 QQ 客户端**时，登录页会直接显示你的头像，点一下就登 —— 连第一次都不用扫。
+
+### 登录态与 AI 共享
+
+面板和 AI 读写的是**同一个** `qun-cookie.json`，所以两边天然同步：
+
+- 你在面板扫码登录 → 直接跟 AI 说「把群里那个 X 踢了」就能用
+- AI 先登过 → 你打开面板就是已登录
+
+AI 侧的工具叫 **`qq_group_admin`**：
+
+| action | 作用 |
+|---|---|
+| `status` | 看登录状态 / 继续等扫码 |
+| `login` | 登录（静默优先，需要才给二维码路径） |
+| `groups` | 列出你创建/管理的群 |
+| `members` | 查成员（uin 精确 / 昵称模糊 / 全量） |
+| `kick` | 踢人 —— **必须带 `confirmed=true`**，否则只回一句「请先跟主人核对群和人」 |
+
+### 隐私与进程
+
+- 浏览器用**独立 profile**（在插件数据目录里），**看不到你日常浏览器的任何东西**
+- **不常驻**：拿到凭据立刻关；等扫码最多留 5 分钟；宿主退出时会一起带走（不留孤儿进程）
+- 凭据只存在你自己的机器上，仓库里不含任何凭据
+
 ## 🚫 无上下文模式（按会话省 token）
 
 让某个 QQ 会话**每轮只记得最近几条对话**，更早的历史自动折叠 —— 群聊省 token 利器。

package/client/qqbot-settings.js

@@ -1932,7 +1932,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
       setInterval(refreshBadge, 20000)
 
       // ── 面板状态(每个实例独立保存, 切回不丢) ──
-      var state = { ns: '', accts: [], gid: '', groups: [], tab: 'chat', sendScope: 'group', sendTo: '', sendName: '', sendText: '', insertCtx: true, targetQ: '', c2cs: [], joins: null, mutes: null, members: null, muteSecs: '60', bindGid: '', bindName: '', msg: '', busy: '', wantPeer: null, lookedUp: false, detected: null, detectedHit: null, chatItems: [], chatMore: false, chatBusy: '', chatErr: '', chatOldest: 0, chatText: '', chatIns: true, outMode: '', outRev: undefined, bpEvents: [], bpSel: null, bpDraft: null, rosterSel: {}, rosterScope: 'all', rosterQ: '', hubSid: '', hubRev: undefined, hubBusy: '', hubMsg: '', gaEnabled: false, gaPoll: false, gaPollWake: true, gaHubNotify: true, gaNotifyGroup: true, gaInterval: 5, gaMinCount: 1, gaMsg: '', gaBusy: '', bcDraft: null, bcTasks: null, cardMd: '', cardBtns: '', cardGid: '', cardBusy: '', cardQ: '', tgGroups: [], tgCur: '' }
+      var state = { ns: '', accts: [], gid: '', groups: [], tab: 'chat', sendScope: 'group', sendTo: '', sendName: '', sendText: '', insertCtx: true, targetQ: '', c2cs: [], joins: null, mutes: null, members: null, muteSecs: '60', bindGid: '', bindName: '', msg: '', busy: '', wantPeer: null, lookedUp: false, detected: null, detectedHit: null, chatItems: [], chatMore: false, chatBusy: '', chatErr: '', chatOldest: 0, chatText: '', chatIns: true, outMode: '', outRev: undefined, bpEvents: [], bpSel: null, bpDraft: null, rosterSel: {}, rosterScope: 'all', rosterQ: '', hubSid: '', hubRev: undefined, hubBusy: '', hubMsg: '', gaEnabled: false, gaPoll: false, gaPollWake: true, gaHubNotify: true, gaNotifyGroup: true, gaInterval: 5, gaMinCount: 1, gaMsg: '', gaBusy: '', bcDraft: null, bcTasks: null, cardMd: '', cardBtns: '', cardGid: '', cardBusy: '', cardQ: '', tgGroups: [], tgCur: '', hammerSub: 'mute', qunLogged: null, qunUin: '', qunGroups: [], qunGc: '', qunKw: '', qunMembers: [], qunCount: 0, qunQr: false, qunMsg: '', qunBusy: false, qunLoading: false }
       // 🗂 自定义目标分组(仿 QQ 分组): 2026-09-12 起**host 持久化**({dataRoot}/.qqbot/target-groups.json),
       // localStorage 只当秒开缓存 —— 这样 **AI 与主人共用同一份分组**(agent 侧 broadcast_send 可直接写分组名群发),
       // 顺带修掉"换个浏览器分组就没了"的老毛病。
@@ -3488,7 +3488,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           + '<button data-t="roster" class="' + (state.tab === 'roster' ? 'on' : '') + '">📇 群组管理</button>'
           + '<button data-t="chat" class="' + (state.tab === 'chat' ? 'on' : '') + '">💬 聊天</button>'
           + '<button data-t="join" class="' + (state.tab === 'join' ? 'on' : '') + '">📥 入群审批<span class="dk-join-badge" style="display:none;background:#ff4d4f;color:#fff;border-radius:8px;font-size:11px;padding:0 5px;margin-left:4px">0</span></button>'
-          + '<button data-t="mute" class="' + (state.tab === 'mute' ? 'on' : '') + '">🔇 禁言</button>'
+          + '<button data-t="mute" class="' + (state.tab === 'mute' ? 'on' : '') + '">🔨 锤子</button>'
           + '<button data-t="out" class="' + (state.tab === 'out' ? 'on' : '') + '">⚙️ 出站</button>'
           + '<button data-t="send" class="' + (['send','broadcast','bp','card'].indexOf(state.tab) >= 0 ? 'on' : '') + '">📤 群发</button>'
           + '<button data-t="session" class="' + (state.tab === 'session' ? 'on' : '') + '">⚙ 单会话设置</button>'
@@ -3574,13 +3574,23 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
             + '<span class="dk-msg">机器人需为群管理员; 通过/拒绝直接生效</span></div>'
           body += '<div class="dk-list" id="dk-join-list"></div>'
         } else if (state.tab === 'mute') {
-          body += '<div class="dk-row">目标群: ' + groupSelHtml
-            + '<button class="dk-btn" id="dk-refresh-mute">🔄 刷新</button></div>'
-          body += '<div class="dk-msg">全员禁言: 官方接口未开放 · 只能操作普通成员(群主/管理员不可禁)</div>'
-          body += '<div style="font-weight:700;font-size:13px;margin:8px 0 4px">① 禁言成员(机器人见过的)</div>'
-          body += '<div class="dk-list" id="dk-member-list"></div>'
-          body += '<div style="font-weight:700;font-size:13px;margin:8px 0 4px">② 正在禁言中</div>'
-          body += '<div class="dk-list" id="dk-mute-list"></div>'
+          // 🔨 锤子（2026-10-02 主人定）：原「禁言」升级成一个锤子，下面分两个子标签
+          var hsub = state.hammerSub || 'mute'
+          body += '<div class="dk-row" style="gap:6px;margin:2px 0">'
+            + '<button class="dk-btn' + (hsub === 'mute' ? ' ok' : '') + '" data-hsub="mute">🔇 禁言</button>'
+            + '<button class="dk-btn' + (hsub === 'kick' ? ' ok' : '') + '" data-hsub="kick">👢 踢人</button>'
+            + '</div>'
+          if (hsub === 'mute') {
+            body += '<div class="dk-row">目标群: ' + groupSelHtml
+              + '<button class="dk-btn" id="dk-refresh-mute">🔄 刷新</button></div>'
+            body += '<div class="dk-msg">全员禁言: 官方接口未开放 · 只能操作普通成员(群主/管理员不可禁)</div>'
+            body += '<div style="font-weight:700;font-size:13px;margin:8px 0 4px">① 禁言成员(机器人见过的)</div>'
+            body += '<div class="dk-list" id="dk-member-list"></div>'
+            body += '<div style="font-weight:700;font-size:13px;margin:8px 0 4px">② 正在禁言中</div>'
+            body += '<div class="dk-list" id="dk-mute-list"></div>'
+          } else {
+            body += hammerKickHtml()
+          }
         } else if (state.tab === 'roster') {
           body += '<div class="dk-row" style="font-weight:700;font-size:13px;margin:2px 0">📇 会话台账:机器人聊过的对象</div>'
           body += '<div class="dk-row"><span class="dk-msg" style="flex:1;line-height:1.5">👤 = 私聊过的人(有 c2c 会话,可直接发消息) · 👥 = 群(群成员≠私聊对象: 群里见过≠能私聊,只能群内@)</span></div>'
@@ -3931,7 +3941,15 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
         if (state.tab === 'send') applyTargetFilter(panel, state)
         if (state.tab === 'chat') renderChatList()
         if (state.tab === 'join') renderJoinList()
-        if (state.tab === 'mute') { renderMemberList(); renderMuteList() }
+        if (state.tab === 'mute') {
+          if ((state.hammerSub || 'mute') === 'kick') {
+            // 首次进踢人页：先查一次登录状态（qunLogged 为 null 表示还没查过，查完会被置成 true/false，不会循环）
+            if (state.qunLogged === null) loadQunStatus(true)
+            renderQunMemberList()
+          } else {
+            renderMemberList(); renderMuteList()
+          }
+        }
         if (state.tab === 'roster' || state.tab === 'send') { renderRosterList(); bindRosterEvents(); loadHubState(); loadBroadcastTasks(false, true) }
         // 📝 卡片: 必须在 paintBody 内绑定(2026-09-10 修复: 原在 tab 点击处先 bind 后 paintBody,
         // 绑的是即将被替换的旧 DOM → 发送/存为事件无反应、预览不渲染)
@@ -3946,6 +3964,141 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
         if (state.tab === 'chat' && !state.chatItems.length && !state.chatBusy) loadChat(true)
         setTimeout(layoutPanel, 0)
       }
+      // ── 🔨 锤子 · 踢人（2026-10-02 主人定）──
+      //   登录态与 AI **共享**：两边读写同一个 {dataRoot}/qun-cookie.json，
+      //   所以面板登录完 AI 立刻能用、AI 登录完面板也立刻显示已登录。
+      function hammerKickHtml() {
+        if (state.qunLogged !== true) {
+          var h = '<div class="dk-msg">踢人需要先登录 QQ 群管理（扫码一次，之后长期免扫；登录态与 AI 共享）。</div>'
+          h += '<div class="dk-row" style="gap:6px;align-items:center">'
+            + '<button class="dk-btn ok" id="dk-qun-login"' + (state.qunBusy ? ' disabled' : '') + '>'
+            + (state.qunBusy ? '⏳ 处理中…' : '📱 刷新二维码') + '</button>'
+            + '<button class="dk-btn" id="dk-qun-status">🔄 查登录状态</button>'
+            + '</div>'
+          if (state.qunQr) {
+            h += '<div class="dk-row" style="justify-content:center;margin:8px 0">'
+              + '<img src="/api/qqbot-settings/qun-qr?t=' + Date.now() + '" alt="二维码" '
+              + 'style="width:230px;height:230px;border:1px solid #e2d9ff;border-radius:8px;background:#fff;object-fit:contain">'
+              + '</div>'
+              + '<div class="dk-msg" style="text-align:center">用手机 QQ「扫一扫」，摄像头对着<b>这块屏幕</b>扫'
+              + '（腾讯只认摄像头；相册 / 长按识别会被拒）</div>'
+          }
+          if (state.qunMsg) h += '<div class="dk-msg">' + esc(state.qunMsg) + '</div>'
+          return h
+        }
+        var groups = state.qunGroups || []
+        var opts = groups.map(function (g) {
+          return '<option value="' + esc(g.gc) + '"' + (g.gc === state.qunGc ? ' selected' : '') + '>'
+            + esc(g.gn || g.gc) + '（' + esc(g.role || '') + '）</option>'
+        }).join('')
+        var out = '<div class="dk-row" style="gap:6px;flex-wrap:wrap;align-items:center">'
+          + '<span style="font-size:12px;color:#666">群:</span>'
+          + '<select class="qqs-sel" id="dk-qun-gc" style="min-width:200px">' + (opts || '<option value="">（没有可管理的群）</option>') + '</select>'
+          + '<input class="qqs-txt" id="dk-qun-kw" placeholder="uin 或昵称（留空=全量）" value="' + esc(state.qunKw || '') + '" style="width:170px">'
+          + '<button class="dk-btn" id="dk-qun-search">🔍 搜索成员</button>'
+          + '<button class="dk-btn no" id="dk-qun-logout" title="清掉本地凭据（下次要重新扫码）">🚪 退出登录</button>'
+          + '</div>'
+        out += '<div class="dk-msg">✅ 已登录 uin=' + esc(state.qunUin || '?')
+          + (state.qunCount ? ' · 该群共 ' + state.qunCount + ' 人' : '') + '</div>'
+        out += '<div class="dk-list" id="dk-qun-member-list"></div>'
+        return out
+      }
+      function renderQunMemberList() {
+        var box = panel.querySelector('#dk-qun-member-list')
+        if (!box) return
+        var ms = state.qunMembers || []
+        if (state.qunLoading) { box.innerHTML = '<div class="dk-empty">加载中…</div>'; return }
+        if (!ms.length) { box.innerHTML = '<div class="dk-empty">还没有成员数据 —— 点「🔍 搜索成员」拉取</div>'; return }
+        box.innerHTML = ms.map(function (m) {
+          return '<div style="display:flex;align-items:center;gap:8px;padding:4px 2px;border-bottom:1px solid #f0ebff">'
+            + '<span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">' + esc(m.nick || '(无昵称)') + '</span>'
+            + '<span style="flex:none;font-family:monospace;font-size:11px;color:#888">' + esc(m.uin) + '</span>'
+            + '<button class="dk-btn no" style="flex:none" data-kick="' + esc(m.uin) + '" data-knick="' + esc(m.nick || '') + '">👢 踢</button>'
+            + '</div>'
+        }).join('')
+        box.querySelectorAll('button[data-kick]').forEach(function (btn) {
+          btn.onclick = function () {
+            var uin = btn.getAttribute('data-kick')
+            var nick = btn.getAttribute('data-knick') || uin
+            if (!window.confirm('确定把「' + nick + '」(uin ' + uin + ') 移出群 ' + state.qunGc + ' ？')) return
+            doQunKick([uin])
+          }
+        })
+      }
+      function loadQunStatus(repaint) {
+        api('qun/status').then(function (d) {
+          state.qunLogged = !!(d && d.logged)
+          if (d && d.uin) state.qunUin = d.uin
+          if (d && d.groups && d.groups.length) {
+            state.qunGroups = d.groups
+            var has = d.groups.some(function (g) { return g.gc === state.qunGc })
+            if (!state.qunGc || !has) state.qunGc = d.groups[0].gc
+          }
+          if (repaint) paintBody()
+        }).catch(function () { state.qunLogged = false; if (repaint) paintBody() })
+      }
+      function doQunLogin() {
+        state.qunBusy = true; state.qunMsg = ''
+        paintBody()
+        apiPost('qun/login', {}).then(function (d) {
+          state.qunBusy = false
+          if (d && d.logged) {
+            state.qunLogged = true; state.qunUin = d.uin || ''
+            state.qunMsg = '✅ 已登录（免扫码）'
+            loadQunStatus(false); paintBody()
+            return
+          }
+          state.qunQr = !!(d && d.needScan)
+          state.qunMsg = (d && d.msg) || (state.qunQr ? '' : '没能生成二维码')
+          paintBody()
+          if (state.qunQr) startQunPoll()
+        }).catch(function (e) { state.qunBusy = false; state.qunMsg = '异常: ' + e.message; paintBody() })
+      }
+      var qunPollTimer = null
+      function startQunPoll() {
+        if (qunPollTimer) return
+        qunPollTimer = setInterval(function () {
+          api('qun/poll').then(function (d) {
+            if (d && d.logged) {
+              clearInterval(qunPollTimer); qunPollTimer = null
+              state.qunLogged = true; state.qunUin = d.uin || ''
+              state.qunQr = false; state.qunMsg = '✅ 登录成功'
+              loadQunStatus(false); paintBody()
+            }
+          }).catch(function () { /* ignore */ })
+        }, 2500)
+      }
+      function doQunKick(uins) {
+        state.qunMsg = '正在踢…'
+        paintBody()
+        apiPost('qun/kick', { gc: state.qunGc, uins: uins }).then(function (d) {
+          var rs = (d && d.results) || []
+          state.qunMsg = (d && d.msg ? d.msg : '完成') + '：' + rs.map(function (x) {
+            return x.uin + (x.ec === 0 ? ' ✅' : ' ❌' + x.msg)
+          }).join('；')
+          loadQunMembers()
+        }).catch(function (e) { state.qunMsg = '踢人异常: ' + e.message; paintBody() })
+      }
+      function loadQunMembers() {
+        if (!state.qunGc) { state.qunMsg = '先选一个群'; paintBody(); return }
+        state.qunLoading = true
+        paintBody()
+        // ⚠️ api(path, q) 的 q 是**字符串 query**，不是对象（传对象会变成 ?[object Object]）
+        var qs = 'gc=' + encodeURIComponent(state.qunGc) + '&q=' + encodeURIComponent(state.qunKw || '')
+        api('qun/members', qs).then(function (d) {
+          state.qunLoading = false
+          if (d && d.ok) {
+            state.qunMembers = d.members || []
+            state.qunCount = d.count || 0
+            state.qunMsg = '共拉取 ' + state.qunMembers.length + ' 人' + (d.note ? '（' + d.note + '）' : '')
+          } else {
+            state.qunMembers = []
+            state.qunMsg = (d && d.error) || '加载失败'
+          }
+          paintBody()
+        }).catch(function (e) { state.qunLoading = false; state.qunMsg = '异常: ' + e.message; paintBody() })
+      }
+
       function bindBodyEvents() {
         // ── 🚫 无上下文模式（2026-09-27）──
         // 照抄本文件既有模式：paintBody() 渲染完 → 调 bindBodyEvents() 统一绑事件
@@ -3955,6 +4108,40 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
         var ctxOnBox = panel.querySelector('#dk-ctxless-on')
         if (ctxOnBox) ctxOnBox.onchange = function () { saveCtxless() }
         if (state.tab === 'session' && (state.stTab || 'lm') === 'cl') loadCtxless()
+        // 🔨 锤子 · 子标签 + 踢人页按钮（2026-10-02）
+        panel.querySelectorAll('[data-hsub]').forEach(function (sb) {
+          sb.onclick = function () {
+            state.hammerSub = sb.getAttribute('data-hsub')
+            paintBody()
+          }
+        })
+        var qLoginBtn = panel.querySelector('#dk-qun-login')
+        if (qLoginBtn) qLoginBtn.onclick = function () { doQunLogin() }
+        var qStatusBtn = panel.querySelector('#dk-qun-status')
+        if (qStatusBtn) qStatusBtn.onclick = function () { state.qunMsg = '正在查询…'; paintBody(); loadQunStatus(true) }
+        var qSearchBtn = panel.querySelector('#dk-qun-search')
+        if (qSearchBtn) {
+          qSearchBtn.onclick = function () {
+            var kwEl = panel.querySelector('#dk-qun-kw')
+            state.qunKw = kwEl ? kwEl.value : state.qunKw
+            loadQunMembers()
+          }
+        }
+        var qGcSel = panel.querySelector('#dk-qun-gc')
+        if (qGcSel) {
+          qGcSel.onchange = function () { state.qunGc = qGcSel.value; loadQunMembers() }
+        }
+        var qLogoutBtn = panel.querySelector('#dk-qun-logout')
+        if (qLogoutBtn) {
+          qLogoutBtn.onclick = function () {
+            if (!window.confirm('清掉本地登录凭据？下次要重新扫码。')) return
+            apiPost('qun/logout', {}).then(function () {
+              state.qunLogged = false; state.qunUin = ''; state.qunMembers = []
+              state.qunGroups = []; state.qunGc = ''; state.qunMsg = '已退出登录'
+              paintBody()
+            }).catch(function () { state.qunLogged = false; paintBody() })
+          }
+        }
         var tbs = panel.querySelectorAll('.dk-tab button')
         tbs.forEach(function (btn) {
           btn.onclick = function () {

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

@@ -1 +1 @@
-{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AA+ElE,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;AAWhC,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAiC;AA+B5F,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,CA+4DvD;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,CAwCvC;AAiID,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAyI;AACzL,wBAAgB,eAAe,IAAI,MAAM,CAA2F;AA0BpI;;;;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+BtJ"}
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../src/channel-tools.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAsFlE,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;AAWhC,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,CA+4DvD;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,CAwCvC;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"}

package/dist/channel-tools.js

@@ -24,6 +24,8 @@ import { managersOf, findManagerByPeer, findManagerBySessionId } from './feature
 import { handleInbound } from './transport/inbound.js';
 import { getQuote } from './features/quote-cache.js';
 import { appendMemoLine, deleteMemo, listMemos, readMemo } from './features/people-memo.js';
+import { loadQunCookie, saveQunCookie, qunLoginStart, qunLoginPoll, qunLoginPending, qunGroups, qunResolveGc, qunMembers, qunKick, } from './features/qun-admin.js';
+import { qunBrowserLoginStart, qunBrowserLoginWait, qunLoginSessionAlive, } from './features/qun-login.js';
 import { appendMemo as appendContextMemo, clearMemo as clearContextMemo, deleteMemo as deleteContextMemo, editMemo as editContextMemo, listMemo as listContextMemo, } from './features/context-memo.js';
 /** 诊断日志路径: 默认关闭; 需要排查时设环境变量 QQBOT_DIAG_FILE 指向日志文件 */
 const DIAG_FILE = process.env.QQBOT_DIAG_FILE || '';
@@ -112,8 +114,9 @@ function getContextlessSmartGlobal() { return ctxSmartGlobal; }
 /** 无上下文·智能判断：取当前会话的 dataRoot + sessionKey */
 async function resolveCtxMemoEnv(exec) {
     // ★ 优先用注册时记住的会话坐标（工具里的 exec.agent 与 pre-step 的 agent 是两个不同对象，反查常失败）
+    //   ⚠️ 必须要求 sessionKey 非空：备忘/压缩都按会话分文件存，空 key 会让所有会话串到同一份。
     const cached = ctxEnvOf(exec);
-    if (cached)
+    if (cached && cached.sessionKey)
         return cached;
     try {
         const got = findSessionRec(channelOf(exec), exec);
@@ -127,6 +130,24 @@ async function resolveCtxMemoEnv(exec) {
         return undefined;
     }
 }
+/**
+ * 只要 dataRoot 的场景（QQ 群管理工具）。
+ * pre-step 里 sessionKey 经常是**空**的（实测 [ctxtool-env] sk= 为空），
+ * 所以这里不能像备忘那样要求 sessionKey —— 群管理只跟数据目录有关，与会话无关。
+ */
+async function resolveCtxDataRoot(exec) {
+    const cached = ctxEnvOf(exec);
+    if (cached && cached.dataRoot)
+        return cached.dataRoot;
+    try {
+        const got = findSessionRec(channelOf(exec), exec);
+        const dataRoot = got?.ch?.manager?.config?.dataRoot;
+        if (dataRoot)
+            return String(dataRoot);
+    }
+    catch { /* ignore */ }
+    return undefined;
+}
 /** 登记文件路径（工具只登记，真正压缩在下一回合 pre-step） */
 function ctxPendingPath(dataRoot, sessionKey) {
     // ⚠️ 同上：不能保留冒号（Windows 文件名禁用 `:`，会导致 pending 写不进/读不到）
@@ -2544,6 +2565,162 @@ var contextDropTool = defineTool({
                 + (a.note ? '（要点已存进你的备忘）' : '（本次没写要点；丢弃后这些历史就找不回来了，建议带 note）') };
     },
 });
+/**
+ * QQ 群管理工具 —— 用主人自己的 QQ 号管理「我创建 / 我管理」的群。
+ * 纯 HTTP（qun.qq.com 的 qun_mgr 接口），**不需要浏览器**，新用户装完插件自己扫码就能用。
+ * 不受「无上下文」开关影响，永远挂在会话上。
+ */
+var qunAdminTool = defineTool({
+    name: 'qq_group_admin',
+    description: '用主人自己的 QQ 号管理群（我创建/我管理的群）：登录、看群列表、查群成员、踢人。'
+        + '登录用 action=login —— 会自动开一个隐藏的浏览器去「点头像授权」，有 QQ 登录态时**免扫码直接登**；'
+        + '若这台机器上还没有 QQ 登录态，它会出一张二维码，你立刻用 send_media 发给主人扫，再调 action=status 等结果（一次最多等 20 秒，没等到再调）。'
+        + '⚠️ 踢人前必须先跟主人确认「哪个群、哪个人」，确认无误后才带 confirmed=true 调用；绝不自己决定踢谁。',
+    parameters: {
+        action: {
+            type: 'string',
+            required: true,
+            enum: ['status', 'login', 'groups', 'members', 'kick'],
+            description: 'status=登录状态/继续等扫码 / login=出二维码 / groups=群列表 / members=查成员 / kick=踢人',
+        },
+        group: { type: 'string', description: '群号或群名（members/kick 必填；群名支持模糊匹配）' },
+        keyword: { type: 'string', description: 'members 用：uin（精确查）或昵称片段' },
+        uins: { type: 'string', description: 'kick 用：要踢的 uin，多个用逗号分隔' },
+        confirmed: { type: 'boolean', description: 'kick 用：主人已明确同意踢这些人时才传 true' },
+    },
+    output: {
+        schema: {
+            type: 'object',
+            additionalProperties: true,
+            properties: {
+                ok: { type: 'boolean', required: true },
+                msg: { type: 'string', required: true },
+            },
+        },
+        render: (_a, v) => [{ type: 'text', text: String(v?.msg ?? '') }],
+    },
+    async execute(args, exec) {
+        // 群管理只认数据目录（不要 sessionKey —— pre-step 里它经常是空的）
+        const dataRoot = await resolveCtxDataRoot(exec);
+        if (!dataRoot)
+            return { ok: false, msg: '没找到会话的数据目录，无法读写 QQ 登录凭据' };
+        const a = (args ?? {});
+        const action = String(a.action || 'status');
+        try {
+            // ── 登录状态 / 继续等扫码 ──
+            if (action === 'status') {
+                // ① 浏览器会话还在等（免扫码那条路）→ 先问它
+                if (qunLoginSessionAlive(dataRoot)) {
+                    const w = await qunBrowserLoginWait(dataRoot, 20000);
+                    if (w.cookie) {
+                        saveQunCookie(dataRoot, { ...w.cookie, at: Date.now() });
+                        return { ok: true, msg: `登录成功（浏览器头像授权），uin=${w.cookie.uin}。可以直接 groups / members / kick 了。` };
+                    }
+                    return { ok: w.ok, msg: w.msg };
+                }
+                const c = loadQunCookie(dataRoot);
+                if (c && !qunLoginPending(dataRoot)) {
+                    return { ok: true, msg: `已登录：uin=${c.uin}（凭据可用）。可以直接 groups / members / kick。` };
+                }
+                if (qunLoginPending(dataRoot)) {
+                    const p = await qunLoginPoll(dataRoot, 20000);
+                    if (p.done)
+                        return { ok: true, msg: p.msg };
+                    return { ok: p.ok, msg: p.msg + '（还没确认就再调一次 status；二维码 3 分钟有效）' };
+                }
+                return { ok: false, msg: '还没登录。请调 action=login。' };
+            }
+            // ── 登录：① 先静默无头试（有登录态/有头像就零打扰完成）；② 要扫码就把二维码送上 dsh 网页 ──
+            if (action === 'login') {
+                const b = await qunBrowserLoginStart(dataRoot, { headless: true });
+                if (b.cookie) {
+                    saveQunCookie(dataRoot, { ...b.cookie, at: Date.now() });
+                    return {
+                        ok: true,
+                        msg: `免扫码登录成功（静默点头像授权，全程没弹窗口），uin=${b.cookie.uin}。可以直接用 groups / members / kick 了。`,
+                    };
+                }
+                // ⚠️ 需要人扫码时**不要试图弹浏览器窗口**：实测宿主 spawn 的浏览器窗口根本到不了用户桌面
+                //   （headless=False 也一样，进程查不到任何可见窗口）。也别发图 —— 用户在手机上收到图
+                //   扫不了自己的屏幕。最稳的做法：**直接给出二维码的本地文件路径**，用户在自己电脑上打开它扫。
+                if (b.qrPath) {
+                    return {
+                        ok: true,
+                        msg: '需要扫一次码。二维码已经生成到本地文件：\n'
+                            + '  ' + b.qrPath + '\n'
+                            + '请在**电脑上打开这张图片**（双击它、或用看图软件），然后用手机 QQ 的「扫一扫」，'
+                            + '**摄像头对着电脑屏幕**扫 —— 腾讯只认摄像头，用相册或长按识别会被拒绝。'
+                            + '扫完调 action=status 等结果。',
+                    };
+                }
+                // ③ 浏览器这条路不通（没装/起不来）→ 退回纯网络二维码（也是同一个本地文件路径）
+                const s = await qunLoginStart(dataRoot);
+                if (!s.ok || !s.qrPath)
+                    return { ok: false, msg: '登录失败：' + b.msg + ' ／ ' + s.msg };
+                return {
+                    ok: true,
+                    msg: '（浏览器方式不可用，已改用纯网络二维码）二维码已生成到本地文件：\n'
+                        + '  ' + s.qrPath + '\n'
+                        + '在电脑上打开这张图，用手机 QQ 摄像头对着屏幕扫，然后调 action=status 等结果。',
+                };
+            }
+            // 以下都要已登录
+            if (!loadQunCookie(dataRoot)) {
+                return { ok: false, msg: '还没登录 QQ。先调 action=login 出二维码（再用 send_media 发给主人扫）。' };
+            }
+            // ── 群列表 ──
+            if (action === 'groups') {
+                const gs = await qunGroups(dataRoot);
+                if (!gs.length)
+                    return { ok: true, msg: '我名下没有「我创建/我管理」的群。' };
+                return {
+                    ok: true,
+                    msg: `共 ${gs.length} 个群（群号\t群名\t身份）：\n` + gs.map((g) => `${g.gc}\t${g.gn}\t[${g.role}]`).join('\n'),
+                };
+            }
+            // ── 查成员 ──
+            if (action === 'members') {
+                const res = await qunResolveGc(dataRoot, String(a.group || ''));
+                if (!res.ok)
+                    return { ok: false, msg: res.msg };
+                const kw = String(a.keyword || '').trim();
+                const m = await qunMembers(dataRoot, res.gc, kw || undefined);
+                const head = `群 ${res.gc}${res.gn ? '(' + res.gn + ')' : ''} 共 ${m.count ?? '?'} 人`
+                    + (kw ? `，命中 ${m.members.length} 人` : `，本次取回 ${m.members.length} 人`) + (m.note || '') + '：';
+                const show = m.members.slice(0, 80);
+                const body = show.map((x) => `${x.uin}\t${x.nick}`).join('\n');
+                const tail = m.members.length > show.length ? `\n…（还有 ${m.members.length - show.length} 人，建议加 keyword 精确查）` : '';
+                return { ok: true, msg: m.members.length ? head + '\n' + body + tail : head + '\n(无匹配)' };
+            }
+            // ── 踢人 ──
+            if (action === 'kick') {
+                const list = String(a.uins || '').split(/[,，\s]+/).map((x) => x.trim()).filter(Boolean);
+                if (!list.length)
+                    return { ok: false, msg: '请给要踢的 uin（uins 参数，多个用逗号分隔）' };
+                if (a.confirmed !== true) {
+                    return { ok: false, msg: `还没确认：准备踢 ${list.join('、')}。请先跟主人核对「群 + 人」，主人明确同意后再带 confirmed=true 调用。` };
+                }
+                const res = await qunResolveGc(dataRoot, String(a.group || ''));
+                if (!res.ok)
+                    return { ok: false, msg: res.msg };
+                const rs = await qunKick(dataRoot, res.gc, list);
+                const okCnt = rs.filter((x) => x.ec === 0).length;
+                return {
+                    ok: okCnt > 0,
+                    msg: `群 ${res.gc}${res.gn ? '(' + res.gn + ')' : ''} 踢人结果（成功 ${okCnt}/${rs.length}）：\n`
+                        + rs.map((x) => `${x.uin}\t${x.ec === 0 ? '✅' : '❌'} ${x.msg}`).join('\n'),
+                };
+            }
+            return { ok: false, msg: '未知 action：' + action };
+        }
+        catch (e) {
+            const msg = String(e?.message ?? e);
+            if (msg.includes('NOT_LOGGED_IN'))
+                return { ok: false, msg: '登录已失效，请重新调 action=login 出二维码。' };
+            return { ok: false, msg: '出错：' + msg.slice(0, 200) };
+        }
+    },
+});
 // 模块级直接拿（不依赖 apply —— apply 只在会话首建时跑，agent 重建后不会重跑）
 //   注意：三个工具定义在同文件下方（var 声明，有提升），故这里用取值函数避免 TDZ。
 /**
@@ -2567,6 +2744,17 @@ function ctxToolsRef() {
     }
     return CTX_TOOLS_REF;
 }
+let QUN_TOOLS_REF = [];
+/** 惰性取 QQ 群管理工具（不分开关，永远挂） */
+function qunAdminRef() {
+    if (QUN_TOOLS_REF.length === 0) {
+        try {
+            QUN_TOOLS_REF = [qunAdminTool];
+        }
+        catch { /* ignore */ }
+    }
+    return QUN_TOOLS_REF;
+}
 const ctxEnvMap = new WeakMap();
 /** 工具执行时取会话坐标：优先用注册时记下的（最准），取不到再回退反查 */
 function ctxEnvOf(exec) {
@@ -2581,6 +2769,18 @@ function ctxEnvOf(exec) {
     catch { /* fallthrough */ }
     return undefined;
 }
+/** 工具挂载诊断：直接追加到 ~/.dsh/contextless-trace.log（与 session-manager 的 trace 同一文件）
+ *  为什么要它：插件工具层（注册/挂载）以前完全没法验证，只能靠猜。有了这行，重启后一眼就能看出
+ *  「群管理工具有没有真的挂上去、dataRoot 传的是什么」。 */
+function traceToolReg(line) {
+    try {
+        const home = process.env['HOME'] || process.env['USERPROFILE'] || '';
+        if (!home)
+            return;
+        appendFileSync(join(home, '.dsh', 'contextless-trace.log'), `[${new Date().toISOString()}]  ${line}\n`);
+    }
+    catch { /* ignore */ }
+}
 /**
  * 按会话开关**动态**注册/注销三个上下文工具（context_memo / context_compact / context_drop）。
  * 由 session-manager 在每个回合的 pre-step 里调用（拿 rec.agentCtx）。
@@ -2594,8 +2794,10 @@ export function syncContextTools(agentCtx, shouldHave, env, reminderText) {
     const key = agentCtx;
     try {
         // ① 先记会话坐标（每次 pre-step 都刷新；这是工具执行时唯一的可靠来源）
-        if (env && env.dataRoot && env.sessionKey) {
-            ctxEnvMap.set(key, { dataRoot: String(env.dataRoot), sessionKey: String(env.sessionKey) });
+        //   ⚠️ 只要 dataRoot 就够了：pre-step 里 sessionKey 经常为空（实测 sk= 空），
+        //     但群管理工具只要数据目录；备忘类工具由 resolveCtxMemoEnv 自己要求 sessionKey 非空。
+        if (env && env.dataRoot) {
+            ctxEnvMap.set(key, { dataRoot: String(env.dataRoot), sessionKey: String(env.sessionKey ?? '') });
         }
         const cur = ctxToolDisposers.get(key);
         // ⚠️ 2026-10-02：不能靠"缓存里已注册"就跳过 —— agent/ctx 一变，实际工具表就作废了，
@@ -2610,11 +2812,12 @@ export function syncContextTools(agentCtx, shouldHave, env, reminderText) {
             }
             ctxToolDisposers.delete(key);
         }
+        const reg = ctxObj.tools?.register;
+        if (typeof reg !== 'function')
+            return;
+        const ds = [];
+        // ① 三个上下文工具：只在「无上下文·智能判断」开启时挂
         if (shouldHave) {
-            const reg = ctxObj.tools?.register;
-            if (typeof reg !== 'function')
-                return;
-            const ds = [];
             for (const t of ctxToolsRef()) {
                 try {
                     const d = reg.call(ctxObj.tools, t);
@@ -2623,10 +2826,25 @@ export function syncContextTools(agentCtx, shouldHave, env, reminderText) {
                 }
                 catch { /* 单个工具注册失败不影响其他 */ }
             }
-            if (ds.length)
-                ctxToolDisposers.set(key, ds);
         }
+        // ② QQ 群管理工具：QQ 通道的会话都挂。
+        //   注：syncContextTools 本来就**只在 QQ 会话**里被调用（web/终端会话不经过这里），
+        //   所以不存在"污染其它会话"的问题。2026-10-02 曾误加"只挂私聊"限制，主人指出多余，已撤销。
+        for (const t of qunAdminRef()) {
+            try {
+                const d = reg.call(ctxObj.tools, t);
+                if (typeof d === 'function')
+                    ds.push(d);
+            }
+            catch { /* ignore */ }
+        }
+        if (ds.length)
+            ctxToolDisposers.set(key, ds);
+        traceToolReg(`[ctxtool-reg] shouldHave=${shouldHave} 挂载=${ds.length} 件 dataRoot=${String(env?.dataRoot ?? '')} sk=${String(env?.sessionKey ?? '')}`);
+    }
+    catch (e) {
+        // fail-soft：工具挂载失败绝不影响会话；但必须留下证据
+        traceToolReg('[ctxtool-reg] 异常: ' + String(e?.message ?? e).slice(0, 160));
     }
-    catch { /* fail-soft：工具挂载失败绝不影响会话 */ }
 }
 //# sourceMappingURL=channel-tools.js.map