feat: 忘记密码/修改密码 + 设置页结构重组 + barrel cleanup + LoginPage 版本统一

新增： - ForgotPasswordModal — 手机号+短信验证码重置密码 (AuthAPI.resetPassword) - ChangePasswordModal — 当前密码验证后修改密码 (AuthAPI.changePassword) - useSmsCooldown Hook — 通用短信发送冷却逻辑，供注册/忘记密码复用 - PasswordSetting — 设置页账号安全区块，双选项：修改密码 / 短信验证码重置修改： - LoginForm \"忘记密码?\" 链接接入 ForgotPasswordModal（替换 TODO） - LoginPage 移除 edition 业务版本 UI 区分，登录/注册 Tab 全局统一 - 设置页 Section 组件移入 blocks/ 子目录（git mv 保留历史） - auth.ts sendSms URL 修正: /sms/send → /send-sms 清理： - settings/index.ts 移除 4 个未使用 re-export，精简为仅 SettingsPage - navbar/index.ts 移除未使用 re-export，精简为仅 NavBar 文档： - WORKLOG.md 新增 2026-06-08 工作日志 - ARCHITECTURE.md / PROJECT.md 更新设置页目录结构与新组件 - TODO.md 忘记密码流程标记已完成 + 短信人机验证列入后期优化
2026-06-08 11:57:35 +08:00
parent 952a723448
commit 7032d1c3f2
22 changed files with 1089 additions and 515 deletions
--- a/PROJECT.md
+++ b/PROJECT.md
@@ -36,78 +36,78 @@
  遵循 Provider → Context → Comsumer 单向流动。组件内部状态使用 useState/useReducer，不污染全局 Context。

 - 事件驱动（EDA）：
-   1. 主进程与渲染进程通信基于 Electron IPC（ipcMain/ipcRenderer），定义明确的事件通道与载荷类型。
+    1. 主进程与渲染进程通信基于 Electron IPC（ipcMain/ipcRenderer），定义明确的事件通道与载荷类型。

-   2. 渲染进程内跨组件通信优先使用 Context；需要解耦的场景使用自定义事件总线（src/utils/event-bus.ts），
-      所有 emit 调用自动记录到日志文件用于审计追踪。
+    2. 渲染进程内跨组件通信优先使用 Context；需要解耦的场景使用自定义事件总线（src/utils/event-bus.ts），
+       所有 emit 调用自动记录到日志文件用于审计追踪。

-   3. 自定义错误体系（RequestError / RefreshError）通过事件总线解耦：请求拦截器抛出自定义错误 →
-      全局捕获 → emit 事件 → UI 层响应。
+    3. 自定义错误体系（RequestError / RefreshError）通过事件总线解耦：请求拦截器抛出自定义错误 →
+       全局捕获 → emit 事件 → UI 层响应。

-   4. 窗口间通信统一通过主进程转发（或使用 MessagePort 等 Electron 支持的机制），保持窗口独立性。
+    4. 窗口间通信统一通过主进程转发（或使用 MessagePort 等 Electron 支持的机制），保持窗口独立性。

 - 路由与导航：主窗口为单页应用，使用 React Router v7+ 管理页面切换。**遵循 QT 多窗口模型映射原则**：
