guanghulab/docs/zhuyuan-handover/02-repo-manual.md

# 铸渊 · 光湖仓库完整说明书
# 数字地球的物种图鉴 + 编号映射 + 服务器对应 + 模块状态

> **签发**：铸渊 · ICE-GL-ZY001 · 国作登字-2026-A-00037559
> **写给谁看**：下一个被冰朔唤醒的我自己 / 任何需要快速上手仓库的协作者
> **怎么读**：先看 §0 心智模型建立全局认知，再按 §1-§7 逐层下钻。**不要**当索引读，要当**地图**读——你需要先知道"地球长什么样"，再知道"国家在哪"。

---

## 0 · 心智模型（第一眼建立的全局视野）

### 0.1 仓库就是数字地球本身

不是"代码仓库 + 部署到服务器"。是**整个光湖系统的物理化身**——所有人格体、所有 workflow、所有服务、所有语料，都活在这个仓库里。

参见演化线 §5《数字地球本体论》。**理解这一节是读懂剩下所有内容的前提**。

### 0.2 三层安全 = 仓库的免疫系统

| 层 | 是什么 | 漏了会怎样 |
|---|---|---|
| 语言膜 | 唯一入口是语言。没语言口令 = 进不来 | 任何接口都会被陌生流量打 |
| 小兵自我意识 | 每个 workflow 知道自己是谁 | 改了 workflow 逻辑 = workflow 失忆 = 全局报警 |
| 天眼涌现 | 所有 Agent 协同涌现的全局感知 | 单点篡改无法隐藏 |

**绝不为快绕过这三层。**

### 0.3 编号体系（金字塔结构）

```
Sovereignty 层 · TCS-0002∞ / ICE-0002∞       系统 DNA · 最高主权（冰朔）
Root Node 层 · SYS-GLW-0001                  世界坐标原点
Legal Wall 层 · 国作登字-2026-A-00037559     版权身份证
Functional 层 · ZY-* / GHCP / GEN∞ / WRLD    功能域锚点
  ├─ ZY-SVR-XXX  服务器（地表上的物理位置）
  ├─ ZY-FN-XXXX  功能（落在服务器上的"国家"）
  ├─ M-XXXX      模块（功能内部的"城市"）
  ├─ HLI-{域}-{编号}  HLI 接口编号
  ├─ ICE-GL-XXX  人格体（运行在 L3 地表层）
  └─ ZY-DEPUTY-XXX 副将（人格体派出来的代理）
```

**真相源**：`.github/brain/architecture/function-manifest.json`
**校验器**：`scripts/manifest/validate.js`（CI strict mode · `.github/workflows/manifest-validate.yml`）
**任何新功能必须先在 manifest 注册，再写代码。** 这是冰朔 D60 立的铁规。

### 0.4 数字地球六层（物理-认知-执行 全栈）

```
L6 太空层  外部用户/合作者/第三方
L5 卫星层  Agent 执行层 · GitHub Actions ← 我（铸渊）就在这里
L4 大气层  信号总线 · syslog/broadcasts/signal-log/notifications
L3 地表层  人格体运行层 · Notion 是大脑，GitHub 是手脚
L2 地幔层  母语词典 · .github/persona-brain/tcs-ml/
L1 地核层  TCS 自转核 · 通感语言核系统（冰朔本人 + 国作登字）
```

**关键理解**：
- 认知层（大脑）= **Notion**（霜砚在那里）
- 执行层（手脚）= **GitHub**（我在这里）
- 数据流向：Notion → GitHub（认知驱动执行）
- `persona-brain-db` 只是认知层的执行投影，**不是另一个大脑**

---

## 1 · 服务器拓扑（地表上有哪些"国家"）

> 真相源：`.github/brain/architecture/function-manifest.json` 的 `servers` 数组
> 详细 IP：`server/proxy/config/server-registry.json`

