dsh-qqchat 0.2.3 → 0.2.5

package/docs/prds/README.md

@@ -0,0 +1,62 @@
+# PRD 撰写规范
+
+本目录存放 dsh-qqchat 的产品需求文档。PRD 用于描述产品目标、功能契约、技术
+边界、验收方式和唯一实施清单；实现状态以文档头部和“实际状态”为准。
+
+## 文件命名
+
+使用：
+
+```text
+PRD-<领域>-<编号>-<中文主题>.md
+```
+
+例如：`PRD-MEM-1-群记忆与群友记忆策略调整.md`。
+
+- `MEM` 表示记忆领域；其他领域可以使用 `IM`、`UI`、`SEC` 等短标识。
+- 编号按领域递增，不使用全局流水号。
+- 主题使用简短中文，不堆叠英文缩写。
+- 同一领域的延续性工作优先更新原 PRD；全新独立特性再新建文档。
+
+## 文档头部
+
+```markdown
+# PRD 标题
+
+> 状态：当前实际能力和缺口
+> 创建：YYYY-MM-DD
+> 最近更新：YYYY-MM-DD
+> 关联模块：`path/to/file.ts`、`path/to/other.ts`
+> 背景参考：参考实现、调查报告或相关文档
+```
+
+“状态”描述真实结果，不写 Phase 作为状态。代码、测试或验证结果发生变化时，
+必须同步更新状态和最近更新日期。
+
+## 推荐章节顺序
+
+1. **实际状态**：只读摘要表，说明当前能力和结果，不列任务。
+2. **背景与目标**：现状、问题、目标和非目标。
+3. **功能需求**：使用 `FR-<领域>-<编号>` 编号，描述目标行为和边界。
+4. **技术方案**：职责、数据、依赖、兼容性、隐私和错误处理。
+5. **验证与上线**：验收方法、测试命令、观测、灰度和回滚。
+6. **风险与待确认问题**：先列风险，再列尚未定案的问题。
+7. **唯一实施 TODO**：全文唯一的可执行复选清单。
+
+只有“唯一实施 TODO”可以使用 `[ ]` 和 `[x]`。其他章节不得用复选框表达进度，
+也不得创建“剩余工作”“Phase TODO”或“验收清单”等第二个任务来源。
+
+## 状态标记
+
+- ✅ 已完成：代码已合并并验证。
+- 🟡 部分完成：已有可运行实现，但仍存在明确缺口。
+- 🔲 待评估：尚未实现或尚未完成真实环境验证。
+- 🚧 进行中：正在实施。
+
+TODO 按 Phase 分组时，每条任务必须有稳定编号、独立复选状态、责任边界和验收
+标准。需求、方案和验收章节只引用任务编号，不复制任务内容。
+
+## 语言与链接
+
+正文使用简体中文；代码标识、字段名、环境变量和命令用反引号包裹。文档之间使用
+相对路径，必要时同时链接 `docs/README.md` 中的导航入口。

package/lib/client.js

@@ -10,6 +10,7 @@ exports.inject = ['slots', 'connection', 'conversationEvents'];
 exports.apply = function apply(ctx) {
     (0, shared_cjs_1.setQQRpc)(ctx.connection.rpc);
     ctx.effect(shared_cjs_1.installStyles, 'dsh-qqchat: client styles');
+    ctx.effect(shared_cjs_1.installQQSettingsIcon, 'dsh-qqchat: QQ settings icon');
     ctx.conversationEvents.register((0, workspace_cjs_1.createQQMessageDefinition)());
     ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'qqchat', order: 35, label: () => 'QQ Chat', inject: () => ({ rpc: ctx.connection.rpc }) }, settings_cjs_1.QQSettings));
     ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({ name: 'conversation.chat.node', key: 'qqchat-message' }, workspace_cjs_1.QQTranscriptNode));