-  - 叠加层（设置、公告、素材库等）→ Modal/Drawer + 事件总线驱动，主页面不卸载
-  - 页面跳转（真正的视图切换）→ React Router，需跨页保持的状态放 Provider 或 localStorage
+    - 叠加层（设置、公告、素材库等）→ Modal/Drawer + 事件总线驱动，主页面不卸载
+    - 页面跳转（真正的视图切换）→ React Router，需跨页保持的状态放 Provider 或 localStorage

 - 辅助窗口（设置、预览、导入导出等）以 Modal/Drawer 叠加在主窗口之上，不与主窗口共享 DOM，但保持在同一个 React 组件树中以确保状态一致性。

 # 目录结构

 ```md
-├── electron/                # Electron 主进程
-│   ├── main.ts              # 入口：窗口创建 / IPC 注册 / 生命周期
-│   ├── preload.ts           # 预加载脚本（contextBridge）
-│   └── main/
-│       ├── updater.ts       # 自定义更新（API 版本检查 + OSS 下载 + NSIS 安装）
-│       ├── logger.ts        # 主进程日志核心（JSON Lines 写入 / 轮转 / 清理）
-│       ├── log-ipc.ts       # 渲染进程日志 IPC 通道接收
-│       ├── net-request.ts   # Electron net.request 的 axios 风格封装
-│       ├── menu/index.ts    # 系统菜单
-│       └── utils/           # 平台判断 / 图标路径
-├── src/                     # 渲染进程（React 19 SPA）
-│   ├── main.tsx             # React 挂载点 + 全局错误捕获
-│   ├── App.tsx              # 根组件（路由 + 登录弹窗）
-│   ├── components/          # 通用 UI 组件 + Provider
-│   │   ├── AppProvider.tsx  # 全局状态（platform / edition / login）
-│   │   ├── ThemeProvider.tsx # 主题状态（light / dark）
-│   │   ├── SettingsProvider.tsx # 设置状态（存储路径等）
-│   │   ├── Layout.tsx       # 页面壳（NavBar + Outlet）
-│   │   └── navbar/          # 导航栏 + 公告抽屉
-│   ├── contexts/            # Context 定义（app / settings / theme）
-│   ├── hooks/               # 自定义 Hooks（useUpdater / useTheme）
-│   ├── pages/               # 页面组件
-│   │   ├── home/            # 首页仪表盘
-│   │   ├── login/           # 登录 / 注册页
-│   │   └── settings/        # 设置面板（主题 / 存储 / 更新）
-│   ├── router/index.tsx     # HashRouter 路由配置
-│   ├── services/            # HTTP 请求封装
-│   │   ├── request.ts       # Axios 封装 + 拦截器 + Token 刷新
-│   │   ├── types.ts         # 自定义错误类型（RequestError / RefreshError）
-│   │   ├── auth-token.ts    # refresh_token 管理
-│   │   └── modules/         # API 模块（auth / announcement）
-│   ├── theme/               # 主题系统
-│   │   ├── tokens.ts        # 设计令牌
-│   │   └── globals.css      # Tailwind + 全局样式
-│   └── utils/               # 纯函数工具
-│       ├── event-bus.ts     # 事件总线（on / off / emit + 日志钩子）
-│       ├── logger.ts        # 渲染进程日志器（IPC 转发 / DEV 控制台）
-│       ├── ipc.ts           # 安全 IPC 守卫（safeIpcOn / send / invoke）
-│       ├── platform.ts      # 平台判定
-│       └── device.ts        # 设备 ID 生成
-├── shared/                  # 主进程 & 渲染进程共享
-│   ├── types/               # 类型定义（API / IPC / update / logging）
-│   ├── constants/           # 常量（IPC 通道 / version / app）
-│   └── utils/               # 共享工具
-│       ├── index.ts         # debounce / throttle / compareVersions
-│       └── sanitize.ts      # 日志脱敏工具（ID / 邮箱 / 手机 / 名称）
-├── scripts/                 # 构建脚本
-│   ├── build.mjs            # 构建总管
-│   ├── clean.mjs            # 清理产物
-│   ├── upload-oss.mjs       # OSS 上传
-│   ├── publish-release.mjs  # 发布到 API
-│   └── generate-update-info.mjs # 生成更新元信息
-├── package.json             # 含 electron-builder 打包配置
+├── electron/ # Electron 主进程
+│ ├── main.ts # 入口：窗口创建 / IPC 注册 / 生命周期
+│ ├── preload.ts # 预加载脚本（contextBridge）
+│ └── main/
+│ ├── updater.ts # 自定义更新（API 版本检查 + OSS 下载 + NSIS 安装）
+│ ├── logger.ts # 主进程日志核心（JSON Lines 写入 / 轮转 / 清理）
+│ ├── log-ipc.ts # 渲染进程日志 IPC 通道接收
+│ ├── net-request.ts # Electron net.request 的 axios 风格封装
+│ ├── menu/index.ts # 系统菜单
+│ └── utils/ # 平台判断 / 图标路径
+├── src/ # 渲染进程（React 19 SPA）
+│ ├── main.tsx # React 挂载点 + 全局错误捕获
+│ ├── App.tsx # 根组件（路由 + 登录弹窗）
+│ ├── components/ # 通用 UI 组件 + Provider
+│ │ ├── AppProvider.tsx # 全局状态（platform / edition / login）
+│ │ ├── ThemeProvider.tsx # 主题状态（light / dark）
+│ │ ├── SettingsProvider.tsx # 设置状态（存储路径等）
+│ │ ├── Layout.tsx # 页面壳（NavBar + Outlet）
+│ │ └── navbar/ # 导航栏 + 公告抽屉
+│ ├── contexts/ # Context 定义（app / settings / theme）
+│ ├── hooks/ # 自定义 Hooks（useUpdater / useTheme）
+│ ├── pages/ # 页面组件
+│ │ ├── home/ # 首页仪表盘
+│ │ ├── login/ # 登录 / 注册页
+│ │ └── settings/ # 设置面板（主题 / 存储 / 账号安全 / 系统信息 / 更新）
+│ ├── router/index.tsx # HashRouter 路由配置
+│ ├── services/ # HTTP 请求封装
+│ │ ├── request.ts # Axios 封装 + 拦截器 + Token 刷新
+│ │ ├── types.ts # 自定义错误类型（RequestError / RefreshError）
+│ │ ├── auth-token.ts # refresh_token 管理
+│ │ └── modules/ # API 模块（auth / announcement）
+│ ├── theme/ # 主题系统
+│ │ ├── tokens.ts # 设计令牌
+│ │ └── globals.css # Tailwind + 全局样式
+│ └── utils/ # 纯函数工具
+│ ├── event-bus.ts # 事件总线（on / off / emit + 日志钩子）
+│ ├── logger.ts # 渲染进程日志器（IPC 转发 / DEV 控制台）
+│ ├── ipc.ts # 安全 IPC 守卫（safeIpcOn / send / invoke）
+│ ├── platform.ts # 平台判定
+│ └── device.ts # 设备 ID 生成
+├── shared/ # 主进程 & 渲染进程共享
+│ ├── types/ # 类型定义（API / IPC / update / logging）
+│ ├── constants/ # 常量（IPC 通道 / version / app）
+│ └── utils/ # 共享工具
+│ ├── index.ts # debounce / throttle / compareVersions
+│ └── sanitize.ts # 日志脱敏工具（ID / 邮箱 / 手机 / 名称）
+├── scripts/ # 构建脚本
+│ ├── build.mjs # 构建总管
+│ ├── clean.mjs # 清理产物
+│ ├── upload-oss.mjs # OSS 上传
+│ ├── publish-release.mjs # 发布到 API
+│ └── generate-update-info.mjs # 生成更新元信息
+├── package.json # 含 electron-builder 打包配置
 ├── vite.config.ts
 ├── tsconfig.json
 └── tailwind.config.ts
@@ -181,14 +181,14 @@
 ## Token 加密存储

 - `access_token` 和 `refresh_token` 通过 Electron `safeStorage` API 加密存储，不落明文：
-  - macOS → Keychain
-  - Windows → DPAPI
-  - Linux → libsecret
+    - macOS → Keychain
+    - Windows → DPAPI
+    - Linux → libsecret
 - 实现文件：
-  - `electron/main/safe-storage-ipc.ts` — 主进程加密/解密 IPC 处理（`BIDIRECTIONAL.SAFESTORAGE_ENCRYPT / DECRYPT`）
-  - `src/utils/safe-storage.ts` — 渲染进程桥接层（`initSafeStore / getSafeStore / setSafeStore / clearSafeStore`）
-  - `src/services/request.ts` — token 存取通过 `getSafeStore / setSafeStore`，无需感知加密细节
-  - `src/services/auth-token.ts` — refresh_token 同理通过 safeStorage 存取
+    - `electron/main/safe-storage-ipc.ts` — 主进程加密/解密 IPC 处理（`BIDIRECTIONAL.SAFESTORAGE_ENCRYPT / DECRYPT`）
+    - `src/utils/safe-storage.ts` — 渲染进程桥接层（`initSafeStore / getSafeStore / setSafeStore / clearSafeStore`）
+    - `src/services/request.ts` — token 存取通过 `getSafeStore / setSafeStore`，无需感知加密细节
+    - `src/services/auth-token.ts` — refresh_token 同理通过 safeStorage 存取

 ## 双 Token 机制

@@ -261,25 +261,27 @@
              └─ 下载完成 → 用户点击"安装更新" → NSIS/DMG/AppImage 执行
 ```

