@zaofan/dsh-qqbot 1.6.0 → 1.6.2

package/README.md

@@ -30,11 +30,14 @@
 - 群消息聚合时按「价值 × 好感」**加权平均**综合判断，不会被一句话钓走
 
 **💬 悬浮球 dock：她的随身控制台**
-设置面板右下角的小球，点开就是一整个操作台：**💬 聊天**（像 QQ 一样回放群/私聊记录，气泡+头像，图能放大、本地视频能播、SILK 语音转 mp3 直接听、文件出下载卡，还能在聊天框里直接发文字/插图/发文件——长文本自动拆条连发不被吞）；**📥 入群审批**、**🔇 禁言**（机器人为群管理员时，有人申请进群她会提醒你，回句"通过/拒绝"就批）；**⚙️ 出站**（适配主动：刚收到真人消息时前几条带引用回你、连发自动转独立消息，定时/后台推送不打扰）。
+设置面板右下角的小球，点开就是一整个操作台：**💬 聊天**（像 QQ 一样回放群/私聊记录，气泡+头像，图能放大、本地视频能播、SILK 语音转 mp3 直接听、文件出下载卡，还能在聊天框里直接发文字/插图/发文件——长文本自动拆条连发不被吞）；**📥 入群审批**、**🔨 锤子**（下面分 **🔇 禁言** 和 **👢 踢人** 两页；踢人用你自己的 QQ 号管群，扫码一次之后长期免扫，登录态与 AI 共享）；**⚙️ 出站**（适配主动：刚收到真人消息时前几条带引用回你、连发自动转独立消息，定时/后台推送不打扰）。
 
 **🛡️ 群主/群管好帮手**
 入群审批 + 禁言 + 查成员，全走官方接口，出错给"人话"（不是管理员/不能禁群主……都告诉你为什么）。
 
+**👢 踢人（v1.6.2）**
+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.2）
+
+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 可直接写分组名群发),
       // 顺带修掉"换个浏览器分组就没了"的老毛病。
@@ -2073,6 +2073,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           state.ctxless = d || null
           if (on) on.checked = !!(d && d.enabled)
           if (win && d && typeof d.window === 'number') win.value = String(d.window)