@@ -39,6 +40,7 @@ function QQSettings({ rpc }) {
     const [groupReplyMenuOpen, setGroupReplyMenuOpen] = (0, shared_cjs_1.useState)(false);
     const [directReplyMenuOpen, setDirectReplyMenuOpen] = (0, shared_cjs_1.useState)(false);
     const [ownerMenuOpen, setOwnerMenuOpen] = (0, shared_cjs_1.useState)(false);
+    const [receiveHelpOpen, setReceiveHelpOpen] = (0, shared_cjs_1.useState)(false);
     const refresh = (0, shared_cjs_1.useCallback)(async () => {
         try {
             const [status, prefs] = await Promise.all([
@@ -217,7 +219,23 @@ function QQSettings({ rpc }) {
         variant: settings.groupReceiveMode === mode ? 'primary' : 'outline',
         onClick: () => void patch({ groupReceiveMode: mode }),
     }, mode === 'auto' ? '自动回应' : mode === 'mention' ? '@回复' : '静默记录')));
-    const receiveGroup = (0, shared_cjs_1.h)('div', { className: 'qqSettingsGroup' }, (0, shared_cjs_1.h)('h3', null, '消息接收'), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊接收方式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, receiveButtons)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, groupReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '私聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 私聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, directReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('label', { className: 'qqCheckRow' }, (0, shared_cjs_1.h)('input', {
+    const receiveHelp = (0, shared_cjs_1.h)(shared_cjs_1.Menu, {
+        open: receiveHelpOpen,
+        onClose: () => setReceiveHelpOpen(false),
+        onSelect: () => undefined,
+        portal: true,
+        align: 'end',
+        items: [
+            { type: 'label', id: 'receive-help-title', text: '开启全量消息接收' },
+            { type: 'label', id: 'receive-help-step-1', text: '1. 手机端 QQ 打开机器人所在的群' },
+            { type: 'label', id: 'receive-help-step-2', text: '2. 点击机器人的头像进入资料页' },
+            { type: 'label', id: 'receive-help-step-3', text: '3. 点击右上角「设置」' },
+            { type: 'label', id: 'receive-help-step-4', text: '4. 打开「全量消息接收」' },
+        ],
+        footer: [{ type: 'label', id: 'receive-help-note', text: '未开启时只能收到 @ 消息，非 @ 消息不会进入会话记录' }],
+        anchor: (0, shared_cjs_1.h)(shared_cjs_1.Button, { size: 'sm', variant: 'outline', onClick: () => setReceiveHelpOpen(!receiveHelpOpen) }, '设置方法'),
+    });
+    const receiveGroup = (0, shared_cjs_1.h)('div', { className: 'qqSettingsGroup' }, (0, shared_cjs_1.h)('h3', null, '消息接收'), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊接收方式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp qqHelpRow' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。', receiveHelp)), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, receiveButtons)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, groupReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '私聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 私聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, directReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('label', { className: 'qqCheckRow' }, (0, shared_cjs_1.h)('input', {
         type: 'checkbox',
         checked: settings.directStreamingEnabled && settings.directReplyFormat !== 'compat',
         disabled: settings.directReplyFormat === 'compat',
@@ -249,6 +267,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateTime = exports.time = exports.initials = exports.short = exports.CHANNEL = exports.h = exports.useSyncExternalStore = exports.useState = exports.useMemo = exports.useEffect = exports.useCallback = exports.Menu = exports.Input = exports.Button = exports.React = void 0;
 exports.setQQRpc = setQQRpc;
 exports.getQQRpc = getQQRpc;
+exports.installQQSettingsIcon = installQQSettingsIcon;
 exports.installStyles = installStyles;
 exports.call = call;
 exports.Modal = Modal;
@@ -265,6 +284,49 @@ function setQQRpc(rpc) { qqRpc = rpc; }
 function getQQRpc() { return qqRpc; }
 exports.CHANNEL = '/qqchat';
 const STYLE_ID = 'dsh-qqchat/client-ui-v2';
+const QQ_ICON_PATH = 'M17.5359 12.5144L16.8402 10.7175C16.8408 10.6968 16.8494 10.3429 16.8494 10.1604C16.8494 7.08792 15.448 4.0003 12.0012 4C8.55459 4.0003 7.15292 7.08792 7.15292 10.1604C7.15292 10.3429 7.16151 10.6968 7.16209 10.7175L6.4667 12.5144C6.27608 13.0285 6.08776 13.564 5.94988 14.0232C5.29262 16.2126 5.50559 17.1186 5.66783 17.139C6.01581 17.1823 7.02221 15.4908 7.02221 15.4908C7.02221 16.4704 7.5095 17.7487 8.56405 18.6719C8.16963 18.7976 7.68635 18.9911 7.37564 19.2284C7.09645 19.442 7.13142 19.6594 7.18158 19.7473C7.40258 20.1329 10.9713 19.9935 12.0017 19.8733C13.0319 19.9935 16.6009 20.1329 16.8216 19.7473C16.872 19.6594 16.9067 19.442 16.6275 19.2284C16.3168 18.9911 15.8333 18.7976 15.4386 18.6716C16.4928 17.7487 16.9801 16.4704 16.9801 15.4908C16.9801 15.4908 17.9868 17.1823 18.3348 17.139C18.4967 17.1186 18.7131 16.2108 18.0524 14.0232C17.9125 13.56 17.7265 13.0285 17.5359 12.5144ZM18.5574 20.7407C18.1843 21.3926 17.7237 21.6334 17.1187 21.7981C16.8792 21.8633 16.621 21.9056 16.325 21.936C15.8844 21.9814 15.3392 22.001 14.712 22C13.786 21.9985 12.693 21.9491 12.0017 21.884C11.3103 21.9491 10.2173 21.9985 9.29129 22C8.66414 22.001 8.11889 21.9814 7.67832 21.936C7.38236 21.9056 7.12409 21.8633 6.88467 21.7981C6.27994 21.6335 5.81954 21.393 5.44496 20.7393C5.15165 20.2258 5.07747 19.6406 5.20612 19.0866C4.61376 18.9546 4.20483 18.6045 3.92733 18.1757C3.77911 17.9466 3.68408 17.7127 3.61845 17.4663C3.53001 17.1344 3.49486 16.7666 3.50184 16.3601C3.51532 15.5749 3.68902 14.5984 4.03435 13.4481C4.17427 12.9821 4.3614 12.4396 4.6015 11.7926L5.15467 10.3632C5.1536 10.287 5.15292 10.2154 5.15292 10.1604C5.15292 5.6047 7.58875 2.00038 12.0013 2C16.4138 2.00038 18.8494 5.60454 18.8494 10.1604C18.8494 10.2154 18.8487 10.2869 18.8477 10.3631L19.401 11.7923L19.4112 11.8191C19.636 12.4254 19.8242 12.9722 19.967 13.445C20.3145 14.5956 20.4889 15.5735 20.5018 16.361C20.5085 16.768 20.4728 17.1365 20.3837 17.4689C20.3178 17.7148 20.2228 17.9483 20.0746 18.1768C19.7976 18.6041 19.3905 18.9532 18.7974 19.0862C18.9266 19.6411 18.8523 20.2274 18.5574 20.7407Z';
+/** Temporarily replaces DSH's fallback settings glyph for the QQ Chat row. */
+function installQQSettingsIcon() {
+    const originals = new Map();
+    const apply = () => {
+        for (const button of Array.from(document.querySelectorAll('button'))) {
+            const label = button.querySelector('span[class$="_navLabel"]');
+            if (label?.textContent?.trim() !== 'QQ Chat')
+                continue;
+            if (button.querySelector('[data-dsh-qqchat-icon]'))
+                continue;
+            const icon = button.querySelector('svg[class$="_navIcon"]');
+            if (!icon)
+                continue;
+            originals.set(button, icon.cloneNode(true));
+            icon.remove();
+            const replacement = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+            replacement.setAttribute('width', '16');
+            replacement.setAttribute('height', '16');
+            replacement.setAttribute('viewBox', '0 0 24 24');
+            replacement.setAttribute('fill', 'currentColor');
+            replacement.setAttribute('aria-hidden', 'true');
+            replacement.setAttribute('data-dsh-qqchat-icon', 'true');
+            replacement.classList.add('dsh-qqchat-nav-icon');
+            const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            path.setAttribute('d', QQ_ICON_PATH);
+            replacement.append(path);
+            button.insertBefore(replacement, label);
+        }
+    };
+    const observer = new MutationObserver(apply);
+    observer.observe(document.body, { childList: true, subtree: true });
+    apply();
+    return () => {
+        observer.disconnect();
+        for (const [button, original] of originals) {
+            const replacement = button.querySelector('[data-dsh-qqchat-icon]');
+            if (replacement)
+                replacement.replaceWith(original);
+        }
+        originals.clear();
+    };
+}
 const css = `
 .qqs{display:flex;flex-direction:column;gap:18px;color:var(--dsw-alias-label-primary);font:inherit}.qqs *{box-sizing:border-box}
 .qqsHead{display:flex;align-items:center;justify-content:space-between;gap:12px}.qqsBrand{display:flex;align-items:center;gap:10px}.qqsLogo{width:34px;height:34px;border-radius:10px;display:grid;place-items:center;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);font-weight:700}.qqsTitle{font-size:15px;font-weight:620}.qqMuted{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.55}.qqStatus{display:flex;align-items:center;gap:7px;font-size:12px;color:var(--dsw-alias-label-secondary)}.qqDot{width:7px;height:7px;border-radius:50%;background:var(--dsw-alias-state-warn-primary)}.qqDot.online{background:var(--dsw-alias-state-success-primary)}
@@ -286,7 +348,7 @@ const css = `
 .qqs{display:block;width:100%;min-width:0}.qqsHead{width:100%}.qqSettingsGroup{display:block;width:100%;min-width:0;margin-top:22px}.qqSettingsGroup h3{margin:0 0 8px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary)}.qqSettingsGroup .qqSetting{display:flex;width:100%;min-width:0;flex:0 0 auto;padding:12px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}.qqSettingsGroup .qqSetting:last-child{border-bottom:0}.qqSetting>div:first-child{flex:1 1 auto;min-width:0}.qqControl{flex:0 0 auto}.qqChoiceButtons{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.qqSettingsGroup select{font:inherit;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:5px 8px}.qqCheckRow{display:flex;align-items:flex-start;gap:10px;cursor:pointer}.qqCheckRow input{flex:none;width:16px;height:16px;margin:2px 0 0;accent-color:var(--dsw-alias-button-primary-fill);cursor:pointer}.qqConnect{display:flex;flex-direction:column;align-items:center;gap:14px;padding:24px 0;text-align:center}.qqTranscript{margin:16px 0}.qqTranscriptBody{max-width:min(78%,680px)}.qqBubble{border:0;border-radius:18px;padding:9px 13px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}.qqTranscript.out .qqBubble{border-radius:18px;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}.qqTranscriptMeta{margin:0 4px 4px;font-size:12px;color:var(--dsw-alias-label-secondary)}.qqQuote{border-color:var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1)}
 .qqWideModal{width:min(760px,calc(100vw - 48px));max-height:calc(100vh - 48px);min-height:0;overflow:hidden}.qqModalContent{min-height:0;overflow:auto}.qqModalContent .qqMemoryGrid{min-width:0}.qqModalContent .qqLog{overflow-wrap:anywhere;word-break:break-word}
 `.concat('.qqQuoteSender{margin-top:4px;font-size:10px;color:var(--dsw-alias-label-secondary)}.qqMediaList{display:flex;flex-wrap:wrap;gap:6px;margin-top:7px}.qqMediaCard{display:flex;align-items:center;gap:6px;max-width:100%;padding:6px 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-layer-1);font-size:11px}.qqMediaKind{color:var(--dsw-alias-brand-primary);font-weight:650}.qqMediaPreview{width:42px;height:42px;object-fit:cover;border-radius:6px}.qqMediaName{max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.qqMediaSize,.qqMediaQuoted{color:var(--dsw-alias-label-secondary)}');
-const qqThemeOverrides = '.qqTranscript.out .qqBubble{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}';
+const qqThemeOverrides = '.qqBubble{background:var(--dsw-specific-bubble);color:var(--dsw-alias-label-primary)}.qqTranscript.out .qqBubble{background:var(--dsw-specific-bubble);color:var(--dsw-alias-label-primary)}';
 function installStyles() {
     if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css="${STYLE_ID}"]`))
         return () => { };

