---
globs: src-tauri/resources/onboarding/**
---
修改接入包模板时，检查 `docs/templates/agents-meta-rules.md` 是否需要同步更新——两者描述同一套元规则，必须保持一致（单一事实来源：tmpl 是分发实体，docs/templates/ 是设计草案）。

**改模板内容必须同步升级 `ONBOARDING_MANAGED_START version="x.y.z"` 版本号**——版本是分发引擎唯一的升级信号，内容变了版本不动，批量分发会全部 skipped（2026-07-06 实测踩坑）。模板改完后跑 `cargo test onboarding` 确认版本相关测试通过。

该规则已由指纹测试 `managed_template_fingerprints_track_versions`（`onboarding.rs`）机器校验：`resources/onboarding/**` 任何内容变化须升 `BASE_ONBOARDING_PACK_VERSION` 与模板 `capability-packs.json` 版本，管理块内容变化另须升块首 version，再按测试报错把新摘要填回 `TEMPLATE_FINGERPRINTS`。

分发到子项目需要**重建安装炼境**（模板打包在二进制资源里），再调 `apply_onboarding_pack`。