qihuaiflow/RELEASES.md

七虎 AI PaaS 平台 - 迭代发布与回滚记录 (RELEASES)

本文件是平台迭代的单一事实来源(single source of truth)之一，配合 Gitea 提交历史与本地 Docker 镜像 tag 使用。 每次"固化(freeze)"都会做四件事：

1. git commit 当前源码 + 打 annotated tag (版本号 + 说明 + 简述)
2. docker commit 当前容器为新镜像 + 打同名版本 tag
3. 把上一版 with-deps 镜像保留为 backup- 以便回滚
4. 在本文件追加一条版本记录 回滚只需：git checkout + docker tag qihuaiflow:with-deps + docker compose up -d

版本列表 (新 -> 旧)

v2026.07.12-recover (2026-07-12)

• Git HEAD: ab9cf55
• 镜像: qihuaiflow:v2026.07.12-recover (= 7a6de5d0cb23)，同时 qihuaiflow:with-deps 指向它
• 备份: qihuaiflow:backup-2026.07.12-prerecover (= c8192c61f3e9，恢复前的镜像)
• 说明: 事故恢复版本。修复 5d7f32d 误删 104 文件导致重建容器后功能丢失。
• 简述:
  • 恢复 chat.py 前台 Auto 模型路由策略(detect_media_intent / _generate_media，来源 5d7f32d^: f5968d0 / 4c37274)
  • 恢复 models.py capability-defaults 默认模型 API 路由(GET/PUT /app/api/admin/models/capability-defaults)
  • 重建前端 dist(含 ①能力默认模型UI ②技能市场URL导入+各hub ③个人微信clawbot对话窗合并 标记)
  • agnes 图像/视频模型在 DB 启用且经香港代理连通(agnes-ai.com=200 / apihub.agnes-ai.com=301)
• 回滚: git checkout v2026.07.11-baseline ; docker tag qihuaiflow:backup-2026.07.12-prerecover qihuaiflow:with-deps ; docker compose up -d

历史可用功能提交 (Gitea 中完好，可随时取回，未丢失)

• 27ba91a feat(admin): 移除后台 Agent/技能/MCP 手动创建，改为仅 URL 导入/AI开发/AI安装
• d62848e feat(chat): 支持 AGNES 图像/视频模型(_generate_media + 前端媒体渲染 + nginx 600s)
• 75a708a / 62f3986 / 2eeaf1d feat: 个人微信每用户独立绑定 / 对话历史持久化+多轮上下文 / iLink规范对齐
• 4c37274 feat: 补全11种能力 + 按能力指定默认模型 + Auto自动模式
• f5968d0 feat: Auto模式按意图路由视频/图像/语音生成模型
• 7daeae6 Phase4 IM Bot 集成 ; 46fb670 G5 platform_bridge MCP ; 891d1ce G5 Local Agent/Privacy

重大事故

• 5d7f32d (2026-07-11): "refactor: sync running-container source back to repo ... remove 104 stale files" - 误删 104 个迭代开发文件，导致重建容器后丢失近期功能。根因：迭代只 docker cp 进容器、未回灌 git/镜像。 后续从 5d7f32d^ (误删前最后一个完整提交) 取回。教训：每次迭代必须走 freeze 闭环。

v2026.07.13-recover — 确定性恢复（源=git HEAD=5d7f32d^ 规范树，逐文件哈希对齐）

• 时间: 2026-07-12 16:48
• 范围: 同步 git 完整规范源进运行容器，确定性重建前端 dist；后端+前端源码与 git HEAD 零偏差(149 文件逐 md5 比对一致)
• 含功能: ①大模型库按能力默认模型 ②前台 Auto 意图路由 ③AGNES 图像/视频模型 ④个人微信 ClawBot IM Bot ⑤技能市场改 URL/AI 导入 ⑥全站 UI 重构(Phase C1-R/C2/C3/C4)+浅色主题
• 回滚: git checkout v2026.07.13-recover && docker tag qihuaiflow:backup-v2026.07.13-recover qihuaiflow:with-deps && docker compose up -d

v2026.07.12-ui-recover — UI 优化 + 微信 IM Bot 对话窗合并恢复

• 恢复来源：本地容器快照 _container_live + 顶层 _*.tsx（7/11 重建前从运行容器拉取）
• 恢复文件：ChatPage.tsx(IM Bot 对话窗合并)、MarketPage.tsx/css(技能市场UI)、 AdminLayout.tsx(全站UI优化)、Dashboard.tsx(全站UI优化)、api/index.ts(IM Bot API客户端)
• 根因：这些 UI/IM 改动只在容器里 docker cp，从未 commit git；docker cp 从 git 恢复时 用缺 UI 的 git 版本覆盖了容器里改好的 UI。
• 已回灌 git + 冻结镜像 v2026.07.12-ui-recover（=with-deps）。上一版备份 backup-v2026.07.13-preui。