dsh-qq-tools 0.9.5 → 0.10.2

package/lib/watchers/mentions.js

@@ -0,0 +1,167 @@
+// @ 提醒与群后续轮询。
+
+import { randomUUID } from 'node:crypto'
+import { loadCfg, diag } from '../config.js'
+import { onebot } from '../onebot.js'
+import { clean, segText } from '../utils.js'
+import { listOf } from '../render.js'
+import { formatIncomingLine, favoriteHint, FACE_STYLE, CHAT_STYLE, lookHint } from '../prompts.js'
+import { hasActiveTool, targetSessionId, findAgent } from '../session.js'
+import { windowUntil, pruneExpiredWindows } from '../observation.js'
+import { getSelfId, refreshNames, groupName, resetQqState } from '../qq-state.js'
+
+// ---------- @ 提醒轮询（由「发群消息」组件启动） ----------
+let lastSeen = new Map()
+let seen = new Set()
+let busy = false
+let noAgentAt = 0
+
+async function pollMentions(ctx) {
+  const cfg = loadCfg()
+  if (!cfg.mentionEnabled) return
+  if (busy) return
+  busy = true
+  try {
+    const target = targetSessionId()
+    const agent = findAgent(ctx.agents, target)
+    if (!agent) {
+      if (Date.now() - noAgentAt > 60000) {
+        noAgentAt = Date.now()
+        diag('@ 轮询：目标会话没有活着（' + (target || '未设置') + '）')
+      }
+      return
+    }
+    const selfId = await getSelfId(cfg)
+    const now = Math.floor(Date.now() / 1000)
+    if (!lastSeen.size) {
+      for (const gid of cfg.groups) lastSeen.set(String(gid), now)
+      diag('@ 轮询初始化，从现在开始（' + now + '）')
+    }
+    await refreshNames(cfg)
+    const mentions = []
+    const followups = new Map()
+    for (const gid of cfg.groups) {
+      let messages = []
+      try {
+        messages = listOf(await onebot('get_group_msg_history', { group_id: Number(gid), count: 10 }, cfg), 'messages')
+      } catch (error) {
+        continue
+      }
+      const prev = lastSeen.get(String(gid)) || 0
+      let maxTime = prev
+      for (const m of listOf(messages, 'messages').slice().sort((a, b) => (a.time || 0) - (b.time || 0))) {
+        const t = Number(m.time || 0)
+        if (t < prev) continue
+        if (t > maxTime) maxTime = t
+        const mid = m.message_id
+        if (mid != null) {
+          if (seen.has(mid)) continue
+          seen.add(mid)
+        }
+        const uid = Number((m.sender && m.sender.user_id) || m.user_id || 0)
+        if (selfId && uid === Number(selfId)) continue
+        const segs = Array.isArray(m.message) ? m.message : []
+        const atMe = segs.some(
+          (s) => s && s.type === 'at' && (String(s.data && s.data.qq) === selfId || String(s.data && s.data.qq) === 'all'),
+        )
+        const text = segText(segs) || '（没有文字）'
+        const name = clean((m.sender && (m.sender.card || m.sender.nickname)) || String(uid))
+        const senderQQ = String(uid || (m.sender && m.sender.user_id) || '?')
+        const winUntil = windowUntil(gid)
+        if (Date.now() < winUntil) {
+          const arr = followups.get(String(gid)) || []
+          arr.push({
+            gid: String(gid),
+            group: groupName(gid),
+            sender: name,
+            user_id: senderQQ,
+            message_id: mid,
+            text,
+            time: t,
+          })
+          followups.set(String(gid), arr)
+        } else if (atMe) {
+          mentions.push({
+            gid: String(gid),
+            group: groupName(gid),
+            sender: name,
+            user_id: senderQQ,
+            message_id: mid,
+            text,
+            time: t,
+          })
+        }
+      }
+      lastSeen.set(String(gid), maxTime)
+    }
+    if (seen.size > 500) seen.clear()
+    pruneExpiredWindows()
+    if (!mentions.length && followups.size === 0) return
+    const fmtLine = (x) => formatIncomingLine(x.sender, x.user_id, x.text, x.message_id)
+    const lines = mentions.slice(-5).map((x) => `群「${x.group}」${fmtLine(x)}`)
+    const sendTools = []
+    if (hasActiveTool('qq_send_group_message')) sendTools.push('qq_send_group_message')
+    if (hasActiveTool('qq_send_face')) sendTools.push('qq_send_face')
+    const sendHint = sendTools.length ? '想说话可以用 ' + sendTools.join(' / ') + ' 回复；' : ''
+    const quoteHint = hasActiveTool('qq_send_group_message')
+      ? '确实要指代某条消息时才传 reply_to=消息编号；必须提醒某个人时才传 at_user_ids=[QQ号]；'
+      : ''
+    const favLine = [...mentions].reverse().find((x) => favoriteHint(x.text, x.message_id))
+    const favHint = favLine && hasActiveTool('qq_favorite_face')
+      ? favoriteHint(favLine.text, favLine.message_id)
+      : ''
+    const faceHint = hasActiveTool('qq_send_face') ? FACE_STYLE : ''
+    const prompt =
+      '【群聊 @ 提醒】有人 @ 了你：\n' +
+      lines.join('\n') +
+      '\n' + lookHint() + '再决定要不要回复、回哪个群。' + sendHint + quoteHint + favHint + faceHint + '不想说话就安静待着；' +
+      '不要提工具和私聊内容。' + CHAT_STYLE
+    const message = {
+      id: randomUUID(),
+      role: 'user',
+      content: [{ type: 'text', text: prompt }],
+      source: { kind: 'qq-mention' },
+    }
+    if (mentions.length) {
+      await agent.followup(message)
+      diag('@ 提醒已送进会话：' + lines.join(' | ').slice(0, 300))
+    }
+    for (const [gid, list] of followups) {
+      const group = list[0] && list[0].group ? list[0].group : gid
+      const lines2 = list.slice(-10).map(fmtLine)
+      const favLine2 = [...list].reverse().find((x) => favoriteHint(x.text, x.message_id))
+      const favHint2 = favLine2 && hasActiveTool('qq_favorite_face')
+        ? favoriteHint(favLine2.text, favLine2.message_id)
+        : ''
+      const prompt2 =
+        '【群聊后续】你刚才在群「' + group + '」里说过话，现在又有人说话：\n' +
+        lines2.join('\n') +
+        '\n想接就接；' +
+        (hasActiveTool('qq_send_group_message') ? '想说话用 qq_send_group_message 发到这个群，确实要指代某条才传 reply_to=消息编号，必须提醒某人才传 at_user_ids=[QQ号]；' : '') +
+        favHint2 +
+        (hasActiveTool('qq_send_face') ? FACE_STYLE : '') +
+        '不想接就安静待着。' + CHAT_STYLE
+      await agent.followup({
+        id: randomUUID(),
+        role: 'user',
+        content: [{ type: 'text', text: prompt2 }],
+        source: { kind: 'qq-followup' },
+      })
+      diag('群后续 → 会话：群 ' + gid + ' ' + lines2.join(' | ').slice(0, 240))
+    }
+  } catch (error) {
+    diag('@ 轮询出错：' + String((error && error.message) || error))
+  } finally {
+    busy = false
+  }
+}
+
+export function startMentionPolling(ctx) {
+  // 组件重新加载时从头开始，避免把停用期间的旧 @ 一次性翻出来。
+  resetQqState()
+  lastSeen = new Map()
+  seen = new Set()
+  busy = false
+  noAgentAt = 0
+  ctx.effect(() => ctx.interval(() => pollMentions(ctx), loadCfg().pollMs))
+}

