v0.1.1-beta

相对上一版

对比基准：v0.1.0-beta（554ce8a）→ 本版 main（f48b390，含 #136–#142）。

统计：约 19 个提交；70+ 个文件变更（相对上一 tag 点，含 pin）。

镜像由 v* tag 触发 publish-image / publish-gateway / publish-sandbox 推送到 GHCR。
start.sh 默认已钉 *:0.1.1-beta（#142）。
三件套全绿前勿宣称 sandbox 版可用。

---

功能（Features）

Token / 项目设置

• Token 统计支持按模型区分，并含 ACP_BRIDGE_MODEL 弱键回填（#139）
• 项目「沙箱环境变量」支持单行启用/停用开关（#138）

评审 / 预览

• 人工审批页恢复 HTML 主产物「窗口放大查看」（fillParent/inline 路径）（#141）
• human_gate 冷会话静默为普通审批，不再展示 ReAct 不可用提示（#137）

审计 / UI

• 升级共用 Pagination，并接入项目审计页（#140）
• Run 筛选触发标签左对齐（#136）

---

基础设施

• Pin 默认 GHCR 到 0.1.1-beta（#142）

v0.1.0-beta

相对上一版

对比基准：v0.0.4-beta（4a26b67）→ 本版 main（554ce8a，含 #113–#135）。

统计：约 30+ 个提交；116 个文件变更（相对 tag 点，含 pin）。

镜像由 v* tag 触发 publish-image / publish-gateway / publish-sandbox 推送到 GHCR。
start.sh 默认已钉 *:0.1.0-beta（#135）。
三件套全绿前勿宣称 sandbox 版可用。

---

功能（Features）

评审 / 门禁

• 统一 human_gate 与 app_preview 为「确认并流转」复审流，去掉 Approve/退回双按钮语义（#130）
• app_preview 等待态改为纯 ReAct 复审，取消 Gate 动作分支（#126）
• 工作流强制同项目 skill_profile Agents（#124）
• Agent 名称支持 Unicode（#123）

澄清 / 流式 / 预览

• 平滑流式追赶展示 + 思考摘要状态（生成中/已完成/已中断）（#129）
• 澄清历史附图 AppModal 预览（#131）
• 完成态单一 relTime 通道（footer 保留、底部时间隐藏）（#128）
• 硬刷新 / WS 重连后续上流式对话（#134）
• 桌面 HTML 预览 fillParent + 60vh shell 上限，避免短页塌缩留白（#133）

文案 / 上手

• 中英文「PM Leader」展示改为「项目管理 / Project Management」（#122、#132）
• 简化「快速上手·轻量」为 draft 连线（#118）
• 通知页文案人类友好化（#120）

---

修复（Fixes）

• CAPA A2–A8：MCP Args 锁定、可观测性与 outcome 拆分（#119）
• i18n：memory-store convention 占位符转义，避免 SyntaxError: 7（#125）
• Sandbox Console：IDE/ACP iframe 懒挂载 + 日志对比度（#113）
• CI sandbox：关闭 GH runner 上的 CN apt 镜像，并加 GHA Docker cache（#127）
• CI：ci-sandbox static-js setup-node 对齐 v7/Node 24（#121）

---

基础设施

• Release 栈数据落到 .localdata bind mounts（#114）
• Pin 默认 GHCR 到 0.1.0-beta（#135）

v0.0.4-beta

相对上一版

对比基准：v0.0.3-beta（c1da13a）→ 本版 main（含 #109 + #110 + #111）。

镜像由 v* tag 触发 publish-image / publish-gateway / publish-sandbox 推送到 GHCR。
start.sh 默认已钉 *:0.0.4-beta。
三件套全绿前勿宣称 sandbox 版可用。

---

功能（Features）

空项目上手

• 空项目首次上手引导：五步向导 + bootstrap 五 Agent +「快速上手·轻量」；默认 well-known Heroku git（#109）

---

修复（Fixes）

• 修复 GHCR 镜像中 onboarding go:embed workspace 为空（.dockerignore 误排除 onboarding_embed/**/*.md），确认步不再报 walk embed workspace … file does not exist（#111）

---

发布配套

• Pin 默认 GHCR 到 0.0.4-beta（#110）

v0.0.3-beta

2026-07-28 重打 tag：v0.0.3-beta 已从 d75e1f0 挪到 c1da13a（含 #107 默认镜像钉 0.0.3-beta、#108 钉 gopls@v0.21.1 + CI 四 provider 完整构建）。已重新触发 publish-image / publish-gateway / publish-sandbox；三件套全绿前勿宣称 sandbox 版可用。## 相对上一版

对比基准：v0.0.2-beta（4cdb5ae，2026-07-26）→ 本版 main（d75e1f0，2026-07-28）。

统计：约 43 个提交、#62–#106 区间已合并变更。

