此功能为实验性功能。标志、输出格式和行为可能在不同版本之间发生变化。请在受控工作流中使用,并在 CI 中固定版本。随着 TMS 集成的成熟,冲突处理和同步约定可能会不断演变。
用法
安全的默认行为
sync pull 默认为试运行模式。先查看报告,然后使用 --dry-run=false 重新运行。
sync pull 在执行时将远程适配器视为权威。它会为请求的范围获取一份新的远程快照,将其与本地文件进行比较,然后在写入本地更新之前应用拉取策略和不变式检查。
本地元数据 sidecar 仍可用于报告,但对于拉取正确性而言并非必需。
标志
--config:配置路径--locale:目标语言环境,可重复--key-prefix:将同步范围限制为具有任意匹配前缀的键,可重复--dry-run:仅预览(默认true)--output:text、json或markdown--fail-on-conflict:在检测到冲突时返回错误(默认true)--apply-curated-over-draft:允许精选的远程值替换本地草稿值(默认true)
示例
注释
- 远程读取始终是所请求范围内的最新数据
- 拉取会在策略检查后应用入门级创建和更新
- 不变量违规仍会阻止不安全的本地写入