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

> 本文件是平台迭代的单一事实来源(single source of truth)之一，配合 Gitea 提交历史与本地 Docker 镜像 tag 使用。
> 每次"固化(freeze)"都会做四件事：
>   1) git commit 当前源码 + 打 annotated tag (版本号 + 说明 + 简述)
>   2) docker commit 当前容器为新镜像 + 打同名版本 tag
>   3) 把上一版 with-deps 镜像保留为 backup-<date> 以便回滚
>   4) 在本文件追加一条版本记录
> 回滚只需：git checkout <tag> + docker tag <backup> 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 闭环。