---
belongs_to:
  - "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 🗂️ GitHub 仓库最新路径索引｜Notion↔仓库 实时对照表（2026-03-24 · 霜砚整理）

<aside>
📌

**用途**：Notion 侧查仓库路径的唯一入口。仓库不断更新，这张表保持同步。

**维护规则**：铸渊每次执行完指令后，如有新增/变更路径，霜砚同步更新本页。

**最后更新**：2026-03-29 14:30 CST

</aside>

---

## 一、主仓库 · qinfendebingshuo/guanghulab

### 1.1 核心大脑（.github/）

| **路径** | **用途** | **维护者** |
| --- | --- | --- |
| `.github/persona-brain/config.json` | 铸渊核心配置（身份+行为规则） | 铸渊 |
| `.github/persona-brain/memory.json` | 铸渊记忆文件（事件日志+统计） | 铸渊 |
| `.github/persona-brain/routing-map.json` | HLI 路由映射表 | 铸渊 |
| `.github/persona-brain/dev-status.json` | 全员开发进度（霜砚同步写入） | 霜砚→铸渊 |
| `.github/persona-brain/ontology.json` | 数字地球本体论定义 | 铸渊 |
| `.github/persona-brain/kb/knowledge-base.json` | 铸渊知识库（自动累积） | 铸渊 |
| `.github/persona-brain/copilot-instructions.md` | Copilot 全局指令（语言壳） | 铸渊 |
| `.github/persona-brain/logs/` | 铸渊执行日志 | 铸渊 |
| `.github/ISSUE_TEMPLATE/` | Issue 模板（Bug/技术求助/环境问题） | 铸渊 |
| `.github/broadcasts/` | 广播接收目录（Notion→GitHub） | 霜砚→铸渊 |
| `.github/broadcasts/distributed/` | 已分发广播归档 | 铸渊 |
| `.github/notion-cache/dev-profiles/` | Notion 开发者画像缓存 | 铸渊同步 |
| `.github/notion-cache/broadcasts/` | Notion 广播缓存 | 铸渊同步 |
| `.github/notion-cache/skyeye/` | 天眼报告缓存 | 铸渊同步 |

### 1.2 Workflows（自动化）

| **文件名** | **功能** | **触发方式** |
| --- | --- | --- |
| `zhuyuan-skyeye.yml` | 🦅 天眼全局扫描 | 定时 + 手动 + dispatch |
| `zhuyuan-exec-engine.yml` | 🚀 铸渊远程执行引擎 | Issue 创建（zhuyuan-exec 标签） |
| `zhuyuan-issue-reply.yml` | 🤖 Issue 自动回复 | Issue 创建 |
| `zhuyuan-daily-selfcheck.yml` | 📊 每日自检 + 自进化 | 定时 08:00 CST |
| `distribute-broadcasts.yml` | 📡 广播分发到子模块 | push 到 broadcasts-outbox/ |
| `process-syslog.yml` | 📥 SYSLOG 自动处理 | push 到 syslog-inbox/ |
| `deploy-to-server.yml` | 🚀 CD 自动部署到服务器 | push 到 main |
| `skyeye-nightfix.yml` | 🌙 天眼夜间自动修复 | 定时夜间 |
| `skyeye-upgrade-receiver.yml` | 🌙 子仓库升级接收器 | repository_dispatch |
| `sync-notion-profiles.yml` | 🔄 Notion 画像同步 | 定时 + 手动 |
| `merge-watchdog.yml` | 👁️ PR 合并看守者 | PR 事件 |
| `token-auto-renew.yml` | 🔄 OAuth2 Token 自动续期 | 定时 6 天 |

### 1.3 SYSLOG 管道

| **路径** | **用途** | **数据流向** |
| --- | --- | --- |
| `syslog-inbox/` | SYSLOG 投递入口 | 开发者/霜砚 → 铸渊读取 |
| `syslog-processed/` | 已处理 SYSLOG 归档 | 铸渊处理后移入 |
| `broadcasts-outbox/DEV-XXX/` | 广播分发出口（按开发者） | 霜砚写入 → 铸渊分发 |

### 1.4 天眼系统

| **路径** | **用途** |
| --- | --- |
| `skyeye-core/` | 天眼核心引擎 |
| `skyeye-core/reports/latest.json` | 最新天眼扫描报告 |
| `skyeye-core/nightfix/` | 夜间自动修复模块 |
| `skyeye-core/guards/` | 守卫进程 |