+          try { var _mmEl = document.getElementById('dk-ctxless-memomax'); if (_mmEl) _mmEl.value = String((d && typeof d.memoMax === 'number') ? d.memoMax : 20) } catch (e) { /* ignore */ }
           // 2026-10-01: 同步 radio（原来只更新了条数框 —— 面板先渲染后拉数据，radio 会停在默认的"按条数"）
           try {
             var _isSmart = !!(d && d.smart === true)
@@ -2099,7 +2100,8 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
         // 2026-10-01: 模式单选 → smart；smart=true 时 window 不生效（互斥）
         var _modeEl = document.querySelector('input[name="dk-ctxless-mode"]:checked')
         var _mode = _modeEl ? String(_modeEl.value) : 'window'
-        var body = { sessionKey: key, enabled: !!(on && on.checked), window: win ? (parseInt(win.value, 10) || 0) : 5, smart: _mode === 'smart' }
+        var _mmEl2 = document.getElementById('dk-ctxless-memomax')
+        var body = { sessionKey: key, enabled: !!(on && on.checked), window: win ? (parseInt(win.value, 10) || 0) : 5, smart: _mode === 'smart', memoMax: _mmEl2 ? (parseInt(_mmEl2.value, 10) || 20) : 20 }
         // radio 切换：智能判断时条数框禁用（互斥的视觉提示）
         Array.prototype.forEach.call(document.querySelectorAll('input[name="dk-ctxless-mode"]'), function (r) {
           r.onchange = function () {
@@ -2114,6 +2116,7 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           api('contextless?sessionKey=' + encodeURIComponent(key)).then(function (back) {
             var same = back && back.enabled === body.enabled && Number(back.window) === Number(body.window)
               && (back.smart === true) === (body.smart === true)
+              && Number(back.memoMax || 20) === Number(body.memoMax || 20)
             if (hint) {
               hint.textContent = same
                 ? ('✅ 已保存并回读确认: ' + (back.enabled ? '开启' : '关闭') + ' / 带 ' + back.window + ' 条')
@@ -3485,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>'
@@ -3571,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>'
@@ -3685,6 +3698,10 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
                 + '<span>智能判断（推荐）'
                 + '<div style="font-size:12px;color:#888;line-height:1.4">由 AI <b>每轮自己判断话题是否结束</b>：结束了它就压缩旧历史（可留最近几条）或整段丢弃，<b>只留下自己总结的要点</b> —— 省 token 最狠，也不容易断片。要点存在独立文件里，<b>压缩永远碰不到</b>。</div></span></label>'
               + '</div>'
+            // 备忘条数上限（面板可设；超出自动丢最旧）
+            body += '<div class="dk-row" style="gap:6px;align-items:center;margin:4px 0 2px 22px;font-size:13px">'
+              + '<span>备忘条数上限 <input type="number" id="dk-ctxless-memomax" min="1" max="500" value="' + ((state.ctxless && typeof state.ctxless.memoMax === 'number') ? state.ctxless.memoMax : 20) + '" style="width:60px"> 条</span>'
+              + '<span style="font-size:12px;color:#888">（超出自动丢最旧的；AI 每轮的提示已要求它写精简）</span></div>'
             body += '<div class="dk-msg" style="line-height:1.5;color:#888">0 条 = 完全不带群消息(只剩系统规则 + 当前这句)。智能判断模式下条数不生效。开关存在插件数据目录, 重启不丢；<b>面板保存即时生效</b>，直接改文件则需重启。</div>'
           } else if (st === 'blank') {
             body += '<div style="border:1px dashed #cfc7ee;border-radius:8px;padding:20px 14px;margin:8px 0;text-align:center;line-height:2">'
@@ -3924,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 → 发送/存为事件无反应、预览不渲染)
@@ -3939,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() 统一绑事件
@@ -3948,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 () {
@@ -4552,18 +4746,18 @@ var QQS_CSS = ".qqs-btn{font:inherit;color:#333;background:linear-gradient(180de
           var keyOf = function (x) { return String(x.seq) + '|' + String(x.dir) + '|' + String(x.text || '').slice(0, 24) }
           var have = {}
           state.chatItems.forEach(function (x) { have[keyOf(x)] = 1 })
-          // ⚠️ 2026-10-01 主人实测「向下滚后最新消息后面冒出历史消息」：
-          //   群打包块([历史]…[/历史])会被拆成多条挂在**同一个新 seq** 上, 内容却是**更早**的消息;
-          //   不过滤就会被当新事件整块接到列表尾部。只收"时间不早于列表尾部那条"的条目。
-          var _tailT = state.chatItems.length ? (Number(state.chatItems[state.chatItems.length - 1].time) || 0) : 0
-          var fresh = list.filter(function (x) {
-            return !have[keyOf(x)] && (Number(x.time) || 0) >= _tailT
+          // ⚠️ 2026-10-01 主人实测「向下滚后最新消息后面冒出历史消息」：
+          //   群打包块([历史]…[/历史])会被拆成多条挂在**同一个新 seq** 上, 内容却是**更早**的消息;
+          //   不过滤就会被当新事件整块接到列表尾部。只收"时间不早于列表尾部那条"的条目。
+          var _tailT = state.chatItems.length ? (Number(state.chatItems[state.chatItems.length - 1].time) || 0) : 0
+          var fresh = list.filter(function (x) {
+            return !have[keyOf(x)] && (Number(x.time) || 0) >= _tailT
           })
           if (fresh.length) {
             state.chatItems = state.chatItems.concat(fresh)
             appendChatRows(fresh)          // ★ 增量追加: 不重绘、不闪、不跳位置
           }
-          // 已加载位置 = 列表里最大的事件 seq（同 ①：不能用 tailSeq）
+          // 已加载位置 = 列表里最大的事件 seq（同 ①：不能用 tailSeq）
           state.chatItems.forEach(function (x) { var n = Number(x.seq); if (n > state.chatNewest) state.chatNewest = n })
           updateChatStatus()
         }).catch(function () { state.chatBusy = ''; updateChatStatus() })