cortico-world-wechat 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 本文件的 `## <版本号>` 段落会显示在扩展市场的发布时间线上（索引仓的 Action 按同样规则切段）。
 
 
+## 0.1.5
+
+- **转达口径（行为变更）**：推给桌宠的文本从「通知」改为「转达请求」。
+  此前她收到 `XX 发来消息：<原文>。跟胡闹说一声。` 会把原文当成对她说的、直接接着聊
+  （实测：原文「你在干嘛呢？」，她答「在呢在呢！」）。原因是问句本身在邀请回答，
+  而"转达"只是附加从句。现在把动作要求前置，并写明**别自己回答**。
+- **分档转达**：正文不超过 `relayQuoteMax`（默认 40 字）时**照原文转达**，保证不失真；
+  超出、或没有文字正文时，改为只要求**一句话转述要点**，不搬运长文
+  （省上下文，也避免她复述长文时跑偏）。
+- 新增配置项 `relayQuoteMax`，可调整分档阈值。
+- 统一加 `【微信】` 前缀，便于识别与排查（此前只有长消息分支带前缀）。
+
 ## 0.1.4
 
 - **补充作者字段 `author`**（`静音胡闹 <2310468741@qq.com>`），此前漏填，npm 页面上作者为空。

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "cortico-world-wechat",
-  "version": "0.1.4",
-  "author": "静音胡闹 <2310468741@qq.com>",
-  "description": "把 Windows 微信新消息播报给桌宠：扩展自己解密并轮询微信本地库，把新消息推进桌宠的事件流，由桌宠决定怎么汇报。",
-  "license": "MIT",
-  "type": "module",
-  "main": "src/index.js",
-  "exports": {
-    ".": "./src/index.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "src",
-    "tools",
-    "test",
-    "describe.json",
-    "CHANGELOG.md",
-    "README.md"
-  ],
-  "os": [
-    "win32"
-  ],
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "dependencies": {
-    "better-sqlite3-multiple-ciphers": "^13.0.3",
-    "ws": "^8.21.3"
-  },
-  "keywords": [
-    "cortico-world",
-    "cortico",
-    "wechat",
-    "weixin",
-    "notifier"
-  ],
-  "cortico": {
-    "displayName": "微信消息提示",
-    "kind": "world",
-    "api": 6,
-    "describe": "describe.json",
-    "tags": [
-      "im",
-      "external-setup",
-      "experimental",
-      "sensitive-data"
-    ]
-  },
-  "scripts": {
-    "test": "node --test test/format.test.mjs test/world.test.mjs"
-  }
-}
+{
+  "name": "cortico-world-wechat",
+  "version": "0.1.5",
+  "author": "静音胡闹 <2310468741@qq.com>",
+  "description": "把 Windows 微信新消息播报给桌宠：扩展自己解密并轮询微信本地库，把新消息推进桌宠的事件流，由桌宠决定怎么汇报。",
+  "license": "MIT",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "tools",
+    "test",
+    "describe.json",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3-multiple-ciphers": "^13.0.3",
+    "ws": "^8.21.3"
+  },
+  "keywords": [
+    "cortico-world",
+    "cortico",
+    "wechat",
+    "weixin",
+    "notifier"
+  ],
+  "cortico": {
+    "displayName": "微信消息提示",
+    "kind": "world",
+    "api": 6,
+    "describe": "describe.json",
+    "tags": [
+      "im",
+      "external-setup",
+      "experimental",
+      "sensitive-data"
+    ]
+  },
+  "scripts": {
+    "test": "node --test test/format.test.mjs test/world.test.mjs"
+  }
+}

package/src/format.js