-| 模块 | 位置 | 职责 |
-|------|------|------|
-| `HeiXiuProvider` | `electron/main/updater.ts` | 自定义 Provider，调用自有 API，无更新返回 APP_VERSION |
-| `checkForUpdates` | `electron/main/updater.ts` | 预检版本 → 无更新直发 IPC / 有更新交 electron-updater |
-| `downloadUpdate` | `electron/main/updater.ts` | 用户确认后触发下载（从 checkForUpdates 分离） |
-| `netRequest` | `electron/main/net-request.ts` | Electron net.request 的 axios 风格封装 |
-| `useUpdater` | `src/hooks/use-updater.ts` | 渲染进程更新状态 Hook（单例 IPC 监听） |
-| `UpdateSetting` | `src/pages/settings/UpdateSetting.tsx` | 设置页更新区块（含"查看详情"弹窗） |
-| `server.py` | `test-server/server.py` | 本地测试服务器，扫描 release/ 目录，语义版本排序 |
+| 模块                | 位置                                            | 职责                                       |
+|-------------------|-----------------------------------------------|------------------------------------------|
+| `HeiXiuProvider`  | `electron/main/updater.ts`                    | 自定义 Provider，调用自有 API，无更新返回 APP_VERSION  |
+| `checkForUpdates` | `electron/main/updater.ts`                    | 预检版本 → 无更新直发 IPC / 有更新交 electron-updater |
+| `downloadUpdate`  | `electron/main/updater.ts`                    | 用户确认后触发下载（从 checkForUpdates 分离）          |
+| `netRequest`      | `electron/main/net-request.ts`                | Electron net.request 的 axios 风格封装        |
+| `useUpdater`      | `src/hooks/use-updater.ts`                    | 渲染进程更新状态 Hook（单例 IPC 监听）                 |
+| `UpdateSetting`   | `src/pages/settings/blocks/UpdateSetting.tsx` | 设置页更新区块（含"查看详情"弹窗）                       |
+| `server.py`       | `test-server/server.py`                       | 本地测试服务器，扫描 release/ 目录，语义版本排序            |

 ## 增量更新（差分下载）

 - `package.json` 配置 `"differentialPackage": true`，electron-builder 打包时自动生成 `.exe.blockmap` 文件
