主题
变更记录
只记录会影响生成项目或升级方式的变更;逐条实现细节看
git log。 框架自己的版本号唯一来源是package.json,生成项目里对应app.config.json的frameworkVersion。
v0.3.0(2026-11-17)
本版只动框架自身的工具链与文档,生成的项目无需改代码。
新增
- 文档站:
docs/用 VitePress 渲染,内容就是仓库里的 Markdown,不再另存一份。pnpm docs:dev本地预览、docs:build出静态文件、docs:deploy直传 Cloudflare Pages (AtomGit 没有 Pages,但 Pages 只认静态文件,不用把仓库搬走)。 - CHANGELOG 门禁:发版要求目标版本在
CHANGELOG.md有段落且不是自动草稿; 缺失时按git log生成分组草稿后退出,逼着人整理一遍再发。 docs/changelog.md由根CHANGELOG.md单向同步,pnpm docs:check与发版都会拦截漂移。- CI 补 shell 语法(
bash -n)、版本一致性(release --check)、文档站构建与同步检查。
修复
- 生成项目的
wifi-web/前端包此前不在 workspace 里,pnpm -r typecheck/build根本不检查它们; 现已纳入,Vue 版包名改为<slug>-wifi-web-vue,避免与 React 版重名。
升级
无破坏性变更,照常替换框架副本即可:
bash
node scripts/update-core.mjs --ref v0.3.0
pnpm installv0.2.0(2026-11-17)
破坏性变更:项目结构
core/ 与 build/ 合并为 framework/,build/ 里的项目配置移到项目根 config/。 框架代码与项目资产彻底分开:升级框架只替换 framework/,不再碰版本、签名、商店配置。
| 旧位置 | 新位置 |
|---|---|
core/crates、core/packages、core/README.md | framework/core/*、framework/README.md |
build/scripts/ | framework/build/scripts/ |
build/env/ | config/env/ |
build/version.json | config/version.json |
build/stores.json、build/metadata/ | config/store/ |
build/config/{android,ios,harmony}/ | config/signing/{android,ios,harmony}/ |
build/dist/、build/out/ | dist/、dist/out/ |
Rust 依赖 ../core/crates/* | ../framework/core/crates/* |
前端依赖 file:../core/packages/* | file:../framework/core/packages/* |
schemaVersion升到 3。低于 3 的旧结构直接报错,不做静默回退——不确定读到的是新值还是旧值, 比报错更难排查。旧布局项目请用最新框架重新生成,或按上表手工迁移。package.json的脚本入口统一改为framework/build/scripts/*。
新增
app.config.json的 JSON Schema:core 模式生成时装配到framework/config.schema.json, 并在首行写入"$schema": "./framework/config.schema.json",编辑器可补全与标红非法字段。 link 模式两者都不带。- 生成器金丝雀扩到 5 种组合(默认 / 全关 / 仅 wifi-bridge / 仅 privacy-consent / link 模式), 新增断言:
$schema写入策略、依赖引用完整性(path与file:依赖目标必须存在)、 默认组合跑一次update-core再严格校验。 - CI 补齐:
bash -n全量 shell 语法、release --check版本一致性、Schema 与配置字段交叉校验。 - wifi-bridge 的失败有明确契约:所有接口出错返回
{ ok:false, error },端口被占是409, 超出单次上限是413+ 可读文案;/status增加max_upload_bytes。
修复
update-core.mjs写入lastUpgrade后,pnpm config:check会因「未知字段」直接失败(会拦住发版)。update-core.mjs重建framework/core/Cargo.toml时把版本写死成旧值,升级后 workspace 版本不对。release.mjs发版时漏提交Cargo.lock,拉下 tag 后第一次cargo build就把工作区改脏。- 传输页把后端字段
reason读成error,上传失败永远只显示「1 个失败」。 - 同名文件并发上传会互相覆盖(
exists()检查与create之间有竞态)。
升级
bash
# core 模式项目:整体替换 framework/,config/ 与业务代码不受影响
node scripts/update-core.mjs --ref v0.2.0
pnpm install
pnpm --dir frontend typecheck
cargo check --manifest-path rust/Cargo.toml旧布局(配置在 build/)的项目不能直接升级,需用最新框架重新生成。
v0.1.0
首个可用版本:ReactLynx 4.2 + Rust 微内核、三端壳模板、Bridge 路由、设置与存储基座、 dev/prod 双环境打包、上架打包体系(AAB / IPA / App Pack / 上传包)、wifi-bridge 可选能力。