@@ -1,50 +1,66 @@
 /**
- * 微信事件帧 → 给桌宠看的一句人话。
+ * 微信事件帧 → 给桌宠看的一句"转达请求"。
  *
- * 刻意做成纯函数：不碰网络、不碰宿主，方便单测把"她会听到什么"钉死。
+ * 为什么不是"通知"：早期版本写「XX 发来消息：<原文>。跟胡闹说一声。」，
+ * 结果她**把原文当成对她说的**，直接接着聊（实测：原文"你在干嘛呢？"，
+ * 她答"在呢在呢！"）。原因是问句本身在邀请回答，而"转达"只是个附加从句。
+ * 所以现在把**动作要求放前面并写明"别自己回答"**。
  *
- * 措辞原则（沿用 companion-bridge 的实测教训，2026-10-16）：
- * 只陈述事实（"张三发了条消息"）会被她当成**状态信息**——她完整读到、跑一轮推理，
- * 然后 end_turn 一声不吭。所以正文要**带上动作要求**，把"信息"变成"要回应的请求"。
+ * 分档（按用户要求）：
+ *   - 单条、内容短 → **照原文转达**，保证不失真；
+ *   - 内容长 → **只转述要点**，不搬运长篇（省上下文，也避免她复述长文时跑偏）。
+ *   真正的"消息多了"由 Python 侧之外的监听层限流负责（同一会话冷却/全局间隔），
+ *   所以这里只需要处理"单条的长度"这一个维度。
  */
 
-/** 单条文字上限，避免一帧把气泡撑爆。 */
-const TEXT_MAX = 160;
+/** 引述原文的上限：超过就改为"只转述要点" */
+export const DEFAULT_RELAY_QUOTE_MAX = 40;
+/** 转达请求本身的总长上限，避免一帧把气泡撑爆 */
+const TEXT_MAX = 200;
 