- 自定义 Provider 模式：`HeiXiuNsisUpdater extends NsisUpdater` / `HeiXiuMacUpdater extends MacUpdater` / `HeiXiuAppImageUpdater extends AppImageUpdater`
- 三平台 Updater 均覆盖 `getUpdateInfoAndProvider()` 注入 `HeiXiuProvider`（自定义 API 版本检查），差分下载由 electron-updater 父类原生处理
+- 自定义 Provider 模式：`HeiXiuNsisUpdater extends NsisUpdater` / `HeiXiuMacUpdater extends MacUpdater` /
+  `HeiXiuAppImageUpdater extends AppImageUpdater`
+- 三平台 Updater 均覆盖 `getUpdateInfoAndProvider()` 注入 `HeiXiuProvider`（自定义 API 版本检查），差分下载由
+  electron-updater 父类原生处理
 - blockmap 文件流程：
-  - `scripts/generate-update-info.mjs` — 扫描 blockmap 文件，写 `blockmap.url` + `blockmap.size` 到 `update-info.json`
-  - `scripts/upload-oss.mjs` — 安装包 + blockmap 文件一并上传 OSS（支持 Node.js 直传和 ossutil 两种模式）
-  - `scripts/publish-release.mjs` — 通过 `--blockmap-url` 参数将 blockmap 信息发布到后端 API
+    - `scripts/generate-update-info.mjs` — 扫描 blockmap 文件，写 `blockmap.url` + `blockmap.size` 到 `update-info.json`
+    - `scripts/upload-oss.mjs` — 安装包 + blockmap 文件一并上传 OSS（支持 Node.js 直传和 ossutil 两种模式）
+    - `scripts/publish-release.mjs` — 通过 `--blockmap-url` 参数将 blockmap 信息发布到后端 API
 - 效果：日常更新仅下载变更区块，预计节省 60%~90% 流量

 ## 环境变量加载机制（主进程）
@@ -293,11 +295,11 @@
 ④ updater.ts 硬编码默认值（https://www.heixiu.com）
 ```

-| 文件 | 何时生效 | 进 git | 用途 |
-|------|---------|:------:|------|
-| `.env.development` | `npm run dev` | ✅ | 本地开发（API → 测试服务器） |
-| `.env.production` | `npm run build:xxx` | ❌ | 构建时参考（API → 生产服务器） |
-| `.env.local` | 始终（后加载） | ❌ | 个人特殊配置（打包后连本地测试） |
+| 文件                 | 何时生效                | 进 git | 用途                 |
+|--------------------|---------------------|:-----:|--------------------|
+| `.env.development` | `npm run dev`       |   ✅   | 本地开发（API → 测试服务器）  |
+| `.env.production`  | `npm run build:xxx` |   ❌   | 构建时参考（API → 生产服务器） |
+| `.env.local`       | 始终（后加载）             |   ❌   | 个人特殊配置（打包后连本地测试）   |

 > `.env.production` 和 `.env.local` 不打包进 ASAR。打包后无这些文件时自动使用代码默认值。