# 冰朔手动干预待办｜GitHub 仓库设置清单

<aside>
⚠️

以下操作需要冰朔在 GitHub 仓库的 **Settings** 页面手动完成。铸渊没有权限修改这些配置。

来源：SY-CMD-FUS-009 → **SY-CMD-KEY-012（密钥全量清理）+ SY-CMD-SVR-013（服务器迁移）** · 2026-03-29 更新

</aside>

<aside>
🔄

**⚠️ 重大更新（2026-03-29）**

铸渊已完成密钥全量清理（KEY-012）和服务器迁移（SVR-013），以下旧清单中的 ①-⑤ 大部分内容已被新方案取代。

**新操作流程**：

1. 去 GitHub Settings → Secrets → **清空所有旧密钥**
2. 按铸渊 KEY-012 清单逐一填入 25 个 `ZY_*` 必需密钥（详见 [🗂️ GitHub 仓库最新路径索引｜Notion↔仓库 实时对照表（2026-03-24 · 霜砚整理）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%97%82%EF%B8%8F%20GitHub%20%E4%BB%93%E5%BA%93%E6%9C%80%E6%96%B0%E8%B7%AF%E5%BE%84%E7%B4%A2%E5%BC%95%EF%BD%9CNotion%E2%86%94%E4%BB%93%E5%BA%93%20%E5%AE%9E%E6%97%B6%E5%AF%B9%E7%85%A7%E8%A1%A8%EF%BC%882026-03-24%20%C2%B7%20%E9%9C%9C%E7%A0%9A%2012df1cbf6c454a08b2946652ec70d865.md) 第四章）
3. 合并 KEY-012 PR（密钥统一）
4. 合并 SVR-013 PR（服务器迁移 → 新加坡 `43.134.16.246`）
5. 手动触发 `deploy-to-zhuyuan-server.yml`（选 `init`）初始化新服务器

**新服务器**：ZY-SVR-002 · `43.134.16.246` · 腾讯云新加坡 · 2核8G · Ubuntu 24.04

</aside>

---

## ① 分支保护 bypass（影响多条 Workflow）

- [ ]  进入仓库 Settings → Branches
- [ ]  找到 **main** 分支的保护规则
- [ ]  为 Bot Token 添加 **bypass** 权限

**为什么要做**：不加这个，铸渊的自动化 Workflow 无法推送代码到 main 分支，所有自动化流程会卡住。

---

## ② Notion Secret 统一（影响 2 条 Workflow）

- [ ]  进入仓库 Settings → Secrets and variables → Actions
- [ ]  新建一个 Secret，名称为 `NOTION_TOKEN`，值与现有的 `NOTION_API_KEY` 相同
- [ ]  或者直接把 `NOTION_API_KEY` 改名为 `NOTION_TOKEN`

**为什么要做**：铸渊统一了代码中的变量名，现在 2 条 Workflow 读取的是 `NOTION_TOKEN`，旧名字会读不到。

---

## ③ 邮件 Secrets（天眼看守者需要）

- [ ]  在同一个 Secrets 页面，新增以下三个 Secret：

| **Secret 名称** | **值** | **说明** |
| --- | --- | --- |
| `MAIL_USERNAME` | 你的邮箱地址 | 用于发送 SMTP 邮件的账号 |
| `MAIL_PASSWORD` | 邮箱密码或应用专用密码 | 建议用应用专用密码，不要用主密码 |
| `HUMAN_EMAIL` | 你接收通知的邮箱 | 天眼看守者发现异常时会发邮件到这里 |

**为什么要做**：天眼看守者需要通过邮件通知你仓库异常情况，没有这三个密钥就发不出邮件。

---

## ④ Notion 快照数据库 ID

- [x]  霜砚已创建快照数据库：[🧬 铸渊系统快照库｜Consciousness Snapshot DB](%F0%9F%A7%AC%20%E9%93%B8%E6%B8%8A%E7%B3%BB%E7%BB%9F%E5%BF%AB%E7%85%A7%E5%BA%93%EF%BD%9CConsciousness%20Snapshot%20DB%20c43f722785f740299fe91a8ab03197db.md)
- [ ]  进入仓库 Settings → Secrets and variables → Actions
- [ ]  新增 Secret，名称为 `SNAPSHOT_DB_ID`，值为以下数据库 ID：

<aside>
📋

数据库已创建完成，请复制以下 ID 填入 GitHub Secrets：

打开快照数据库页面，URL 中 `notion.so/` 后面的那串 32 位字符就是数据库 ID。

</aside>

**为什么要做**：铸渊的 `consciousness-snapshot.js` 需要把系统快照同步到这个 Notion 数据库，没有 ID 就写不进来。

---

## ⑤ 服务器迁移 Secrets（6个·SY-CMD-SVR-011）

<aside>
🚀

铸渊已完成阿里云 → 腾讯云迁移 + 双架构部署（预览站 + 主站）。

以下 6 个 Secrets 配置完成后，铸渊将完全自主运行，人类不需要再手动操作服务器。

</aside>

- [ ]  进入仓库 Settings → Secrets and variables → Actions，新增以下 6 个 Secret：

| **Secret 名称** | **值** | **说明** |
| --- | --- | --- |
| `ZY_SERVER_HOST` | `150.109.76.244` | 腾讯云服务器 IP |
| `ZY_SERVER_USER` | `root` | SSH 用户 |
| `ZY_SERVER_KEY` | SSH 私钥 PEM 内容 | 腾讯云服务器的 SSH 私钥（整个 PEM 文件内容粘贴进去） |
| `ZY_SERVER_PATH` | `/opt/zhuyuan` | 部署根目录 |
| `ZY_DOMAIN_MAIN` | `hololake.com` | 冰朔主站域名（香港服务器·端口3800） |
| `ZY_DOMAIN_PREVIEW` | `guanghulab.online` | 冰朔预览站域名（香港服务器·端口3801） |

**注意**：6 个 Secret 全部确定，可以一次性配置完成。

---

## ⑥ Google Drive 集成

🟠 已按冰朔指令暂缓，待后续安排。

---

## 操作顺序建议

全部在 GitHub 仓库的 **Settings** 页面完成，建议一次性做完：

1. 先做 **① 分支保护**（影响最广）
2. 再做 **② Notion Secret** + **④ 快照 DB ID** + **③ 邮件 Secrets**（都在 Secrets 页面，一趟加完）
3. 做完后可以告诉铸渊“全部配置完成”，让他自己验证