[Anson-Se]

做了什么

这个 PR 包含三件互相依赖的事，按提交顺序：

1. L3 场域认知改造（前 7 个提交）

• 把 L3 从“每个项目四段整段重写的文字”改成按“本机 / 项目”分开存的短条目，只有两类：
  • 环境事实（env_fact）：“条件 -> 现象”，必须有工具输出作证据；
  • 项目规矩（project_constraint）：用户希望以后在这个项目里一直遵守的做法。
• 判断标准是“换一个人在这台电脑或这个项目上工作，这条仍然成立”。
• 以下内容不记：
  • 个人偏好、单次任务的细节；
  • 工作产出的结论、读代码得到的知识；
  • 通用常识、临时状态；
  • Agent 自身的沙箱和工具限制。
• 条目支持新增、替换、删除、确认：新规矩会替换旧规矩，问题修好后对应条目会失效。
• 环境画像由代码扫描生成，模型只读不写。
• 项目识别：先看用户在桌面端选过的项目，再看 git 仓库，最后看普通文件夹。临时目录、系统和工具目录、依赖包目录不算项目。
• 有开关 algorithm.l3FieldCognition.enabled（环境变量 MEMMY_L3_FIELD_COGNITION=1），默认关闭。关闭时走原来的 L3，行为不变。
• 不改 SCHEMA_VERSION（仍为 9），只新增 4 张表，旧数据不转写，旧版 Memmy 仍能打开这个库。

2. MEMMY-852 失败批次补跑（第 8 个提交）

• 临时失败（空响应、网络错误、超时、限流）分别等 1、5、15、30、60 分钟再重试，第 5 次重试还失败就进死信，后面的批次照常处理。
• 配置类错误（没配模型、key 错、额度不足）先挂起，不消耗重试次数，每 30 分钟再试一次；没配进化模型时不领取 L3 任务。
• 新增补跑入口 POST /api/v1/l3/failed-batches/retry，在原任务上复位后重跑。
• 全部接在现有的 evolution_jobs 队列上（用 runAfter、attempts/max_attempts、failJob 这些现有字段和方法），没有新建队列、定时器或重试表。

3. #590 扫描会话进 L3（第 9 个提交）

• 扫描新开的会话走新协议，并关闭 Work Memory。
• 每个来源一轮扫描处理完后，把这一轮碰到的会话交给 L3 处理，不等模型跑完，所以不会拖慢扫描。
• 托管导入路径（backend ingestion-service）也走同样的处理。
• 先扫描、后来 Hook 又接管同一会话时，由 Hook 接手。

Closes #590

改动范围

提交	内容
add l3 field cognition tables and flag	新表、开关、仓库层、快照记忆
resolve l3 projects from paths	从路径识别项目
accept user-selected project roots for l3	桌面端把用户选过的项目推给 Memory
build l3 evidence fragments with unit candidates	证据片段及其归属
profile machine and project units for l3	本机画像、项目画像
inject and display l3 field context	会话开头注入 L3、面板显示
update l3 field items from frozen batches	更新流水线、提示词、输入裁剪与上限
retry and resume failed l3 jobs through the job queue	MEMMY-852
feed scanned sessions into l3	#590

共 46 个文件，约 3400 行，其中包含测试。

怎么验证的

• 测试：
  • npm run memory:test 1754 个通过。有 9 个失败，都在已知的“满负载超时”名单里（扫描响应、checkpoint 恢复等），单独运行全部通过。
  • App/backend 992 个通过，失败的 1 个单独运行通过。
  • App/memmy-agent 改动涉及的部分 2810 个通过。
  • typecheck 通过。
• 离线回放对比：同样 27 个会话（16 个真实会话 + 11 个测试会话），新旧两版都从空 L3 开始，同一个模型，各跑 3 次。存下的条目混在一起交给独立评审盲评，评审不知道条目来自哪个版本。

	v1.2.6	本 PR
每次存下的条目	72～94	10～11
其中该存的占比	37%	91%
噪声（一次性、常识、临时状态、Agent 自身限制）	34～58 条	0
模型输入 token	约 445 万	约 45 万
模型调用次数	67～68	44～46

• 输入 token 少的原因：旧版把整段原始对话原样发给模型，其中工具调用和工具输出占 99%；而且项目契约、领域知识两个字段各发一遍。新版每组只调用一次模型，工具输出只留头尾和报错行，输入上限 65536 字，超出时先丢工具输出。
• 真机测试：在本机用 Memmy CLI 和 Codex 跑过多个场景，包括规矩替换、问题修好后失效、个人偏好不记、大文件夹里改子项目、扫描会话进 L3，结果都符合预期。
• Codex 审核 4 轮：前 3 轮提的问题都已修复。第 4 轮提出 1 个阻塞问题（模型上下文较小时会进死信），已修复：输出预算降到 16384，超出上下文时缩小输入再试一次。

已知限制

• 开关默认关闭。打开后，面板里旧 L3 和新 L3 会同时显示。
• 补跑入口还没接前端。
• 条目偶尔会比提示词要求的长；少量只和某个工具相关的事实会被放到“所有地方”。
• 可能和 fix: 优化记忆后台任务调度，避免历史导入阻塞实时任务和向量重试 #734（后台任务调度）冲突，两边都改了任务调度和重试的逻辑。
• feat(memory): 基于模型判断 L1 提取并复用同 Session 历史 Episode #681 合入后，L1 接口需要再适配一次。

🤖 Generated with Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

[Anson-Se]

@origami-chen