镜像会由 v* tag 触发 publish-image / publish-gateway / publish-sandbox 推送到 GHCR。
注意：打 tag 不会自动改 start.sh / .env.example / compose.release.yaml 默认镜像版本（当前仍指向 0.0.2-beta），需另开 PR 升到 0.0.3-beta。

未纳入本版：无（open PR 为空）。

---

功能（Features）

PM / MCP / 组织

• PM MCP：产物全文分页读取 + 复审 ReAct 提交（普通 reply / 可选 force）（#90）
• PM MCP：pm-agent-fs 可读组织架构与下属 Agent workspace 文件（#100）
• 门禁可自动唤起 PM 代审（#72）

通知 / IM

• Run waiting_human / failed → QQ 可配置推送（P0）（#80）
• Run→QQ 通知文案模板可配置（#98）

审计 / Token / Board

• 项目审计轨迹（Audit Trail）（#73）
• 审计：去掉 new badge；Type→resource 级联筛选（#74）
• 审计 Run 模式 Demo（#75）
• PM Token 统计 Board（#81）
• 结构化产物预览支持导出 PNG/PDF（#68）

标签 / 筛选

• Run 标签筛选（#91）
• 标签筛选交互重做（共享 TagFilter）（#99）

UX / 控件

• 统一方型 AppSwitch（#63）
• 澄清会话对齐沙箱队列 / 流式 / Cancel + 刷新续传（#92）
• 复审会话对齐沙箱队列语义（#77）
• app_preview：真脱钩保活 + set_preview 即进复审 ReAct（#105）

Release / 沙箱镜像

• release 栈：Agent /app/data 持久化 + 按 acpBackend 多镜像（默认不再全局强制单一 sandbox）（#106）

文档

• 双语 README 围绕 harness 叙事重写（#95）

---

修复（Fixes）

澄清 / 审批 / 流式

• 澄清 busy 对话面消除空气泡（C 档三态）（#94）
• 澄清进入时强制贴底（#76）
• 审批/澄清硬刷新续流与四阶段流式 UX（#102）
• 审批预览不再被 noisy softRefresh 闪烁（#78）
• Run 列表刷新中仍可点击进入详情（#88）

移动端 / 布局

• Token 统计 / 项目详情 Tab 窄屏布局（#65）
• Run 详情移动端单栏时间线，避免「Run 汇总」被裁切（#82）
• 审计面板移动端布局（#104）
• 官网 Approve Demo 框选左上→右下与 NW 指针（#70）
• hero workflow 窄屏横向滚动（#62）

交互性能 / 剪贴板

• 削减 P0 路径 INP（canvas / markdown / paint-first）（#71）
• 沙箱复制在 HTTP/内网可用（#67）
• CI：web merge gate 加固、e2e:ci 扩展、clipboard HTTP fallback（#69）

文案 / 视觉

• 中文通知策略「关闭」文案（#96）；英文 modeOff → Off（#103）
• 永久隐藏 PM Leader Studio 记忆迁移引导条（#97）
• PM Token rank/trend 对齐 workflow 紫色；消除 12PM34 伪影（#93, #101）

安全 / 依赖 / CI

• CodeQL 残留告警清理（#66）
• golang.org/x/net → v0.57.0（CVE-2026-25680）（#89）
• Dependabot Go modules 批量升级（#84）
• gateway Dockerfile 升至 Go 1.25；PR 冒烟构建拦住镜像基线漂移（#85, #86）

性能 / 其它

• 产物列表查询省略 Content（#79）
• 钉默认 GHCR 镜像到 0.0.2-beta（#64，随本 tag 基线一并纳入）

---

升级注意

1. 拉取本版镜像：ghcr.io/cocofhu/approving:0.0.3-beta 等（publish 完成后可用）。
2. 升级 release 栈时：若旧 .env 仍写有 SANDBOX_IMAGE=...cursor...，./start.sh 会把它当作全局强制；要按 backend 分流请注释掉该行。
3. 首次挂载空的 /app/data 命名卷后，此前写在容器可写层的 Agent 配置可能一次性不可见（预期迁移缺口）；此后请勿 docker compose down -v。

v0.0.2-beta

相对上一版

对比基准：v0.0.1-beta（ccd3c3f，2026-07-24）→ 本版 main（4cdb5ae，2026-07-26）。

统计：约 161 个提交、#1–#61 区间已合并变更（含直接 push 的文档/启动脚本调整）。上一版仅有 tag、无 GitHub Release 页面；本版起补全 Release Notes。

镜像会由 v* tag 触发 publish-image / publish-gateway / publish-sandbox 推送到 GHCR。
注意：打 tag 不会自动改 start.sh / .env.example 默认镜像版本（当前仍指向 0.0.1-beta），需另开 PR 升到 0.0.2-beta。

未纳入本版（仍开放）：

• #62 fix(docs): hero workflow 窄屏横向滚动
• #63 feat(web): 统一方型 AppSwitch

---

功能（Features）

Run / 执行与观测

