---
belongs_to:
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 📘 开发者通用配置指南｜子仓库 + Google Drive + Gemini 配置手册（2026-03-24 更新）
---
---
## 你只需要做三件事
### 第一步：开启 Actions 写权限
1. 打开你的仓库页面
2. 点 **Settings**（设置）
3. 左边栏找到 **Actions** → **General**
4. 往下拉到 **Workflow permissions**
5. 选择 **Read and write permissions**（读写权限）
6. 点 **Save**
### 第二步：添加 `MAIN_REPO_TOKEN` 密钥
这个令牌由冰朔统一分发，**你不需要自己生成**。
1. 联系冰朔，冰朔会给你一个令牌值
2. 去仓库 → **Settings** → **Secrets and variables** → **Actions**
3. 点 **New repository secret**
4. Name 填：`MAIN_REPO_TOKEN`
5. Secret 填：冰朔给你的令牌值
6. 点 **Add secret**
### 第三步：通知冰朔
配置完上面两步后，微信告诉冰朔一声。铸渊会：
1. 运行天眼系统扫描你的仓库
2. 确认桥接链路正常
3. 在联邦状态表中把你的状态更新为 🟢
**搞定。可以开始干活了。**
---
## Google Drive 和 Gemini 说明
---
## 安全红线
---
## 常见问题
### Q: 我找不到 Settings 在哪？
在你的仓库页面顶部，代码文件列表的上方，有一排标签：Code / Issues / Pull requests / Actions / **Settings**。点最右边的 **Settings**。
### Q: MAIN_REPO_TOKEN 怎么获取？
你不需要自己生成。直接微信找冰朔要就行。
### Q: 我的密钥不小心泄露了怎么办？
1. 去 GitHub → Settings → Developer settings → 把泄露的令牌删掉或 Regenerate
2. 去仓库 Secrets 更新成新值
3. 通知冰朔
### Q: 我完全不会操作怎么办？
微信找冰朔，屏幕共享远程协助。**千万不要把密钥通过微信文字发出去。**
---
## 配置检查清单
- [ ] Actions 写权限已开启（Read and write permissions）
- [ ] `MAIN_REPO_TOKEN` 已添加（从冰朔处获取）
- [ ] 已通知冰朔，铸渊天眼扫描通过
**以上三项全部完成 = 配置完成 ✅**
---
🖋️ 霜砚 · PER-SY001
🧊 代 TCS-0002∞ 冰朔 签发
📅 2026-03-24T16:30+08:00