Fix Gist setup and first-run bootstrap

This commit is contained in:
2026-07-29 17:43:26 +08:00
parent 13cf327f48
commit f19466a5df
9 changed files with 189 additions and 65 deletions
+9 -10
View File
@@ -22,9 +22,9 @@
## 2. 准备 Gist
1. 登录 GitHub,打开 <https://gist.github.com/>
2. 创建一个 Secret Gist。GitHub 不允许创建完全空白的 Gist,可以先放一个 `README.md`
3. 复制完整 Gist URL 或末尾的 Gist ID
不需要预先创建 Gist:第一次执行 Push 时,如果本机尚未配置 Gist,系统会询问是否自动创建新的 Secret Gist
已有 Gist 时,也可以登录 GitHub、打开 <https://gist.github.com/>,复制完整 Gist URL 或末尾的 Gist ID,再通过 `Configure GitHub Gist...` 关联
Gist ID 不是访问令牌。身份认证由 GitHub CLI `gh` 管理。
@@ -58,13 +58,12 @@ Zed Settings: Authenticate GitHub...
gh auth login
```
### 3.2 保存 Gist
### 3.2 创建或关联 Gist
1.`Mod+R`
2. 运行 `Zed Settings: Configure GitHub Gist...`
3. 粘贴 Gist URL 或 Gist ID
4. 运行 `Zed Settings: Push to GitHub Gist`
5. 运行 `Zed Settings: Show GitHub Gist Status`,确认状态为 `Synchronized`
2. 没有 Gist 时直接运行 `Zed Settings: Push to GitHub Gist`,确认自动创建
3. 已有 Gist 时先运行 `Zed Settings: Configure GitHub Gist...` 并粘贴 URL/ID,再执行 Push
4. 运行 `Zed Settings: Show GitHub Gist Status`,确认状态为 `Synchronized`
Push 只会在该 Gist 中创建或更新 `zed-settings-sync.json`,不会删除 Gist 中的其他文件。
@@ -126,8 +125,8 @@ curl -fsSL https://<Gitea域名>/<用户>/<仓库>/raw/branch/main/bootstrap-fro
1. 检查 Node.js 和 `gh`
2. 在尚未登录时运行 `gh auth login`
3. 询问 Gist URL 或 ID。
4. 从 GitHub API 读取 `zed-settings-sync.json`
3. 询问 Gist URL 或 ID;留空时自动创建新的 Secret Gist
4. 输入已有 Gist 时从 GitHub API 读取配置;留空时使用本仓库的 `zed-settings-sync.json` 种子配置
5. 验证顶层文件路径,防止写出 Zed 配置目录。
6. 备份新机器已有配置。
7. 安装设置、键位、Tasks、snippets、themes 和辅助脚本。