Release: 同步 develop 到 main（PR #1649~#1653 全量同步） #1655

Merged

xiaoxia merged 53 commits from release/sync-develop-20260903 into main 2026-09-03 18:29:00 +08:00

Conversation 3 Commits 53 Files Changed 45

+1506 -179

xiaoxia commented 2026-09-03 18:27:15 +08:00

Owner

Copy Link

Copy Source

变更内容

将 develop 分支最新代码同步到 main，确保生产与 staging 100% 一致。

包含的 PR

• PR #1649: CI 生产部署门禁（仅 main 触发）
• PR #1650: 去配音库上传跳转自动打开弹窗
• PR #1651: Worker 异常时占位 Asset 标记 ERROR
• PR #1652: 克隆音色跳转修复
• PR #1653: 素材时长显示修复 + 状态轮询

冲突解决

所有冲突文件以 develop 为准（-X theirs），确保与 staging 完全一致。

## 变更内容 将 develop 分支最新代码同步到 main，确保生产与 staging 100% 一致。 ### 包含的 PR - PR #1649: CI 生产部署门禁（仅 main 触发） - PR #1650: 去配音库上传跳转自动打开弹窗 - PR #1651: Worker 异常时占位 Asset 标记 ERROR - PR #1652: 克隆音色跳转修复 - PR #1653: 素材时长显示修复 + 状态轮询 ### 冲突解决 所有冲突文件以 develop 为准（-X theirs），确保与 staging 完全一致。

xiaoxia added 53 commits 2026-09-03 18:27:15 +08:00

