refactor: GeneratePage Phase 1 — 抽离常量/类型/UI组件（3036→2682行） #796

Merged

xiaoxia merged 6 commits from refactor/generate-page-phase1 into develop 2026-07-24 11:01:42 +08:00

Conversation 2 Commits 6 Files Changed 8

+787 -431

xiaoxia commented 2026-07-24 00:16:48 +08:00

Owner

Copy Link

Copy Source

背景

GeneratePage.tsx 巨无霸拆分 Phase 1，纯结构重构，业务逻辑零改动。

改动

新增 5 个文件

• pages/generate/constants.ts — 12组常量（STEPS/TITLE_PRESETS/AI标题模板/智能匹配理由/渐变色/图标等）
• pages/generate/types.ts — TitleSettings/SmartMatchResult/AiTitleResult 等类型定义
• pages/generate/components/GenerateHeader.tsx — 页头组件
• pages/generate/components/GenerateStepsBar.tsx — 步骤条组件
• pages/generate/components/GenerateResultPanel.tsx — 右侧生成结果面板

主文件瘦身

GeneratePage.tsx：3036 行 → 2682 行（-354行）

验证

• 纯结构重构，无业务逻辑变更
• 所有常量/类型/UI完全按原代码抽取，行为一致
• Phase 2 将继续拆分 7 个 Step 为独立组件

## 背景 GeneratePage.tsx 巨无霸拆分 Phase 1，纯结构重构，业务逻辑零改动。 ## 改动 ### 新增 5 个文件 - `pages/generate/constants.ts` — 12组常量（STEPS/TITLE_PRESETS/AI标题模板/智能匹配理由/渐变色/图标等） - `pages/generate/types.ts` — TitleSettings/SmartMatchResult/AiTitleResult 等类型定义 - `pages/generate/components/GenerateHeader.tsx` — 页头组件 - `pages/generate/components/GenerateStepsBar.tsx` — 步骤条组件 - `pages/generate/components/GenerateResultPanel.tsx` — 右侧生成结果面板 ### 主文件瘦身 GeneratePage.tsx：3036 行 → **2682 行**（-354行） ## 验证 - 纯结构重构，无业务逻辑变更 - 所有常量/类型/UI完全按原代码抽取，行为一致 - Phase 2 将继续拆分 7 个 Step 为独立组件

xiaoxia added 2 commits 2026-07-24 00:16:48 +08:00

docs(#780): 补齐.env.example缺失的30+配置项 ... 9a852a4a12

梳理所有配置文件（shared/api/worker），完整列出全部环境变量：
- 新增：数据库连接池配置（pool_size/max_overflow/timeout/recycle）
- 新增：Celery broker/backend 配置
- 新增：Worker 并发/子进程数 配置
- 新增：OSS 直传大小/过期时间 配置
- 新增：豆包大模型（Doubao）配置
- 新增：CosyVoice 克隆模型配置
- 新增：渲染引擎选择（RENDER_ENGINE）
- 新增：邮件投递开关 / SMTP TLS / API 端口等零散配置
- 每个配置补充用途注释和默认值说明
- 顶部增加配置读取优先级说明

refactor: GeneratePage Phase 1 - 抽取常量/类型/UI组件 ... e9d4885f7a

将 3036 行的 GeneratePage.tsx 按 Phase 1 计划拆分：

新增文件：
- constants.ts — 12组常量（STEPS/TITLE_PRESETS/AI标题模板/智能匹配理由/渐变色/图标等）
- types.ts — TitleSettings/SmartMatchResult/AiTitleResult 等类型定义
- components/GenerateHeader.tsx — 页头组件
- components/GenerateStepsBar.tsx — 步骤条组件
- components/GenerateResultPanel.tsx — 右侧生成结果面板

GeneratePage.tsx 从 3036 行 → 2682 行（-354行）
纯结构重构，业务逻辑零改动

xiaoxia added 1 commit 2026-07-24 01:09:34 +08:00

fix: remove unused type imports to pass ESLint 952f1a5e99

xiaoxia added 1 commit 2026-07-24 09:42:29 +08:00

style: format with prettier 5f4ab624ab

xiaoxia added 1 commit 2026-07-24 09:53:40 +08:00

test: add GenerateHeader component smoke test 39470676a5

xiaoxia added 1 commit 2026-07-24 10:10:17 +08:00

style: fix GenerateHeader test prettier formatting ce8084982a

auto-approve-bot commented 2026-07-24 10:21:53 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #796

⚠️ 问题（0个需要修改）

无

💡 建议（2个可选）

1. apps/web/src/pages/generate/components/GenerateResultPanel.tsx 第7行：建议调整工具函数的导入路径

   • formatDuration 是一个通用的格式化工具函数，从 @/api/voice-clone 导入不符合模块职责划分原则（API 模块应仅负责数据请求）。建议将其移动到 @/utils 或 @/lib/utils 等公共工具目录中导入，以避免潜在的循环依赖风险并提高代码可维护性。

2. apps/web/src/pages/generate/components/GenerateResultPanel.tsx 第153行：简化类型判断逻辑

   • 代码中使用了 typeof generateError === "string" ? generateError : "请重试"。根据接口定义 generateError: string | null，TypeScript 已经能够进行类型收窄，该 typeof 检查是冗余的。建议简化为 {generateError || "请重试"} 以提高代码简洁性。

---

✅ 格式检查通过 | ✅ 逻辑审查需修改 | ✅ 性能

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-24 02:21:53 | 模型:}

## 代码审查结果 - PR #796 ### ⚠️ 问题（0个需要修改） 无 ### 💡 建议（2个可选） 1. **apps/web/src/pages/generate/components/GenerateResultPanel.tsx 第7行**：建议调整工具函数的导入路径 - `formatDuration` 是一个通用的格式化工具函数，从 `@/api/voice-clone` 导入不符合模块职责划分原则（API 模块应仅负责数据请求）。建议将其移动到 `@/utils` 或 `@/lib/utils` 等公共工具目录中导入，以避免潜在的循环依赖风险并提高代码可维护性。 2. **apps/web/src/pages/generate/components/GenerateResultPanel.tsx 第153行**：简化类型判断逻辑 - 代码中使用了 `typeof generateError === "string" ? generateError : "请重试"`。根据接口定义 `generateError: string | null`，TypeScript 已经能够进行类型收窄，该 `typeof` 检查是冗余的。建议简化为 `{generateError || "请重试"}` 以提高代码简洁性。 --- ✅ 格式检查通过 | ✅ 逻辑审查需修改 | ✅ 性能 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-24 02:21:53 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit da53b6d175 into develop 2026-07-24 11:01:42 +08:00

gitea-actions bot commented 2026-07-24 11:30:44 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

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#796