Files
agent/app/server/memory.js
T
kicer 01ec42a197 feat(memory): M1 会话收口——4h 空闲自动下班 + 定时即下班(brief 模板碎片)
微信通道拟人化第二里程碑:会话=工作台,收口=下班记日记。

- 空闲收口:扫描器扩为会话闲置双阶段(sweepIdleSessions)——30min held 归档(原有)
  + 4h(memory.wrap_idle_ms 可配,0=关)无更新且未收口的 held/completed 会话,
  后台异步 journalFragment 摘要落碎片(fire-and-forget 不阻塞消息路径),
  顺手归档 + 删 channel_sessions 绑定行——微信下条消息经 ensureSession 自然新建
  工作台;用户抢先复活(active)则不撤台。updated_at 门槛越过即永远成立,
  「不重复收口」靠 sessions.journaled_at 物理标记(防陈年 completed 每轮烧 LLM)。
- 定时即下班:schedule 工具 create 新增 brief 参数(一句话任务人话描述,进 schema),
  scheduler.createTask 落库;工具只打 run.taskWrap 标记,收口在 finalize done 广播后
  (attachBus 监听已同步捕获绑定入队投递,删绑定不影响本次回复送达)——
  brief 纯模板碎片零 LLM 落收口当日条目 + journaled 占坑(任务会话从此退出 4h 流程,
  任务执行痕迹不落日记,「任务是什么+成果文件」即可回溯全貌)+ 解绑退位。
- 碎片时间线定稿:入【收口当日】而非会话创建日(长跨度会话不会落进已裁掉的旧日期)。
- 网页/微信统一碎片(用户级共享),解绑只对通道会话生效(网页无绑定行 DELETE 空操作)。
  /new /switch /clear 不产碎片;/clear 重置 journaled(清空=撕掉作业,可再收口)。
- 记忆关闭(retain_days=0)时定时收口整体不执行:没有日记的下班没有意义,不抽工作台。

上电探针 6 项全过(brief 落库/钩子标记/journaled 占坑/归档/当日条目/解绑),探针已清理。
M2(新会话注入日记)下一棒。
2026-09-29 11:18:16 +08:00

