主题
目录结构迁移检查清单(framework/ + config/)
依据 architecture.md §10.1 的规范。按顺序执行,每步都能独立验证。 目标:
core/+build/→framework/,build/里的项目配置 → 根config/。
0. 前置
- [x]
main与origin/main同步,工作区干净 - [x] 基线通过:
node scripts/generate-check.mjs - [x] 记录当前生成项目结构(迁移后用来对照)
1. 框架仓库内重组
- [x] 新建根
build/,迁入templates/app/build/(P1-6 已完成) - [x] 新建
templates/config/,承接生成项目用的默认配置:env/{dev,prod}.json、version.json、store/{stores,listing,icon}.json、signing/*.example - [x]
templates/wifi-web/→features/wifi-bridge/web/{react,vue}/(P0-2 已完成) - [x]
templates/app/只保留frontend/、rust/、docs/与骨架文件(P1-6 已完成) - [x] 删除空的
templates/app/build/,确认没有残留引用(P1-6 已完成)
2. 脚本路径适配
- [x]
templates/app/package.json中build/scripts/*→framework/build/scripts/* - [x]
build/scripts/*.mjs的ROOT再向上一层(dirname/../../..) - [x] 所有配置读取走
config.mjs的resolveProjectPaths(),禁止硬编码build/env/... - [x]
config.mjs路径解析全部指向config/,schemaVersion升到 3(无旧项目,不留回退) - [x]
scripts/update-core.mjs:替换范围从core/扩到framework/,不触碰config/、platforms/
3. 生成器装配
- [x]
create.mjs组装framework/{core,build}(core←crates/+packages/;build← 根build/) - [x] 项目配置写入根
config/(installProjectConfig():templates/config/→config/) - [x] Rust 依赖路径:
../core/crates→../framework/core/crates - [x] 前端
@aura/*:file:../core/packages/*→file:../framework/core/packages/* - [x] 三端壳内的路径(keystore / signingConfigs / 图标 / privacy)同步到
config/ - [x] core 模式写
app.config.json的$schema(./framework/config.schema.json),link 模式不写 - [x]
generate-check.mjs:新增framework/、config/、旧路径不存在的断言(并补 link 模式组合)
4. 验证
- [x]
node --check覆盖scripts/*.mjs、build/scripts/*.mjs;bash -n覆盖全部 shell - [x]
node scripts/generate-check.mjs通过(5 种组合:4 feature 组合 + link 模式) - [x] 生成项目里
sync-config --check、load-env、doctor、preflight --no-artifacts均正常 - [x] 三端
DRY_RUN=1 build-*.sh计划输出正确,产物落到dist/ - [x] 无旧布局项目,
build/旧路径回退与旧 config 结构兼容分支已删除 - [x]
update-core.mjs --local可整体替换framework/
5. 文档同步
- [x]
docs/architecture.md§8 的项目树、§10 的配置清单改为新结构;§10.1 标为已实施 - [x]
docs/quickstart.md、templates/app/README.md、build/README.md路径更新 - [x] 根
README.md删除「待实施」标记 - [x]
docs/extraction-map.md标记为历史文档(内容已部分过时)