Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
Mobile 任务消息内存治理方案
状态:已实现(2026-08-15)
1. 背景与目标
Mobile 的任务详情此前把完整消息长期保存在进程级 remoteSessionStore,并通过
AsyncStorage 缓存最新一页。浏览大量任务、持续接收流式消息或遇到超大工具输出时,
消息正文会在 JS 堆中持续累积;定时任务又会自动产生大量很少再次打开的会话,放大
驻留问题。
本方案只治理 Mobile 的完整消息正文与紧邻的运行时投影,不改变 Desktop、共享协议、 数据库 schema、原生配置或依赖。
交付目标:
- schedule 任务只在当前可见详情驻留完整消息,隐藏后最终回收到 0;
- regular 任务离开详情后压回最近一页,全局约 800 条或 64 MiB;
- 当前详情、运行中、待处理交互、排队输入、草稿和本地在途工作不被误回收;
- 失焦、切任务、切后台后,旧异步读取和旧订阅不得在重新聚焦后复活正文;
- 内存淘汰与磁盘缓存删除使用不同语义,不因
messages=[]误删 regular 缓存; - 本地系统卡、乐观用户行和未落库的 assistant 行优先保留。
2. 边界
本次改动限定在 apps/mobile/**:
- 不修改 device-link wire protocol;
- 不修改 Desktop 或服务端;
- 不修改 Mobile 原生配置、原生依赖与 runtime fingerprint;
- 不引入轮询、TTL 或后台常驻定时回收器;
- 不把消息正文迁移进新的数据库。
3. 分类
分类是创建来源决定的二分类:
| 分类 | 判据 | 隐藏后的目标 |
|---|---|---|
schedule |
session.source === 'scheduler' |
完整消息最终为 0 |
regular |
其它情况,包括 source 缺失 | 最近 80 条软窗口 |
不使用 schedule 索引或标题前缀。索引会晚到且同时包含“schedule 创建”和“绑定既有 任务”;标题可被用户修改。source 缺失时按 regular 保守处理,方向是多驻留而不是误 回收。
4. 生命周期与写权限
每个会话拥有单调递增的 generation:
- 详情获得焦点且 App 在前台时
enter(sessionId),生成新 authority; - 失焦、切任务或 App 进入后台时
leave(sessionId, reason, authority); - leave 先递增 generation、撤销可见性,再考虑是否可以回收;
- 页面
listMessages、around-message、自动补历史在请求开始时捕获 authority; - 断线重读对已进入过详情的任务同样捕获 authority;从未打开的 regular 只在响应返回时 仍未进入详情、且仍归属原设备时更新全局镜像;
- 携 authority 的异步响应提交时必须同时满足 sessionId、generation、visible 三项仍一致。
旧 cleanup 也必须携带自己的 authority。这样 A1 失焦、A2 重新聚焦后,A1 的 cleanup 和响应都不能影响 A2。
完整消息 push 的规则:
- schedule 非当前详情拒绝正文 push;
- regular 曾经离开详情后拒绝旧订阅 push;
- 从未打开的 regular 保留全局消息镜像,但补读期间一旦 enter、leave、forget 或设备归属 变化,旧响应即拒绝;
- 页面离场但本地工作尚未收口时,允许必要的乐观/对账写入,排空后统一回收;
- status、live activity、通知摘要等轻量事实不依赖完整消息 authority。
5. 本地工作与延迟回收
页面通过常驻 controller 持有工作租约,报告以下同步事实:
- outbox 条目;
- 附件上传与粘贴占位;
send()同步在途;- enqueue 未落定;
- 已出队但消息尚未回流;
- composer 附件托盘。
页面聚合租约只反映当前组件内的同步状态。send() 的异步发送作用域和每一条 outbox
dispatch 都会另外获取一份 active 租约,并只在各自的 finally 中释放;因此页面卸载
释放聚合租约时,不会把仍在等待上传、enqueue 或对账的异步工作误判为已结束。
Store 另外保护:
inputProjection.pendingQueue;- 运行中状态与 maker turn;
- pending interaction;
- regular 的文本草稿、富文本草稿和引用。
回收请求若遇到保护事实,只记录 pending,不在页面 effect 内轮询。页面卸载后租约仍按 cleanup 收口;最后一份租约释放或 Store 保护状态归零时,在 microtask 中重试。若期间 重新聚焦,新 generation 会取消旧 pending reclaim。
6. 窗口与预算
6.1 单会话窗口
- schedule 当前详情始终保持一个 80 条软窗口,不提供“加载更早”;
- regular 在详情内仍可加载历史,离开详情时压回 80 条;
- 以下行优先保留,必要时可使软上限略微超出:
mobile-system-*本地系统卡;- 未落库的 live assistant;
- 尚无服务端 id 的乐观 user 行。
6.2 regular 全局预算
regular 完整消息的软预算为:
- 约 800 条;或
- 估算 64 MiB。
任一维度超限时,按最近访问顺序淘汰非保护任务。字节估算包含 content、agentMeta、 systemCardData 与固定结构开销,只用于量级保护,不作为精确内存统计。
LRU 只删除内存消息与相应连续性结论,不删除 AsyncStorage 缓存。
LRU 是整窗淘汰:只要某个候选任务仍含本地系统卡、乐观用户行或未落库 assistant 行, 就跳过整个任务,避免把不可重取行单独留下后又被缓存 hook 误当成完整窗口落盘。
regular 离场压窗和 LRU 淘汰都会释放 live plan、task update、parked task update 与 input projection,并抬升 input projection authority epoch,阻止离场前启动的慢查询污染下次打开。
7. 缓存语义
缓存与内存驻留分离:
- regular:可读取、去抖写入最新窗口;
- schedule:不读取、不写入,识别后定点删除存量缓存;
- 空内存快照不再自动等价为删除磁盘缓存;
- 远端删除、权威空窗与 schedule 回收使用显式删除;
- 同一缓存 key 的 set/remove 串行,避免较早开始的写在较晚删除后完成并复活正文;
- 登出全清期间禁止铸造新缓存写权,避免
getAllKeys取完快照后的卸载 flush 创建漏删 key; - hydrate、debounce 回调和卸载 flush 都在提交前二次检查 retention;
- 缓存归一化同样保护窗口外的
mobile-system-*。
8. 页面行为
- focus 与 AppState 分别上报,二者都满足才授予可见 authority;
- 从后台回前台时 regular 与 schedule 都重新登记当前详情并补一次同步;
- schedule 隐藏“加载更早”入口,并拒绝程序化翻历史;
- 页面不自行拼接消息清理步骤,只上报生命周期与本地工作事实。
9. 验证矩阵
自动化覆盖:
- blur → refocus 后旧代际拒写、新代际可写;
- 旧 cleanup 不撤销新 authority;
- 页面卸载后最后一份工作租约释放仍能回收;
- 重新聚焦取消旧 deferred reclaim;
- schedule 失焦归零且迟到 push 不复活;
- regular 离场拒绝旧订阅与旧流式 flush;
- 从未打开的 regular 重连补读可写;请求期间首次进入、已离场 regular 与从未打开的 schedule 均拒绝旧补读;
- pending queue 排空触发补回收;
- regular 压窗保留本地系统卡;
- regular LRU 保护当前详情并压回约 800 条;
- async send 与 outbox dispatch 使用跨页面卸载的独立工作租约;
- regular 离场/LRU 释放详情投影并拒绝旧 projection 回写;
- regular LRU 跳过仍含不可重取行的整个任务;
- source 晚到改判 schedule 后压窗并清缓存;
- schedule 删除消息不持久化剩余正文;
- regular LRU 不删除磁盘缓存;
- 缓存写/删乱序最终以删除为准;
- 显式空窗、内存已淘汰后的删除 push、登出全清都不会被旧在途写复活。
已执行(2026-08-15):
pnpm --filter mobile test:301 个测试文件通过、1 个跳过;3514 个测试通过、9 个跳过;pnpm --filter mobile test:scope:通过;pnpm --filter mobile test:smoke:2 个测试文件、2 个测试通过;pnpm --filter mobile run --if-present typecheck:通过;pnpm test:unit:related:Mobile related unit 通过。
模拟器验证项目见架构文档的交付检查清单;未执行的项目必须在 PR 中如实说明。