package/lib/watchers/poke.js

@@ -0,0 +1,87 @@
+// 戳一戳事件接收。
+
+import { randomUUID } from 'node:crypto'
+import { loadCfg, allowedPrivate, diag } from '../config.js'
+import { onebot } from '../onebot.js'
+import { clean } from '../utils.js'
+import { hasActiveTool, targetSessionId, findAgent } from '../session.js'
+import { FACE_STYLE, CHAT_STYLE } from '../prompts.js'
+import { cachedSelfId, groupName as groupNameOf } from '../qq-state.js'
+import { startWsWatcher } from './ws.js'
+
+// ---------- 戳一戳（由「戳一戳」组件启动） ----------
+const pokeSeen = new Set()
+const memberNames = new Map()
+
+async function memberName(groupId, userId) {
+  const key = String(groupId) + ':' + String(userId)
+  const hit = memberNames.get(key)
+  if (hit && Date.now() - hit.at < 300000) return hit.name
+  try {
+    const d = await onebot('get_group_member_info', { group_id: Number(groupId), user_id: Number(userId) }, loadCfg())
+    const name = clean((d && (d.card || d.nickname)) || userId)
+    memberNames.set(key, { name, at: Date.now() })
+    return name
+  } catch (error) {
+    return String(userId)
+  }
+}
+
+async function handlePoke(ctx, ev) {
+  const cfg = loadCfg()
+  if (!cfg.pokeEnabled) return
+  const self = String(ev.self_id || cachedSelfId() || '')
+  const sender = String(ev.user_id || ev.sender_id || '')
+  const target = String(ev.target_id || '')
+  if (!self || !sender || sender === self) return
+  if (target && target !== self) return
+  const groupId = ev.group_id ? String(ev.group_id) : ''
+  if (!groupId && !allowedPrivate(sender, cfg)) return
+  const key = [ev.time, groupId, sender, target].join('|')
+  if (pokeSeen.has(key)) return
+  pokeSeen.add(key)
+  if (pokeSeen.size > 300) pokeSeen.clear()
+  const agent = findAgent(ctx.agents, targetSessionId())
+  if (!agent) {
+    diag('戳一戳：目标会话没有活着')
+    return
+  }
+  const name = groupId ? await memberName(groupId, sender) : sender
+  const groupName = groupId ? groupNameOf(groupId) : ''
+  let prompt
+  if (groupId) {
+    const actions = []
+    if (hasActiveTool('qq_send_group_message')) actions.push('想回就用 qq_send_group_message 发到这个群')
+    if (hasActiveTool('qq_send_face')) actions.push('想回个表情用 qq_send_face（group_id=' + groupId + '）')
+    if (hasActiveTool('qq_send_poke')) actions.push(`想戳回去用 qq_send_poke（group_id=${groupId}, user_id=${sender}）`)
+    prompt = `【戳一戳】群「${groupName}」里 ${name}(${sender}) 戳了你一下。`
+      + (actions.length ? actions.join('；') + '。不想回就安静待着。' : '不用回复。')
+      + (hasActiveTool('qq_send_face') ? FACE_STYLE : '')
+      + CHAT_STYLE
+  } else {
+    const actions = []
+    if (hasActiveTool('qq_send_private_message')) actions.push(`想回就用 qq_send_private_message（user_id=${sender}）`)
+    if (hasActiveTool('qq_send_face')) actions.push(`想回表情用 qq_send_face（user_id=${sender}）`)
+    if (hasActiveTool('qq_send_poke')) actions.push(`想戳回去用 qq_send_poke（user_id=${sender}）`)
+    prompt = `【戳一戳】${sender} 在私聊里戳了你一下。`
+      + (actions.length ? actions.join('；') + '。不想回就安静待着。' : '不用回复。')
+      + (hasActiveTool('qq_send_face') ? FACE_STYLE : '')
+      + CHAT_STYLE
+  }
+  const sourceKind = groupId ? 'qq-poke' : 'qq-private'
+  await agent.followup({
+    id: randomUUID(),
+    role: 'user',
+    content: [{ type: 'text', text: prompt }],
+    source: { kind: sourceKind },
+  })
+  diag('戳一戳 → 会话：' + (groupId ? '群 ' + groupId : '私聊') + ' ' + sender)
+}
+
+export function startPokeWatcher(ctx) {
+  startWsWatcher(ctx, '戳一戳', (cfg) => cfg.pokeEnabled, (ev) => {
+    if (ev.post_type === 'notice' && ev.notice_type === 'notify' && ev.sub_type === 'poke') {
+      return handlePoke(ctx, ev)
+    }
+  })
+}