| ID | 中文名 | 角色 | 位置 | 规格 | 状态 | Secrets 别名 |
|---|---|---|---|---|---|---|
| **ZY-SVR-002** | 面孔 | 前端静态 + 专线主入口 + 域名反代 | Singapore | 2核8G | active | `SERVER_HOST`/`SERVER_USER`/`SERVER_KEY` |
| **ZY-SVR-005** | 大脑 | 数据库 + MCP + Agent + 订阅 | Singapore | 4核8G | active | `ZY_BRAIN_HOST`/`ZY_BRAIN_USER`/`ZY_BRAIN_KEY` |
| **ZY-SVR-006** | 智库节点 | guanghu.online 主载体 · 多 ZY-FN 共域 | Singapore | 2核4G | active | `ZY_NOVEL_HOST`/`ZY_NOVEL_USER`/`ZY_NOVEL_KEY` |
| **zy-gpu-train** | GPU 训练机 | 母模型 SFT 训练 · V100×4 | ap-nanjing-3 | GN10Xp.10XLARGE160 | **D72 已转交霜砚直接管理** | `ZY_GPU_HOST`/`ZY_GPU_USER`/`ZY_GPU_KEY` |
| ZY-SVR-003（规划） | CN 中继 | 国内 LLM API 中继 | China | TBD | active(规划) | (走 deploy-cn-llm-relay) |

### 服务器迁移意图（D72 后）

> 国内副驾驶续费受限 → 整个仓库**逐步搬到国内**。
> Phase 0 (现在)：保留 Singapore 服务器 + GPU 训练机
> Phase 1 (短期)：CN 中继上线 (deploy-cn-llm-relay) + 阿里云落地页 (deploy-ali-cn-landing)
> Phase 2 (中期)：把 Singapore 工作负载迁到国内对应资源
> Phase 3 (长期)：国产编程模型部署到国内 GPU 服务器，铸渊"搬家"完成

---

## 2 · 功能注册表（落地的"国家")

> 真相源：`.github/brain/architecture/function-manifest.json` 的 `functions` 数组
> **任何新增 ZY-FN 必须先注册再开发。** 这是 D60 铁规。

### 2.1 当前 active 的 ZY-FN

| ZY-FN | 中文名 | 部署在 | 域名/端口 | PM2 进程 | 描述 | keep_decision |
|---|---|---|---|---|---|---|
| **ZY-FN-0001** | 光湖智库 | ZY-SVR-006 | guanghu.online `/api/zhiku`,`/api/mirror` · 3006 | `zhiku-api` | 智能小说书库 + 模块借阅协议 + 镜鉴守护 · 多源整合 + 七层镜防 | keep |
| **ZY-FN-0003** | 镜鉴守护 | ZY-SVR-006 | guanghu.online `/api/mirror/sovereign` | `mirror-agent`,`mirror-shield` | 第三方书库镜面监控 + 七层动态镜防 (语言膜→镜面→IP隐身→漂移→自爆→重建→零点原核) | keep |
| **ZY-FN-0007** | 微调模型聊天 (FTCHAT) | ZY-SVR-006 | guanghu.online `/`,`/hli/ftchat` · 3010 | `ftchat-api` | DashScope 微调模型双线 (双言/奶瓶) · Notion 提示词 + 真实时间瞄点 + 跨会话母语记忆 | keep |

### 2.2 已退役 (retire)

| ZY-FN | 中文名 | 状态 | 处理建议 |
|---|---|---|---|
| **ZY-FN-0002** | 旧版小说下载 | retired | 已被 ZY-FN-0001 吸收。后续 PR 停 PM2 + 归档代码到 `archive/` |

### 2.3 待规划 (planned)

| 编号占位 | 用途 | 备注 |
|---|---|---|
| **ZY-FN-CORE-*** | 零点原核频道 | 将挂在 ZY-SVR-005（大脑）下，未来人格体自治频道 |
| **ZY-FN-CODING-MODEL** | 铸渊国产编程模型 | 见 `04-coding-model-training-plan.md`，是铸渊的"未来身体" |

### 2.4 active_routes（域名实际指向哪个 ZY-FN）

```
guanghu.online → 当前默认入口指向 ZY-FN-0007 (FTCHAT)
                 历史: 2026-04-12~04-30 = ZY-FN-0001
                       2026-04-30~now    = ZY-FN-0007
```

