# scripts/mp-sync

跟随上游移植工具(说明与对照总表:`docs/porting/mp-sync-ledger.md`)。Node 24 或 `deno run -A` 均可运行,不依赖根 package.json / deno.json 任务。

| 脚本 | 作用 |
| --- | --- |
| `check.mjs [--mp <MP 仓库>] [--to <提交>] [--json] [--ledger <文件>]` | 比较 `ledger.json` 与 MP 目标提交:已变更 / 已删除 / `spider/`、`parser/` 新增文件,输出 `git diff` 命令;有变化退出码 1 |
| `build-ledger.mjs [--mp <MP 仓库>] [--commit <提交>]` | 扫描源码 `@mp-source <路径> @ <提交>` 标签 + `ledger.manual.json`,生成 `ledger.json`(含上游文件 sha256)并刷新文档表格 |
| `movieclaw-import.mjs [--repo <MC 仓库>] [--ref v0.27.0] [--check]` | MovieClaw v0.27.0(MIT)站点 YAML → `packages/adapters/src/sites/definitions/*.json` + `manifest.generated.ts`;覆盖层 `movieclaw-overrides/<id>.json`;`--check` 只比较 |

```bash
node scripts/mp-sync/check.mjs --to <新提交>
node scripts/mp-sync/build-ledger.mjs --commit <新提交>
node scripts/mp-sync/movieclaw-import.mjs --check
```

MovieClaw v0.27.0 之后为附条件许可:`movieclaw-import.mjs` 校验 ref→提交与 LICENSE=MIT,其他 ref 需 `--allow-ref` 并另行核对许可。