|
|
8b697e775d
|
feat: 去除构建时版控变量 + 窗口标题动态版控 + 退出登录保留缓存 (0.0.24)
版控体系重构（13 文件）：
- 移除 build.mjs --personal/--enterprise 参数和 EDITION 环境变量
- 统一安装包文件名：船长-HeiXiu-{os}-{版本号}-Setup.{ext}
- 简化 package.json 构建脚本，移除 :enterprise 变体
- scripts/*.mjs 不再接受 edition 参数
- 移除 shared/constants/app.ts 的 parseEdition()
窗口标题动态版控：
- 新格式：船长-HeiXiu-{os}-{版本号}（登录前）/ ·{版控} 后缀（登录后）
- 链路：AppProvider(account_type) → useEffect → appRuntime IPC → main process
- 移除 updater.ts 更新检查 API 的 edition 查询参数
本地存储生命周期修正：
- 退出登录不再自动清空缓存（user_id 隔离，重新登录命中缓存）
- clearUserStorage 添加 isOpen() 竞态守卫
- 移除 closeDatabase() 避免退出→重新登录后数据库不可用
- 手动「清理缓存」按钮保留
文档：
- CHANGELOG.md 新增 0.0.24 条目
- TODO.md 新增已完成项
|
2026-06-22 13:36:42 +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 |
|
|
|
1da95eaef3
|
feat: 实现业务首页（三栏布局 + 轮播图）
## 首页整体架构
- 新增 src/pages/home/ — 完整首页模块（10 个组件）
- HomePage / HomeContent：三栏弹性布局，拖动分隔条调整列宽
- BannerCarousel：顶部轮播图（antd Carousel，2280×90 长条图片适配）
- LeftPanel：模型选择器(Menu 分组) + 任务记录(Table 分页)，纵向拖拽调整比例
- CenterPanel / ModelInputForm：动态表单，根据模型 param_schema/ui_config 渲染控件
- RightPanel / OutputPreview：任务输出预览（Image/Video）
- 新增 Layout 组件：h-screen flex 布局，首页 Banner + NavBar + Outlet
## 数据层（数据与视图分离）
- 新增 src/services/modules/ — API 模块（banner/models/task/auth）
- TaskAPI 静态方法，TaskInfoItemResponseBody 判别联合类型
- ModelAPI / BannerAPI，const 断言路由常量
- 新增 src/hooks/use-async.ts — 通用异步 Hook
- useAsyncData：竞态处理、条件请求(enabled)、自动错误日志
- useAsyncMutation：数据变更，onSuccess/onError
- getErrorMessage()：RequestErrorType → 可读错误信息
- 新增 src/hooks/use-api.ts — 业务 Hook
- useBannerList / useModelList / useTaskList / useTaskDetail / useSubmitTask
## 主题与交互
- 重写暗色令牌：科技感蓝紫（#080C24 底 / #0F1340 面板 / #2A3278 边框）
- 三栏分隔线：token.colorBorderSecondary 常驻 + 手柄竖线 hover 高亮
- 左面板纵向拖拽：模型区/任务区可调比例，ResizeObserver 自适应
- 暗色/亮色同步：tokens.ts + antd-theme.ts + globals.css 三处一致
## 基础设施
- EventBus 新增 TASK_SUBMITTED 事件（替代 Context 数字递增 hack）
- HomeContext 状态管理（选中模型、任务分页、折叠状态）
- 所有组件边框使用 token.colorBorderSecondary（主题自适应）
- Table 滚动高度 ResizeObserver 动态计算（修复分页器遮挡）
|
2026-06-05 16:24:17 +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 |
|
|
|
767bb8b297
|
feat: 初始化船长·HeiXiu 桌面应用项目（错误是svg的问题）
Electron + React 19 + TypeScript + Ant Design 6 + Tailwind CSS 4
【核心架构】
- Electron 主进程（窗口管理、平台检测、图标适配）
- Vite 构建链（双产物 dist/ + dist-electron/）
- 共享层 shared/（类型、常量、工具函数）
- IPC 通信框架 + 安全守卫
【主题系统】
- 蓝紫渐变主题（亮色/暗色双模式）
- Ant Design ConfigProvider 适配（lightAlgorithm / darkAlgorithm）
- Tailwind CSS 4 @theme 指令 + CSS 变量
- 设计令牌三处同步（tokens.ts / globals.css / antd-theme.ts）
【导航栏】
- 自定义 H5 导航栏替代系统菜单
- 个人版/企业版双布局
- 未登录拦截 + 事件总线驱动登录弹窗
【登录注册】
- Modal 弹层（Portal）+ Tabs 切换
- 登录/注册表单动态字段渲染
- 记住密码 / 自动登录 / 用户协议
【更新系统】
- 自定义 API 版本检查（替代 electron-updater generic provider）
- 手动下载 + SHA512 校验 + spawn NSIS 安装
- 渲染进程更新状态机 Hook（useUpdater）
- 检查更新按钮 + 下载进度展示
【构建工具链】
- build.mjs 构建总管（--win/--mac/--linux --personal/--enterprise --build/--clean/--sign/--upload/--publish）
- scripts/ 自动化脚本（clean / generate-update-info / upload-oss / publish-release）
- electron-builder NSIS 安装器（可选路径、多版本打包）
- update-info.json 自动生成（fileSize/sha512/changelog/releaseDate）
【代码质量】
- ESLint + TypeScript strict + Prettier
- husky + lint-staged（提交前自动检查）
- commitlint（规范提交信息）
- Playwright E2E + Vitest 单元测试框架
- rollup-plugin-visualizer 打包体积分析
【文档】
- README.md（快速开始 + 目录结构 + 命令速查）
- UpdateA.md（发布手册：API/签名/发版流程/数据库）
- CHANGELOG.md（更新日志）
- .env.example（构建环境变量模板）
|
2026-06-03 15:00:51 +08:00 |
|
