31 lines
1.4 KiB
Markdown
31 lines
1.4 KiB
Markdown
---
|
|
description: 自诊断 —— 一次查完所有前置条件,定位同步为什么不能用
|
|
---
|
|
|
|
用 Bash(Windows 用 git-bash)运行诊断脚本(只读,不改任何东西):
|
|
|
|
```bash
|
|
export ZCODE_SYNC_PASSPHRASE='团队口令' # 给了才能验证"latest 能否解密"
|
|
SYNC_PLUGIN="${ZCODE_SYNC_PLUGIN:-$(find ~/.zcode/plugins -maxdepth 3 -name doctor.mjs -path '*env-sync*' 2>/dev/null | head -1)}"
|
|
node "$SYNC_PLUGIN"
|
|
```
|
|
|
|
二十多项检查(条数随环境变化),每项给 `✓ ok` / `⚠ warn` / `✗ fail`,失败项附**可执行的修复建议**:
|
|
|
|
- 运行时:Node 版本、git 是否可用
|
|
- 凭据:同步口令是否设置且够长、Gitea token 是否读到
|
|
- 仓库:工作区是否已克隆、`origin` 是否内嵌凭据(会明文留在 `.git/config`)、
|
|
换行符锁定(`.gitattributes: * -text` + `core.autocrlf=false`,否则 hash 会漂移)、
|
|
`HEAD` 与 `origin/main` 是否一致、有无未提交改动
|
|
- 快照:总数与总体积、manifest 是否损坏、`latest` 指向是否有效、**当前口令能否解开 latest**
|
|
- 环境:启用插件数、自研插件、本插件版本、MCP server 数、模型 provider(几个带密钥)、备份目录
|
|
|
|
退出码:有 `fail` 时为 1。
|
|
|
|
用法场景:**用户说"同步不工作/导入失败/推送失败/status 报版本不同"时,先跑这个**,
|
|
再把报告里的 `fail` 项与修复建议照实告诉用户,不要自己猜。
|
|
|
|
**把脚本输出原样展示给用户**。
|
|
|
|
用户附加要求:$ARGUMENTS
|