chore: rebuild release package

.planning/runtime-image-send/progress.md

@@ -0,0 +1,116 @@
+# 进度记录：排队与运行中图片发送
+
+## 2026-07-17
+
+### 阶段 1：核对附件生命周期与现有改动边界
+
+- **状态：** complete
+- 已完成：
+  - 读取 `planning-with-files`、`todo-list-csv` 与 Trellis 工作流。
+  - 运行 session catchup 并检查工作树，确认存在其他活跃任务及重叠文件改动。
+  - 使用 `codebase-memory-mcp` 定位队列、普通发送、steer 和 Codex App 输入构造函数。
+  - 使用本机 Codex 0.144.1 Schema 验证 `turn/steer` 协议接受 `localImage`。
+  - 确认 `resolveMessageAttachments` 提供服务端元数据解析、文件存在性和过期校验，可直接复用于 steer。
+  - 确认会话持久化已有统一的 `attachments` 归一化入口。
+  - 核对目标函数所在 diff，确认可做局部补丁且不会覆盖当前主题与回归改动。
+  - 确认 mock 已能把 `localImage` 反映到 steer 输出，测试可直接断言图片文件名。
+- 已创建：
+  - `.planning/runtime-image-send/task_plan.md`
+  - `.planning/runtime-image-send/findings.md`
+  - `.planning/runtime-image-send/progress.md`
+  - `.trellis/tasks/07-17-runtime-image-send/` 下的 PRD、技术设计、研究和代理上下文
+
+### 阶段 2：补充失败回归测试
+
+- **状态：** complete
+- 已完成：
+  - 新增 `runtime-image-send` 定向回归目标。
+  - 覆盖前端队列附件契约、成功 steer 图片、stale fallback 图片与历史持久化。
+  - 审阅并修正 mock 图片 marker：协议断言使用服务端附件 ID，历史断言保留原始文件名。
+
+### 阶段 3：运行目标回归确认失败
+
+- **状态：** complete
+- 已执行：
+  - `timeout 60s node scripts/regression.js --target runtime-image-send`
+- 结果：3.8 秒退出，状态码 1；active steer、stale replacement、前端队列契约均按预期失败。
+
+### 阶段 4：实现前端附件传递
+
+- **状态：** complete
+- 已实现：
+  - 队列附件快照、纯图片校验、摘要、删除清理与出队发送。
+  - 运行中插入附件气泡、WebSocket 发送和 composer 清空。
+  - 卡片编辑保留附件，正常出队不误删上传记录。
+- 阶段验证：
+  - `node --check public/app.js` 通过。
+  - 定向回归中的前端静态契约已通过，剩余失败均为后端。
+
+### 阶段 5：实现后端 steer 附件链路
+
+- **状态：** complete
+- 已实现：
+  - `handleMessage` 向 steer 传递已解析附件和去 path 的持久化附件。
+  - active steer、纯图片、历史保存和 stale replacement 复用附件。
+  - 最多等待 2 秒获取 ready turn，并在持久化前重载最新 session，修复两个竞态。
+- 阶段验证：
+  - `node --check server.js` 通过。
+  - 代理运行定向回归已通过。
+
+### 阶段 6：运行目标回归和静态检查
+
+- **状态：** complete
+- 已通过：
+  - `node --check public/app.js`
+  - `node --check server.js`
+  - `node --check scripts/regression.js`
+  - `timeout 60s node scripts/regression.js --target runtime-image-send`（4.9 秒）
+  - `timeout 60s node scripts/regression.js --target codexapp-stale-running`（2.9 秒）
+- 已通过：
+  - `timeout 60s node scripts/regression.js`（完整回归）。
+
+### 阶段 7：审查差异并修正问题
+
+- **状态：** complete
+- 已完成审查：
+  - 修复 active steer 失效附件只返回普通 error、用户气泡停在 pending 的问题。
+  - error/status 现在带 sessionId/clientMessageId，失败输入不持久化。
+  - 恢复普通消息“校验通过后才取消容量重试”的原有顺序，避免无关语义变化。
+- 主代理复验：
+  - 三个修改文件的 `node --check` 通过。
+  - `runtime-image-send` 定向回归通过。
+  - 完整回归通过。
+
+### 阶段 8：检查会话状态并安全重启服务
+
+- **状态：** in_progress
+- 待执行：
+  - 查询当前会话列表并排除本对话。
+  - 无其他 running 会话时重启并健康检查；否则暂缓。
+
+## 测试结果
+
+| 测试 | 预期 | 实际 | 状态 |
+|------|------|------|------|
+| 尚未执行 | - | - | 待执行 |
+| 定向回归红灯 | `--target runtime-image-send` | 三类缺口失败 | 三类缺口失败，3.8 秒 | ✓ |
+| 定向回归绿灯 | `--target runtime-image-send` | 通过 | 通过，4.9 秒 | ✓ |
+| stale-running 回归 | `--target codexapp-stale-running` | 通过 | 通过，2.9 秒 | ✓ |
+| JavaScript 语法 | 三个修改文件 `node --check` | 通过 | 全部通过 | ✓ |
+| 完整回归 | `timeout 60s node scripts/regression.js` | 通过 | Regression checks passed | ✓ |
+
+## 错误日志
+
+| 时间 | 错误 | 次数 | 处理 |
+|------|------|------|------|
+| 2026-07-17 | Trellis 自定义代理 TOML 路径不存在 | 1 | 改用标准协作代理并显式传递任务文件与规范路径 |
+
+## 5 问恢复检查
+
+| 问题 | 回答 |
+|------|------|
+| 当前在哪？ | 阶段 8，检查会话并安全重启 |
+| 接下来去哪？ | 先补失败回归，再做前后端最小实现 |
+| 目标是什么？ | 排队与运行中插入均支持图片附件 |
+| 已掌握什么？ | 见 `findings.md` |
+| 已完成什么？ | 见上方进度记录 |