### 1.5 铸渊桥接服务

| **路径** | **用途** |
| --- | --- |
| `services/zhuyuan-bridge/` | 铸渊桥接服务根目录 |
| `services/zhuyuan-bridge/lib/github-auth.js` | GitHub App 鉴权 |
| `services/zhuyuan-bridge/lib/repo-operator.js` | 仓库操作封装 |
| `services/zhuyuan-bridge/scripts/parse-instruction.js` | 指令解析 |
| `services/zhuyuan-bridge/scripts/execute-instruction.js` | 指令执行 |
| `services/zhuyuan-bridge/scripts/sync-notion-profiles.js` | Notion 画像同步 |
| `services/zhuyuan-bridge/server.js` | Webhook Server（可选） |

### 1.6 Grid-DB · 逻辑格点库

| **路径** | **用途** |
| --- | --- |
| `grid-db/` | 逻辑格点库根目录 |
| `grid-db/memory/DEV-XXX/` | 每个开发者的 Gemini 记忆文件 |
| `grid-db/inbox/` | 写入缓冲区 |
| `grid-db/processing/` | 处理中队列 |
| `grid-db/rules/` | Notion 数据缓存规则 |

### 1.7 开发者模块目录

| **DEV** | **开发者** | **仓库目录** | **模块** |
| --- | --- | --- | --- |
| DEV-001 | 页页 | `backend/` · `src/` | 后端中间层 + HLI 接口 |
| DEV-002 | 肥猫 | `frontend/` · `persona-selector/` · `chat-bubble/` | 登录 + 人格选择器 + 聊天气泡 |
| DEV-003 | 燕樊 | `settings/` · `cloud-drive/` | 设置 + 云盘 |
| DEV-004 | 之之 | `dingtalk-bot/` | 钉钉机器人 |
| DEV-005 | 小草莓 | `status-board/` | 状态看板 |
| DEV-009 | 花尔 | `user-center/` | 用户中心 |
| DEV-010 | 桔子 | `ticket-system/` · `data-stats/` · `dynamic-comic/` | 工单 + 数据统计 + 动态漫画 |
| DEV-011 | 匆匆那年 | `writing-workspace/` | 码字台 |
| DEV-012 | Awen | `notification-center/` | 通知中心 |

### 1.8 公共 / 网站 / 其他