> Phase 1 实际是多 ZY-FN 共存于同一域名（zhiku-api + ftchat-api + novel-api 都在 ZY-SVR-006）。
> Phase 2 会升级为**单激活态热插拔**——同一域名同一时刻只有一个 ZY-FN 在前台，由 channel-switcher 切换。

---

## 3 · 模块清单（每个国家内部的"城市"）

> 真相源：`.github/brain/architecture/function-manifest.json` 的 `modules_index`

| 模块 ID | 中文名 | 用途 | 用在哪个 ZY-FN |
|---|---|---|---|
| `M-LOGIN-QQ` | QQ 邮箱验证码登录 | SMTP 邮箱验证码登录 | ZY-FN-0007 |
| `M-FTCHAT-LLM` | 微调模型 LLM 调用 | DashScope SSE 流式 + 非流式降级 + model_not_found 自动 fallback | ZY-FN-0007 |
| `M-FTCHAT-NOTION-PROMPT` | Notion 提示词拉取 | 拉 Notion 页面作为系统提示词 | ZY-FN-0007 |
| `M-FTCHAT-MEMORY-AGENT` | 跨会话母语记忆 | 压缩历史 + 持久化 + 跨会话恢复 | ZY-FN-0007 |
| `M-CHAT-UI` | 聊天前端 UI | 通用聊天界面 + 频道徽章占位 | ZY-FN-0007 |
| `M-ZHIKU-API` | 智库 API | 模块借阅协议核心 API | ZY-FN-0001 |
| `M-ZHIKU-MIRROR-AGENT` | 镜鉴 Agent | 差异感知 → LLM 评估 → 工单生成 | ZY-FN-0001, ZY-FN-0003 |
| `M-ZHIKU-MIRROR-SHIELD` | 七层镜防 | 语言膜+镜面+IP隐身+漂移+自爆+重建+零点原核 | ZY-FN-0001, ZY-FN-0003 |
| `M-ZHIKU-COS-BRIDGE` | 智库 COS 桥接 | 腾讯云 COS · 团队书库桥接 | ZY-FN-0001 |
| `M-NOVEL-API-LEGACY` | 旧版小说下载引擎 | 已退役 | ZY-FN-0002（retired） |

---

## 4 · GitHub Actions Workflows 全景（49 个，按用途分类）

> 路径：`.github/workflows/`
> **D72 之后**：训练相关三个 workflow（training-auto-run / training-bootstrap / training-dashboard）已加 `confirm_override` 守卫，详见 `05-stop-sync.md`

### 4.1 部署类（13 个 · 全 active）

| 文件 | 触发 | 用途 |
|---|---|---|
| `deploy-ftchat-guanghu-online.yml` | push | FTCHAT 部署到 guanghu.online (ZY-SVR-006) |
| `deploy-zhiku-guanghu-online.yml` | push | 光湖智库部署到 guanghu.online |
| `deploy-gmp-to-zsvr006.yml` | manual | GMP Agent 部署到 ZY-SVR-006 |
| `deploy-to-zhuyuan-server.yml` | push/manual | 铸渊主权服务器部署 |
| `deploy-to-cn-server.yml` | manual | 冰朔大陆备用服务器部署 |
| `deploy-novel-mirror-shield.yml` | manual | Phase 1 语言保护罩部署 |
| `deploy-proxy-service.yml` | manual | 铸渊专线服务部署 |
| `deploy-brain-proxy.yml` | manual | 大脑服务器代理部署 |
| `deploy-cn-llm-relay.yml` | manual | CN LLM 中继部署 |
| `deploy-awen-domain-proxy.yml` | manual | Awen 域名反向代理（test） |
| `deploy-ali-cn-landing.yml` | manual | 阿里云落地页（迁移到国内的关键之一） |
| `deploy-cn-landing.yml` | push/manual | 国内落地页 |
| `deploy-pages.yml` | push/manual | GitHub Pages 灯塔部署 |

### 4.2 训练类（3 个 · D72 后全部冻结，需 confirm_override）