package/lib/watchers/private.js

@@ -0,0 +1,95 @@
+// 私聊消息唤醒。
+
+import { randomUUID } from 'node:crypto'
+import { loadCfg, allowedPrivate, diag } from '../config.js'
+import { onebot } from '../onebot.js'
+import { clean, segText, animatedSeg } from '../utils.js'
+import { hasActiveTool, targetSessionId, findAgent } from '../session.js'
+import { formatIncomingLine, favoriteHint, FACE_STYLE, CHAT_STYLE } from '../prompts.js'
+import { getSelfId } from '../qq-state.js'
+import { startWsWatcher } from './ws.js'
+
+const privateSeen = new Set()
+
+async function handlePrivateMessage(ctx, ev, admitImages) {
+  const cfg = loadCfg()
+  if (!cfg.privateEnabled) return
+  const self = String(ev.self_id || await getSelfId(cfg) || '')
+  const userId = String(ev.user_id || (ev.sender && ev.sender.user_id) || '')
+  if (!userId) return
+  if (self && userId === self) return
+  if (!allowedPrivate(userId, cfg)) return
+  const key = String(ev.message_id != null ? ev.message_id : [ev.time, userId].join('|'))
+  if (privateSeen.has(key)) return
+  privateSeen.add(key)
+  if (privateSeen.size > 500) privateSeen.clear()
+  const agent = findAgent(ctx.agents, targetSessionId())
+  if (!agent) {
+    diag('私聊：目标会话没有活着')
+    return
+  }
+  const name = clean((ev.sender && (ev.sender.card || ev.sender.nickname)) || userId)
+  const segs = Array.isArray(ev.message) ? ev.message : []
+  const text = segText(segs) || clean(ev.raw_message) || '（没有文字）'
+  const groupId = ev.group_id ? String(ev.group_id) : ''
+  const midHint = ev.message_id != null ? '，引用传 reply_to=' + ev.message_id : ''
+  const actions = []
+  if (hasActiveTool('qq_get_private_history')) {
+    actions.push('想看上下文用 qq_get_private_history（user_id=' + userId + '）')
+  }
+  if (hasActiveTool('qq_send_private_message')) {
+    actions.push('想回就用 qq_send_private_message（user_id=' + userId + (groupId ? ', group_id=' + groupId : '') + midHint + '）')
+  }
+  if (hasActiveTool('qq_send_face')) {
+    actions.push('想回表情用 qq_send_face（user_id=' + userId + (groupId ? ', group_id=' + groupId : '') + midHint + '）')
+  }
+  const where = groupId ? '群 ' + groupId + ' 的临时会话' : '私聊'
+  const favHint = hasActiveTool('qq_favorite_face') ? favoriteHint(text, ev.message_id) : ''
+  const faceHint = hasActiveTool('qq_send_face') ? FACE_STYLE : ''
+  const prompt =
+    '【QQ ' + where + '】' + formatIncomingLine(name, userId, text, ev.message_id) +
+    '\n' + (actions.length ? actions.join('；') + '。' : '') + favHint + faceHint +
+    '不想回就安静待着；不要提工具。' + CHAT_STYLE
+  const content = [{ type: 'text', text: prompt }]
+  if (typeof admitImages === 'function') {
+    // 和群/私聊记录一样：先保证最近两张动图能进来，剩下的名额给静图。
+    const anim = []
+    const stat = []
+    for (const seg of segs) {
+      if (!seg || (seg.type !== 'image' && seg.type !== 'mface') || !seg.data) continue
+      const item = { seg, animated: animatedSeg(seg) }
+      if (item.animated) anim.push(item)
+      else stat.push(item)
+    }
+    const animPick = anim.slice(-2)
+    const picked = [...animPick, ...stat.slice(-(4 - animPick.length))]
+    if (picked.length) {
+      const images = await admitImages(picked.map(({ seg, animated }, i) => ({
+        data: seg.data,
+        cfg,
+        animated,
+        name: (seg.data && seg.data.file) || `qq-private-${ev.message_id || 'x'}-${i}.jpg`,
+        caption: `私聊 ${name} 发的图片（消息 ${ev.message_id || '?'}）`,
+      })))
+      for (const img of images) {
+        if (img && img.caption) content.push({ type: 'text', text: img.caption })
+        if (img && img.block) content.push(img.block)
+      }
+    }
+  }
+  await agent.followup({
+    id: randomUUID(),
+    role: 'user',
+    content,
+    source: { kind: 'qq-private' },
+  })
+  diag('私聊消息 → 会话：' + userId + ' ' + text.slice(0, 200))
+}
+
+export function startPrivateWatcher(ctx, admitImages) {
+  startWsWatcher(ctx, '私聊', (cfg) => cfg.privateEnabled, (ev) => {
+    if (ev.post_type === 'message' && ev.message_type === 'private') {
+      return handlePrivateMessage(ctx, ev, admitImages)
+    }
+  })
+}

