|
|
|
# 排障 FAQ
|
|
|
|
|
|
|
|
> 与代码版本无关的坑都放这里。格式：症状 → 原因 → 处置。新条目加在最上面。
|
|
|
|
|
|
|
|
## sync 后本地改动没了
|
|
|
|
|
|
|
|
- **症状**：`cdgs sync` 后，本地对 `SKILL.md` / `references/` 的改动被覆盖。
|
|
|
|
- **原因**：sync 是版本门控，以 `origin/main` 为准覆盖共享文件。
|
|
|
|
- **处置**：共享内容要走「bump `metadata.version` + push/PR」；个人沉淀放 `*.local.md` / `local/`（永不覆盖）。
|
|
|
|
|
|
|
|
## install.ps1 建 junction 全失败
|
|
|
|
|
|
|
|
- **症状**：skills 没注册上，store 里没有 junction。
|
|
|
|
- **原因**：在 Git Bash 里用了 `mklink /J`，MSYS 把 `/J` 当路径吞掉。
|
|
|
|
- **处置**：一律用 PowerShell `New-Item -ItemType Junction`。
|
|
|
|
|
|
|
|
## 模板（新条目复制这段）
|
|
|
|
|
|
|
|
```
|
|
|
|
## <一句话症状>
|
|
|
|
|
|
|
|
- **症状**：
|
|
|
|
- **原因**：
|
|
|
|
- **处置**：
|
|
|
|
``` |
