cortico-world-forward-reader 0.1.0 → 0.1.2

package/describe.json

@@ -5,13 +5,13 @@
       "tags": [
         "read"
       ],
-      "description": "拆开 QQ 的「合并转发 / 聊天记录」卡片，包括转发里套着的转发。\n什么时候用：收到 `qq.forward` 事件、或者 QQ 消息里写着「[合并转发]」但只摊开了一层、里面还有「又一层」时；想看清某段聊天记录到底是谁说了什么，也用它。\n怎么给编号：QQ 消息事件行首的 `#编号`（如 `#265277450`）就是 message_id，原样填进 ref；带不带 `#`、前后有空格都不要紧。\n它只读，只走本机的 SnowLuma OneBot HTTP 接口（默认 127.0.0.1:3000），不发消息、不改任何东西；接口没开或 token 不对会直接说清楚哪一步不对。输出过长会截断。",
+      "description": "拆开 QQ 的「合并转发 / 聊天记录」卡片，包括转发里套着的转发。\n什么时候用：收到 `qq.forward` 事件、或者 QQ 消息里写着「[合并转发]」但只摊开了一层、里面还有「又一层」时；想看清某段聊天记录到底是谁说了什么，也用它。\n怎么给编号：QQ 消息事件行首的 `#编号`（如 `#265277450`）就是 message_id，原样填进 ref；带不带 `#`、前后有空格都不要紧。编号可能是负数（如 `#-1175570559`），负号是编号的一部分，要一起填，别去掉。\n它只读，只走本机的 SnowLuma OneBot HTTP 接口（默认 127.0.0.1:3000），不发消息、不改任何东西；接口没开或 token 不对会直接说清楚哪一步不对。输出过长会截断。",
       "parameters": {
         "type": "object",
         "properties": {
           "ref": {
             "type": "string",
-            "description": "消息编号，即 QQ 消息事件行首的 #后面的数字，如 \"265277450\"。"
+            "description": "消息编号，即 QQ 消息事件行首的 #后面的数字，如 \"265277450\"；负数就带负号一起填，如 \"-1175570559\"。"
           },
           "depth": {
             "type": "integer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-forward-reader",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "转发拆解 World：把 QQ 的「合并转发」一层层拆到底，嵌套在里面的转发也展开，输出带缩进的人话。只读，不发消息。",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -40,13 +40,21 @@ function senderName(sender) {
   return sender.card || sender.nickname || (sender.user_id ? String(sender.user_id) : '?');
 }
 
+/** 今天的时间只给 HH:MM；跨天的带上日期，免得整份记录分不清哪天。 */
 function clockOf(time) {
   if (!time) return '';
   const d = new Date(Number(time) * 1000);
   if (Number.isNaN(d.getTime())) return '';
   const hh = String(d.getHours()).padStart(2, '0');
   const mm = String(d.getMinutes()).padStart(2, '0');
-  return `${hh}:${mm}`;
+  const now = new Date();
+  const sameDay =
+    d.getFullYear() === now.getFullYear() && d.getMonth() === now.getMonth() && d.getDate() === now.getDate();
+  if (sameDay) return `${hh}:${mm}`;
+  const mo = String(d.getMonth() + 1).padStart(2, '0');
+  const dd = String(d.getDate()).padStart(2, '0');
+  const year = d.getFullYear() === now.getFullYear() ? '' : `${d.getFullYear()}-`;
+  return `${year}${mo}-${dd} ${hh}:${mm}`;
 }
 
 /** 把一条消息的段合成一行，并挑出里面嵌套的转发段。 */
@@ -126,46 +134,58 @@ export class ForwardReaderWorld {
     const cfg = this.cfg;
     const rawRef = String(args.ref ?? '')
       .trim()
-      .replace(/^#/, '');
+      .replace(/^#/, '')
+      .trim();
     if (!rawRef) return fail('要给消息编号（QQ 消息行首的 #后面那串数字）。');
-    if (!/^\d+$/.test(rawRef)) return fail(`"${rawRef}" 不像消息编号，应该是纯数字，比如 265277450。`);
+    // QQ 的 message_id 有负数的（合并转发卡片就常见）：负号是 id 的一部分，不能丢。
+    if (!/^-?\d+$/.test(rawRef)) return fail(`"${rawRef}" 不像消息编号，应该是数字（前面可能带一个负号），比如 265277450 或 -1175570559。`);
 
     const maxDepth = clampInt(args.depth ?? cfg.maxDepth, 8, 1, 20);
     const limit = clampInt(args.maxChars ?? cfg.maxChars, MAX_OUTPUT_CHARS, 1000, 60000);
 
+    let data;
+    try {
+      data = await callOneBot(cfg, 'get_msg', { message_id: rawRef });
+    } catch (err) {
+      const why = String(err?.message || err);
+      const hint = /not found|不存在|找不到/i.test(why)
+        ? '取不到这条，常见原因：消息太老、SnowLuma 那边没缓存了；或者编号抄错——负号是编号的一部分，除了行首的「#」别的字符一个都不能少。'
+        : '';
+      return fail(`取消息 ${rawRef} 失败：${why}${hint ? '\n' + hint : ''}\n可以先跑 qq_forward_status 看看接口和 token 怎么样。`);
+    }
+
     const out = [];
     const state = { items: 0, levels: 0, truncated: false };
+    const segments = data?.message || [];
+    const whole = foldMessage(segments);
+    const who = senderName(data?.sender);
+    const when = clockOf(data?.time);
+
+    if (!whole.nested.length) {
+      // 不是合并转发：直接把这条消息本身给人看。
+      out.push(`# 消息 ${rawRef}${who !== '?' ? ` · ${who}` : ''}${when ? ` · ${when}` : ''}`);
+      out.push('');
+      out.push(whole.text || '（没有文字内容）');
+      out.push('');
+      out.push('这条不是合并转发卡片，所以没有可拆的层。');
+      return cap(out.join('\n'), limit);
+    }
 
-    try {
-      const data = await callOneBot(cfg, 'get_msg', { message_id: rawRef });
-      const segments = data?.message || [];
-      const whole = foldMessage(segments);
-
-      if (!whole.nested.length) {
-        // 不是合并转发：直接把这条消息本身给人看。
-        const who = senderName(data?.sender);
-        const when = clockOf(data?.time);
-        out.push(`# 消息 ${rawRef}${who !== '?' ? ` · ${who}` : ''}${when ? ` · ${when}` : ''}`);
-        out.push('');
-        out.push(whole.text || '（没有文字内容）');
-        out.push('');
-        out.push('这条不是合并转发卡片，所以没有可拆的层。');
-        return cap(out.join('\n'), limit);
-      }
+    out.push(`# 转发拆解 · 消息 ${rawRef}${who !== '?' ? ` · ${who}` : ''}${when ? ` · ${when}` : ''}`);
+    out.push('');
 
-      const time = clockOf(data?.time);
-      out.push(`# 转发拆解 · 消息 ${rawRef}${time ? ` · ${time}` : ''}`);
+    // 卡片本身带的文字也要留下，不然只列转发内容就把原话吞掉了。
+    if (whole.text) {
+      out.push(`（这张卡片上还写着）${whole.text}`);
       out.push('');
+    }
 
-      for (const seg of whole.nested) {
-        await this.walk(seg.data?.id, 0, out, state, maxDepth);
-      }
-
-      out.unshift(`共 ${state.levels} 层 / ${state.items} 条${state.truncated ? '（已达条数上限，后面没再往下翻）' : ''}`);
-      return cap(out.join('\n'), limit);
-    } catch (err) {
-      return fail(`拆不开：${err.message}\n可以先跑 qq_forward_status 看看接口和 token 怎么样。`);
+    for (const seg of whole.nested) {
+      await this.walk(seg.data?.id, 0, out, state, maxDepth);
     }
+
+    out.unshift(`共 ${state.levels} 层 / ${state.items} 条${state.truncated ? '（已达条数上限，后面没再往下翻）' : ''}`);
+    return cap(out.join('\n'), limit);
   }
 
   async walk(forwardId, depth, out, state, maxDepth) {

package/src/tools.js

@@ -15,7 +15,8 @@ export const TOOL_DECLS = [
       '拆开 QQ 的「合并转发 / 聊天记录」卡片，包括转发里套着的转发。\n' +
       '什么时候用：收到 `qq.forward` 事件、或者 QQ 消息里写着「[合并转发]」但只摊开了一层、里面还有「又一层」时；' +
       '想看清某段聊天记录到底是谁说了什么，也用它。\n' +
-      '怎么给编号：QQ 消息事件行首的 `#编号`（如 `#265277450`）就是 message_id，原样填进 ref；带不带 `#`、前后有空格都不要紧。\n' +
+      '怎么给编号：QQ 消息事件行首的 `#编号`（如 `#265277450`）就是 message_id，原样填进 ref；带不带 `#`、前后有空格都不要紧。' +
+      '编号可能是负数（如 `#-1175570559`），负号是编号的一部分，要一起填，别去掉。\n' +
       '它只读，只走本机的 SnowLuma OneBot HTTP 接口（默认 127.0.0.1:3000），不发消息、不改任何东西；' +
       '接口没开或 token 不对会直接说清楚哪一步不对。输出过长会截断。',
     parameters: {
@@ -23,7 +24,7 @@ export const TOOL_DECLS = [
       properties: {
         ref: {
           type: 'string',
-          description: '消息编号，即 QQ 消息事件行首的 #后面的数字，如 "265277450"。',
+          description: '消息编号，即 QQ 消息事件行首的 #后面的数字，如 "265277450"；负数就带负号一起填，如 "-1175570559"。',
         },
         depth: {
           type: 'integer',