Yang-RuiQi/ele-HeiXiu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
41 Commits 2 Branches 0 Tags
e4c9ae8fc67894a0a85c4d47cbbefc81a9d3951d
Commit Graph

9 Commits

Author SHA1 Message Date
YoungestSongMo
e4c9ae8fc6 feat: 三栏比例缩放 + SeedanceContent视频上传 + 本地存储基建 (0.0.22) 
三栏布局
- ResizeObserver 等比例分配替代固定默认值恢复
- 修复拖拽+窗口调整竞态卡死（needsRecalcRef 延迟补算）
- containerRef.current 动态读取 DOM 替代闭包 el

Seedance2Content
- 从占位文本重构为内容编排控件（文本+图片/视频/音频上传）
- 根据 spec.image_files/video_files/audio_files 动态渲染上传区域
- 值 JSON 序列化 → 提交时转 ContentItem[]（text/image_url/video_url/audio_url）

图片上传兼容视频文件
- buildAccept 根据 file_filter 区分 image/video 前缀
- createMediaBeforeUpload 动态放行 video/* MIME
- 公共模块 media-upload-utils.ts

本地存储基建
- sql.js (WASM SQLite) + safeStorage 加密持久化
- 8个IPC文件操作通道 + resolveSafe 路径穿越防护
- <userData>/heixiu-data/ 沙箱 + JWT用户隔离
- 7表DDL + 游标分页 + LRU媒体淘汰

其他
- 修复 errorMessageRef 渲染期写入警告
- 媒体预览回退直接URL（<img>无CORS限制）+ output_type类型补充
- CSP wasm-unsafe-eval + https: CDN媒体源
 2026-06-18 19:22:28 +08:00
YoungestSongMo
95019316b2 feat: 前后端联调 — 任务创建 + 账户信息 + 预估花费 (0.0.18) 
- task: device_id 改为必填参数，API 层 Omit 封装 + getDeviceId() 自动注入
- pricing.ts: Python 后端 calculate_cost 完整移植，六种定价模式 + 6 个 Bug 修复
  (浮点冗余/维度匹配不一致/null 守卫/matrix 数据提取/unit_scale 等)
- ModelInputForm: 三层兜底预估消费展示 + React Hooks 顺序修复
- AccountInfo: VIP 等级列表匹配，套餐详情展示（说明/周期/席位/到期）
- 模型列表加密缓存 (safe-storage, stale-while-revalidate)
- VIP API 模块 (激活码/等级/订单/模拟支付)
- device_id 统一使用 UUID v4 持久化 (与 login/register 对齐)
 2026-06-10 19:38:26 +08:00
YoungestSongMo
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
YoungestSongMo
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
YoungestSongMo
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
YoungestSongMo
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
YoungestSongMo
ae733016bb feat: 日志模块 + netRequest 封装 + PROJECT.md 更新 
日志模块（文件持久化 + 事件总线联动 + 脱敏）
    新增：
      - shared/types/logging.ts         — LogLevel / LogCategory / LogEntry 类型
      - electron/main/logger.ts         — 主进程日志核心（JSON Lines / 每日轮转 / 7天清理）
      - electron/main/log-ipc.ts        — 渲染进程日志 IPC 通道接收
      - src/utils/logger.ts             — 渲染进程日志器（IPC 转发 / DEV 控制台 / 事件总线钩子）
      - shared/utils/sanitize.ts        — 脱敏工具（ID哈希 / 邮箱 / 手机 / 名称 / Token）
    修改：
      - electron/main.ts                — initLogger + flushLogger + uncaughtException
      - src/main.tsx                    — renderer 全局错误捕获
      - src/utils/event-bus.ts          — setEventLogListener 钩子，emit 自动审计
      - src/services/request.ts         — 拦截器结构化错误分级记录
      - electron/main/updater.ts        — 14处 console → logger 迁移
      - src/components/AppProvider.tsx   — 登录/登出/自动登录 auth 事件日志
      - shared/constants/ipc-channels.ts — 新增 LOG_MESSAGE 通道

  netRequest 封装（Electron net.request 的 axios 风格 API）
    新增：
      - electron/main/net-request.ts     — netRequest.get/post/put/del 命名空间
    修改：
      - electron/main/updater.ts         — fetchUpdateInfo 改用 netRequest（22→12行）

  文档更新
    - PROJECT.md                       — 目录结构 / 状态管理 / 日志系统 / IPC 章节同步现状
    - TODO.md                          — 增量更新改造 + 日志模块待办
    - UpdateA.md                       — API blockmap 字段 / 数据库字段说明
 2026-06-04 11:03:25 +08:00
YoungestSongMo
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
YoungestSongMo
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