• 支持删除已完成、失败、已取消的 Run；Run 列表增加删除与三态操作列（#2, #21, #38）
• Run 列表支持按开始时间 / 优先级服务端排序（#28）
• Trigger 收敛为 manual | api | pm_mcp 白名单（#22）
• 可从列表/详情取消 queued / running / waiting_human 的 Run（#10）
• 执行时间线展示逐步与整次 Token 用量；Run 后 ReAct review 保留 Token（#4）
• 执行统计面板展示 Token KPI；紧凑 tip，并修复主题色（#29, #42, #61）
• 早期节点失败时暴露可读失败原因（#37）
• 测试节点增加 plan_coverage 适配门禁（#35）

项目 / Board / Token

• 项目列表与详情展示 Workflow Token 汇总；悬停可见 Token 明细 tip（#30, #40）
• Board Token 统计与趋势图（Chart.js，修复 SVG 拉伸）（#41, #60）
• 项目删除入口从 header 移到 meta footer（#48）

Agent / 工作流编辑

• 新建 Agent 引导改为 5 步向导（#52）
• Agent 重命名级联更新工作流中的 skill_profile 引用（#27）
• Agent Studio：窄屏启用 Data 页；组织树叶子隐藏 reportsTo 副标题（#24, #25）
• 工作流编辑器工具栏可直接改 description（#57）
• 项目沙箱环境允许官方 ACP / Cursor API Key（#8, #14）

PM / 澄清 / 门禁

• PM Leader 消息改为尾窗 + 上滑懒加载（#18）
• ClarifyChat 增加贴底未读 FAB（#33）
• 多选澄清自动前进时选中全部 recommended 选项（#6）
• 审批后待办收件箱 UI 收敛，避免陈旧覆盖（#20）
• 屏蔽虚假进度 citation，并拆分 Run 加载错误（#36）
• proposal_select auto_confirm 时回收上游 park session（#12）
• 项目详情页可删除 cron 任务（#56）

IM / 渠道

• 会话忙时 IM 消息按 conversation 排队（#49）
• IM Reply/Work 统一 QQ 出口 + cron 推送队列（#50）

Sandbox / Gateway

• Docker 沙箱暴露 PID1 日志（六态 live/archived UI）（#23）
• K8s driver 支持 sandbox logs，并补齐 pods/log RBAC（#44, #59）
• AgentChat 队列与输入外框改方角（#16）
• 通用沙箱镜像预装 GitHub CLI（#1）

定时任务

• cron next_run_at 以 UTC 持久化，修复 SQLite 到期比较约晚 8h（#19）

官网 / 文档站

• 静态项目站 + Pages 发布；自定义域名根路径资源修复（#43, #46）
• 文档站英文 /en 镜像与语言切换；Approve 注解跑马灯 Issue 徽章修复（#51, #54, #58）
• README 品牌文案对齐宣传站；覆盖率徽章（server/web/gateway）（#7, #47, #53）
• 根目录 AGENTS.md 贡献约定（#31）
• 双 Run 失败诊断基线文档（#39）

---

修复（Fixes）

• submit_mr：已有/已合/无 diff 的 MR 视为幂等成功（#13）
• React：pending ask_question 不被 OutcomeRetry 误杀（#17）
• zh-CN 墙钟类文案改为可读时长标签（#26）
• Demo DATA key 引号修复，恢复 page.html 交互
• CodeQL alerts #1–#23 清理（#55）
• npm audit high 清零并加固 security 扫描（#45）

---

CI / 质量 / 安全

• 常开 CI gate（分支保护）；path-filtered ci-gateway / ci-sandbox（含 gh/glab）（#1, #5）
• server 核心包覆盖率门禁 90%；web Lines 覆盖率门禁 + README 徽章（#9, #11）
• Go/Web 首轮静态检查；web 关键路径 Playwright e2e 进 CI（#15, #32）
• 最小 security 扫描基线：CodeQL / npm audit / gitleaks（#34）
• GitHub Actions 升级到 Node 24 major（#3）
• 新鲜安装默认不再灌 sample seed；./start.sh 默认拉 GHCR 已发布镜像

---

镜像（打 tag 后由 Actions 发布）

镜像	Tag
ghcr.io/cocofhu/approving	0.0.2-beta
ghcr.io/cocofhu/sandbox-gateway	0.0.2-beta
ghcr.io/cocofhu/universal-sandbox-*	0.0.2-beta

（docker-metadata 对 v0.0.2-beta 生成 semver {{version}} = 0.0.2-beta；含 - 预发布标记时不会推 latest。）

---

升级提示

1. 等待本 tag 的 publish-* workflow 全部成功。
2. 将本地 / 部署环境镜像改为 *:0.0.2-beta（或临时 export APPROVING_IMAGE=... 等）。
3. 仓库内默认版本（start.sh / .env.example）仍为 0.0.1-beta，需要的话再说一声我开 PR 升默认版本。