dsh-qq-tools 0.9.1 → 0.9.4

package/README.md

@@ -189,7 +189,7 @@ dsh plugin --profile <profile> add dsh-qq-tools
 需要固定版本时：
 
 ```sh
-dsh plugin --profile <profile> add dsh-qq-tools@0.9.1
+dsh plugin --profile <profile> add dsh-qq-tools@0.9.2
 ```
 
 ### 本地开发 / 自己改代码
@@ -202,7 +202,7 @@ dsh plugin --profile <profile> add link:/path/to/dsh-qq-tools
 
 ```sh
 pnpm pack
-dsh plugin --profile <profile> add ./dsh-qq-tools-0.9.1.tgz
+dsh plugin --profile <profile> add ./dsh-qq-tools-0.9.2.tgz
 ```
 
 `dsh plugin` 会在安装后自动把这个包追加进 profile 的 `dsh.profile.bundles`，不用手改 `package.json`。卸载用：
@@ -211,6 +211,14 @@ dsh plugin --profile <profile> add ./dsh-qq-tools-0.9.1.tgz
 dsh plugin --profile <profile> remove dsh-qq-tools
 ```
 
+## 兼容性、权限与商城状态
+
+Node.js 要求为 `>=22`，DSH 支持范围为 `0.2.x`，与原有依赖说明一致。机器可读版本范围声明位于 `package.json` 的 `dsh.compatibility`。
+
+本次声明依据、已获得的安装证据及未验证项见 [整改记录](docs/verification/README.md)。用户已自行测试现有功能；本次不重复功能测试，也不将手工使用情况冒充完整的商城生命周期验收。
+
+本插件需要文件、网络和 OneBot token 权限。配置/诊断日志、本地图片读取、外部服务、账号写操作及失败边界详见 [SECURITY.md](SECURITY.md)。这些能力是 QQ 桥接的实际需要；补齐声明和验收证据不保证 DSH STORE 自动批准，商城可能仍要求 `user-reviewed` 专项审阅或保持 `blocked`。本仓库的验收记录不构成独立安全审计。
+
 ## 依赖
 
 - DSH 0.2.x（cordis 插件体系）
@@ -222,4 +230,4 @@ dsh plugin --profile <profile> remove dsh-qq-tools
 
 ---
 
-版本：0.9.1
+版本：0.9.2

package/lib/shared.js

@@ -450,6 +450,33 @@ export function formatIncomingLine(name, userId, text, messageId) {
   return `${who}(${qq})：${text || '（空）'}` + (messageId != null ? `（消息 #${messageId}）` : '')
 }
 
