用途：对依赖 @open-mercato/* 的独立应用或下游仓库执行 Open Mercato 0.6.7 → 0.7.0 升级中的机械性部分，以 UPGRADE_NOTES.md 对应章节为准，意图敏感改动一律作为人工发现项报告。不修改框架 monorepo、框架自有 packages/、依赖版本、锁文件、生成产物、vendor 依赖或密钥。
参数：--path <dir> 指定下游仓库根目录（默认当前目录）；--dry-run 只检测、分类、报告，不编辑文件或执行变更命令；--only <id[,id...]> 限定检查项；--skip <id[,id...]> 跳过并记录。拒绝未知参数，禁止同时使用 --only 与 --skip。
主要能力：覆盖 21 类升级检查，如 passkey-mfa-assertion、jwt-secret-required、standalone-ds-i18n-gates、module-fact-sheet-directories、user-confirmation-semantics、audit-log-context-shape、global-search-acl、hybrid-search-acl、preset-search-module、data-sync-batch-traces、tanstack-table-v9、ioredis-resp2、sales-line-default-order、workflow-unresolved-templates、credential-free-integrations、removed-example-injection-flag、module-facts-v2、settings-section-group-id、webhook-body-limits、standalone-security-headers、sidebar-preference-null。仅对精确匹配执行自动编辑：ColumnDef 类型导入改为 LegacyColumnDef as ColumnDef、settings groupId 改为 settings.sections.moduleConfigs、删除 .env* 中已移除标志的赋值行、扁平模块事实表路径改为 <id>/index.md。
使用方式：先校验目标（存在 package.json 且含 @open-mercato/ 依赖，版本为 0.7.0 或经用户确认），排除 .git、node_modules、生成目录等；展示编辑计划并确认后执行最小幂等编辑；再按下游声明的脚本依次运行生成、类型检查、受影响测试、构建；最后报告改动文件、人工发现项、验证结果与未决运维事项。
限制：不自动放宽权限、不编造 ACL、不改写工作流意图、不重钉事实 ID、不削弱 CSP、不生成或打印 JWT_SECRET、不删除或重置 MFA 凭据、不削弱类型检查/测试/构建。若无需代码改动，仍报告全部 21 类检查已运行，并建议部署前审阅完整升级说明。