[1.5.2 Patch 总控] 基于真实用户反馈修复路径展示、端口误判、外部运行时安全、桌面急救与白屏兜底

[weidonglang]

背景

有用户基于 DevEnv Manager 1.3.0 进行了真实试用反馈。虽然当前仓库已经发布到 1.5.1 Final Stable，很多能力已经被增强，但反馈中暴露出的现象仍然具有代表性，尤其是：路径展示不友好、端口识别误判、外部运行时可能被误当作受管运行时、错误提示霸屏、桌面急救打开目录不够精确、页面说明不够有用，以及偶发启动白屏。

本 issue 作为 1.5.2 Patch 总控任务，目标不是新增大功能，而是根据真实用户反馈修复可用性、安全性和可信度问题。

用户反馈原始现象摘要

用户使用的是 1.3.0，反馈包括：

1. 默认根目录显示 \\?\C:\Dev\DevEnvs，用户不确定路径是否合法，也担心反斜杠处理是否有影响。
2. 端口管理有用，但识别不准：Steam 日常占用 8080、QQ 占用 8082，却被识别为 Spring / Tomcat / Spring Boot。
3. 环境医生能发现当前 Java 版本，但用户感觉不能直接管理或跳转处理。
4. 本机环境发现中的 Go 被用户点击“系统卸载”后像是被当成便携运行时删除，回收站操作失败，且错误提示长时间显示不消失。
5. JDK 管理中，用户希望 Java 不一致时能统一到某个本机版本；外部 JDK 虽然不应卸载，但仍应能作为候选进行验证、设为 JAVA_HOME 或纳入稳定修复计划。
6. 桌面急救中，“打开目录”直接打开桌面根目录，用户希望打开具体大文件或分类文件所在目录。
7. “这个页面怎么用？”提示太浅，尤其命令面板提示像口号，不知道的人看了仍不知道怎么用。
8. 偶发打开后空白，疑似 WebView / 前端初始化异常。

总目标

完成 1.5.2 Patch，修复以下方向：

• UI 路径展示去除 \\?\ 等 Windows 内部前缀，保存路径前做合法性校验。
• 端口识别改为 process-first + evidence-first，降低 Steam/QQ/浏览器等误判为 Spring/Tomcat 的概率。
• 外部运行时安全收紧：非 DevEnv Manager 受管运行时不得显示删除/卸载目录类危险操作。
• Java/JDK 候选项分清受管、外部、IDE 内置，外部 JDK 可验证和设为 JAVA_HOME，但不可删除。
• Toast 和错误提示改为可关闭、自动消失、长错误折叠详情。
• 桌面急救和大文件/重复文件等“打开目录”打开具体所在目录，而不是总目录。
• 页面帮助从口号式说明改成“用途、第一步、示例、风险、不做什么”。
• 增加前端启动白屏兜底、错误页、日志入口和重置 UI 配置入口。

本 patch 不做什么

• 不新增系统管家功能。
• 不新增注册表清理。
• 不新增杀毒、驱动、隐私清理。
• 不新增自动删除外部运行时。
• 不自动关闭 Store Alias。
• 不自动修改系统级环境变量。
• 不扩大 C 盘清理范围。
• 不把命令面板变成通用 Shell。

子 issue

请按以下专项 issue 完成：

1. UI 路径展示与 rootDir 合法性校验。
2. 端口识别误判修复。
3. 外部运行时卸载/删除安全收紧。
4. Java/JDK 候选管理与环境修复入口联动。
5. 桌面急救 / 大文件 / 重复文件打开目录精确化。
6. 页面帮助说明增强。
7. 前端白屏兜底与错误恢复。

最终验收

• cargo test --all-targets 通过。
• npm run build 通过。
• npm run tauri:build 通过。
• 新增或更新 docs/issues-57-64.md 记录用户反馈与修复结果。
• 新增 docs/release-v1.5.2.md。
• README 更新 1.5.2 Patch 说明。
• 所有子 issue 回填完成说明后关闭。
• 本总控 issue 在所有子 issue 关闭后再关闭。

[weidonglang]

补充 1.5.2 Patch 子任务：

