YoungestSongMo
72ec1a5459
## 根因
设置页 `navigate('/settings')` 导致 React Router `/*` 的 index
路由不匹配，HomePage 被卸载重挂载，所有 useState 回到默认值。
## 修复（6 文件）
- event-bus.ts: 新增 OPEN_SETTINGS 事件
- nav-config.ts: 设置按钮 action: 'navigate' → 'button'，去路由化
- NavBar.tsx: button case 中 emit(OPEN_SETTINGS)
- SettingsPage.tsx: 去路由化，改为 Modal 居中叠加 + open/onClose props，
使用 antd 6.x 正确 API destroyOnHidden（非废弃的 destroyOnClose），
mask={{ closable: false }} + keyboard={false} 仅允许 X 按钮关闭
- router/index.tsx: 移除 SettingsPage 渲染
- App.tsx: 添加 SettingsPage Modal，事件驱动（与 LoginPage 模式一致）
## UX 优化（2 文件）
- HomeContent.tsx: 右侧分隔条移除多余 marginLeft，左右视觉对称
- BannerCarousel.tsx: 新增关闭按钮，session 级别 useState 隐藏，
不做 localStorage 持久化，确保每次启动重新展示
## 架构原则
确立 QT 多窗口模型 → Web 映射：叠加层走 Modal/Drawer + 事件总线，
主页面不卸载；真正的视图切换才用 React Router。
## 文档同步
- TODO.md: 移除已完成项详细记录，精简为未完成待办
- WORKLOG.md: 追加 2026-06-07 完整工作日志
- PROJECT.md: 更新路由/叠加层架构说明
- CHANGELOG.md: 追加 v0.0.13 条目
- ARCHITECTURE.md: 更新日期 + 新增叠加层模式章节
3.1 KiB
3.1 KiB
TODO — 船长·HeiXiu 待办与优化清单
最后更新：2026-06-07
🟡 功能待完善（优先级中）
设置页面
- 设置数据通过 IPC 同步到主进程（当前仅渲染进程 localStorage）
- 存储路径有效性校验（检查路径是否存在）
- "恢复默认设置"按钮
路由与页面
- 合规素材库页面（
/compliance-assets） - 项目管理页面（
/projects，企业版） - 账户/会员/充值/消费记录/订单明细页面
- 忘记密码流程
- 各页面暗色主题适配
导航栏
- 移除调试用的
console.log - 导航配置中的
action: 'external'统一管理（白名单校验） - 未登录点击需登录项 → 登录成功后自动跳转到目标页
公告
- 公告已读/未读状态
- 公告红点/角标提醒（有新公告时导航栏图标变化）
- 公告缓存（减少重复请求）
🟢 工程优化（优先级低）
构建与开发
- CI/CD 流水线（GitHub Actions / 自建）
- 代码签名自动化（Windows Authenticode / macOS notarization）
- E2E 测试用例编写（Playwright）
- 单元测试覆盖（Vitest）
- Bundle 体积分析优化（rollup-plugin-visualizer 已有，定期检查）
代码质量
- 移除未使用的
shared/类型和常量 - 统一 IPC 通道注册/注销模式（避免重复监听）
- React 组件 lazy loading（React.lazy + Suspense）
- 错误边界组件（ErrorBoundary）
文档
- API 接口文档（Swagger / 手动维护）
- 组件文档（Storybook）
- 用户操作手册
⚠️ 已知技术债务
| 问题 | 说明 | 影响 |
|---|---|---|
| localStorage 依赖 | 所有持久化数据依赖 localStorage | 清理浏览器数据会丢失所有配置 |
| IPC 监听器 | useUpdater 已改为单例，其他 IPC hook 可能也有类似问题 | 长期运行可能内存泄漏 |
✅ 已修复 — 根因：设置页 navigate('/settings') 导致路由 /* 仅匹配 index，HomePage 被卸载重挂载。修复：SettingsPage 改为事件总线驱动的 Modal 居中叠加，不走路由 |
||
test.py |
仓库根目录残留测试文件 | 无实际作用，应清理 |
null 文件 |
仓库根目录名为 null 的文件 | 构建产物或误操作残留 |
📋 下次开发计划
- 合规素材库页面（功能待完善 — 按 QT 原版设计，以 Modal/Drawer 叠加而非路由跳转实现）
- 各页面 nav 导航补齐（后续页面优先使用叠加模式，遵循 QT 多窗口模型 → 见 WORKLOG 2026-06-07）
- leftWidth / rightWidth / taskPage 加 localStorage 持久化（UX 优化：刷新页面后保持用户偏好）
- 轮播图关闭按钮状态优化（当前为 session 级别 useState，可考虑加 localStorage 记录关闭时间戳，超过 N 天再显示）