docs: 同步文件结构重组至文档（CHANGELOG/PROJECT/TODO）

- CHANGELOG: 新增 0.0.21 条目
- PROJECT: 更新目录结构、状态管理架构描述
- TODO: 移除已修复的 ESLint react-refresh 警告（HomeContext 拆分后自动消除）

PROJECT.md

@@ -68,18 +68,16 @@
 ├── 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/ # 设置面板（主题 / 存储 / 账号安全 / 系统信息 / 更新）
+│ ├── components/ # 可复用组件（按职责分三层）
+│ │ ├── providers/ # 状态管理（App/Theme/SettingsProvider）
+│ │ ├── shell/ # 应用外壳（Layout/PageDispatcher/navbar/）
+│ │ └── ui/ # 通用 UI 原子（FloatingPanel/LegalTextModal）
+│ ├── hooks/ # 自定义 Hooks（业务逻辑封装）
+│ ├── pages/ # 业务页面（按功能模块组织）
+│ │ ├── home/ # 首页（panels/ features/ controls/ hooks/）
+│ │ ├── auth/ # 认证模块（登录/注册/忘记密码/修改密码）
+│ │ ├── settings/ # 设置面板（sections/）
+│ │ └── panels/ # NavBar 触发的面板页（Account/Billing/WechatWork）
 │ ├── router/index.tsx # HashRouter 路由配置
 │ ├── services/ # HTTP 请求封装
 │ │ ├── request.ts # Axios 封装 + 拦截器 + Token 刷新
@@ -151,12 +149,14 @@
 ## 状态管理
 
 - 使用 React Context + Provider 模式管理全局状态，按领域拆分：AppContext（平台/登录）、ThemeContext（主题）、
-  SettingsContext（设置项）。避免引入 Redux 等重量级方案。
+  SettingsContext（设置项）。各 Context 定义与 Provider 合并在 `components/providers/` 目录下，避免引入 Redux 等重量级方案。
 
-- Provider 组件在 main.tsx 中按层级嵌套挂载：
+- Provider 在 main.tsx 中按层级嵌套挂载：
   AppProvider → ThemeProvider → SettingsProvider → AntdApp → App
 
-- 各模块通过自定义 Hook 消费（useAppContext / useTheme / useSettings），Hook 内部做 null 检查。
+- 各模块通过自定义 Hook 消费（useAppContext / useTheme / useSettings），Hook 内部做 null 检查并抛出明确错误信息。
+
+- 页面级状态（如首页的 selectedModel / selectedTask / 分页）放在 HomeContext 中，由 HomeContent 提供，遵循与全局 Provider 相同的 Context + Provider + Hook 模式。
 
 ## 日志系统