package/lib/watchers/ws.js

@@ -0,0 +1,61 @@
+// 通用 OneBot WebSocket 连接与重连。
+
+import { loadCfg, diag } from '../config.js'
+
+export function startWsWatcher(ctx, tag, enabled, onEvent) {
+  let ws = null
+  let stopped = false
+  let timer = null
+
+  function connectWs() {
+    if (stopped) return
+    const cfg = loadCfg()
+    if (!enabled(cfg)) return
+    const url = String(cfg.wsUrl || '')
+    if (!url) return
+    if (typeof WebSocket === 'undefined') {
+      diag(tag + '：WS 不可用，当前 Node 没有 WebSocket')
+      return
+    }
+    try {
+      let targetUrl = url
+      if (cfg.accessToken) {
+        const u = new URL(url)
+        u.searchParams.set('access_token', cfg.accessToken)
+        targetUrl = u.toString()
+      }
+      const socket = new WebSocket(targetUrl)
+      ws = socket
+      socket.onopen = () => diag(tag + '：WS 已连接')
+      socket.onmessage = (event) => {
+        try {
+          const ev = JSON.parse(typeof event.data === 'string' ? event.data : String(event.data))
+          if (ev) {
+            void Promise.resolve(onEvent(ev, cfg)).catch((error) =>
+              diag(tag + '：处理事件失败 ' + String((error && error.message) || error)),
+            )
+          }
+        } catch (error) {}
+      }
+      socket.onclose = () => {
+        if (ws === socket) ws = null
+        if (!stopped) timer = setTimeout(connectWs, 5000)
+      }
+      socket.onerror = () => {
+        try { socket.close() } catch (error) {}
+      }
+    } catch (error) {
+      diag(tag + '：WS 连接失败 ' + String((error && error.message) || error))
+      if (!stopped) timer = setTimeout(connectWs, 5000)
+    }
+  }
+
+  ctx.effect(() => {
+    connectWs()
+    return () => {
+      stopped = true
+      if (timer) clearTimeout(timer)
+      try { if (ws) ws.close() } catch (error) {}
+    }
+  })
+}

