cortico-world-forward-reader 0.1.1 → 0.1.3

package/package.json

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

package/src/index.js

@@ -40,17 +40,25 @@ 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}`;
 }
 
 /** 把一条消息的段合成一行，并挑出里面嵌套的转发段。 */
-function foldMessage(segments) {
+function foldMessage(segments, opts = {}) {
   const parts = [];
   const nested = [];
   for (const seg of segments || []) {
@@ -59,7 +67,7 @@ function foldMessage(segments) {
       nested.push(seg);
       continue;
     }
-    const piece = segmentText(seg);
+    const piece = segmentText(seg, opts);
     if (piece) parts.push(piece);
   }
   return { text: parts.join('').trim(), nested };
@@ -126,7 +134,8 @@ export class ForwardReaderWorld {
     const cfg = this.cfg;
     const rawRef = String(args.ref ?? '')
       .trim()
-      .replace(/^#/, '');
+      .replace(/^#/, '')
+      .trim();
     if (!rawRef) return fail('要给消息编号（QQ 消息行首的 #后面那串数字）。');
     // QQ 的 message_id 有负数的（合并转发卡片就常见）：负号是 id 的一部分，不能丢。
     if (!/^-?\d+$/.test(rawRef)) return fail(`"${rawRef}" 不像消息编号，应该是数字（前面可能带一个负号），比如 265277450 或 -1175570559。`);
@@ -134,39 +143,49 @@ export class ForwardReaderWorld {
     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, { links: true });
+    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) {
@@ -193,7 +212,7 @@ export class ForwardReaderWorld {
       }
       const who = senderName(item?.sender);
       const when = clockOf(item?.time);
-      const folded = foldMessage(item?.message);
+      const folded = foldMessage(item?.message, { links: true });
       const head = `${pad(depth)}[${who}${when ? ' ' + when : ''}]`;
       state.items += 1;
       out.push(`${head} ${folded.text || '（空）'}`);

package/src/onebot.js

@@ -97,15 +97,23 @@ export async function callOneBot(cfg, action, params = {}) {
   return json.data ?? json;
 }
 
-/** 一条消息里的某个段 → 一行给人看的小字。 */
-export function segmentText(seg) {
+/**
+ * 一条消息里的某个段 → 一行给人看的小字。
+ * opts.links 为真时，图片后面补上地址（SnowLuma 一般给 url，取不到就退回 file），
+ * 这样带图的那条记录也能拿链接去看图，而不是只剩一个「[图片]」。
+ */
+export function segmentText(seg, opts = {}) {
   if (!seg || typeof seg !== 'object') return '';
   const d = seg.data || {};
   switch (seg.type) {
     case 'text':
       return d.text || '';
-    case 'image':
-      return `[图片${d.summary ? '：' + d.summary : ''}]`;
+    case 'image': {
+      const base = `[图片${d.summary ? '：' + d.summary : ''}]`;
+      if (!opts.links) return base;
+      const where = d.url || d.path || d.file || '';
+      return where ? `${base} ${where}` : base;
+    }
     case 'face':
       return `[表情${d.id ? ':' + d.id : ''}]`;
     case 'mface':