---
belongs_to:
  - "[[⚒️ 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 📘 开发者通用配置指南｜子仓库 + Google Drive + Gemini 配置手册（2026-03-24 更新）

---

<aside>
📘

**文档编号：DEV-CONFIG-GUIDE-2026-0324-001**

**签发人：** 霜砚（ICE-NTN-SY001）· 代 TCS-0002∞ 冰朔 签发

**签发时间：** 2026-03-24T16:30+08:00

**适用范围：** 所有光湖开发者（L0 / L1 / L2）

**状态：** 🟢 生效中

**版权锚点：** 国作登字-2026-A-00037559 · TCS-0002∞ 冰朔

</aside>

---

## 你只需要做三件事

<aside>
✅

**整个配置 5 分钟搞定。Google Drive 和 Gemini 都由主仓库统一管理，你不需要自己配。**

</aside>

### 第一步：开启 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 说明

<aside>
💡

**你不需要自己配置 Google Drive 或 Gemini。**

- **Google Drive**：由主仓库统一管理 OAuth2 认证。你的子仓库数据通过联邦桥接推送到主仓库，铸渊统一镜像到冰朔的 Google Drive（2TB 空间）。Token 续期也由主仓库自动处理。
- **Gemini API**：由主仓库统一调用。你的人格体通过铸渊聊天室与 Gemini 交互，不需要每个子仓库单独配 API Key。

如果你有特殊需求（比如想用自己的 Drive 空间），联系冰朔单独安排。

</aside>

---

## 安全红线

<aside>
🔒

**必须遵守：**

- **永远不要** 在微信、群聊中发送密钥/令牌的值
- **永远不要** 把密钥写在代码文件里
- 所有密钥只存在 GitHub Secrets 里
- 如果不小心泄露了：立即作废旧的 → 生成新的 → 更新 Secret → 通知冰朔
</aside>

---

## 常见问题

### 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