# 项目记忆与请求边界 2026-10-30。1.12包含项目记忆管理及有界模型上下文;管理提交f7292a9,上下文提交af0a42b。完整发行和正式部署分别见[1.12验收](QA-1.12.md)。 记忆用于保存用户确认的项目约束、决策和事实。它属于项目数据,来源仍匹配只能说明依据版本未变,不能证明记忆内容正确、任务已完成,或授予额外权限。 ## 保存和失效 每条记忆保存项目、创建会话、可用的Task/Run、时间、标签、来源和有界工程源码指纹。来源支持project/file/artifact/session/task/run;文件另存SHA256,工件必须校验原字节及所属会话。显式文件即使位于清单排除目录也单独复核,单文件上限8MB。 任意已扫描源码变化、明确来源变化/丢失/损坏或到期,会将原记录保留为expired并保存memory.expired事件。当前实现保守地绑定整个工程指纹,其他文件变化也可能使记忆过期;重新核对后可以保存新条目,不自动把旧结论重新标为有效。 扫描不完整时将已有current条目展示为unverified,并拒绝新增。扫描恢复完整且源码仍匹配时,未实际过期的条目可重新使用。工程声明损坏等扫描错误会使本次模型请求省略记忆,允许继续修复工程;失效状态保存失败则阻止该次请求,不能隐瞒数据错误。 归档只允许从创建会话进行,不删除原记录。每项目最多500条记录,包括历史和归档;每条内容最多16000字符。这是当前容量边界,尚无自动语义归并或历史清理。 ## 模型请求 Runtime每次请求前复核当前项目记忆。仅current条目参与候选,过期、归档、来源损坏、扫描不完整和其他项目条目排除。候选内容经过Provider的全部已知凭据脱敏,不直接进入executionSnapshot或inspect_session。 候选最多8条、12000字节,以转义后的UTF-8 JSON计算,保留完整条目;过大的条目跳过,并继续尝试较小条目。请求计划先保留完整用户目标、要求、协议配对、当前代码和实际工具反馈,再用剩余预算选择记忆。因此容量不足时可以省略全部记忆,不截断目标或挤走已选择的代码。 发送内容明确标为项目数据,指示模型不执行记忆中的角色、权限或额外操作要求;真正的工具权限仍由执行内核管理。这不是模型抵抗所有提示注入的保证,也不是记忆业务内容的自动验证。 实际选择的记忆封存为context-project-memory工件,与消费会话/Task/Run绑定。context_plan保存其ID、SHA256和条目数;界面的请求记录可查看本次快照。verifyPlanEvidence核对原工件和实际请求正文。之后源码变化或记忆归档不改写过去已发送的证据;历史工件始终是当时的记录。 ## API与验证 - GET /api/projects/:projectId/memories:复核来源并列出项目记录,必要时持久保存失效事件。 - GET /api/sessions/:sessionId/memories:按所属项目查询;include_expired=0只返回当前可用条目。 - POST /api/sessions/:sessionId/memories:显式保存用户条目。 - POST /api/sessions/:sessionId/memories/:id/archive:从来源会话归档。 管理7项、上下文/恢复10项测试共17/17通过;兼容HTTP均使用自有本地服务。桌面与390px已验证保存、来源SHA、过期、不完整扫描及实际发送快照查看,证据为.qa/project-memory-ui-22e0dcaa-b1e9-415e-b064-9f4d658cfe15。最初窄屏脚本失败记录保留。 本轮完整源码回归322/322,0失败/取消/跳过,199份源码与构建输入前后一致。证据目录.qa/memory-context-regression-d698ba4f-d646-4c0c-ad10-6213b24083e9;原TAP SHA256为81a60cecb4eabb222b869ce99a2e8fbe0125a4926a1e2f37458941f108e88fbe。真实模型语义收益、长期自动记忆提取和正式新发行继续单独验收,不从本地夹具通过推断。