用途：升级既有 EmDash 项目。运行 upgrade-emdash 解析所选 npm 发行标签，更新项目中每个直接 EmDash 包，刷新 EmDash 技能，并生成项目专属工作单。该更新器不修改应用代码、不应用数据库迁移、也不部署。
准备与执行：在项目根目录运行 npx upgrade-emdash@latest --dry-run 预览，再运行 npx upgrade-emdash@latest。用 --to <tag> 切换到 next、beta 等其他 npm dist-tag，注意 --to 不接受具体版本号。非交互环境可用 --yes 接受提示，--json 输出机器可读的 dry-run 结果，项目根目录在别处时用 --cwd <path>。执行后更新器写入 .emdash/UPGRADE.md，需阅读该文件：它包含本项目直接包所跨过的完整手写变更日志条目（已去除自动生成的依赖升级条目），以及安装后找到的核心迁移差异。
完成升级：检查现有项目及其未提交改动，保留无关工作。对照 .emdash/UPGRADE.md 中每个发行条目评估项目，应用必要的源码与配置改动；项目未使用相关表面时不要引入新功能。运行仓库相关的格式化、测试、类型检查与构建命令，并从工作单运行迁移状态命令，报告目标数据库与待处理迁移。当工作单列出新增核心迁移、状态命令报告较早的待处理迁移，或某发行条目要求改动数据的项目操作时，须按工作单的备份流程操作，之后才能启动或部署升级后的应用。
限制与注意：应用迁移到数据库、部署或任何远程改动前须先询问，除非用户明确要求。授权迁移和部署后，运行迁移检查并验证受影响的站点路径。核心迁移只向前，没有新增或待处理迁移的包更新不需要升级专属恢复点。授权改动数据库前，需具备用备份与恢复创建的、可还原的数据库备份，单独的媒体备份、相关加密密钥，以及用于迁移和部署的同一构建产物；JSON 备份不算恢复点。回滚应同时还原匹配的数据库与应用产物，而不是运行迁移 down() 或删除迁移记录。