97 lines
5.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 长期记忆(日记):微信通道拟人化工程的 M0 地基——纯存储与渲染,不碰模型
//(碎片摘要生成在 engine.journalFragment,与自动标题同模式:fire-and-forget + 失败降级)。
// 与 profile(user-profile.js)分工:profile 记「用户是什么样的人」(语义记忆、稳定特质),
// 日记记「我近几天帮他做过什么」(事件记忆、按天条目),两类记忆互不混。
// 规则:
// - (user, day) 一行;碎片 = 会话收口(下班)时生成的一小段第一人称记录,
// 按【收口当日】入条目(时间线跟下班日走,长跨度会话不会把记忆落进已裁掉的旧日期);
// 同日多碎片按到达顺序拼接,不做 LLM 二次合并(确定性、零成本,每片本身已是条目化短文本);
// - sid 去重:同一会话向同一天的条目只贡献一次碎片(防轮换竞态双写;代价:同一会话
// 被 /switch 捡回再离开时第二片同样被挡——M0 接受的简化,粒度留到轮换触发接线时复盘);
// - memory.retain_days = 保留窗口(默认 7 天,硬帽 MAX_RETAIN);0 = 整体关闭(不写不读不裁)。
// 时区与 cron(scheduler.js)对齐 Asia/Shanghai:上海无夏令时,按毫秒日移取 day 字符串安全。
const TZ = 'Asia/Shanghai';
const MAX_RETAIN = 30;
const DAY_MAX = 4000; // 单日条目长度帽:溢出从头部裁(保最近片段)
const FRAG_MAX = 600; // 单碎片长度帽(含【标题 · sid】头行)
function retainDays(cfg) {
const n = Math.floor(Number((cfg && cfg.memory || {}).retain_days) || 0);
return Math.max(0, Math.min(MAX_RETAIN, n));
}
function isEnabled(cfg) { return retainDays(cfg) > 0; }
const dayFmt = new Intl.DateTimeFormat('en-CA', { timeZone: TZ }); // en-CA = ISO 'YYYY-MM-DD'
function dayString(ms) { return dayFmt.format(new Date(Number(ms) || Date.now())); }
// 近 n 天窗口(含今天),数组按日期降序(新在前)。
function recentDays(cfg, refMs) {
const n = retainDays(cfg);
const out = [];
const t = Number(refMs) || Date.now();
for (let i = 0; i < n; i++) out.push(dayString(t - i * 86400000));
return out;
}
// ---------- 写:碎片追加进对应天条目 ----------
// sid 三重角色:去重标记 / 条目里的下钻索引(M3 回忆按它取旧会话详情与成果文件)/ 溯源。
// 返回值三态:'added' 新落 / 'dupe' 该会话已有碎片(去重命中)/ 'off' 功能关闭或空文。
// 调用方(engine 收口链路)把 added 与 dupe 都视为「已收口」落 journaled 标记,不重试不重复摘要。
function appendFragment(db, cfg, user, day, text, sid) {
if (!isEnabled(cfg) || !day) return 'off';
const frag = String(text || '').replace(/\r/g, '').trim().slice(0, FRAG_MAX);
if (!frag) return 'off';
const key = String(user || '');
const row = db.prepare('SELECT content FROM memory_entries WHERE user = ? AND day = ?').get(key, day);
const base = row ? String(row.content) : '';
if (sid && base.includes(String(sid))) return 'dupe'; // 本会话已入当天日记
let next = base ? base + '\n\n' + frag : frag;
if (next.length > DAY_MAX) next = next.slice(next.length - DAY_MAX);
db.prepare(
'INSERT INTO memory_entries (user, day, content, updated_at) VALUES (?,?,?,?)'
+ ' ON CONFLICT(user, day) DO UPDATE SET content = excluded.content, updated_at = excluded.updated_at'
).run(key, day, next, Date.now());
prune(db, cfg); // 裁剪就一条廉价 DELETE,每次追加顺带做,表恒在保留窗内
return 'added';
}
// 收口标记:每会话唯一碎片的物理保证(空闲/任务收口落地后置位;之后会话被再激活也不补碎片——
// 记忆稳定性优先于完备,新工作值得新工作台)。
function markJournaled(db, sessionId, ms) {
db.prepare('UPDATE sessions SET journaled_at = ? WHERE id = ? AND journaled_at IS NULL')
.run(Number(ms) || Date.now(), String(sessionId));
}
// ---------- 读:渲染成可注入会话上下文的日记文本(M2 的数据源) ----------
// 无记忆返回 '';天降序(新在前);头行说明 sid 用途,AI 自然知道可以下钻。
function journalFor(db, cfg, user) {
const n = retainDays(cfg);
if (!n) return '';
const days = recentDays(cfg);
const rows = db.prepare(
'SELECT day, content FROM memory_entries WHERE user = ? AND day IN ('
+ days.map(() => '?').join(',') + ') ORDER BY day DESC'
).all(String(user || ''), ...days);
if (!rows.length) return '';
const head = '【长期记忆·日记(近' + n + '天)】近期交互的当日事件记录;'
+ '【… · 】内的编号是当时会话 id,需要当时的对话细节或成果文件时,用回忆工具按它下钻。';
const parts = [head];
for (const r of rows) parts.push('=== ' + r.day + ' ===\n' + r.content);
return parts.join('\n\n');
}
// ---------- 裁剪:day 为 ISO 串,字典序即日期序 ----------
function prune(db, cfg) {
const days = recentDays(cfg);
if (!days.length) return 0;
const res = db.prepare('DELETE FROM memory_entries WHERE day < ?').run(days[days.length - 1]);
return res.changes || 0;
}
module.exports = {
isEnabled, retainDays, dayString, recentDays,
appendFragment, markJournaled, journalFor, prune,
MAX_RETAIN, DAY_MAX, FRAG_MAX,
};