fix(canvas): 画布同步 - 素材缺失时可强制覆盖并恢复文本与连线顺序

云端缺少素材时可用本地版强制覆盖，只清失效媒体引用。文本节点不再把资源地址当正文，合并时保留引用槽位顺序。

docs/content/docs/progress/pending-test.mdx

@@ -5,6 +5,19 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 
 # 待测试
 
+## 画布素材缺失时的本地强制覆盖
+
+- 已实现：云端保存返回 `canvas_history_resources_missing` 时，画布同步面板提供“用本地版强制覆盖云端”。操作会先保存本地草稿，探测资源状态，清理确认已删除或不存在的资源定位，保留节点布局、提示词和连线后再提交；普通自动保存仍执行完整素材校验。
+- [x] 专项测试覆盖嵌套资源定位收集、失效媒体字段清理、素材绑定移除以及画布性能回归；前端构建、后端画布/处理器/仓储测试通过。
+- [ ] 使用已登录浏览器打开具体画布，点击强制覆盖并刷新确认：失效图片节点仍保留为可重新上传的空节点，本地草稿可从版本记录恢复。
+
+## Agent 只读循环软收敛
+
+- 已实现：缓存只读结果重复回放、图片同版本重复识别或本轮只读快照达到累计上限时，记录 `read_loop_guard` 并在下一次模型请求暂时收起只读工具；运行保持 `running`，仍可回复、提问或执行获准写操作，不再由该护栏写入 `run_failed`。
+- 已调整：能力错误提示优先复用本回合 `model_list`，只有素材、模式或模型选择变化后才重新查询，避免纠偏消息诱发重复读取。
+- [x] `internal/app` 专项测试覆盖缓存回放、跨参数读取上限、图片重复识别、Pi 请求工具过滤、批量读取回执和运行状态；完整 `go test ./internal/app` 通过。
+- [ ] 在真实 Agent 会话中复现长时间重复读取，确认模型使用已有结果收束、写操作和 `ask_user` 仍可用，并观察护栏事件与费用变化。
+
 ## Agent 画布权限与大事件审批
 
 - 已修复：权限查询使用 `canvas_projects`；大画布增量超过事件上限时改为完整快照刷新通知，避免审批执行事务回滚。