[1.5.2 Patch][P2] 前端 main.ts 拆分为 feature modules，降低白屏和回归风险

[weidonglang]

背景

当前前端入口文件 src/main.ts 承载了大量类型、状态、页面逻辑和功能入口。随着端口管理、MySQL 修复、Python 分析、安全声明、功能说明、环境可靠性等功能继续增强，单文件复杂度会持续上升。

风险

• 小改动容易引发大范围回归。
• Codex 修改时容易在同一大文件里冲突或改坏。
• 白屏问题定位困难。
• 组件测试困难。
• 类型定义、API 调用、UI 渲染耦合严重。

修复目标

在不重写 UI 的前提下，做一次低风险模块化拆分。

建议目录结构

src/types/
src/api/
src/components/
src/pages/
src/features/ports/
src/features/mysql/
src/features/python/
src/features/safety/
src/features/environment/
src/features/runtime/
src/features/cleanup/

拆分原则

1. 不重做视觉风格。
2. 不一次性大重构业务逻辑。
3. 每次移动一个功能区，保证可编译。
4. 类型先拆到 src/types。
5. Tauri invoke 封装到 src/api。
6. 端口管理相关放到 features/ports。
7. MySQL 相关放到 features/mysql。
8. Python 分析相关放到 features/python。
9. 安全声明、功能说明、风险徽章放到 features/safety 或 components。

必须优先拆分的模块

• PortRecord / PortHistory / 端口 UI。
• MySqlRepairReport / MySqlRepairPlan / MySQL UI。
• PythonAnalysis / PythonRepairPlan / Python UI。
• FeatureRiskInfo / safety disclaimer / feature help。
• EnvReliabilitySnapshot。

测试要求

• npm run build 每一步都通过。
• 拆分后 TypeScript 类型无 any 滥用。
• 页面功能入口不丢失。
• 白屏兜底 [1.5.2 Patch] 前端启动白屏兜底、全局错误页、日志入口与 UI 配置恢复 #64 仍能捕获异常。
• 端口管理 [1.5.2 Patch] 端口管理界面布局优化：摘要优先、筛选分层、表格轻量、详情抽屉承载复杂信息 #72 的布局改造在模块化后完成或同步完成。

验收标准

• main.ts 明显减小，只保留应用启动、顶层路由和少量全局状态。
• 核心 feature 有独立文件夹。
• npm run build 通过。
• docs/release-v1.5.2.md 记录该可维护性改进。

[weidonglang]

完成内容

• v1.5.3 已完成低风险模块化：types、api、safety 聚合拆分；端口/MySQL/Python 大页面级拆分延期到 1.5.4，避免稳定发布前引入大规模 UI 回归。
• 已合入 PR v1.5.3 Quality Patch first round #87 / chore: release DevEnv Manager v1.5.3 stable #88，并发布 v1.5.3 Stable。

修改文件

• tauri/src-tauri/src/lib.rs
• tauri/src-tauri/src/mysql_repair.rs
• tauri/src-tauri/src/cleanup/duplicates.rs
• tauri/src-tauri/src/cleanup/large_files.rs
• tauri/src/main.ts
• tauri/src/styles.css
• tauri/src/types/index.ts
• tauri/src/api/tauri.ts
• tauri/src/features/safety/index.ts
• README.md
• docs/release-v1.5.3.md
• update-manifest.json

验证命令

• cargo test --all-targets
• cargo clippy --all-targets -- -D warnings
• npm ci
• npm run build
• npm run tauri:build
• py -3 scripts\check_safety_wording.py
• py -3 scripts\check_repo_hygiene.py

手动验证

• GitHub Release v1.5.3 已创建并上传 DevEnv.Manager_1.5.3_x64-setup.exe。
• 已从 Release 下载安装包并校验 SHA256：32439838bc46687010b83d4c5f80583fbb0c2b99ed4a836078772184f50e069c。
• update-manifest.json 指向 v1.5.3 真实下载链接，下载后 SHA256 与 manifest 一致。

Release

• https://github.com/weidonglang/DevEnv-Manager/releases/tag/v1.5.3
• https://github.com/weidonglang/DevEnv-Manager/releases/download/v1.5.3/DevEnv.Manager_1.5.3_x64-setup.exe

[weidonglang]

QA 复核：main.ts 仍是超大入口文件，#82 不应按完整模块化关闭

当前 #82 的关闭说明承认：只做了 types、api、safety 聚合拆分，端口 / MySQL / Python 大页面级拆分延期。实际主分支 tauri/src/main.ts 仍然承载大量 HTML 模板、状态、渲染函数、事件绑定和业务逻辑。

这与 #82 原始验收标准不一致：

• main.ts 明显减小，只保留应用启动、顶层路由和少量全局状态。
• Port / MySQL / Python / Cleanup 等核心 feature 有独立文件夹。
• 白屏问题定位更容易。

1.6 建议

不要在 1.6 里做大规模重写，但至少把这些从 main.ts 拆出：

1. Toast / SafeMode / SafetyGate。
2. Port workbench 渲染与端口事件。
3. MySQL repair UI。
4. Cleanup / Desktop rescue / large file result UI。
5. Java/JDK environment UI。
6. Update check UI。

如果 1.6 目标是稳定可用，至少要把安全模式、toast、端口、MySQL、桌面急救这些正在反复出问题的区域拆出来，降低后续回归风险。

建议重新打开或把 #82 作为 1.6 可维护性 P1 项继续处理。

[weidonglang]

已在 v1.6.1 Stable 收口：用户已完成实机验收，PR #91/#92 已合并，v1.6.1 已发布为 latest，update-manifest 已指向 v1.6.1 安装包与 SHA256。