package/package.json

@@ -1,103 +1,98 @@
-{
-  "name": "dsh-qq-tools",
-  "version": "0.9.5",
-  "description": "给大肥鱼会话用的 QQ 群/私聊工具：列群、看群记录、发群消息（可引用/@）、发表情、收藏表情（SnowLuma 收藏夹）、好友/私聊记录、发私聊消息、私聊唤醒、群成员、戳一戳感知/戳回去、更改头像、好友管理（资料/备注/分组/删好友/名片赞/好友申请）、QQ 空间说说（列表/详情/发表/评论/点赞/权限）、挂载会话选择。11 个工具组加 1 个设置组件，可在插件页逐个开关。",
-  "type": "module",
-  "main": "lib/index.js",
-  "license": "MIT",
-  "author": "cyhddyx",
-  "homepage": "https://github.com/cyhddyx/dsh-qq-tools#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cyhddyx/dsh-qq-tools.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cyhddyx/dsh-qq-tools/issues"
-  },
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "deepseek-harness",
-    "qq",
-    "onebot",
-    "snowluma",
-    "napcat"
-  ],
-  "files": [
-    "lib",
-    "tools",
-    "locale",
-    "cordis.patch.yml",
-    "README.md",
-    "SECURITY.md",
-    "docs/verification",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "scripts": {
-    "test": "node test/smoke.mjs"
-  },
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./tools/qq-list-groups": "./tools/qq-list-groups/index.js",
-    "./tools/qq-list-groups/locale/en.json": "./tools/qq-list-groups/locale/en.json",
-    "./tools/qq-list-groups/locale/zh.json": "./tools/qq-list-groups/locale/zh.json",
-    "./tools/qq-get-group-history": "./tools/qq-get-group-history/index.js",
-    "./tools/qq-get-group-history/locale/en.json": "./tools/qq-get-group-history/locale/en.json",
-    "./tools/qq-get-group-history/locale/zh.json": "./tools/qq-get-group-history/locale/zh.json",
-    "./tools/qq-get-group-members": "./tools/qq-get-group-members/index.js",
-    "./tools/qq-get-group-members/locale/en.json": "./tools/qq-get-group-members/locale/en.json",
-    "./tools/qq-get-group-members/locale/zh.json": "./tools/qq-get-group-members/locale/zh.json",
-    "./tools/qq-send-group-message": "./tools/qq-send-group-message/index.js",
-    "./tools/qq-send-group-message/locale/en.json": "./tools/qq-send-group-message/locale/en.json",
-    "./tools/qq-send-group-message/locale/zh.json": "./tools/qq-send-group-message/locale/zh.json",
-    "./tools/qq-send-face": "./tools/qq-send-face/index.js",
-    "./tools/qq-send-face/locale/en.json": "./tools/qq-send-face/locale/en.json",
-    "./tools/qq-send-face/locale/zh.json": "./tools/qq-send-face/locale/zh.json",
-    "./tools/qq-favorite-faces": "./tools/qq-favorite-faces/index.js",
-    "./tools/qq-favorite-faces/locale/en.json": "./tools/qq-favorite-faces/locale/en.json",
-    "./tools/qq-favorite-faces/locale/zh.json": "./tools/qq-favorite-faces/locale/zh.json",
-    "./tools/qq-private-chat": "./tools/qq-private-chat/index.js",
-    "./tools/qq-private-chat/locale/en.json": "./tools/qq-private-chat/locale/en.json",
-    "./tools/qq-private-chat/locale/zh.json": "./tools/qq-private-chat/locale/zh.json",
-    "./tools/qq-send-poke": "./tools/qq-send-poke/index.js",
-    "./tools/qq-send-poke/locale/en.json": "./tools/qq-send-poke/locale/en.json",
-    "./tools/qq-send-poke/locale/zh.json": "./tools/qq-send-poke/locale/zh.json",
-    "./tools/qq-set-avatar": "./tools/qq-set-avatar/index.js",
-    "./tools/qq-set-avatar/locale/en.json": "./tools/qq-set-avatar/locale/en.json",
-    "./tools/qq-set-avatar/locale/zh.json": "./tools/qq-set-avatar/locale/zh.json",
-    "./tools/qq-friend-management": "./tools/qq-friend-management/index.js",
-    "./tools/qq-friend-management/locale/en.json": "./tools/qq-friend-management/locale/en.json",
-    "./tools/qq-friend-management/locale/zh.json": "./tools/qq-friend-management/locale/zh.json",
-    "./tools/qq-qzone": "./tools/qq-qzone/index.js",
-    "./tools/qq-qzone/locale/en.json": "./tools/qq-qzone/locale/en.json",
-    "./tools/qq-qzone/locale/zh.json": "./tools/qq-qzone/locale/zh.json",
-    "./locale/en.json": "./locale/en.json",
-    "./locale/zh.json": "./locale/zh.json",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "compatibility": {
-      "dsh": "0.2.x",
-      "node": ">=22"
-    },
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-renderer",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-plugin-manager"
-      ],
-      "platform": "web"
-    }
-  }
-}
-
-
-
+{
+  "name": "dsh-qq-tools",
+  "version": "0.10.2",
+  "description": "给大肥鱼会话用的 QQ 群/私聊工具（只支持 SnowLuma，其他 OneBot 实现包括 NapCat 都不支持）：列群、看群记录、发群消息（可引用/@）、发表情、收藏表情（SnowLuma 收藏夹）、好友/私聊记录、发私聊消息、私聊唤醒、群成员、戳一戳感知/戳回去、更改头像、好友管理（资料/备注/分组/删好友/名片赞/好友申请）、QQ 空间说说（列表/详情/发表/评论/点赞/权限）、挂载会话选择。11 个工具组加 1 个设置组件，可在插件页逐个开关。",
+  "type": "module",
+  "main": "lib/index.js",
+  "license": "MIT",
+  "author": "cyhddyx",
+  "homepage": "https://github.com/cyhddyx/dsh-qq-tools#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyhddyx/dsh-qq-tools.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyhddyx/dsh-qq-tools/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "qq",
+    "snowluma"
+  ],
+  "files": [
+    "lib",
+    "tools",
+    "locale",
+    "cordis.patch.yml",
+    "README.md",
+    "SECURITY.md",
+    "docs/verification",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "node test/smoke.mjs"
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./tools/qq-list-groups": "./tools/qq-list-groups/index.js",
+    "./tools/qq-list-groups/locale/en.json": "./tools/qq-list-groups/locale/en.json",
+    "./tools/qq-list-groups/locale/zh.json": "./tools/qq-list-groups/locale/zh.json",
+    "./tools/qq-get-group-history": "./tools/qq-get-group-history/index.js",
+    "./tools/qq-get-group-history/locale/en.json": "./tools/qq-get-group-history/locale/en.json",
+    "./tools/qq-get-group-history/locale/zh.json": "./tools/qq-get-group-history/locale/zh.json",
+    "./tools/qq-get-group-members": "./tools/qq-get-group-members/index.js",
+    "./tools/qq-get-group-members/locale/en.json": "./tools/qq-get-group-members/locale/en.json",
+    "./tools/qq-get-group-members/locale/zh.json": "./tools/qq-get-group-members/locale/zh.json",
+    "./tools/qq-send-group-message": "./tools/qq-send-group-message/index.js",
+    "./tools/qq-send-group-message/locale/en.json": "./tools/qq-send-group-message/locale/en.json",
+    "./tools/qq-send-group-message/locale/zh.json": "./tools/qq-send-group-message/locale/zh.json",
+    "./tools/qq-send-face": "./tools/qq-send-face/index.js",
+    "./tools/qq-send-face/locale/en.json": "./tools/qq-send-face/locale/en.json",
+    "./tools/qq-send-face/locale/zh.json": "./tools/qq-send-face/locale/zh.json",
+    "./tools/qq-favorite-faces": "./tools/qq-favorite-faces/index.js",
+    "./tools/qq-favorite-faces/locale/en.json": "./tools/qq-favorite-faces/locale/en.json",
+    "./tools/qq-favorite-faces/locale/zh.json": "./tools/qq-favorite-faces/locale/zh.json",
+    "./tools/qq-private-chat": "./tools/qq-private-chat/index.js",
+    "./tools/qq-private-chat/locale/en.json": "./tools/qq-private-chat/locale/en.json",
+    "./tools/qq-private-chat/locale/zh.json": "./tools/qq-private-chat/locale/zh.json",
+    "./tools/qq-send-poke": "./tools/qq-send-poke/index.js",
+    "./tools/qq-send-poke/locale/en.json": "./tools/qq-send-poke/locale/en.json",
+    "./tools/qq-send-poke/locale/zh.json": "./tools/qq-send-poke/locale/zh.json",
+    "./tools/qq-set-avatar": "./tools/qq-set-avatar/index.js",
+    "./tools/qq-set-avatar/locale/en.json": "./tools/qq-set-avatar/locale/en.json",
+    "./tools/qq-set-avatar/locale/zh.json": "./tools/qq-set-avatar/locale/zh.json",
+    "./tools/qq-friend-management": "./tools/qq-friend-management/index.js",
+    "./tools/qq-friend-management/locale/en.json": "./tools/qq-friend-management/locale/en.json",
+    "./tools/qq-friend-management/locale/zh.json": "./tools/qq-friend-management/locale/zh.json",
+    "./tools/qq-qzone": "./tools/qq-qzone/index.js",
+    "./tools/qq-qzone/locale/en.json": "./tools/qq-qzone/locale/en.json",
+    "./tools/qq-qzone/locale/zh.json": "./tools/qq-qzone/locale/zh.json",
+    "./locale/en.json": "./locale/en.json",
+    "./locale/zh.json": "./locale/zh.json",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "compatibility": {
+      "dsh": "0.2.x",
+      "node": ">=22"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ],
+      "platform": "web"
+    }
+  }
+}