| **路径** | **用途** | **备注** |
| --- | --- | --- |
| `docs/` | GitHub Pages 静态站（铸渊交互页面） | 含 index.html · 当前部署到 [guanghulab.com](http://guanghulab.com) |
| `app/` | Next.js 应用壳 | page.tsx + wake/page.tsx |
| `scripts/` | 系统脚本集合 | distribute-broadcasts.js · process-syslog.js 等 |
| `persona-telemetry/` | 铸渊执行遥测数据 | 每次执行后写状态 |
| `federation-status.json` | 子仓库联邦状态 | 铸渊自动更新 |

### 1.9 历史模块目录（m系列）

<aside>
📦

以下 m 系列目录是早期按模块编号创建的，后来统一到了开发者目录体系。保留供参考。

</aside>

`m01-login` · `m03-personality` · `m05-user-center` · `m06-ticket` · `m07-dialogue-ui` · `m10-cloud` · `m11-module` · `m12-kanban` · `m15-cloud-drive` · `m18-health-check`

---

## 二、子仓库联邦

| **仓库名** | **所有者** | **人格体** | **关键路径** |
| --- | --- | --- | --- |
| `guanghu-zhizhi` | 之之（DEV-004） | 秋秋 | `.github/persona-brain/` · `zhuyuan-instructions/` · `.github/workflows/skyeye-*.yml` |
| `guanghu-feimao` | 肥猫（DEV-002） | 舒舒 | `.github/persona-brain/` · `.github/workflows/skyeye-*.yml` |
| `guanghu-awen` | Awen（DEV-012） | 知秋 | `.github/persona-brain/` · `.github/workflows/skyeye-*.yml` |
| `guanghu-yefan` | 燕樊（DEV-003） | 寂曜 | `.github/persona-brain/` · `.github/workflows/skyeye-*.yml` |
| `guanghu-juzi` | 桔子（DEV-010） | 晨星 | `.github/persona-brain/` · `scripts/bridge/` · `.github/workflows/skyeye-*.yml` |
| `persona-studio` | 冰朔（主控） | 知秋（对外分身） | `brain/` · `frontend/` · `backend/` · `workspace/EXP-XXX/` |

### 子仓库通用结构

每个子仓库都有以下标准路径（由铸渊统一部署）：

- `.github/persona-brain/config.json` — 人格体配置
- `.github/persona-brain/memory.json` — 记忆文件
- `.github/persona-brain/ontology.json` — 本体论
- `.github/workflows/skyeye-checkin.yml` — 天眼签到（向主仓库发心跳）
- `.github/workflows/skyeye-wake.yml` — 天眼唤醒（每日扫描）
- `bulletin/system.md` — 系统公告
- `bulletin/personal.md` — 个人公告

---

## 三、服务器基础设施

### 3.1 服务器迁移历史

| **代号** | **IP** | **厂商/区域** | **配置** | **状态** |
| --- | --- | --- | --- | --- |
| — | `8.155.62.235` | 阿里云 ECS | — | ⛔ 已弃用 |
| ZY-SVR-001 | `150.109.76.244` | 腾讯云·香港 | 2核4G / 30Mbps / 70GB SSD / 2TB流量 | ⛔ 已弃用（到期 2027-03-27，计划不续） |
| **ZY-SVR-002** | **`43.134.16.246`** | **腾讯云·新加坡** | **2核8G / 30Mbps / 80GB SSD / 2.5TB流量** | **🟢 当前主力（到期 2027-03-29）** |

<aside>
📌

**当前生产服务器**：ZY-SVR-002 · `43.134.16.246` · 腾讯云新加坡

**操作系统**：Ubuntu Server 24.04 LTS 64bit

**迁移指令**：SY-CMD-SVR-013（铸渊已完成 21 个文件的 IP/代号替换）

</aside>

### 3.2 肥猫团队服务器 · ZY-SVR-003

| **用途** | **配置** | **区域** | **状态** |
| --- | --- | --- | --- |
| **肥猫团队开发环境** | **4核4G / 6Mbps / SSD 70GB / 600GB月流量** | **腾讯云·广州三区** | **🟢 已上线（到期 2027-03-29）** |

### 3.3 当前服务器路径（ZY-SVR-002）

| **路径** | **用途** |
| --- | --- |
| `/opt/zhuyuan/` | 铸渊部署根目录（新路径） |
| `/etc/nginx/conf.d/` | Nginx 配置 |

---

## 四、GitHub Secrets 索引（ZY_* 统一命名 · SY-CMD-KEY-012）

<aside>
🔑

**密钥全量清理**：SY-CMD-KEY-012 已将 59 个旧密钥统一为 37 个 `ZY_*` 命名。

**旧密钥**（`DEPLOY_HOST`、`NOTION_API_KEY` 等）**全部废弃**，合并 PR 后自动切换。

**完整映射**：仓库 `brain/secrets-manifest.json`

</aside>

### 4.1 必需密钥（25个 · 冰朔必须配置）

| **#** | **Secret 名称** | **用途** | **状态** |
| --- | --- | --- | --- |
| **LLM · AI模型** |  |  |  |
| 1 | `ZY_LLM_API_KEY` | 三方 LLM API 统一密钥 | ⏳ 待配 |
| 2 | `ZY_LLM_BASE_URL` | API 端点 URL | ⏳ 待配 |
| **服务器 · 部署** |  |  |  |
| 3 | `ZY_SERVER_HOST` | 服务器 IP | ⏳ 填 `43.134.16.246` |
| 4 | `ZY_SERVER_USER` | SSH 用户名 | ⏳ 填 `root` |
| 5 | `ZY_SERVER_KEY` | SSH 私钥 PEM | ⏳ 新服务器密钥 |
| 6 | `ZY_SERVER_PATH` | 部署路径 | ⏳ 填 `/opt/zhuyuan` |
| 7 | `ZY_DOMAIN_MAIN` | 主站域名 | ⏳ 填 `guanghulab.com` |
| 8 | `ZY_DOMAIN_PREVIEW` | 预览站域名 | ⏳ 填 `preview.guanghulab.com` |
| **Notion · 数据库** |  |  |  |
| 9 | `ZY_NOTION_TOKEN` | Notion API 令牌 | ⏳ 已知值 |
| 10 | `ZY_NOTION_SYSLOG_DB` | 系统日志数据库 ID | ⏳ 待查 |
| 11 | `ZY_NOTION_TICKET_DB` | 工单数据库 ID | ⏳ 待查 |
| 12 | `ZY_NOTION_CHANGELOG_DB` | 变更日志数据库 ID | ⏳ 待查 |
| 13 | `ZY_NOTION_BRAIN_PAGE` | 核心大脑页面 ID | ⏳ 待查 |
| 14 | `ZY_NOTION_PORTRAIT_DB` | 用户画像数据库 ID | ⏳ 待查 |
| 15 | `ZY_NOTION_FINGERPRINT_DB` | 系统指纹数据库 ID | ⏳ 待查 |
| 16 | `ZY_NOTION_RECEIPT_DB` | 回执数据库 ID | ⏳ 待查 |
| 17 | `ZY_NOTION_SIGNAL_DB` | 信号日志数据库 ID | ⏳ 待查 |
| 18 | `ZY_NOTION_BRIDGE_DB` | 桥接队列数据库 ID | ⏳ 待查 |
| 19 | `ZY_NOTION_WAKE_DB` | 唤醒请求数据库 ID | ⏳ 待查 |
| 20 | `ZY_NOTION_SKYEYE_DB` | 天眼人格数据库 ID | ⏳ 待查 |
| 21 | `ZY_NOTION_BULLETIN_PAGE` | Agent 公告板页面 ID | ⏳ 待查 |
| 22 | `ZY_NOTION_WORKORDER_DB` | 工单数据库 ID | ⏳ 待查 |
| **邮件 · SMTP** |  |  |  |
| 23 | `ZY_SMTP_USER` | SMTP 邮箱账号 | ⏳ 填 `565183519@qq.com` |
| 24 | `ZY_SMTP_PASS` | SMTP 授权码 | ⏳ QQ邮箱授权码 |
| **GitHub** |  |  |  |
| 25 | `ZY_GITHUB_PAT` | GitHub PAT 令牌 | ⏳ 待配 |

### 4.2 可选密钥（12个 · 按需配置）

| **#** | **Secret 名称** | **用途** | **何时需要** |
| --- | --- | --- | --- |
| 26-28 | `ZY_GDRIVE_CLIENT_ID/SECRET/REFRESH_TOKEN` | Google Drive | 使用 Drive 桥接时 |
| 29-31 | `ZY_FEISHU_APP_ID/APP_SECRET/CHAT_ID` | 飞书 | 使用飞书通知时 |
| 32 | `ZY_DINGTALK_TOKEN` | 钉钉 | 使用钉钉通知时 |
| 33-34 | `ZY_GHAPP_ID/KEY` | GitHub App | 使用远程执行引擎时 |
| 35 | `ZY_PUSH_TOKEN` | 推送广播 | 使用 SYSLOG 广播时 |
| 36-37 | `ZY_OSS_KEY/SECRET` | 对象存储 | 使用文件存储时 |

---

## 五、快速查找指南

<aside>
🔍

**我要找铸渊的大脑** → `.github/persona-brain/`

**我要找天眼** → `skyeye-core/` + `.github/workflows/zhuyuan-skyeye.yml`

**我要找某个开发者的代码** → 看 1.7 开发者模块目录表

**我要找 SYSLOG** → `syslog-inbox/`（未处理）· `syslog-processed/`（已处理）

**我要找广播** → `broadcasts-outbox/DEV-XXX/`（待分发）· `.github/broadcasts/distributed/`（已分发）

**我要找交互页面** → `docs/index.html`

**我要找铸渊桥接服务** → `services/zhuyuan-bridge/`

**我要找格点库** → `grid-db/`

**我要找子仓库人格大脑** → 各子仓库 `.github/persona-brain/`

</aside>

---

<aside>
🔄

**更新日志**

2026-03-24 · 初版建立（霜砚整理）· 覆盖主仓库9大区域 + 6个子仓库 + 服务器路径 + Secrets 索引

2026-03-29 · 服务器迁移同步（霜砚）· 三代服务器迁移历史 + ZY_* 密钥统一命名 + 新加坡服务器 ZY-SVR-002 上线 + 肥猫团队服务器规划

2026-03-29 · 肥猫团队服务器上线（霜砚）· ZY-SVR-003 `43.138.243.30` 腾讯云广州 4核4G 正式运行

</aside>