• [1.5.2 Patch] chsrc 统一换源依赖缺失处理不完整：补齐检测、安装指引、刷新验证与降级方案 #65 chsrc 统一换源依赖缺失处理不完整：补齐检测、安装指引、刷新验证与降级方案。
• [1.5.2 Patch] 端口检测全面增强：识别准确性、详情解释、风险分级、历史记录与项目端口联动收口 #66 端口检测全面增强：识别准确性、详情解释、风险分级、历史记录与项目端口联动收口。
• [1.5.2 Patch] MySQL 修复中心系统库缺失/不完整疑似误报：补齐诊断证据、连接验证、风险分级、强制备份与三次确认 #67 MySQL 修复中心系统库缺失/不完整疑似误报：补齐诊断证据、连接验证、风险分级、强制备份与三次确认。
• [1.5.2 Patch] 首次启动强制安全声明弹窗：阅读确认后才允许进入主界面 #68 首次启动强制安全声明弹窗：阅读确认后才允许进入主界面。

#68 的安全声明弹窗属于全局使用前告知，不应只放在环境页面。确认前不得自动执行诊断、扫描、修复、清理、安装等动作；确认后本地保存状态，后续可在设置/关于/安全说明中重新查看。

[weidonglang]

补充 1.5.2 Patch 子任务：

• [1.5.2 Patch] Python 修复计划被 Microsoft Store Alias / 无效路径阻断：补齐原因解释、设置入口、受管 Python 切换与重新验证闭环 #69 Python 修复计划被 Microsoft Store Alias / 无效路径阻断：补齐原因解释、设置入口、受管 Python 切换与重新验证闭环。

该问题属于功能可用性 bug / 修复入口可恢复性不足。检测到 Store Alias 或无效路径时阻断危险修复是正确的，但不能只显示一句“请先关闭应用执行别名或切换受管 Python”。需要提供原因、证据、设置入口、受管 Python 切换/安装入口、重新检测和只读诊断报告导出。

[weidonglang]

补充 1.5.2 Patch 子任务：

• [1.5.2 Patch] 全页面功能说明增强并支持“下次默认折叠”，减少说明卡片遮挡主界面 #70 全页面功能说明增强并支持“下次默认折叠”，减少说明卡片遮挡主界面。

该任务用于把现有页面说明从固定展开卡片升级为可折叠、可记忆、分层展示的功能帮助系统。首次进入页面可默认展开；用户勾选“下次进入此页面默认折叠”后，下次进入该页面或子功能时说明缩成小条，不影响主界面视野。此任务不替代 #68 首次启动安全声明，也不替代高风险功能的二次/三次确认。

[weidonglang]

补充 1.5.2 Patch 子任务：

• [1.5.2 Patch] 端口管理进阶特色增强：软件识别库、智能快捷操作、项目联动与证据评分体系 #71 端口管理进阶特色增强：软件识别库、智能快捷操作、项目联动与证据评分体系。

#66 主要解决端口检测准确性、详情解释、风险分级和项目联动收口；#71 进一步要求把端口管理做成 DevEnv Manager 的特色功能：覆盖更多开发服务、数据库/中间件、Python Web/AI、本地 HTTP 服务、桌面应用/WebView，提供证据评分、置信度、智能快捷操作、端口冲突建议和历史占用画像。边界仍然是不做抓包、防火墙、远程扫描、网络监控或自动结束进程。

[weidonglang]

补充 1.5.2 Patch 子任务：

• [1.5.2 Patch] 端口管理界面布局优化：摘要优先、筛选分层、表格轻量、详情抽屉承载复杂信息 #72 端口管理界面布局优化：摘要优先、筛选分层、表格轻量、详情抽屉承载复杂信息。

#66 / #71 已经把端口管理的识别能力、证据评分、软件识别库和快捷操作拉高；#72 专门负责布局设计，避免信息过多导致页面拥挤、错位、表格变形。推荐采用“顶部状态摘要 + 搜索筛选 + 轻量表格 + 右侧详情抽屉 + 场景化快捷操作”的布局。复杂证据、冲突原因、评分过程、历史画像和项目联动应放到详情抽屉，而不是塞进表格。

[weidonglang]