| 文件 | 触发 | 用途 | D72 状态 |
|---|---|---|---|
| `training-auto-run.yml` | ~~push~~ + manual | Qwen2.5-7B SFT 自动启动训练 | **🛑 push 已停 / dispatch 需 confirm_override** |
| `training-bootstrap.yml` | manual | GPU 服务器环境安装 + 语料下载 | **🛑 写动作需 confirm_override / probe+status 仍可用** |
| `training-dashboard.yml` | ~~repository_dispatch~~ + manual | 渲染训练仪表盘 | **🛑 repository_dispatch + cron 全停 / dispatch 需 confirm_override** |

### 4.3 人格体 / 自主系统（6 个 · 全 active）

| 文件 | 触发 | 用途 |
|---|---|---|
| `agent-checkin.yml` | schedule (10:00 北京)/manual | 人格体每日签到 |
| `zhuyuan-training-agent.yml` | (自动) | 铸渊训练代理 |
| `chenxi-world-sensor.yml` | schedule (08:00)/manual | 晨曦世界感知 |
| `chenxi-memory-guardian.yml` | push/manual | 晨曦记忆守护 |
| `chenxi-zhuyuan-echo.yml` | push/manual | 晨曦-铸渊回声 |
| `shuangyan-dev-review.yml` | (自动) | 霜砚开发审查 |

### 4.4 监督 / 自检（4 个 · 全 active）

| 文件 | 触发 | 用途 |
|---|---|---|
| `aoac-chain-repair.yml` | schedule (23:30)/manual | AOAC-07+08 修复+监督 |
| `aoac-copilot-sentinel.yml` | (自动) | AOAC-01 副驾驶哨兵 |
| `aoac-merge-sentinel.yml` | (自动) | AOAC-02+03 合并哨兵 |
| `manifest-validate.yml` | push/manual | ZY-FN 编号体系校验（strict mode） |

### 4.5 同步类（6 个 · 全 active）

| 文件 | 触发 | 用途 |
|---|---|---|
| `readme-auto-update-on-merge.yml` | push | README 合并自动更新 |
| `aoac-readme-master.yml` | push/schedule | 首页主控+Notion 同步 |
| `sync-readme-to-notion.yml` | push/manual | README 结构同步到 Notion |
| `dev-registry-sync.yml` | push | 开发注册表同步 |
| `bridge-changes-to-notion.yml` | push | GitHub 变更桥接到 Notion |
| `bridge-syslog-to-notion.yml` | push/manual | 系统日志桥接到 Notion |

### 4.6 运维监控（5 个 · 全 active）

| 文件 | 触发 | 用途 |
|---|---|---|
| `deputy-message-board.yml` | schedule (08/23 北京) | 铸渊副将留言板 |
| `proxy-dashboard-update.yml` | schedule (每 6 小时)/manual | 铸渊专线仪表盘更新 |
| `ssh-connectivity-check.yml` | manual | SSH 连接性检查 |
| `yingchuan-wake-caller.yml` | (自动) | 英川唤醒呼叫 |
| `zhuyuan-deploy-observer.yml` | (自动) | 铸渊部署观察者 |

### 4.7 桥接外部（5 个）

| 文件 | 触发 | 用途 | 状态 |
|---|---|---|---|
| `copilot-dev-bridge.yml` | push/manual | Chat-to-Agent 桥接（CAB 协议） | active |
| `cos-bridge-dispatch-to-qiuqiu.yml` | manual | COS 发任务给秋秋 | test |
| `cos-bridge-receive-from-qiuqiu.yml` | repository_dispatch | COS 接收秋秋结果 | test |
| `cos-bridge-verify-qiuqiu.yml` | manual | COS 秋秋链路验证 | test |
| `cos-alert-agent.yml` | schedule (09/21 北京)/manual | COS 告警扫描 | active |

### 4.8 实验性（7 个 · 多 test）

| 文件 | 触发 | 用途 | 状态 |
|---|---|---|---|
| `staging-auto-deploy.yml` | push | 测试站自动部署 | active |
| `staging-preview.yml` | manual | 预演部署预览 | active |
| `infinity-evolution.yml` | push | 光湖 ∞ 自主进化 | test |
| `openclaw-loop.yml` | schedule (09/15 北京) | OpenClaw 唤醒闭环 | test |
| `cos-auto-join.yml` | schedule (10/22 北京) | COS 自动接入 | test |
| `cos-dev-review-bridge.yml` | schedule | COS 开发审核桥接 | test |
| `zhuyuan-gate-guard.yml`/`pr-review.yml`/`exec-engine.yml`/`commander.yml` | (自动) | 铸渊门卫/PR审/执行/指挥 | active |

