sync
将资源包变化同步到所有已配置引擎,保留你的修改。
用法
navori sync [--interactive] [--apply] [--yes] [--accept-new] [--accept-new-files] [--keep-mine] [--dry-run] [--json] [--workspace <name>]
参数
--interactive 逐个查看差异并选择保留或接受,适用于 CLAUDE.md 块、带标记整文件及无标记整文件;后者整份替换并备份。 --apply 直接应用,无交互提示。 --yes 自动确认,有冲突时退出 1,适用于 CI 关卡。 --accept-new 无需询问,所有 CLAUDE.md 块冲突接受新内容。具有破坏性,需 --apply 或 --yes,先备份文件并保留用户区。 --keep-mine 无需询问,所有 CLAUDE.md 块冲突保留你的修改,应用其余变化。需 --apply 或 --yes。 --dry-run 显示计划,不写入。 --json 输出机器可读结果,抑制人类输出,适用于 CI。 --accept-new-files 无需询问,覆盖仍带 navori 标记的手改整文件。需 --apply 或 --yes,逐文件先备份;--accept-new 不处理整文件。 --workspace <name> 仅同步指定 monorepo 工作区。 示例
交互解决冲突
$ navori sync --interactive Conflict CLAUDE.md:idioma-rol - your edit + new rendered version ? keep mine / accept new
注意事项
- 手改受管理块时 sync 检测哈希漂移,不直接覆盖,由你解决。
- 带 navori 标记的手改整文件(智能体、技能、钩子、脚本、AGENTS.md 等)可用 --interactive 查看差异并保留/接受,或用 --accept-new-files 批量接受。完全无标记的旧脚本或自有文件仅可交互整份替换:提示并显示差异,默认保留,接受前备份且保留 30 天,可用 navori backup restore 恢复。批量参数和 --json 不触碰它们。标记仅剩部分或只在注释中出现时,须手动移开再运行 render --apply。
- --json 为各冲突提供 resolvable(bulk 或 none),输出 acceptNewFiles,不含文件内容,报告解决后的状态。
- sync 用于版本更新,render --apply 用于重新生成。
- 与其他受管理块一样,更新 .claude/.gitignore 及启用 codex 时的 .codex/.gitignore。