zcode-tooling/zcode-env-sync/commands/sync-export.md

description

description
导出本机 ZCode 环境快照并推送到 Gitea 私仓(root/zcode-env-sync)

用 Bash(Windows 用 git-bash)运行导出脚本。口令必须先设置(团队线下约定,不要进仓):

export ZCODE_SYNC_PASSPHRASE='团队口令'
SYNC_PLUGIN="${ZCODE_SYNC_PLUGIN:-$(find ~/.zcode/plugins -maxdepth 3 -name export.mjs -path '*env-sync*' 2>/dev/null | head -1)}"
node "$SYNC_PLUGIN" $ARGUMENTS

SYNC_PLUGIN 从本机插件目录自动定位,不写死路径(快照要跨机器还原, 写死路径到了别的机器就是废的)。也可以直接设 ZCODE_SYNC_PLUGIN=/绝对/路径/export.mjs。

可选参数(环境变量):

• ZCODE_SYNC_REPO=root/zcode-env-sync 私仓坐标
• ZCODE_SYNC_HOST=https://gitea.mymoyu.top 托管地址
• ZCODE_SYNC_WORK=~/.zcode-env-sync 本地工作区(含 repo clone 与备份)
• ZCODE_SYNC_WITH_MODELS=1 连带同步模型 provider(默认关;开启时只写脱敏版, 真密钥走加密束) —— 覆盖默认 4 项
• ZCODE_SYNC_NO_PUSH=1 只落本地不推远端(离线排查用)
• ZCODE_SYNC_ALLOW_SECRETS='$.路径' 逗号分隔,放行已知误报的密钥扫描
• ZCODE_SYNC_ALLOW_PATH_LEAK=1 放行路径残留自检(确认无害时才用)

导出过程自带两道闸门,命中即中断且不推送:明文区出现真密钥值、明文区残留本机路径。

把脚本输出原样展示给用户,包含快照名、推送结果、各项统计。 失败时把报错和缺什么说清楚,不要自己编快照名。

用户附加要求:$ARGUMENTS