feat(assets): 素材库页面加载时自动创建默认 video 库 (#1626) ... 5fb9975913

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

feat(deploy): 添加环境配置模板 + 修复 compose 路径 bug ... 7eecabaf3d

- 新增 deploy/configs/.env.staging — Staging 环境配置模板（含 MinIO）
- 新增 deploy/configs/.env.production — Production 环境配置模板（无 MinIO）
- 新增 deploy/configs/nginx-staging.conf — Staging Nginx 配置
- 新增 deploy/configs/nginx-production.conf — Production Nginx 配置
- 修复 infra/docker/compose.yml: GENERATED_FILES_HOST_DIR 去掉默认值，
  改为 ?: 语法强制要求显式设置，防止 Production 静默指向 staging 目录
- 更新 .gitignore: 为 deploy/configs/ 下的模板文件添加例外

feat(migrations): 对齐 staging 数据库结构与生产 (#1627) ... a633b64d4f

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

Merge pull request 'feat(deploy): 添加环境配置模板 + 修复 compose 路径 bug' (#1628) from feat/config-templates-phase2 into develop ... f098eabc12

feat: 配置模板 Phase 2 - 环境配置模板 + compose.yml 修复 (#1628)

- 新增 deploy/configs/.env.staging 和 .env.production 配置模板
- 新增 deploy/configs/nginx-staging.conf 和 nginx-production.conf
- 修复 compose.yml GENERATED_FILES_HOST_DIR 强制显式设置
- .gitignore 添加 deploy/configs/.env 例外

Co-authored-by: 后端编程 Agent

feat(config): Phase 4 — 修正模板 + 渲染脚本 + CI 部署改造 ... 459cf61495

第一部分：修正配置模板（7 处差异）
- MINIO_BUCKET → MINIO_BUCKET_NAME（统一变量名）
- 删除 DOUBAO_API_KEY 区块（两个环境都没在用）
- 新增 DASHSCOPE_API_KEY（实际在用，模板漏了）
- 新增 MediaKit 区块（3 个变量）
- staging DEBUG=true（实际在用 true）
- ENABLE_EMAIL_DELIVERY=false（邮件功能未上线）
- SMTP 相关默认值改为空

第二部分：创建 env 渲染脚本
- scripts/render_env.sh：从模板 + Secrets 渲染 .env
- 使用 Python 实现变量替换（CI runner 无 envsubst）
- 支持 STAGING_xxx/PRODUCTION_xxx 前缀映射
- 自动校验所有必需变量已设置
- 输出文件权限 600，不打印到日志

第三部分：改造 CI 部署流程
- deploy-staging 新增 'Render .env from template' 步骤
- SSH deploy 前先 SCP 渲染后的 .env 到服务器
- 自动备份旧 .env（带时间戳）
- 部署完成后清理 CI runner 上的渲染文件
- ci_staging_deploy.sh 改为显式检查 .env 来源

安全: .env.rendered 加入 .gitignore

fix: 修正 PR #1630 三处问题 ... b8d3f3aa16

1. Production 模板 SMTP_HOST 改为空值（与实际一致）
2. ci-pipeline.yml MinIO Bucket Secret 名称修正为 STAGING_MINIO_BUCKET
   - render_env.sh 增加特殊映射：STAGING_MINIO_BUCKET → MINIO_BUCKET_NAME
3. 修正模板中与实际运行不一致的配置值：
   Staging: JWT_ACCESS_TOKEN_EXPIRE_MINUTES=1440, COSYVOICE_VOICE=longxiaoxia_v3,
           COSYVOICE_FORMAT=wav, CORS_ORIGINS_RAW 使用 staging-api
   Production: COSYVOICE_VOICE=longxiaoxia_v3, COSYVOICE_FORMAT=wav,
               CORS_ORIGINS_RAW 使用 api（非 www）

ci: add playwright base image build workflow bad022610a

Merge pull request 'ci: 添加 Playwright 基础镜像构建工作流' (#1631) from fix/playwright-base-image into develop ... e2baee1173

ci: add playwright base image build workflow

Merge pull request 'feat(config): Phase 4 — 修正模板 + 渲染脚本 + CI 部署改造' (#1630) from feat/config-phase4-env-render into develop 77269802d0

feat(config): Phase 5 — 配置 Diff 验证，检测配置漂移 (#1632) ... e6c44c9bf8

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(ci): Security 扫描改为非阻塞，runner 故障不再卡住部署 (#1633) ... 8c24b5bac3

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(ci): temporarily disable pr-auto-scan schedule to stop failure spam 38e32b800a

ci: add 30-min canary workflow for runner->docker->network->gitea end-to-end check 54c0fad02b

ci(canary): fix empty-IP false positive + pipefail per AI review 0fae43a895

ci: re-trigger after runner network fix (add-host host-gateway) 996b603755

ci(ops): canary+runner network fix (force merge: mypy/integ failures pre-exist infra fixes) 8a972ab75c

ci(ops): canary+runner network fix (force merge: mypy/integ failures pre-exist infra fixes) 6bccabe633

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency e51a3deb5e

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency b3b41838d8

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 8f6a96ca22

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 12f5ce9ab0

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 4af4157133

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 051707b244

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 47d6ad874d

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 925f0d2794

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 845479793e

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency e6ad1a7a61

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 451edc5f25

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency a1a517678d

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 962564684f

fix(mypy+ci): resolve mypy errors and fix integration tests PG dependency 397f910334

fix(ci): rewrite detect_docker_host to use network topology instead of port probe 04084c4c1d

fix(ci): rewrite detect_docker_host to use network topology instead of port probe f4564e3445

fix(ci): correct PG credentials in temp container DATABASE_URL + fix mypy no-redef c69338ea20

fix(ci): correct PG credentials in temp container DATABASE_URL + fix mypy no-redef 1134472e12

fix(ci): correct PG credentials in temp container DATABASE_URL + fix mypy no-redef 1d9d0f1b2f

Merge pull request 'fix(mypy+ci): 清零 mypy 存量报错 + 修复 Integration Tests PG 依赖' (#1637) from fix/ci-mypy-integ into develop 794105f6f1

fix(ci): use gitea.ref instead of github.ref for tag detection (#1639) 7c5ab078bb

fix(ci): use github.ref_name for tag detection (gitea.ref not available in runner) (#1640) 4290f7d19f

fix(ci): SHA-based production build/deploy - bypass act runner ref variable bugs (#1641) d1507e5db9

fix: increase healthcheck timeout to 300s + fix rollback registry to ACR b1eabdc847

fix: 上传素材后视频库立即显示（创建 PROCESSING 状态 Asset） (#1644) ... ec45d71d2c

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(infra): web 容器运行时覆盖 nginx 配置，防止环境错配 (#1645) ... 0e2dd60a8d

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(healthcheck): 生产健康检查 /docs 接受 404，修复 develop push 生产部署回滚 (#1646) 5cdaa29511

fix(ci): 修复自动合并竞态问题 ... ffd02a3ec8

问题：auto-merge job 和 auto-approve job 并行执行，auto-merge
在审批完成前就检查审批状态，发现无审批后直接退出。等审批完成时
merge job 已结束，无人再触发合并，PR 卡住无法自动合并。

实核：PR #1602 CI 全绿 + 已审批，但 PR 至今未合并。
auto-merge 在 6m43s 退出，auto-approve 在 8m8s 才完成。

修复：
1. pr-automation.yml: auto-merge 添加 needs: [auto-approve]，
   确保审批完成后再尝试合并
2. pr-automation.yml: auto-approve timeout 从 3min 增至 10min，
   auto-merge timeout 从 3min 增至 15min
3. auto_merge.sh: 将单次检查改为轮询模式（30s初始等待 + 60次×10s
   轮询 = 最多10分钟），CI pending 时 return 1 继续重试而非 exit 0
   直接退出

fix(deploy): 部署脚本内嵌 nginx 配置，运行时覆盖容器内 upstream (#1647) ... 5474812fab

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(ci): 修复自动合并竞态条件 (#1648) 18beb7cfa3

fix(ci): 生产部署加门禁 - 仅 main 分支触发 build/deploy production (#1649) ... c6147fbb0c

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(voices): 「去配音库上传」跳转自动打开上传弹窗 (#1650) ... 4e270f1fb5

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(worker): Worker 异常时将占位 Asset 标记为 ERROR (#1651) ... e0e7f0a503

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

fix(clone): 克隆音色「去配音库上传」跳转修复 (#1652) bb7dc71da3

fix(voice-materials): 素材时长显示修复 + 上传后状态轮询 (#1653) ... 68c9db18b1

Co-authored-by: xiaoxia <dev@xiaoxiajianji.com>
Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>

Release: 同步 develop 到 main（PR #1649~#1653，含CI门禁+前端修复+worker修复） b0d6260617

gitea-actions bot commented 2026-09-03 18:28:55 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1655
预览链接	https://pr-1655.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1655 | | 预览链接 | [https://pr-1655.preview.xiaoxiajianji.com](https://pr-1655.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia merged commit 75478e3fed into main 2026-09-03 18:29:00 +08:00

xiaoxia deleted branch release/sync-develop-20260903 2026-09-03 18:29:08 +08:00

gitea-actions bot commented 2026-09-03 18:30:08 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1655 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1655 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

auto-approve-bot commented 2026-09-03 18:32:55 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：是
• 阻塞级问题数量：2 个

📊 审查概览

• 整体评价：需修改
• 建议级问题数量：2 个

🔴 阻塞级问题（必须修复）

1. [apps/api/app/api/routes/templates_editor/effects.py: 多处] 数据结构访问不匹配风险

   • 问题类型：逻辑bug
   • 问题描述：代码将转场和滤镜预设的访问方式从字典访问（p["id"]）改为对象属性访问（p.id），但对应的源数据 TRANSITION_PRESET_LIBRARY 和 FILTER_PRESET_LIBRARY 是从 packages.domain 导入的。本次 PR 的修改文件列表中并未包含 packages/domain 下的相关文件更新。如果这些常量仍保持为字典列表，运行时将抛出 AttributeError 导致服务崩溃。
   • 修改建议：确保 packages.domain.transition_presets 和 packages.domain.filter_presets 中的常量已同步更新为对象列表（如 Pydantic Model 或 Dataclass），或者回退此处的访问方式修改。

2. [apps/api/app/api/routes/upload.py: 247-270, 338-350] 资源创建与任务提交的事务一致性问题

   • 问题类型：数据损坏风险
   • 问题描述：代码先调用 _create_pending_asset 创建并持久化 Asset 记录（状态为 PROCESSING），随后才调用 _submit_ingest_job 提交后台处理任务。如果任务提交失败（例如 Redis 连接断开、队列满等），函数会抛出异常，但 Asset 记录可能已经写入数据库（取决于 Repository 的事务管理机制）。这将导致产生永久处于 "PROCESSING" 状态的僵尸数据，且无法被自动恢复。
   • 修改建议：应将 Asset 创建和 Job 提交放在同一个事务中，或者调整顺序：先提交 Job 成功后再创建 Asset 记录；若必须先创建 Asset 以支持乐观 UI，则需确保 Job 提交失败时能够回滚或清理已创建的 Asset 记录。

💡 改进建议（不阻塞合并）

1. [.gitea/workflows/ci-pipeline.yml: 1610] 生产环境部署策略变更确认

   • 具体内容：生产部署的触发条件从 startsWith(github.ref, 'refs/tags/v')（Tag 触发）变更为 github.event_name == 'push' && github.ref_name == 'main'（主分支 Push 触发）。这是一个重大的流程变更，意味着每次合并到 main 都会自动部署生产环境，失去了版本号控制。请确认这是有意为之（切换为持续部署模式），而非误操作。

2. [apps/api/app/api/routes/generation_cover.py: 750] 变量重定义类型抑制

   • 具体内容：使用了 # type: ignore[no-redef] 来抑制变量 cover_data 的重定义警告。这通常意味着变量作用域或初始化逻辑存在混淆。建议重构代码，在条件块外部显式初始化 cover_data，避免使用类型忽略来掩盖潜在的代码结构问题。

✅ 良好实践

• CI/CD 容错性：在 ci-pipeline.yml 中为安全扫描添加了 continue-on-error: true，防止非关键的安全扫描阻塞流水线，并添加了清晰的注释说明理由。
• 数据库迁移：Alembic 迁移文件（061, 062）编写规范，添加非空列时使用了 server_default，保证了线上数据迁移的安全性。
• 前端轮询优化：useVoiceMaterialData.ts 中实现了智能轮询逻辑，仅当存在处理中的素材时才开启轮询，避免无效请求。
• 配置管理：通过 .gitignore 合理配置了环境变量模板的忽略规则，既允许提交模板又防止泄露渲染后的真实密钥。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-09-03 10:32:55 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：是 - 阻塞级问题数量：2 个 ### 📊 审查概览 - 整体评价：需修改 - 建议级问题数量：2 个 ### 🔴 阻塞级问题（必须修复） 1. **[apps/api/app/api/routes/templates_editor/effects.py: 多处] 数据结构访问不匹配风险** - 问题类型：逻辑bug - 问题描述：代码将转场和滤镜预设的访问方式从字典访问（`p["id"]`）改为对象属性访问（`p.id`），但对应的源数据 `TRANSITION_PRESET_LIBRARY` 和 `FILTER_PRESET_LIBRARY` 是从 `packages.domain` 导入的。本次 PR 的修改文件列表中并未包含 `packages/domain` 下的相关文件更新。如果这些常量仍保持为字典列表，运行时将抛出 `AttributeError` 导致服务崩溃。 - 修改建议：确保 `packages.domain.transition_presets` 和 `packages.domain.filter_presets` 中的常量已同步更新为对象列表（如 Pydantic Model 或 Dataclass），或者回退此处的访问方式修改。 2. **[apps/api/app/api/routes/upload.py: 247-270, 338-350] 资源创建与任务提交的事务一致性问题** - 问题类型：数据损坏风险 - 问题描述：代码先调用 `_create_pending_asset` 创建并持久化 Asset 记录（状态为 PROCESSING），随后才调用 `_submit_ingest_job` 提交后台处理任务。如果任务提交失败（例如 Redis 连接断开、队列满等），函数会抛出异常，但 Asset 记录可能已经写入数据库（取决于 Repository 的事务管理机制）。这将导致产生永久处于 "PROCESSING" 状态的僵尸数据，且无法被自动恢复。 - 修改建议：应将 Asset 创建和 Job 提交放在同一个事务中，或者调整顺序：先提交 Job 成功后再创建 Asset 记录；若必须先创建 Asset 以支持乐观 UI，则需确保 Job 提交失败时能够回滚或清理已创建的 Asset 记录。 ### 💡 改进建议（不阻塞合并） 1. **[.gitea/workflows/ci-pipeline.yml: 1610] 生产环境部署策略变更确认** - 具体内容：生产部署的触发条件从 `startsWith(github.ref, 'refs/tags/v')`（Tag 触发）变更为 `github.event_name == 'push' && github.ref_name == 'main'`（主分支 Push 触发）。这是一个重大的流程变更，意味着每次合并到 main 都会自动部署生产环境，失去了版本号控制。请确认这是有意为之（切换为持续部署模式），而非误操作。 2. **[apps/api/app/api/routes/generation_cover.py: 750] 变量重定义类型抑制** - 具体内容：使用了 `# type: ignore[no-redef]` 来抑制变量 `cover_data` 的重定义警告。这通常意味着变量作用域或初始化逻辑存在混淆。建议重构代码，在条件块外部显式初始化 `cover_data`，避免使用类型忽略来掩盖潜在的代码结构问题。 ### ✅ 良好实践 - **CI/CD 容错性**：在 `ci-pipeline.yml` 中为安全扫描添加了 `continue-on-error: true`，防止非关键的安全扫描阻塞流水线，并添加了清晰的注释说明理由。 - **数据库迁移**：Alembic 迁移文件（061, 062）编写规范，添加非空列时使用了 `server_default`，保证了线上数据迁移的安全性。 - **前端轮询优化**：`useVoiceMaterialData.ts` 中实现了智能轮询逻辑，仅当存在处理中的素材时才开启轮询，避免无效请求。 - **配置管理**：通过 `.gitignore` 合理配置了环境变量模板的忽略规则，既允许提交模板又防止泄露渲染后的真实密钥。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-09-03 10:32:55 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1655