补充 1.5.2 Release 总开发计划：本次必须覆盖 #58-#83。开发顺序建议：先修 P0 安全与更新链路（#73 #74 #68 #64 #75），再修路径/运行时/环境安全（#58 #60 #61 #65 #69 #77 #81），再修 MySQL（#67 #78），再修端口管理（#59 #66 #71 #72），再修清理扫描体验（#62 #79），再修页面帮助和前端模块化（#63 #70 #82），最后做仓库卫生、脱敏和 CI（#76 #80 #83）。完成后统一升级版本到 1.5.2，运行 cargo test、cargo clippy、npm ci、npm run build、npm run tauri:build、check_safety_wording、check_repo_hygiene，打包安装包，计算 SHA256，创建 GitHub Release v1.5.2，更新 update-manifest.json，并逐个 issue 回填完成内容和测试结果后关闭。

[weidonglang]

完成内容

• v1.5.3 Stable 已完成：PR v1.5.3 Quality Patch first round #87、PR chore: release DevEnv Manager v1.5.3 stable #88 均已合并到 main。
• 已发布 GitHub Release v1.5.3，并上传 DevEnv.Manager_1.5.3_x64-setup.exe。
• update-manifest.json 已更新到 v1.5.3，并指向真实 release asset。
• [1.5.2 Patch] 外部运行时卸载/删除安全收紧，禁止把系统安装项当作受管便携目录删除 #60-[1.5.2 Patch][P2] 增加 GitHub Actions CI 与仓库卫生门禁 #83、v1.5.2 安装后疑似仍是旧功能：tag 与 1.5.1 相比缺少业务实现变更 #85 已逐条回填验证结果并关闭。

修改文件

• 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 Actions main CI：success

手动验证

• GitHub Release v1.5.3 存在，asset 名为 DevEnv.Manager_1.5.3_x64-setup.exe。
• 已从 Release 下载 installer 并校验 SHA256：32439838bc46687010b83d4c5f80583fbb0c2b99ed4a836078772184f50e069c。
• update-manifest.json 中 SHA256 与下载文件一致。

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 复核：总控不应保持 completed，部分子 issue 已重新打开

继续按真实软件测试口径复核后，发现多个已关闭子 issue 并未完成用户可见闭环，已重新打开：

• [1.5.2 Patch] Java/JDK 候选管理与环境医生联动，支持外部 JDK 设为 JAVA_HOME 但禁止卸载 #61 外部 JDK 候选验证 / JAVA_HOME 候选闭环未过。
• [1.5.2 Patch] 桌面急救/大文件/重复文件打开目录精确化，不再只打开总目录 #62 桌面急救 / 大文件明细 / 精确定位未过。
• [1.5.2 Patch] 页面帮助说明增强：从口号式安全提示改为可操作使用指南 #63 页面帮助仍像口号，未达到可操作指南。
• [1.5.2 Patch] 前端启动白屏兜底、全局错误页、日志入口与 UI 配置恢复 #64 安全模式触发 plugin:dialog|confirm not allowed by ACL，兜底流程自身报错。
• [1.5.2 Patch] 端口检测全面增强：识别准确性、详情解释、风险分级、历史记录与项目端口联动收口 #66 端口检测仍缺冲突解释和常见进程识别。
• [1.5.2 Patch] MySQL 修复中心系统库缺失/不完整疑似误报：补齐诊断证据、连接验证、风险分级、强制备份与三次确认 #67 MySQL 修复中心结构化字段有推进，但 UI 可读性和 PermissionUnknown 解释未过。
• [1.5.2 Patch] 端口管理进阶特色增强：软件识别库、智能快捷操作、项目联动与证据评分体系 #71 端口管理进阶识别库和 unknown 分析不足。
• [1.5.2 Patch] 端口管理界面布局优化：摘要优先、筛选分层、表格轻量、详情抽屉承载复杂信息 #72 端口详情 / 冲突证据展示仍不足。

因此 #57 总控不应继续作为“全部完成”状态。建议将剩余问题集中进入 v1.6 QA 修复：目标不是新增大功能，而是补齐 v1.5.3 已声明但用户实际体验未闭环的部分。

[weidonglang]

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