lhk229
cc88564d4a
catch 此前对所有错误一视同仁：标 failed、finally 解锁、按钮恢复可点。transport 异常、abort 和 120 秒客户端超时因此被谎报成明确失败，而服务端此时很可能已经完成 OSS PUT、asset object、project resource、账号素材和画布回填，只是响应没回来。用户 按提示重试就再造一整份。这违反本功能自己立下的契约：结果未知时先 GET 权威快照， 由用户显式决定是否再次执行。 判别依据是 ApiClientError 只在拿到 Response 时由 buildApiClientError 构造， transport 异常、AbortError 和 TimeoutError 在重试判定后原样抛出。已知结果不发 对账 GET，避免每个 400 都多打一次权威读取。 未知结果先 loadEditorProject，再按占位是否存活分流：占位已被 completion 消费掉 说明这次其实成功，按快照收口并写入正常的 perfect-pixel 历史；占位仍在说明画布没 收到结果，同步快照但不写历史，文案要求先核对素材库再决定是否重试——持久化是非 事务的，对象和素材可能已落库而画布回填未完成。对账 GET 本身失败时给独立文案， 不退回谎报。 既有用例 keeps a failed perfect-pixel placeholder 原本用裸 Error 表达「服务端识别 不到网格」，语义不准且会误入对账路径，改为 ApiClientError。harness 新增 dialog-error 输出，否则对账文案不可观测。 刷新后停在 generating 的占位仍无自动收口，需要先给 dialog 增加「无 durable job 的 inline 链路」标记才能在 hydration 后对账，改动面大于本次，单独立项。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
文档总览
docs/ 只把当前融合文档和仍在维护的专题文档作为实现依据。旧创作模板、旧创作入口及其专属服务文档仅保留为历史材料，不再要求继续实现或兼容。
必读入口
团队长期约定、决策、流程和排障摘要统一从 项目记忆入口 读取。代码、当前融合文档与项目记忆冲突时，以代码和最新融合文档为准。
当前专题
图片编辑器与 Agent
- 图片画布编辑器 MVP 接入方案
- 图片画布编辑器前端拆分计划
- 画布 Agent 对话面板
- 画布 Agent 会话消息存 OSS
- 图片画布撤销范围与操作提示方案
- 浏览器内 AI Web 工程沙箱预览
- AI Web 工程 Runner 安全模型
后端与公开数据
- 外部生成 Worker 化方案
- BgFilter 受限资源调度方案（同步内部 HTTP 原地等待版）
- 统一公开作品 Read Model 设计
- 外部 OpenAPI 与 API Key 接入方案
- SpacetimeDB 连接池取消安全
后台、宿主壳与运维
- Dashboard 运营看板方案
- 后台多账号与 Tab 访问权限
- 宿主壳能力统一协议
- Expo React Native 与 Tauri 宿主壳方案
- Pingora 独立网关试点
- 本地 SSH 服务器管理面板
测试与协作
历史文档边界
- 旧创作模板、旧创作入口、旧运行态和旧素材生成方案不再从本页索引，也不再作为修复目标。
maincloud、旧 Node/Express/PostgreSQL/Go 后端和人工spacetime --root-dir口径均已废弃。- 历史文档不得覆盖当前融合文档、代码契约或
docs/project-memory/shared-memory/decision-log.md中更新的决策。
命名规则
后续新增 Markdown 文档文件名使用 【标签名】中文标题-日期.md。历史文件不做无关批量重命名；本次涉及的旧文档可直接删除或在当前入口中取消引用。