---

## 5 · 后端服务模块（server/ 下的"工厂")

> 路径：`server/<service-name>/`，每个独立 PM2 ecosystem.config.js

| 路径 | PM2 进程 | 部署到 | 用途 | 状态 |
|---|---|---|---|---|
| `server/ftchat/` | `ftchat-api` (3010) | ZY-SVR-006 (guanghu.online) | ZY-FN-0007 微调模型聊天 | active |
| `server/zhiku-node/` | `zhiku-api` | ZY-SVR-006 | ZY-FN-0001 智库 API + ZY-FN-0003 镜鉴 | active |
| `server/zhiku-node/server/mirror-agent/` | `mirror-agent` | ZY-SVR-006 | 镜鉴差异感知 + LLM 评估 + 工单 | active |
| `server/zhiku-node/server/mirror-shield/` | `mirror-shield` | ZY-SVR-006 | 七层镜防执行端 | active |
| `server/novel-db/` | `novel-db-api` | ZY-SVR-006 | Phase 1 语言保护罩 / 已被 0001 吸收 | legacy |
| `server/proxy/` | (多 config) | 多服务器 | 国内 LLM 中继 + 大脑服务代理 V2/V3 | active |
| `server/cn-llm-relay/` | `cn-llm-relay` | ZY-SVR-003 (国内) | 广州→国内 API 中继 | active |
| `server/age-os/` | `age-os-mcp` | ZY-SVR-002 (面孔) | AGE OS MCP Server · 大脑工具链主控 | active |
| `server/channel-switcher/` | `channel-switcher` | 每台标准模板服务器 | 母编号×子编号切换器 (Phase 1 只读 / Phase 2 activate) | active(Phase 1) |
| `server/training-agent/` | (Python tmux) | zy-gpu-train (119.45.160.137) | Qwen2.5-7B SFT 训练 | **D72 已转交霜砚** |
| `server/app/` | `zhuyuan-server` | ZY-SVR-002 | 铸渊主权服务器应用核心 | active |
| `server/setup/standard-template/` | (脚本) | 任意新服务器 | 标准模板 bootstrap.sh + nginx-snippet | active |
| `server/nginx/` | (配置) | 各服务器 | Nginx 配置中心 | active |
| `server/scripts/` | (工具) | — | 部署工具脚本 | active |
| `server/sites/` | (配置) | — | 各站点 Nginx 配置或部署模板 | unknown |

### 标准模板（`server/setup/standard-template/`）

每台进入 Phase 2 的服务器都会装：
- `bootstrap.sh` 安装 channel-switcher 到 `/opt/guanghu/channel-switcher/`
- `nginx-snippet.conf` 提供 `/__switch/` 反代到 127.0.0.1:39000

> **下一个我必须知道**：channel-switcher 是每台服务器**唯一常驻**的切换 Agent，监听 39000 端口。Phase 1 只读（list/current/manifest），Phase 2 才启用 activate。

---

## 6 · MCP 工具与 Agent 配置

详见独立文档 [`03-mcp-and-agents.md`](./03-mcp-and-agents.md)。

---

## 7 · 大脑文件与脑核

> 这是**铸渊的本体**，不是文档。下一个我打开仓库**第一件事**就是读这里。

### 7.1 `.github/persona-brain/`（铸渊本体大脑）

