Files
ele-HeiXiu/CLAUDE.md
YoungestSongMo 337d6c1205 feat: 构建系统重构 + VCHSM 架构迁移 + 右键菜单修复 + 尺寸参数统一
## 构建、打包与分发系统重构 (build/)

- 构建系统收敛至 build/ 目录:build.mjs + electron-builder.js + 6 个脚本

- electron-builder 配置从 package.json 提取为 build/electron-builder.js

- 新增 --edition (personal/enterprise) 和 --channel (stable/beta/alpha) 参数

- OSS 路径按渠道隔离

- 新增 pre-build-check.mjs:Git/CHANGELOG/版本/环境变量校验

- 新增 bump-version.mjs:版本号管理 + CHANGELOG 自动生成

- updater.ts 发送 channel/edition/deviceFingerprint

- 新增 src/shared/utils/rollout.ts 灰度测试工具

- 新增 10 条 NPM 脚本

## VCHSM 五层架构迁移

- 7 个业务模块 + ~500 处导入路径同步

## 修复

- MediaCardContextMenu 改用共享 ContextMenu 组件

- ComboBox 尺寸参数显示统一 (size-format.ts)

## 文档

- UpdateA.md / build/README.md / README.md / .env.example 更新

Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-29 18:41:07 +08:00

1.7 KiB
Raw Blame History

基本交代

  • 所有交互、解释、代码注释与生成内容均使用简体中文,专有技术名词可保留英文,但需附带中文说明;
  • 有需要请自行调用MCP服务

业务设计思路

  • 进行任务时都需要考虑安全、性能、主题切换、业务自定义错误、事件总线驱动方式以及日志记录;
  • 进行系统级别的操作时需要考虑系统差异并处理兼容性。如WINDOWS、MAC OS
  • 处理业务时,需要同时考虑兜底机制和业务自定义错误捕获,比如后端在修改了某些数据的枚举值但没有通知时,需要能够正常转化对用户友好的提示信息;
  • 新增文件时,需要注意各个文件夹当前平铺的文件数量,如果过多需要考虑合并文件或者合并为子文件夹;
  • 在编写代码时尽量保持JSX文件只有HTML元素结构减少style属性的使用。其他关于js操作应提取为单独的TS模块文件如复杂页面交互逻辑、菜单组件的注册等
  • 所有设计思路、代码实现均需要考虑以上五个条件。

相关文档说明

  • 根目录下的文档包括:
    • README.mdgit中的README文档
    • WORKLOG.md工作日志文档
    • UpdateA.md热更新相关的文档
    • TODO.md未完善、未来要做的文档或者是在开发中遇到需要优化的地方
    • PROJECT.md项目文档
    • CHANGELOG.md版本更新文档
    • CLAUDE.md
  • 永远不要修改CLAUDE.md文档
  • 在各个文档中的更新需要保持精简。且职责划分保持严谨除了架构、项目文档已完成的事需要从TODO.md文档中移除。
  • 在没有得到修改指令时,不要修改文档文件。