主题升级模型：starter 初始化，npm 持续更新

主题项目最常见的问题之一是：初始化方便，但升级混乱。Anglefeint 的做法是把路径统一。

初始化：

npm create astro@latest -- --template anglefeint/astro-theme-anglefeint#starter

兼容的纯包更新：

npm update 只更新主题包，不会改写本地 starter 的配置、路由、适配器或 Astro 集成。如果发布说明要求更新工程结构，应在新目录创建最新 starter，再迁移文章和个人设置，不要用旧配置辅助文件覆盖新文件。详见升级指南。

npm update @anglefeint/astro-theme
npm run doctor

npm update 只在 package.json 声明的范围内更新：^0.5.1 不包含 0.6.0。兼容但跨范围的更新，应按发布说明安装明确的目标版本，不要直接安装 @latest。用 npm ls @anglefeint/astro-theme astro 确认实际版本。

当前 starter 的 doctor 已包含检查和构建，成功后用 npm run preview 人工检查站点。只有明确报告生成适配文件与本地模板不同步时，才运行 npm run sync-adapters，然后重跑 npm run doctor；它不会下载上游模板。旧工程的脚本可能不同，请查看本地 package.json 并遵循升级指南。

这样主题核心可以通过包分发持续更新。

遇到 Astro 大版本迁移时，先看官方升级文档，再执行本项目的检查与构建命令。

目标不是零人工，而是路径清晰、可重复执行。