+// 回复风格：群聊要像随手打字，短、分条、不刷屏地 @ 和引用。
+export const CHAT_STYLE = '回复像群友随手打字：想连发几条就传 messages，每条一句短话（十几二十个字），最多三条；'
+  + '不要句号收尾，不要写长段落，不要 Markdown，不要把昵称或 QQ 号写进正文，不要每句都 @ 或引用——'
+  + '只有确实要指代某条消息时才传 reply_to，只有必须提醒某个人时才传 at_user_ids。'
+
+const CHAT_BUBBLE_CHARS = 80
+const CHAT_BUBBLE_MAX = 5
+
+// 一条气泡的清理：压掉复制来的对齐空格和多行，去掉正文开头重复的 @昵称。
+function cleanBubble(value) {
+  return String(value || '')
+    .replace(/\r/g, '')
+    .replace(/[\u3000\t ]+/g, ' ')
+    .replace(/\s*\n\s*/g, ' ')
+    .trim()
+    .replace(/^@[^\s@]{1,40}\s+/, '')
+    .slice(0, CHAT_BUBBLE_CHARS)
+}
+
+// 模型自己决定发几条：messages 数组每条一个气泡；只给 message 就是一条，不做机械切分。
+export function chatMessages(args) {
+  const list = Array.isArray(args && args.messages) ? args.messages : []
+  const single = args && args.message
+  const source = list.length ? list : (single ? [single] : [])
+  return source.map(cleanBubble).filter(Boolean).slice(0, CHAT_BUBBLE_MAX)
+}
+
 
 function renderTool(_args, v) {
   if (!v || !v.ok) return [{ type: 'text', text: 'QQ 工具失败：' + String((v && v.error) || '未知错误') }]
@@ -924,17 +951,21 @@ export function makeSendTool(onSent) {
   return {
     name: 'qq_send_group_message',
     description:
-      '在指定群里发一条消息。发之前先确认群号；只发到允许的群。' +
+      '在指定群里发消息。发之前先确认群号；只发到允许的群。' +
       'reply_to 传消息前面的 #编号 可以引用那条消息；at_user_ids 传 QQ 号可以 @ 人，at_all=true 是 @全体成员。' +
-      '普通闲聊不要用 Markdown；一句话短一点，像群友随手打的。' +
+      CHAT_STYLE +
       '不想说话就不要调用这个工具；调用后不要再重复说自己发了什么。',
     parameters: {
       type: 'object',
       properties: {
         group_id: { type: 'number', description: '群号' },
-        message: { type: 'string', description: '要发到群里的文字；只 @ 不说话时可以留空' },
-        reply_to: { type: 'string', description: '要引用的消息 ID（消息前面的 #编号），可选' },
-        at_user_ids: { type: 'array', items: { type: 'number' }, description: '要 @ 的 QQ 号列表，可选' },
+        messages: {
+          type: 'array', items: { type: 'string' },
+          description: '想连发几条就放这里，每条一个气泡、一句短话；最多 5 条',
+        },
+        message: { type: 'string', description: '只发一条时的文字；要发多条用 messages；只 @ 不说话时可以留空' },
+        reply_to: { type: 'string', description: '要引用的消息 ID（消息前面的 #编号），可选', },
+        at_user_ids: { type: 'array', items: { type: 'number' }, description: '要 @ 的 QQ 号列表，可选', },
         at_all: { type: 'boolean', description: 'true = @全体成员，可选' },
       },
       required: ['group_id'],
@@ -944,28 +975,37 @@ export function makeSendTool(onSent) {
     async execute(args) {
       const cfg = loadCfg()
       const groupId = Number(args && args.group_id)
-      const text = String((args && args.message) || '').trim()
+      const bubbles = chatMessages(args)
       const atIds = [...new Set(
         (Array.isArray(args && args.at_user_ids) ? args.at_user_ids : [])
           .map((x) => Number(x)).filter((x) => Number.isInteger(x) && x > 0),
       )].slice(0, 20)
       const atAll = args && args.at_all === true
       if (!Number.isFinite(groupId)) return { ok: false, error: 'group_id 不是有效群号' }
-      if (!text && !atIds.length && !atAll) return { ok: false, error: '消息是空的' }
+      if (!bubbles.length && !atIds.length && !atAll) return { ok: false, error: '消息是空的' }
       if (!allowedGroup(groupId, cfg)) return { ok: false, error: '这个群不在允许列表里' }
       try {
-        const message = []
         const replyTo = args && args.reply_to
-        if (replyTo != null && replyTo !== '') message.push({ type: 'reply', data: { id: String(replyTo) } })
-        if (atAll) message.push({ type: 'at', data: { qq: 'all' } })
-        else for (const qq of atIds) message.push({ type: 'at', data: { qq: String(qq) } })
-        if (text) message.push({ type: 'text', data: { text: text.slice(0, 1000) } })
-        const data = await onebot('send_group_msg', { group_id: groupId, message }, cfg)
+        const messageIds = []
+        for (const [index, segment] of (bubbles.length ? bubbles : ['']).entries()) {
+          const message = []
+          // 引用和 @ 只挂在第一条上，避免每条都刷一遍。
+          if (index === 0 && replyTo != null && replyTo !== '') message.push({ type: 'reply', data: { id: String(replyTo) } })
+          if (index === 0) {
+            if (atAll) message.push({ type: 'at', data: { qq: 'all' } })
+            else for (const qq of atIds) message.push({ type: 'at', data: { qq: String(qq) } })
+          }
+          if (segment) message.push({ type: 'text', data: { text: segment } })
+          const data = await onebot('send_group_msg', { group_id: groupId, message }, cfg)
+          messageIds.push(data && data.message_id)
+        }
         try { if (typeof onSent === 'function') onSent(groupId, '发群消息') } catch (error) {}
         return {
           ok: true,
           group_id: groupId,
-          message_id: data && data.message_id,
+          message_id: messageIds[0],
+          message_ids: messageIds,
+          segments: bubbles.length,
           reply_to: replyTo != null && replyTo !== '' ? String(replyTo) : '',
           at_user_ids: atAll ? [] : atIds,
           at_all: atAll,
@@ -980,7 +1020,8 @@ export function makeSendTool(onSent) {
       if (v.reply_to) extra.push('引用了 #' + v.reply_to)
       if (v.at_all) extra.push('@全体成员')
       else if (Array.isArray(v.at_user_ids) && v.at_user_ids.length) extra.push('@了 ' + v.at_user_ids.join('、'))
-      return [{ type: 'text', text: `已发到群 ${v.group_id}（消息 ${v.message_id || '?'}${extra.length ? '，' + extra.join('，') : ''}）。` }]
+      const count = Array.isArray(v.message_ids) && v.message_ids.length > 1 ? `，分 ${v.message_ids.length} 条` : ''
+      return [{ type: 'text', text: `已发到群 ${v.group_id}（消息 ${v.message_id || '?'}${count}${extra.length ? '，' + extra.join('，') : ''}）。` }]
     },
   }
 }
@@ -1125,42 +1166,52 @@ export function makeSendPrivateTool() {
   return {
     name: 'qq_send_private_message',
     description:
-      '给某个 QQ 好友发一条私聊消息。user_id 从 qq_list_friends 或私聊唤醒提示里拿。' +
+      '给某个 QQ 好友发私聊消息。user_id 从 qq_list_friends 或私聊唤醒提示里拿。' +
       'reply_to 传消息前面的 #编号 可以引用那条消息。' +
-      '普通闲聊不要用 Markdown；一句话短一点，像聊天一样。' +
+      CHAT_STYLE +
       '不想说话就不要调用；调用后不要再重复说自己发了什么。',
     parameters: {
       type: 'object',
       properties: {
         user_id: { type: 'number', description: '对方的 QQ 号' },
-        message: { type: 'string', description: '要发的文字，不要 Markdown' },
+        messages: {
+          type: 'array', items: { type: 'string' },
+          description: '想连发几条就放这里，每条一个气泡、一句短话；最多 5 条',
+        },
+        message: { type: 'string', description: '只发一条时的文字；要发多条用 messages' },
         reply_to: { type: 'string', description: '要引用的消息 ID（消息前面的 #编号），可选' },
         group_id: { type: 'number', description: '临时会话的来源群号，可选；普通好友私聊不用传' },
       },
-      required: ['user_id', 'message'],
+      required: ['user_id'],
       additionalProperties: false,
     },
     output: { schema: { type: 'object', additionalProperties: true }, render: renderTool },
     async execute(args) {
       const cfg = loadCfg()
       const userId = Number(args && args.user_id)
-      const text = String((args && args.message) || '').trim()
+      const bubbles = chatMessages(args)
       const groupId = args && args.group_id != null ? Number(args.group_id) : 0
       if (!Number.isFinite(userId)) return { ok: false, error: 'user_id 不是有效 QQ 号' }
-      if (!text) return { ok: false, error: '消息是空的' }
+      if (!bubbles.length) return { ok: false, error: '消息是空的' }
       if (!allowedPrivate(userId, cfg)) return { ok: false, error: '这个 QQ 不在允许列表里' }
       try {
-        const message = []
         const replyTo = args && args.reply_to
-        if (replyTo != null && replyTo !== '') message.push({ type: 'reply', data: { id: String(replyTo) } })
-        message.push({ type: 'text', data: { text: text.slice(0, 1000) } })
-        const body = { user_id: userId, message }
-        if (groupId) body.group_id = groupId
-        const data = await onebot('send_private_msg', body, cfg)
+        const messageIds = []
+        for (const [index, segment] of bubbles.entries()) {
+          const message = []
+          if (index === 0 && replyTo != null && replyTo !== '') message.push({ type: 'reply', data: { id: String(replyTo) } })
+          message.push({ type: 'text', data: { text: segment } })
+          const body = { user_id: userId, message }
+          if (groupId) body.group_id = groupId
+          const data = await onebot('send_private_msg', body, cfg)
+          messageIds.push(data && data.message_id)
+        }
         return {
           ok: true,
           user_id: userId,
-          message_id: data && data.message_id,
+          message_id: messageIds[0],
+          message_ids: messageIds,
+          segments: bubbles.length,
           reply_to: replyTo != null && replyTo !== '' ? String(replyTo) : '',
         }
       } catch (error) {
@@ -1170,7 +1221,8 @@ export function makeSendPrivateTool() {
     render(_args, v) {
       if (!v || !v.ok) return [{ type: 'text', text: '发私聊消息失败：' + String((v && v.error) || '未知错误') }]
       const quote = v.reply_to ? '，引用了 #' + v.reply_to : ''
-      return [{ type: 'text', text: `已发给 QQ ${v.user_id}（消息 ${v.message_id || '?'}${quote}）。` }]
+      const count = Array.isArray(v.message_ids) && v.message_ids.length > 1 ? `，分 ${v.message_ids.length} 条` : ''
+      return [{ type: 'text', text: `已发给 QQ ${v.user_id}（消息 ${v.message_id || '?'}${count}${quote}）。` }]
     },
   }
 }
@@ -3034,13 +3086,13 @@ async function pollMentions(ctx) {
     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号]，@全体传 at_all=true；'
+      ? '确实要指代某条消息时才传 reply_to=消息编号；必须提醒某个人时才传 at_user_ids=[QQ号]；'
       : ''
     const prompt =
       '【群聊 @ 提醒】有人 @ 了你：\n' +
       lines.join('\n') +
       '\n' + lookHint() + '再决定要不要回复、回哪个群。' + sendHint + quoteHint + '不想说话就安静待着；' +
-      '不要用 Markdown，不要提工具和私聊内容，短一点。'
+      '不要提工具和私聊内容。' + CHAT_STYLE
     const message = {
       id: randomUUID(),
       role: 'user',
@@ -3058,9 +3110,9 @@ async function pollMentions(ctx) {
         '【群聊后续】你刚才在群「' + group + '」里说过话，现在又有人说话：\n' +
         lines2.join('\n') +
         '\n想接就接；' +
-        (hasActiveTool('qq_send_group_message') ? '想说话用 qq_send_group_message 发到这个群，引用某条传 reply_to=消息编号，@人传 at_user_ids=[QQ号]，@全体传 at_all=true；' : '') +
+        (hasActiveTool('qq_send_group_message') ? '想说话用 qq_send_group_message 发到这个群，确实要指代某条才传 reply_to=消息编号，必须提醒某人才传 at_user_ids=[QQ号]；' : '') +
         (hasActiveTool('qq_send_face') ? '想回表情用 qq_send_face；' : '') +
-        '不想接就安静待着。不要用 Markdown，短一点。'
+        '不想接就安静待着。' + CHAT_STYLE
       await agent.followup({
         id: randomUUID(),
         role: 'user',
@@ -3136,7 +3188,7 @@ async function handlePoke(ctx, ev) {
     if (hasActiveTool('qq_send_poke')) actions.push(`想戳回去用 qq_send_poke（group_id=${groupId}, user_id=${sender}）`)
     prompt = `【戳一戳】群「${groupName}」里 ${name}(${sender}) 戳了你一下。`
       + (actions.length ? actions.join('；') + '。不想回就安静待着。' : '不用回复。')
-      + '不要用 Markdown，短一点。'
+      + CHAT_STYLE
   } else {
     const actions = []
     if (hasActiveTool('qq_send_private_message')) actions.push(`想回就用 qq_send_private_message（user_id=${sender}）`)
@@ -3144,7 +3196,7 @@ async function handlePoke(ctx, ev) {
     if (hasActiveTool('qq_send_poke')) actions.push(`想戳回去用 qq_send_poke（user_id=${sender}）`)
     prompt = `【戳一戳】${sender} 在私聊里戳了你一下。`
       + (actions.length ? actions.join('；') + '。不想回就安静待着。' : '不用回复。')
-      + '不要用 Markdown，短一点。'
+      + CHAT_STYLE
   }
   const sourceKind = groupId ? 'qq-poke' : 'qq-private'
   await agent.followup({
@@ -3200,7 +3252,7 @@ async function handlePrivateMessage(ctx, ev, admitImages) {
   const prompt =
     '【QQ ' + where + '】' + formatIncomingLine(name, userId, text, ev.message_id) +
     '\n' + (actions.length ? actions.join('；') + '。' : '') +
-    '不想回就安静待着；不要用 Markdown，不要提工具，短一点。'
+    '不想回就安静待着；不要提工具。' + CHAT_STYLE
   const content = [{ type: 'text', text: prompt }]
   if (typeof admitImages === 'function') {
     // 和群/私聊记录一样：先保证最近两张动图能进来，剩下的名额给静图。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qq-tools",
-  "version": "0.9.1",
+  "version": "0.9.4",
   "description": "给大肥鱼会话用的 QQ 群/私聊工具：列群、看群记录、发群消息（可引用/@）、发表情、收藏表情（SnowLuma 收藏夹）、好友/私聊记录、发私聊消息、私聊唤醒、群成员、戳一戳感知/戳回去、更改头像、好友管理（资料/备注/分组/删好友/名片赞/好友申请）、QQ 空间说说（列表/详情/发表/评论/点赞/权限）、挂载会话选择。11 个工具组加 1 个设置组件，可在插件页逐个开关。",
   "type": "module",
   "main": "lib/index.js",
@@ -29,6 +29,8 @@
     "locale",
     "cordis.patch.yml",
     "README.md",
+    "SECURITY.md",
+    "docs/verification",
     "LICENSE"
   ],
   "engines": {
@@ -78,6 +80,10 @@
     "./package.json": "./package.json"
   },
   "dsh": {
+    "compatibility": {
+      "dsh": "0.2.x",
+      "node": ">=22"
+    },
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
@@ -92,3 +98,5 @@
     }
   }
 }
+
+