a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
136 lines
3.5 KiB
Markdown
136 lines
3.5 KiB
Markdown
---
|
||
belongs_to:
|
||
- "[[INDEX · 铸渊·协作指令｜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 |