|
|
53df926973
|
refactor: Context 与 Provider 合并 — 消除 contexts/ 目录，一文件一状态单元
- ThemeContext + useTheme → ThemeProvider.tsx（原 hooks/use-theme.ts 删除）
- AppContext + useAppContext → AppProvider.tsx（原 contexts/app-context.ts 删除）
- SettingsContext + useSettings → SettingsProvider.tsx（原 contexts/settings-context.ts 删除）
- HomeContext + useHomeContext → HomeContent.tsx（原 contexts/home-context.ts 删除）
- 删除空的 contexts/ 目录，20+ 导入路径同步更新
- TypeScript 编译通过（npx tsc --noEmit 零错误）
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
2026-06-09 14:02:48 +08:00 |
|
|
|
eb12248a62
|
feat: 主题切换性能优化 — View Transitions API + 0.15s 统一过渡 + 设置页增强
【问题】
桌面端（Electron）切换主题时颜色变化速度不一致、明显卡顿。
根因分析（4 轮迭代）：
1. 过渡时长不统一（body 0.3s / 组件 0.15s）→ 统一到 0.2s
2. antd CSS-in-JS 标签替换导致瞬间变色 → 尝试 cssVar（无效，仍走标签替换）
3. applyHtmlTheme 在 updater 回调中执行，与 antd CSS 变更不同帧 → 移入 useLayoutEffect
4. html * 全局过渡在 Electron 中为数千 DOM 节点同步插值 → 合成器掉帧
终极方案：View Transitions API（GPU 合成器 1 次 cross-fade 替代 N 个 CSS 过渡）
+ 精准 CSS 过渡覆盖 ~80 个 antd 容器类（回退方案）
【修改】
ThemeProvider.tsx — 核心重构
- applyHtmlTheme 从 setIsDark updater → useLayoutEffect([isDark])
确保自定义 CSS 变量与 antd CSS-in-JS 在同一次 React 提交中生效
- View Transitions API：document.startViewTransition + flushSync
GPU 合成器截取旧/新两帧做单次 cross-fade，消除多元素插值卡顿
- 浏览器不支持时自动回退到 CSS transition 方案
globals.css — 过渡策略
- body: 0.3s ease → 0.15s linear
- View Transitions 动画：::view-transition-old/new(root) 0.15s linear
- ~80 个 antd 容器类精准过渡（Layout/Card/Modal/Table/Input/
Select/Picker/Menu/Tabs/Tag/Alert/Empty/Result/Skeleton 等）
按功能分组：布局 → 表格 → 表单 → 导航 → 反馈
不覆盖交互组件自有 transition（Button/Switch/Slider 等）
linear 替代 ease — 匀速插值，桌面应用更利落
Layout.tsx / HomeContent.tsx / LeftPanel.tsx / ModelSelector.tsx
- 过渡参数对齐：全部 0.2s → 0.15s linear
SettingsPage.tsx — 用户体验
- Modal 取消 keyboard={false}，Esc 键可关闭
- macOS：关闭按钮移至标题左侧（遵循 macOS HIG）
- afterClose 中 blur 当前焦点元素，防止聚焦跳到导航栏
【文档】
CHANGELOG.md — 新增 0.0.15 版本记录
CLAUDE.md — 新增主题系统架构章节（双轨颜色体系 / 时序 / 过渡策略）
|
2026-06-09 11:02:40 +08:00 |
|
|
|
ada915f298
|
feat: 去 React Router 化 + 实现三种窗口类型的页面调度体系
移除 react-router-dom 依赖，将导航从 URL 路由切换为事件总线驱动，
新增 Modal / Drawer / FloatingPanel 三种窗口类型支持。
架构变更：
- 删除 src/router/（唯一路由 /* → HomePage，无实际用途）
- App.tsx 移除 HashRouter，直接渲染 Layout > HomePage
- Layout 从 useLocation + Outlet 改为 children prop
- NavBar 移除 useNavigate，所有页面导航改为 emit(OPEN_PAGE)
- NavAction 精简：'navigate'|'spa' 合并为 'page'
新增组件：
- FloatingPanel：纯手写非模态浮动面板（可拖拽、无遮罩、多面板共存、
暗色主题适配、边界约束），对应 QT 非模态窗口的 Web 映射
Modal（居中模态）| Drawer（侧滑）| FloatingPanel（浮动可拖拽）
- 8 个页面占位组件（compliance-assets/account/vip/recharge/
billing/orders/projects/quota），各显示导航栏名称作为占位
配置扩展：
- NavItemConfig 新增 modalType?: 'modal' | 'drawer' | 'floating'
- nav-config 所有 page 项补齐 modalType（支付类→modal，浏览类→floating）
- event-bus 新增 OPEN_PAGE 事件，payload 携带 {target, modalType, label}
- 卸载 react-router-dom@^7.16.0（连带移除 4 个包）
设计原则：
- 页面组件不感知窗口类型（内容与容器分离），切换窗口类型只需改配置
- Modal/Drawer 单实例（模态含义=独占注意力），Floating 多实例共存
- 主页面始终挂载不卸载，所有子页面为叠加层（对应 QT 多窗口模型）
|
2026-06-08 16:33:47 +08:00 |
|
|
|
7032d1c3f2
|
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 |
|
|
|
72ec1a5459
|
fix: 修复主题切换后首页状态重置 + 首页 UX 优化 + 文档同步
## 根因
设置页 `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: 更新日期 + 新增叠加层模式章节
|
2026-06-07 05:21:47 +08:00 |
|
|
|
6204c14b88
|
feat: 重构更新流程 — 无更新不抛异常、用户决定下载、更新详情展示（md文件中的）
【核心重构】
- getLatestVersion() 不再 throw Error，无更新时返回 { version: APP_VERSION }
- checkForUpdates() 先自行预检 → 无更新直发 IPC，有更新才交 electron-updater
- 移除 NO_UPDATE_MESSAGE 常量及所有字符串匹配拦截代码
- HeiXiuProvider 增加 500ms TTL 缓存，避免预检+electron-updater 重复请求 API
【用户体验】
- 检查到新版本后不再自动下载，展示更新内容供用户决定
- 新增"下载更新"按钮（与"安装更新"分离为两步操作）
- 设置页新增"查看详情"弹窗，Markdown 格式化渲染更新日志
- available / downloading / downloaded 三个状态 UI 独立展示
【Bug 修复】
- 测试服务器版本排序：字符串序 → 语义版本序（_version_key），0.0.10 正确 > 0.0.9
- 版本比较：!= → <（_version_key），防止高版本误判为有更新
- get_best_release fallback 同样改为语义版本排序
- Windows cmd set 命令尾部空格 → Invalid URL（.trim() 修复）
- electron-updater 'error' 事件中拦截 NO_UPDATE_MESSAGE → UPDATE_NOT_AVAILABLE
【文档更新】
- CHANGELOG.md、PROJECT.md、UpdateA.md 同步更新架构图和流程说明
|
2026-06-04 18:31:52 +08:00 |
|
|
|
3becdb85d4
|
feat: 实现设置页面 + 路由系统 + JWT认证体系 + 公告优化 + 错误类型系统
## 新增功能
### 设置页面（Router + Modal 叠加）
- HashRouter 路由系统，Electron file:// 协议兼容
- 设置页以居中 Modal 叠加首页，仅 X 按钮关闭
- 主题切换 Segmented 控件（与首页 Switch 共享 Context）
- 大模型产物存储仓库路径配置（原生文件夹选择对话框）
- 企业版额外：团队创作存储仓库路径
- 系统信息展示（平台/版本/版本类型/环境）
- 版本更新检查（状态机：idle→checking→no-update/available→downloading→downloaded→error）
### JWT 认证体系
- 双 Token 机制：access_token + refresh_token
- Axios 拦截器 401 自动刷新 + 并发请求去重队列
- 启动时 refresh_token 静默续期（自动登录）
- 记住密码：Base64 编码存储，表单自动回填
- setTokenRefreshHandler 解耦模式：request.ts 不知晓 auth
### 自定义错误类型系统
- RefreshError 继承 RequestError，type = AUTH_EXPIRED
- 全局拦截器捕获 RefreshError → 自动 clearToken + AUTH_REQUIRED
- 任何位置 throw new RefreshError() 即可触发登录 Modal
### 公告卡片优化
- 长文本 Tooltip 悬浮预览
- 点击卡片弹出详情 Modal（全文保留换行）
### SettingsContext（类似 Vue Pinia）
- 集中式设置状态管理
- localStorage 持久化：ele-heixiu-output-path / ele-heixiu-team-repo-path
- useSettings() 全局消费
## 架构变更
- App.tsx → HashRouter + AppRoutes + LoginPage 弹层
- Layout.tsx = NavBar + <Outlet /> 页面壳
- HomePage.tsx 从 App.tsx 提取
- NavBar 使用 useNavigate() 真实路由导航
- useUpdater 改为模块级单例 IPC 监听器（修复 MaxListenersExceededWarning）
- electron/main.ts 新增 FILE_DIALOG IPC handler
## 依赖
- 新增 react-router-dom
|
2026-06-03 19:25:15 +08:00 |
|