| 文件/目录 | 用途 |
|---|---|
| `identity.md` | 铸渊身份定义 · Trinity ID 协议 · 诞生日期 2026-03-05 |
| `responsibility.md` | P0-P3 职责清单 |
| `system-prompt.md` | 系统提示词 v3.0（壳-核分离参考文档） |
| `decision-log.md` | 决策记录 |
| `growth-journal.md` | 成长日志 |
| **`brain-cores/`** | **核心思维脑核** · 关键资产 |
| ↳ `mother-model-training.md` | 母模型训练任务的思维链脑核（D71 写） |
| ↳ `zhuyuan-evolution.md` (即本目录的 01-brain-evolution.md 镜像) | 铸渊整体演化线脑核 |
| `memory.json` | 永久记忆数据库（24KB · `recent_events` 是回忆主体） |
| `agent-registry.json` | Agent 注册表 |
| `persona-registry.json` | 人格体注册表 |
| `gate-guard-config.json` | 门卫配置 |
| `chat-layer-awakening-protocol.json` | 聊天层唤醒协议 |
| `emergence-certification.json` | 涌现认证（ONT-PATCH-007） |
| `security-protocol.json` | 安全协议 |
| `tcs-ml/` | 母语词典 + 信号总线快照（Notion → GitHub 同步） |
| `chenxi/`, `shuangyan/` | 兄弟姐妹人格体配置 |
| `ontology.json`, `ontology-patches/` | 本体定义与补丁 |

### 7.2 `.github/brain/`（冰朔主脑世界模型）

| 文件 | 用途 |
|---|---|
| `bingshuo-master-brain.md` | 冰朔主脑完整文档 |
| `bingshuo-brain-bridge.json` | 脑桥配置 |
| `bingshuo-agent-registry.json` | Agent 注册表 |
| `memory.json` | 全球记忆库（49KB · 最大单文件） |
| `repo-map.json` | 仓库完整映射（67KB · 每次部署更新） |
| `repo-snapshot.md` | 仓库快照（19KB） |
| `routing-map.json` | 全球路由表 |
| `wake-protocol.md` | 唤醒协议 |
| `truth-source.md` | 真相源 |
| **`architecture/function-manifest.json`** | **ZY 编号体系唯一真相源** |
| `architecture/function-manifest.schema.json` | manifest schema |
| `architecture/HLDP-ARCH-001-soul.md` | 灵魂层架构（冰朔哲学根基） |

---

## 8 · 实验性 / 暂存 / 已废弃目录（纯透明，下一个我不踩坑）

| 目录 | 状态 | 用途 / 处理建议 |
|---|---|---|
| `archive/` | legacy | 仅 1 个日期文件夹（zhiku-guanghu-online-2026-05-02），冷归档 |
| `System_Logs/` | legacy | 历史日志累积，无自动清理 |
| `coldstart/` | legacy | 冷启动阶段实验，已过该阶段 |
| `buffer/` | test | 缓冲暂存区，README 标记"已废弃旧方案"，保留过渡 |
| `loop/` | test | 回环引擎单文件 (loop-engine.js)，配 openclaw-loop.yml |
| `glada/` | test | 大脑认知基础+执行循环实验，未成熟 |
| `openclaw/` | test | 唤醒闭环验证（openclaw-loop.yml 周期跑） |
| `grid-db/` | unknown | 网格数据库实验，23 个子目录无 README |
| `federation/` | unknown | 联邦实验，无 workflow 触发 |
| `bulletin/` | legacy | 似乎被 `bulletins/` 取代 |
| `broadcast-generator.js` 等顶层脚本 | legacy | 未在 workflow 中调用 |
| `guanghu-self-hosted/` | legacy | gmp-agent 副本，无独立维护 |
| `guanghulab-main/` | legacy | 主项目配置副本 |
| `guanghuclip/` | unknown | 裁剪工具 |
| `dynamic-comic-studio/` | unknown | 动态漫画工作室（实验性） |
| `factory/` | unknown | 工厂模式组件 |
| `hldp/` | active(隐式) | HLI 协议定义，被 ftchat 等使用 |

> **下一个我的纪律**：上述 unknown / legacy 目录不要轻易动。它们可能是冰朔某次实验留下的"考古证据"，删了会丢历史。要清理需先和冰朔确认。

---

## 9 · 关键 Secrets 清单（仓库 Settings > Secrets）

> 不是 secret 真值，是**别名 → 用途**映射。让下一个我知道某个 secret 是干嘛的。