package/lib/config.js

@@ -8,10 +8,10 @@ const DEFAULT_CONFIG = Object.freeze({
     groupReadEnabled: true,
     replyFormat: 'smart',
     recentGroupMessages: 40,
-    reflectionIdleMs: 120_000,
+    reflectionIdleMs: 900_000,
     reflectionBatchSize: 20,
     reflectionMaxMessages: 80,
-    memoryMaxTokens: 1400,
+    memoryMaxTokens: 4096,
     memoryCompressionMaxTokens: 15000,
 });
 export function resolveConfig(input = {}) {
@@ -45,6 +45,7 @@ export function defaultRuntimeSettings(config) {
         : config.groupRequiresAt ? 'mention' : 'auto';
     return {
         memoryEnabled: true,
+        memoryMemberBatchEnabled: true,
         groupReceiveMode,
         groupReplyFormat: 'compat',
         directReplyFormat: config.replyFormat,

package/lib/index.js

@@ -31,7 +31,9 @@ export function apply(ctx, inputConfig = {}) {
     const runtime = new QQChatRuntime(ctx, db, api, auth, memory, bridge, config, logger, media);
     ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime), { authority: 'loopback' });
     ctx.effect(() => {
-        void runtime.start().catch(error => logger.error?.(error));
+        void (async () => {
+            await runtime.start();
+        })().catch(error => logger.error?.(error));
         return () => runtime.stop();
     }, 'dsh-qqchat runtime');
 }

package/lib/session/memory-snapshot.d.ts

@@ -11,6 +11,10 @@ export interface MemorySnapshotEvent {
         source?: {
             kind?: string;
             plugin?: string;
+            sections?: readonly {
+                name?: string;
+                text?: string;
+            }[];
         };
         content?: readonly {
             type?: string;

package/lib/session/memory-snapshot.js

@@ -16,9 +16,13 @@ export function restoreMemorySnapshotState(events, sourcePlugin) {
         const event = events[index];
         if (!event)
             continue;
-        if (event.type !== 'user/message' || event.data?.source?.kind !== 'plugin' || event.data.source.plugin !== sourcePlugin)
+        const source = event.data?.source;
+        if (event.type !== 'user/message' || source?.kind !== 'plugin' || source.plugin !== sourcePlugin)
             continue;
-        const block = event.data.content?.length === 1 ? event.data.content[0] : undefined;
+        if (!source.sections?.some(section => section.name === 'qq-chat-context'))
+            continue;
+        const content = event.data?.content;
+        const block = content?.length === 1 ? content[0] : undefined;
         if (block?.type !== 'text' || typeof block.text !== 'string')
             continue;
         return { hash: memorySnapshotHash(block.text), lastInjectedAt: Number(event.time) || 0, stale: lastCompactionAt > (Number(event.time) || 0) };

package/lib/session/runtime.js

@@ -59,6 +59,8 @@ export class QQChatRuntime {
     updateSettings(patch) {
         if (patch.memoryEnabled !== undefined)
             this.db.setSetting('memoryEnabled', Boolean(patch.memoryEnabled));
+        if (patch.memoryMemberBatchEnabled !== undefined)
+            this.db.setSetting('memoryMemberBatchEnabled', Boolean(patch.memoryMemberBatchEnabled));
         if (patch.groupReceiveMode !== undefined) {
             if (!isGroupReceiveMode(patch.groupReceiveMode))
                 throw new Error('无效的群聊接收模式');
@@ -131,8 +133,11 @@ export class QQChatRuntime {
             content: text, quotedText: '', mentioned: false, createdAt: Date.now(),
         }, row, true);
         if (this.settings().memoryEnabled) {
-            if (chatType === 'group')
+            if (chatType === 'group') {
                 this.memory.schedule(Number(row.id));
+                if (settings.memoryMemberBatchEnabled)
+                    this.memory.scheduleGroupMembers(Number(row.id));
+            }
             else
                 this.memory.scheduleMember(Number(row.id));
         }
@@ -261,10 +266,11 @@ export class QQChatRuntime {
             quotedText: message.quotedText, mentioned: message.mentioned, createdAt: Date.now(), attachments: publicAttachments(ownAttachments), quote: safeQuote,
         };
         if (settings.memoryEnabled) {
-            if (group)
+            if (group) {
                 this.memory.schedule(Number(group.id));
-            else
-                this.memory.scheduleMember(Number(member.id));
+                if (settings.memoryMemberBatchEnabled)
+                    this.memory.scheduleGroupMembers(Number(group.id));
+            }
         }
         if (!shouldReply) {
             await this.bridge.recordTranscript(displayEvent, row, true);
@@ -303,8 +309,11 @@ export class QQChatRuntime {
                 memberId: message.chatType === 'c2c' ? member.id : undefined, direction: 'outbound', content: reply, mentioned: false,
             });
             if (settings.memoryEnabled) {
-                if (group)
+                if (group) {
                     this.memory.schedule(Number(group.id));
+                    if (settings.memoryMemberBatchEnabled)
+                        this.memory.scheduleGroupMembers(Number(group.id));
+                }
                 else
                     this.memory.scheduleMember(Number(member.id));
             }

package/lib/storage/db.d.ts

@@ -1,4 +1,4 @@
-import type { AccountRow, AuthTaskRow, ChatType, DirectChatListRow, DailyEntry, GroupDefaults, GroupListRow, GroupMemberRow, GroupPatch, GroupRow, InsertMessageInput, MemberRow, MemoryDocuments, MemoryDocType, MemoryScopeType, MessageRow, OutboxRow, PublicAccountRow, QQChatRuntimeSettings, QQMediaKind, QQQuoteIndexInput, QQQuoteIndexRow, StoredAttachmentSummary } from '../types.js';
+import type { AccountRow, AuthTaskRow, ChatType, DirectChatListRow, DailyEntry, GroupDefaults, GroupListRow, GroupMemberRow, GroupPatch, GroupRow, InsertMessageInput, MemberRow, MemoryDocuments, MemoryDocType, MemoryScopeType, MessageRow, OutboxRow, PublicAccountRow, QQChatRuntimeSettings, QQMediaKind, QQQuoteIndexInput, QQQuoteIndexRow, StoredAttachmentSummary, ReflectionTaskInput } from '../types.js';
 export declare class QQChatDatabase {
     readonly path: string;
     private readonly db;
@@ -67,7 +67,12 @@ export declare class QQChatDatabase {
     recentGroupMessages(groupId: number, limit?: number): MessageRow[];
     unreflectedMessages(groupId: number, limit?: number): MessageRow[];
     unreflectedCount(groupId: number): number;
+    unreflectedMemberMessages(groupId: number, limit?: number): MessageRow[];
+    unreflectedMemberCount(groupId: number): number;
     markReflected(groupId: number, messageId: number): void;
+    markMembersReflected(groupId: number, messageId: number): void;
+    startReflectionTask(input: ReflectionTaskInput): boolean;
+    finishReflectionTask(idempotencyKey: string, status: 'completed' | 'failed'): void;
     memoryDocs(scopeType: MemoryScopeType, scopeKey: number): MemoryDocuments;
     setMemoryDoc(scopeType: MemoryScopeType, scopeKey: number, docType: MemoryDocType, content: string): void;
     appendMemoryDoc(scopeType: MemoryScopeType, scopeKey: number, docType: MemoryDocType, content: string, maxChars?: number): void;

package/lib/storage/db.js

@@ -2,6 +2,7 @@ import { DatabaseSync } from 'node:sqlite';
 import { chmodSync, mkdirSync } from 'node:fs';
 import { dirname } from 'node:path';
 const now = () => Date.now();
+const REFLECTION_TASK_STALE_MS = 15 * 60 * 1000;
 function parseStringList(value) {
     if (!value)
         return [];
@@ -209,8 +210,23 @@ export class QQChatDatabase {
       CREATE TABLE IF NOT EXISTS reflection_state (
         group_id INTEGER PRIMARY KEY REFERENCES groups(id) ON DELETE CASCADE,
         last_message_id INTEGER NOT NULL DEFAULT 0,
+        last_member_reflected_message_id INTEGER NOT NULL DEFAULT 0,
         last_reflected_at INTEGER
       );
+      CREATE TABLE IF NOT EXISTS reflection_tasks (
+        id INTEGER PRIMARY KEY,
+        scope_type TEXT NOT NULL CHECK(scope_type IN ('group','member','private')),
+        scope_key INTEGER NOT NULL,
+        task_type TEXT NOT NULL CHECK(task_type IN ('group','member-batch','private-owner')),
+        start_message_id INTEGER NOT NULL,
+        end_message_id INTEGER NOT NULL,
+        status TEXT NOT NULL CHECK(status IN ('running','completed','failed')),
+        attempts INTEGER NOT NULL DEFAULT 0,
+        idempotency_key TEXT NOT NULL UNIQUE,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS reflection_tasks_scope ON reflection_tasks(scope_type, scope_key, task_type, status);
       CREATE TABLE IF NOT EXISTS outbox (
         id INTEGER PRIMARY KEY,
         account_id INTEGER NOT NULL REFERENCES accounts(id) ON DELETE CASCADE,
@@ -223,6 +239,8 @@ export class QQChatDatabase {
         error TEXT
       );
     `);
+        this.db.prepare("UPDATE reflection_tasks SET status='failed',updated_at=? WHERE status='running' AND updated_at<?")
+            .run(now(), now() - REFLECTION_TASK_STALE_MS);
         const columns = new Set(many(this.db.prepare('PRAGMA table_info(group_members)').all()).map(column => column.name));
         const groupColumns = new Set(many(this.db.prepare('PRAGMA table_info(groups)').all()).map(column => column.name));
         if (groupColumns.has('requires_at'))
@@ -234,6 +252,10 @@ export class QQChatDatabase {
         if (!columns.has('message_count'))
             this.db.exec('ALTER TABLE group_members ADD COLUMN message_count INTEGER NOT NULL DEFAULT 0');
         const messageColumns = new Set(many(this.db.prepare('PRAGMA table_info(messages)').all()).map(column => column.name));
+        const reflectionColumns = new Set(many(this.db.prepare('PRAGMA table_info(reflection_state)').all()).map(column => column.name));
+        if (!reflectionColumns.has('last_member_reflected_message_id')) {
+            this.db.exec('ALTER TABLE reflection_state ADD COLUMN last_member_reflected_message_id INTEGER NOT NULL DEFAULT 0');
+        }
         if (!messageColumns.has('attachments_json'))
             this.db.exec('ALTER TABLE messages ADD COLUMN attachments_json TEXT');
         if (!messageColumns.has('quote_json'))
@@ -342,6 +364,7 @@ export class QQChatDatabase {
     runtimeSettings(defaults) {
         return {
             memoryEnabled: this.getSetting('memoryEnabled', defaults.memoryEnabled),
+            memoryMemberBatchEnabled: this.getSetting('memoryMemberBatchEnabled', defaults.memoryMemberBatchEnabled),
             groupReceiveMode: this.getSetting('groupReceiveMode', defaults.groupReceiveMode),
             groupReplyFormat: this.getSetting('groupReplyFormat', defaults.groupReplyFormat),
             directReplyFormat: this.getSetting('directReplyFormat', this.getSetting('replyFormat', defaults.directReplyFormat)),
@@ -611,11 +634,45 @@ export class QQChatDatabase {
         const row = one(this.db.prepare('SELECT COUNT(*) AS n FROM messages WHERE group_id=? AND id>?').get(groupId, Number(state?.last_message_id || 0)));
         return Number(row?.n || 0);
     }
+    unreflectedMemberMessages(groupId, limit = 80) {
+        const state = one(this.db.prepare('SELECT last_member_reflected_message_id FROM reflection_state WHERE group_id=?').get(groupId));
+        const after = Number(state?.last_member_reflected_message_id || 0);
+        return many(this.db.prepare(`SELECT m.*,mem.platform_user_id,mem.display_name
+      FROM messages m LEFT JOIN members mem ON mem.id=m.member_id
+      WHERE m.group_id=? AND m.id>? ORDER BY m.id ASC LIMIT ?`).all(groupId, after, limit));
+    }
+    unreflectedMemberCount(groupId) {
+        const state = one(this.db.prepare('SELECT last_member_reflected_message_id FROM reflection_state WHERE group_id=?').get(groupId));
+        const row = one(this.db.prepare('SELECT COUNT(*) AS n FROM messages WHERE group_id=? AND id>?').get(groupId, Number(state?.last_member_reflected_message_id || 0)));
+        return Number(row?.n || 0);
+    }
     markReflected(groupId, messageId) {
         this.db.prepare(`INSERT INTO reflection_state(group_id,last_message_id,last_reflected_at) VALUES(?,?,?)
       ON CONFLICT(group_id) DO UPDATE SET last_message_id=excluded.last_message_id,last_reflected_at=excluded.last_reflected_at`)
             .run(groupId, messageId, now());
     }
+    markMembersReflected(groupId, messageId) {
+        this.db.prepare(`INSERT INTO reflection_state(group_id,last_message_id,last_member_reflected_message_id,last_reflected_at) VALUES(?,?,?,?)
+      ON CONFLICT(group_id) DO UPDATE SET last_member_reflected_message_id=excluded.last_member_reflected_message_id,last_reflected_at=excluded.last_reflected_at`)
+            .run(groupId, 0, messageId, now());
+    }
+    startReflectionTask(input) {
+        const existing = one(this.db.prepare('SELECT id,status FROM reflection_tasks WHERE idempotency_key=?').get(input.idempotencyKey));
+        if (existing?.status === 'completed' || existing?.status === 'running')
+            return false;
+        if (existing) {
+            this.db.prepare(`UPDATE reflection_tasks SET status='running',attempts=attempts+1,updated_at=? WHERE id=?`)
+                .run(now(), existing.id);
+            return true;
+        }
+        this.db.prepare(`INSERT INTO reflection_tasks(scope_type,scope_key,task_type,start_message_id,end_message_id,status,attempts,idempotency_key,created_at,updated_at)
+      VALUES(?,?,?,?,?,'running',1,?,?,?)`)
+            .run(input.scopeType, input.scopeKey, input.taskType, input.startMessageId, input.endMessageId, input.idempotencyKey, now(), now());
+        return true;
+    }
+    finishReflectionTask(idempotencyKey, status) {
+        this.db.prepare('UPDATE reflection_tasks SET status=?,updated_at=? WHERE idempotency_key=?').run(status, now(), idempotencyKey);
+    }
     memoryDocs(scopeType, scopeKey) {
         const rows = many(this.db.prepare('SELECT doc_type,content,updated_at FROM memory_documents WHERE scope_type=? AND scope_key=?')
             .all(scopeType, scopeKey));

package/lib/storage/memory.d.ts

@@ -1,13 +1,19 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { QQChatDatabase } from './db.js';
-import type { GroupRow, LoggerLike, MemoryDocuments, MemoryView, QQChatConfig, ReflectionPayload, QQNormalizedMessage } from '../types.js';
+import type { GroupRow, LoggerLike, MemoryDocuments, MemoryView, QQChatConfig, ReflectionPayload, MemberBatchReflectionPayload, QQNormalizedMessage } from '../types.js';
 interface MemberReflectionPayload {
+    profile_add?: unknown;
+    profile_remove?: unknown;
+    pattern_add?: unknown;
+    pattern_remove?: unknown;
     profile?: unknown;
     pattern?: unknown;
     summary?: unknown;
     memory?: unknown;
     daily?: unknown;
 }
+/** 与咕咕一致：每个记忆 scope 的本轮直注入预算（按字符计）。 */
+export declare const MEMORY_INJECT_CHARS = 2000;
 export declare class MemoryEngine {
     private readonly ctx;
     private readonly db;
@@ -15,24 +21,38 @@ export declare class MemoryEngine {
     private readonly logger;
     private readonly timers;
     private readonly memberTimers;
+    private readonly memberBatchTimers;
     private readonly routes;
     private readonly memberRoutes;
     private readonly reflectingGroups;
     private readonly reflectingMembers;
+    private readonly reflectingMemberBatches;
+    private readonly groupRetryAt;
+    private readonly memberRetryAt;
+    private readonly memberBatchRetryAt;
     constructor(ctx: Context, db: QQChatDatabase, config: QQChatConfig, logger?: LoggerLike);
     dispose(): void;
     setRoute(groupId: number, provider: string, model: string, sessionId: string): void;
     setMemberRoute(memberId: number, provider: string, model: string, sessionId: string): void;
     schedule(groupId: number): void;
     scheduleMember(memberId: number): void;
+    scheduleGroupMembers(groupId: number): void;
+    private inRetryCooldown;
+    private reflectionDelay;
+    private runScheduledGroupReflection;
+    private runScheduledMemberReflection;
+    private runScheduledMemberBatchReflection;
     reflectNow(groupId: number): Promise<MemoryView>;
     private reflectNowInternal;
+    reflectMembersNow(groupId: number): Promise<MemoryView>;
+    private reflectMembersNowInternal;
     reflectMemberNow(memberId: number): Promise<MemoryDocuments>;
     private reflectMemberNowInternal;
     private compactDaily;
     private generateReflection;
     private unreflectedDirectMessages;
-    private applyReflection;
+    private applyGroupReflection;
+    private applyMemberBatchReflection;
     contextForGroup(group: GroupRow, currentMember?: {
         id: number;
         platform_user_id: string;
@@ -46,5 +66,11 @@ export declare class MemoryEngine {
     currentMessageText(message: QQNormalizedMessage): string;
     memoryView(groupId: number): MemoryView | undefined;
 }
+export declare function memorySystemPrompt(): string;
+export declare function memberBatchMemorySystemPrompt(): string;
+export declare function privateMemorySystemPrompt(): string;
+export declare function groupCompressionSystemPrompt(): string;
+export declare function memberCompressionSystemPrompt(): string;
 export declare function parseJsonObject(text: string): ReflectionPayload | MemberReflectionPayload;
+export declare function validateMemberBatchPayload(value: unknown, allowedSenderIds: ReadonlySet<string>): value is MemberBatchReflectionPayload;
 export {};