-/** 折叠空白并截断。 */
-function clip(text, max = TEXT_MAX) {
+/** 折叠空白并截断 */
+function clip(text, max) {
   const s = String(text ?? '').replace(/\s+/g, ' ').trim();
-  if (s.length <= max) return s;
+  if (!max || s.length <= max) return s;
   return `${s.slice(0, max)}…`;
 }
 
 /**
- * 事件帧 → 事件正文。
+ * 事件帧 → 转达请求文本。
  *
- * 帧形状（Python 侧 ws_client.py 定义，字段全部来自微信库实测）：
- *   { t:'notice', v:1, kind:'message', chat, chat_username, sender, is_group, preview, ts, local_id, shard }
- *   { t:'hello', v:1, role:'wechat-listener' }
+ * 帧形状（监听层产出，字段来自微信库实测）：
+ *   { t:'notice', kind:'message', chat, chat_username, sender, is_group,
+ *     preview, ts, local_id, shard, relay_quote_max? }
  *
  * @param {Record<string, unknown>} frame
+ * @param {{ relayQuoteMax?: number }} [options]
  * @returns {string | null} null = 这一帧不需要她知道
  */
-export function frameToText(frame) {
+export function frameToText(frame, options = {}) {
   if (!frame || typeof frame !== 'object') return null;
-  if (frame.t !== 'notice') return null; // hello 等控制帧不是给她听的内容
+  if (frame.t !== 'notice') return null;
   if (frame.kind && frame.kind !== 'message') return null;
 
   const chat = clip(frame.chat, 40) || '某个会话';
   const sender = clip(frame.sender, 24) || '某人';
   const preview = clip(frame.preview, 100);
+  const quoteMax = Number(options.relayQuoteMax ?? frame.relay_quote_max ?? DEFAULT_RELAY_QUOTE_MAX);
 
-  // 自己发的消息不催办：她不需要被提醒"你自己说了句话"
+  // 自己发的消息不催办
   if (sender === '我') {
-    return `【微信】你在「${chat}」发了一条消息。`;
+    return `【微信】你在「${chat}」发了一条消息。不用转达。`;
   }
 
   const where = frame.is_group === true ? `群「${chat}」里的 ${sender}` : sender;
-  const content = preview ? `：${preview}` : '（没有正文，可能是图片或文件）';
-  return `【微信】${where}发来消息${content}。跟胡闹说一声。`;
+
+  // 短内容：照原文转达（带"别回答"约束）
+  if (preview && preview.length <= quoteMax) {
+    return `【微信】${where}发来消息：「${preview}」。转达给胡闹，别自己回答。`;
+  }
+
+  // 长内容 / 无正文：只转述要点
+  const what = preview ? '内容较长' : '没有文字正文（可能是图片或文件）';
+  return `【微信】${where}发来消息（${what}）。用一句话转述要点给胡闹，别照抄、别自己回答。`;
 }
 
 export { clip };

package/src/world.js

@@ -43,6 +43,8 @@ export function wechatDefaults() {
     cacheDir: '',
     /** 轮询间隔（秒）。 */
     pollIntervalSec: 1,
+    /** 转达口径：正文短于此长度就照原文转达，超过只转述要点（避免她复述长文跑偏）。 */
+    relayQuoteMax: 40,
   };
 }
 
@@ -92,9 +94,11 @@ export class WechatWorld {
     return {
       wechat_notifier_url: String(this.cfg.url),
       wechat_notifier_duty:
-        '微信消息提示是给你看的：微信里有人给你发消息了。'
-        + '看到要主动用 pet_say 简短汇报给胡闹（一句话说清"谁在哪个会话说了什么"，别念全文），'
-        + '不要只是记下来就结束这一轮。自己发的消息不用汇报。',
+        '微信消息提示是给你看的：有人在微信里给胡闹发了消息。'
+        + '你的任务是**转达**——用 pet_say 把"谁、在哪个会话、说了什么"简短告诉胡闹，'
+        + '短消息照原话说，长消息只讲要点。'
+        + '注意：那条消息是说给胡闹的，不是问你的，别自己回答、别接着聊天。'
+        + '自己发的消息不用转达。',
     };
   }
 
@@ -192,7 +196,7 @@ export class WechatWorld {
       this.log(`配置关闭群消息，跳过：${event.chat ?? ''}`);
       return;
     }
-    const text = frameToText(event);
+    const text = frameToText(event, { relayQuoteMax: this.cfg.relayQuoteMax ?? 40 });
     if (!text) return;
     this.log(`收到 ${event.chat ?? '?'} 的消息 → 推给她：${text.slice(0, 60)}`);
     void this.push(text);

package/test/format.test.mjs

@@ -1,42 +1,59 @@
 /**
  * format.js 单测：把"她会听到什么"钉死。
- * 运行：node test/format.test.mjs（DSH 沙箱内不要用 node --test，见 README）
+ * 运行：node test/format.test.mjs（受限沙箱里不要用 node --test）
  */
 import assert from 'node:assert/strict';
 import test from 'node:test';
 
-import { frameToText } from '../src/format.js';
+import { DEFAULT_RELAY_QUOTE_MAX, frameToText } from '../src/format.js';
 
-test('单聊消息：说清谁说了什么，并带动作要求', () => {
-  const text = frameToText({
-    t: 'notice', kind: 'message', chat: '张三', sender: '张三',
-    is_group: false, preview: '下午三点开会',
-  });
-  assert.equal(text, '【微信】张三发来消息：下午三点开会。跟胡闹说一声。');
+const base = { t: 'notice', kind: 'message', is_group: false };
+
+test('单聊短消息：照原文转达，并明确"别自己回答"', () => {
+  const text = frameToText({ ...base, chat: '张三', sender: '张三', preview: '下午三点开会' });
+  assert.equal(text, '【微信】张三发来消息：「下午三点开会」。转达给胡闹，别自己回答。');
+  assert.ok(text.includes('别自己回答'), '必须带"别回答"约束——否则她会把问句当成对她说的');
+});
+
+test('群聊短消息：带群名与发言人', () => {
+  const text = frameToText({ ...base, chat: '云南项目部', sender: '李四', is_group: true, preview: '明天上线' });
+  assert.equal(text, '【微信】群「云南项目部」里的 李四发来消息：「明天上线」。转达给胡闹，别自己回答。');
+});
+
+test('问句短消息：仍只是转达，不给她"回答问题"的空间', () => {
+  // 这条是实测教训：原文"你在干嘛呢？"曾让她答"在呢在呢！"
+  const text = frameToText({ ...base, chat: '静音胡闹', sender: '静音胡闹', preview: '你在干嘛呢？' });
+  assert.ok(text.endsWith('转达给胡闹，别自己回答。'));
+  assert.ok(!text.includes('告诉'), '不应出现"回答我"这类措辞');
 });
 
-test('群聊消息：带群名与发言人', () => {
-  const text = frameToText({
-    t: 'notice', kind: 'message', chat: '云南项目部', sender: '李四',
-    is_group: true, preview: '明天上线',
-  });
-  assert.equal(text, '【微信】群「云南项目部」里的 李四发来消息：明天上线。跟胡闹说一声。');
+test('长消息：只转述要点，不搬运原文', () => {
+  const long = '这是一段很长的正文，'.repeat(8); // 80 字 > 默认阈值
+  const text = frameToText({ ...base, chat: '张三', sender: '张三', preview: long });
+  assert.ok(text.includes('内容较长'), `应提示内容较长：${text}`);
+  assert.ok(text.includes('用一句话转述要点'), '应要求只转述要点');
+  assert.ok(!text.includes(long.slice(0, 20)), '不应照抄长文');
+  assert.ok(text.length < 120, '转达请求本身要短');
 });
 
-test('自己发的消息不催办', () => {
-  const text = frameToText({
-    t: 'notice', kind: 'message', chat: '文件传输助手', sender: '我',
-    is_group: false, preview: '测试',
-  });
-  assert.equal(text, '【微信】你在「文件传输助手」发了一条消息。');
-  assert.ok(!text.includes('胡闹说一声'), '自己发的消息不该催她汇报');
+test('阈值可配：调大后短消息也走"照原文"', () => {
+  const preview = '一二三四五六七八九十';
+  const quoted = frameToText({ ...base, chat: '张三', sender: '张三', preview }, { relayQuoteMax: 100 });
+  assert.ok(quoted.includes(preview), '阈值调大后应照原文转达');
+  const terse = frameToText({ ...base, chat: '张三', sender: '张三', preview }, { relayQuoteMax: 5 });
+  assert.ok(terse.includes('内容较长'), '阈值调小后应只转述要点');
 });
 
-test('空正文给占位，不出现空串', () => {
-  const text = frameToText({
-    t: 'notice', kind: 'message', chat: '张三', sender: '张三', is_group: false, preview: '',
-  });
-  assert.ok(text.includes('没有正文'), `空正文应有占位说明，实际: ${text}`);
+test('无正文（图片/文件）：给转述口径，不出现空串', () => {
+  const text = frameToText({ ...base, chat: '张三', sender: '张三', preview: '' });
+  assert.ok(text.includes('没有文字正文'), `应说明无正文：${text}`);
+  assert.ok(text.includes('转述要点'));
+});
+
+test('自己发的消息：不催办', () => {
+  const text = frameToText({ ...base, chat: '文件传输助手', sender: '我', preview: '测试' });
+  assert.ok(text.includes('不用转达'), '自己发的不该让她转达');
+  assert.ok(!text.includes('转达给胡闹'));
 });
 
 test('控制帧不产生正文', () => {
@@ -45,11 +62,12 @@ test('控制帧不产生正文', () => {
   assert.equal(frameToText({ t: 'notice', kind: 'other' }), null);
 });
 
-test('超长正文被截断', () => {
-  const text = frameToText({
-    t: 'notice', kind: 'message', chat: '张三', sender: '张三', is_group: false,
-    preview: '长'.repeat(500),
-  });
-  assert.ok(text.length < 220, `应被截断，实际长度 ${text.length}`);
-  assert.ok(text.includes('…'));
+test('超长内容被截断，请求整体不会撑爆气泡', () => {
+  const text = frameToText({ ...base, chat: '张三', sender: '张三', preview: '长'.repeat(500) });
+  assert.ok(text.length < 220, `应受总长限制，实际 ${text.length}`);
+});
+
+test('默认阈值是 40 字', () => {
+  assert.equal(DEFAULT_RELAY_QUOTE_MAX, 40);
 });
+

package/test/world.test.mjs

@@ -97,12 +97,14 @@ test('默认配置符合预期（仅回环、默认关闭）', () => {
   assert.equal(defaults.notifyGroup, true);
 });
 
-test('envPromptVars 必须含"要主动汇报"的职责说明', () => {
+test('envPromptVars 必须含"转达、别自己回答"的职责说明', () => {
   const world = new WechatWorld(WECHAT_ID, {}, loadWs);
   const vars = world.envPromptVars();
   assert.ok(vars.wechat_notifier_url, '应注入地址变量');
-  assert.ok(vars.wechat_notifier_duty.includes('pet_say'), '缺了这句她会读完不吭声');
-  assert.ok(vars.wechat_notifier_duty.includes('不要只是记下来'));
+  assert.ok(vars.wechat_notifier_duty.includes('pet_say'), '要指明用 pet_say 汇报');
+  // 这条是实测教训：只写"跟胡闹说一声"时，她会把消息原文当成对她说的、直接接着聊
+  assert.ok(vars.wechat_notifier_duty.includes('别自己回答'), '必须写明别自己回答');
+  assert.ok(vars.wechat_notifier_duty.includes('转达'), '应说明任务是转达');
 });
 
 test('客户端连上后收到 hello', async () => {
@@ -118,19 +120,24 @@ test('客户端连上后收到 hello', async () => {
 
 test('收到微信消息 -> 翻译并 pushEvent（带 trigger:flush 与 worldId.notice 类型）', async () => {
   const { world, pushes, port } = await startWorld();
-  const socket = await connect(port);
-  socket.send(JSON.stringify({
-    t: 'notice', kind: 'message', chat: '张三', sender: '张三',
-    is_group: false, preview: '下午三点开会', ts: 1792137092000,
-  }));
-  await new Promise((resolve) => setTimeout(resolve, 200));
-  assert.equal(pushes.length, 1);
-  assert.equal(pushes[0].event.type, `${WECHAT_ID}.notice`);
-  assert.equal(pushes[0].event.source, WECHAT_ID);
-  assert.match(pushes[0].event.text, /张三发来消息：下午三点开会/);
-  assert.equal(pushes[0].opts.trigger, 'flush');
-  socket.close();
-  await world.stop();
+  try {
+    const socket = await connect(port);
+    socket.send(JSON.stringify({
+      t: 'notice', kind: 'message', chat: '张三', sender: '张三',
+      is_group: false, preview: '下午三点开会', ts: 1792137092000,
+    }));
+    await new Promise((resolve) => setTimeout(resolve, 200));
+    assert.equal(pushes.length, 1);
+    assert.equal(pushes[0].event.type, `${WECHAT_ID}.notice`);
+    assert.equal(pushes[0].event.source, WECHAT_ID);
+    // 转达口径：带原文引号 + "别自己回答"
+    assert.match(pushes[0].event.text, /张三发来消息：「下午三点开会」/);
+    assert.match(pushes[0].event.text, /转达给胡闹，别自己回答/);
+    assert.equal(pushes[0].opts.trigger, 'flush');
+    socket.close();
+  } finally {
+    await world.stop();
+  }
 });
 
 test('自己发的消息按配置不推送', async () => {