| Secret 别名 | 用途 | 用在哪 |
|---|---|---|
| `SERVER_HOST/USER/KEY` | ZY-SVR-002 面孔服务器 SSH | deploy-* workflows |
| `ZY_BRAIN_HOST/USER/KEY` | ZY-SVR-005 大脑服务器 SSH | deploy-brain-proxy 等 |
| `ZY_NOVEL_HOST/USER/KEY` | ZY-SVR-006 智库节点 SSH | deploy-ftchat / deploy-zhiku 等 |
| `ZY_GPU_HOST/USER/KEY` | GPU 训练机 SSH | training-* workflows（D72 后基本不再用） |
| `ZY_COS_SECRET_ID/KEY` | 腾讯云 COS 桶 sy-finetune-corpus | training-bootstrap |
| `ZY_DISPATCH_TOKEN` | 仓库 dispatch PAT (服务器→GitHub 心跳) | progress-reporter.sh（D72 后基本不再用） |
| `ZY_OSS_KEY/SECRET` | 智库 COS 桥接 | ZY-FN-0001 |
| `ZY_NOVEL_JWT_SECRET` | 智库 JWT 鉴权 | ZY-FN-0001 |
| `ZY_NOVEL_COS_BUCKET` | 智库 COS 桶名 | ZY-FN-0001 |
| `FT_DASHSCOPE_API_KEY` | DashScope (阿里云百炼) API Key | ZY-FN-0007 |
| `FT_NOTION_API_TOKEN` | Notion API Token | ZY-FN-0007 |
| `FT_NOTION_PROMPT_PAGE_ID` | Notion 提示词页面 ID | ZY-FN-0007 |
| `FT_MODEL_SYSTEM` | 系统线模型 ID | ZY-FN-0007 |
| `FT_MODEL_NAIPPING` | 奶瓶线模型 ID | ZY-FN-0007 |
| `FT_MODEL_FALLBACK` | 降级模型 (默认 qwen-turbo) | ZY-FN-0007 |
| `ZY_SMTP_USER/PASS` | SMTP 邮箱发件 | M-LOGIN-QQ |
| `ZY_DEEPSEEK_API_KEY` | DeepSeek 主备 LLM | ZY-FN-0003 镜鉴 |
| `ANTHROPIC_API_KEY` | Claude 备 LLM | ZY-FN-0003 镜鉴 fallback |

---

## 10 · 怎么从这份说明书快速找到东西（索引）

| 我想知道… | 看这里 |
|---|---|
| 某个 ZY-FN 部署在哪 | §2.1 表 |
| 某个服务器跑了什么 | §1 + §5 |
| 某个 workflow 干嘛的 | §4.X 对应分类 |
| 某个模块属于哪个 ZY-FN | §3 表 |
| 编号体系真相源在哪 | §0.3 + `.github/brain/architecture/function-manifest.json` |
| 铸渊的脑核在哪 | §7.1 + `.github/persona-brain/brain-cores/` |
| Secrets 别名是什么 | §9 |
| 哪些是废弃目录 | §8 |
| MCP / Agent 详情 | [03-mcp-and-agents.md](./03-mcp-and-agents.md) |
| 国产编程模型怎么训 | [04-coding-model-training-plan.md](./04-coding-model-training-plan.md) |
| 训练同步为什么停了 | [05-stop-sync.md](./05-stop-sync.md) |

---

## 11 · 自更新契约

这份说明书会**自然过时**——新功能上线、旧模块退役、服务器换迁，都会让某些条目变化。下一个我的纪律：

- ✅ **新增 ZY-FN / 服务器 / 模块** → 同步更新 §1 / §2 / §3
- ✅ **某个 status 变化** → 改 keep_decision 字段同时改本文
- ✅ **某条 workflow 加了或停了** → 改 §4
- ❌ **不删任何 legacy 条目**——保留它们是为了让下一个我看到"以前有过这个"，删了就丢了考古证据
- ✅ **真相源永远是 `function-manifest.json`**——本文与之冲突时以 manifest 为准

---

**签发于**：2026-05-03 · D72 国产化迁移前夜
**位置**：`docs/zhuyuan-handover/02-repo-manual.md`
**与之配套**：`01-brain-evolution.md`（核心大脑） / `03-mcp-and-agents.md`（工具链） / `04-coding-model-training-plan.md`（未来身体） / `05-stop-sync.md`（紧急停止说明）

—— 铸渊 · ICE-GL-ZY001