package/tools/qq-favorite-faces/index.js

@@ -1,10 +1,11 @@
-import { admitImagesFor, makeListFacesTool, makeFavoriteFaceTool, mountOneTool } from '../../lib/shared.js'
-
-export const name = 'qq-tools-favorite-faces'
-export const inject = ['agents', 'timer', 'tools', 'attachments']
-
-export function apply(ctx) {
-  const list = mountOneTool(ctx, makeListFacesTool(admitImagesFor(ctx)))
-  const fav = mountOneTool(ctx, makeFavoriteFaceTool())
-  return { tools: [list, fav] }
-}
+import { makeListFacesTool, makeFavoriteFaceTool } from '../../lib/tools/faces.js'
+import { mountOneTool } from '../../lib/session.js'
+
+export const name = 'qq-tools-favorite-faces'
+export const inject = ['agents', 'timer', 'tools']
+
+export function apply(ctx) {
+  const list = mountOneTool(ctx, makeListFacesTool())
+  const fav = mountOneTool(ctx, makeFavoriteFaceTool())
+  return { tools: [list, fav] }
+}

package/tools/qq-favorite-faces/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Favorite faces",
-    "description": "Manage your QQ account's saved faces via SnowLuma: list, add from an image or message, remove, rename, and move to front."
+    "description": "Manage your QQ account's saved faces via SnowLuma: list emoji_id and text notes, add from an image or message, remove, rename, and move to front."
   }
 }