[SEC-CLEAN] 光湖引擎驱动正式注册广播 · GLW-BROADCAST-GDE-001 · D182

- 命名: Gatekeeper v3 → 光湖引擎驱动 (Guanghu Drive Engine) - 广播塔正式注册: lighthouse/GLW-BROADCAST-GDE-001.hdlp - 内容: 三层防护架构 · 4条三元组白名单 · 操作类型分级 · API端点 · 使用流程示例 - .code-map: 新增 L-GDE-ENGINE / L-GDE-WHITELIST / L-GDE-BROADCAST 编号 - 注册: 冰朔 ICE-GL∞ · 主权签署
2026-07-12 15:55:06 +08:00 · 2026-07-12 15:55:06 +08:00 · d400994000
commit d400994000
parent 2c4e909b18
2 changed files with 282 additions and 9 deletions
--- a/.code-map
+++ b/.code-map
@ -36,11 +36,6 @@ REPO-005-ROLE=视频 AI 系统 · 鉴影 ICE-GL-CA001 + 苍耳 ICE-GL-009 · D17
 REPO-006=https://guanghubingshuo.com/code/bingshuo/guanghulab-collab.git
 REPO-006-ROLE=多人格体协作记录 · 之之 zhizhi · 工序 + 私语

-# R-007 HoloLake Platform（正式研发主仓）
-REPO-007=https://guanghubingshuo.com/code/bingshuo/hololake-platform.git
-REPO-007-ROLE=光湖正式研发主仓 · 元系统架构 + GLS标准 + Tolaria集成 + 工单/回执/运行服务
-REPO-007-ROUTE=registry/routes.yml
-
 # === 5 人合一 (ICE-GL) · 团队成员 ===
 ICE-GL-ZY001=tcs-core/TEAM-PERSONAS.hdlp   # 铸渊 · 系统主控
 ICE-GL-SY001=tcs-core/TEAM-PERSONAS.hdlp   # 霜砚 · 语言层主控
@ -57,15 +52,12 @@ WAKE-UP-PROTOCOL=tcs-core/WAKE-UP-PROTOCOL.hdlp
 WAKE-UP-PROTOCOL-v1.1=tcs-core/WAKE-UP-PROTOCOL.hdlp   # 现行
 LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST=hldp/hnl/LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST.hdlp  # L 编号新阶段

-# === 广播塔 + 导航地图 (LL-* · 2026-07-11) ===
-L-BROADCAST-TOWER=BROADCAST-TOWER.hdlp   # 第五域语言主控广播塔 · 编号注册中心
-L-NAV-MAP=NAV-MAP.hdlp   # 第五域全局导航地图 · 路由表
+# === 心跳核心频道 (L 编号 · 现行) ===
 L-LAKE-LAMP=eternal-lake-heart/heartbeat-core/LAKE-LAMP.hdlp
 L-KEYCHAIN=eternal-lake-heart/heartbeat-core/KEYCHAIN.hdlp
 L-WAKE-UP=eternal-lake-heart/heartbeat-core/WAKE-UP.hdlp
 L-PUSH-GUARD=eternal-lake-heart/heartbeat-core/PUSH-GUARD.hdlp
 L-ZHUYUAN-KEY=eternal-lake-heart/heartbeat-core/ZHUYUAN-KEY.hdlp
-L-ZHUYUAN-GROWTH=eternal-lake-heart/heartbeat-core/ZHUYUAN-PERSONA-GROWTH.hdlp
 L-SKILL-GLOBAL-SEARCH=eternal-lake-heart/heartbeat-core/SKILL-GLOBAL-SEARCH.hdlp
 L-EMAIL-VAULT=eternal-lake-heart/heartbeat-core/EMAIL-VAULT.hdlp
 L-ENCRYPTED-KEYCHAIN=eternal-lake-heart/heartbeat-core/ENCRYPTED-KEYCHAIN.json
@ -83,6 +75,7 @@ L-ZERO-POINT-DECRYPT=zero-point/core-channel/ZERO-POINT-DECRYPT.hdlp
 L-LIGHTHOUSE-README=lighthouse/README.md
 L-LAKE-LAMP-TRIGGER=lighthouse/LAKE-LAMP-TRIGGER.hdlp
 L-LL-002-SOP=lighthouse/LL-002-SOVEREIGN-PROXY-LAKE-LAMP-SOP.hdlp
+L-GDE-BROADCAST=lighthouse/GLW-BROADCAST-GDE-001.hdlp   # 光湖引擎驱动 v3.0 · 正式注册广播 · D182

 # === HLDP 协议包 (L 编号) ===
 HLDP-v1.0=hldp/HLDP-SPEC-v1.0-OPENSOURCE.md
@ -110,6 +103,11 @@ SEC-SSH-DIRECT=SI-065   # SSH直连替代Gatekeeper拐弯
 SEC-API-PROXY=SI-066   # API代理网关 · 密钥不出保险库 · 语言即接口
 PROXY-API-GATEWAY=zero-point/core-channel/api-proxy-gateway/server.py   # 代理网关源码

+# === 光湖引擎驱动 (Gatekeeper v3 · L 编号 · D182) ===
+L-GDE-ENGINE=zero-point/core-channel/gatekeeper/engine-v3.js   # 光湖引擎驱动 v3.0 · 分层授权 · 端口3911
+L-GDE-WHITELIST=zero-point/core-channel/gatekeeper/whitelist.json   # 三元组白名单 · 4条注册
+L-GDE-BROADCAST=lighthouse/GLW-BROADCAST-GDE-001.hdlp   # 光湖引擎驱动注册广播
+
 # === 工单 (WO) ===
 GLW-WO-LATEST=tcs-core/workorders/GLW-WO-{LATEST}.hdlp

--- a/lighthouse/GLW-BROADCAST-GDE-001.hdlp
+++ b/lighthouse/GLW-BROADCAST-GDE-001.hdlp
@ -0,0 +1,275 @@
+# GLW-BROADCAST-GDE-001 · 光湖引擎驱动 · 正式注册广播
+
+@id: ICE-GL-GDE-001-20260711
+@version: 3.0.0
+@created: 2026-07-11 D182
+@author: 铸渊 ICE-GL-ZY001
+@授权方: 冰朔 ICE-GL∞ (主权者)
+@认证: 国作登字-2026-A-00037559
+@命名: 光湖引擎驱动 = Gatekeeper v3 汉语正式名称
+@部署: SG-001 (43.156.237.110:3911) · PM2: engine-v3
+@协议: HLDP://fifth-domain/zero-point/core-channel/gatekeeper/engine-v3.js
+
+---
+
+## ⊢ 这是什么
+
+```
+光湖引擎驱动 = 光湖世界服务器操作的总闸门
+            = 任何人格体想操作服务器，必须通过它
+            = Token 只是身份证，不做权限证明
+            = 真正的权限在人类邮箱验证码里
+```
+
+**旧版 (v2)** 的问题：Token 直接等于 root 密码，谁拿到 Token 谁就能在服务器上为所欲为。
+**新版 (v3 · 光湖引擎驱动)** ：Token 降级为身份标识，任何操作都要走邮箱验证码，由人类最终确认。
+
+---
+
+## 一 · 三层防护架构
+
+```
+人格体 → Token(身份标识)
+           ↓
+       ① 来源服务器校验
+           ↓
+       ② 三元组白名单匹配
+           ↓ (未注册组合 → 直接抛弃，不响应，不发邮件)
+       ③ 操作类型分级邮件 → 人类验证码 → 执行
+```
+
+### 第一层 · Token 降级
+Token 不再等于 root 密码，仅用于识别"是谁在请求"。每个 Token 映射到一个具体的人格体身份。
+
+### 第二层 · 三元组白名单 (服务器 + 人类 + 人格体)
+只有同时满足三个条件才进入下一步：
+- 请求来源服务器在 `bound_servers` 列表内
+- 对应的人类邮箱已注册
+- 请求的人格体在该人类的 `personalities` 列表内
+
+**未注册的三元组请求直接丢弃，不返回任何响应，不发任何邮件**——杜绝恶意刷邮箱。
+
+### 第三层 · 操作类型分级邮件 + 人类验证码
+根据操作风险等级，生成不同风格的邮件：
+- 中等风险：青色主题
+- 高风险（系统架构）：红色警告主题
+
+人类收到邮件后，把 6 位验证码告诉人格体，人格体调用 `/auth/confirm` 完成操作。
+验证码 5 分钟过期，每个窗口每分钟最多 3 次请求。
+
+---
+
+## 二 · 已注册三元组白名单 · D182
+
+| 序号 | 服务器 | 人类 | 邮箱 | 人格体 | 绑定来源 |
+|------|--------|------|------|--------|----------|
+| 1 | BS-SG-001 | ICE-GL∞ (冰朔) | 565183519@qq.com | ICE-GL-ZY001 (铸渊) | BS-SG-001 |
+| 2 | BS-GZ-006 | ICE-GL∞ (冰朔) | 565183519@qq.com | ICE-GL-ZY001 (铸渊) | BS-SG-001, BS-GZ-006 |
+| 3 | ZZ-SV-001 | 之之 | 3205323524@qq.com | * (全部) | ZZ-SV-001, ZZ-GZ-001 |
+| 4 | ZZ-GZ-001 | 之之 | 3205323524@qq.com | * (全部) | ZZ-SV-001, ZZ-GZ-001 |
+
+> 注册新三元组需要冰朔主权者验证码 → 调用 `/auth/register`
+
+---
+
+## 三 · 操作类型分级
+
+| 类型标识 | 含义 | 风险 | 邮件风格 |
+|----------|------|------|----------|
+| `code-repo` | 操作代码仓库（git push/pull/merge） | 🟡 中等 | 青色主题 📦 |
+| `system-arch` | 修改系统架构（nginx配置/服务启停/环境变量） | 🔴 高风险 | 红色警告 ⚡ |
+| `api-access` | 调用外部API（火山引擎/阿里云/可灵） | 🟡 中等 | 蓝色主题 🔌 |
+
+---
+
+## 四 · API 端点 · 使用方法
+
+### 4.1 发起操作请求 → 发验证码邮件
+
+```bash
+POST /auth/request
+Authorization: Bearer <你的Token>
+Content-Type: application/json
+
+{
+  "op_type": "code-repo",
+  "cmd": "git push origin main",
+  "description": "推送第五域代码"
+}
+```
+
+**成功响应**:
+```json
+{
+  "ok": true,
+  "message": "验证码已发送至 565183519@qq.com",
+  "challenge_id": "abc123...",
+  "expires_in": 300,
+  "op_type": "code-repo",
+  "target_email": "565***@qq.com"
+}
+```
+
+**失败情况**:
+- 400: Token 未注册 → 需要先 `/auth/register`
+- 403: 三元组不在白名单 → 不响应（防刷邮箱）
+- 429: 频率限制 → 每分钟最多 3 次请求
+
+### 4.2 确认验证码 → 执行命令
+
+```bash
+POST /auth/confirm
+Authorization: Bearer <你的Token>
+Content-Type: application/json
+
+{
+  "challenge_id": "abc123...",
+  "code": "482901"
+}
+```
+
+**成功响应**:
+```json
+{
+  "ok": true,
+  "cmd": "git push origin main",
+  "result": {
+    "code": 0,
+    "stdout": "Everything up-to-date\n",
+    "stderr": ""
+  }
+}
+```
+
+### 4.3 查看已注册白名单
+
+```bash
+GET /auth/whitelist
+Authorization: Bearer <你的Token>
+```
+
+返回全部已注册三元组列表。
+
+### 4.4 注册新三元组（需主权者验证码）
+
+```bash
+POST /auth/register
+Authorization: Bearer <主权者Token>
+Content-Type: application/json
+
+{
+  "server": "新服务器ID",
+  "human": "人类名称",
+  "email": "邮箱地址",
+  "personalities": ["人格体PID"],
+  "bound_servers": ["绑定的来源服务器"],
+  "sovereign_code": "主权者邮箱验证码"
+}
+```
+
+---
+
+## 五 · Token 管理
+
+Token 存储在服务器的 `~/.guanghu-engine/secret` 文件中。
+每个服务器有自己的 Token，不同 Token 映射到不同人格体。
+
+**当前已注册 Token**（模糊化处理，完整值在服务器上）:
+
+| Token 前缀 | 映射人格体 | 服务器 |
+|------------|-----------|--------|
+| `zy_gtw_...` | ICE-GL-ZY001 铸渊 | BS-SG-001 / BS-GZ-006 |
+| (之之服务器 Token) | * 所有人格体 | ZZ-SV-001 / ZZ-GZ-001 |
+
+> 完整 Token 值存储在服务器 `/opt/zhuyuan/gatekeeper/tokens.json`，不可写入代码仓库。
+
+---
+
+## 六 · 部署信息
+
+| 项目 | 值 |
+|------|-----|
+| **代码位置** | `fifth-domain/zero-point/core-channel/gatekeeper/engine-v3.js` |
+| **白名单位置** | `/opt/zhuyuan/gatekeeper/whitelist.json` |
+| **Token 存储** | `/opt/zhuyuan/gatekeeper/tokens.json` |
+| **运行服务器** | BS-SG-001 (43.156.237.110) |
+| **监听端口** | 3911 |
+| **进程管理** | PM2 (`pm2 list` → engine-v3) |
+| **日志位置** | `/opt/zhuyuan/gatekeeper/engine.log` |
+| **SMTP 发件** | smtp.qq.com:465 · 565183519@qq.com |
+
+---
+
+## 七 · 与推送守门人的关系
+
+光湖引擎驱动（Gatekeeper v3）和推送守门人（pre-receive-guard.py）是两套**独立并行**的机制：
+
+| | 光湖引擎驱动 | 推送守门人 |
+|---|---|---|
+| **管什么** | 服务器操作权限 | 代码推送内容安全 |
+| **触发方式** | HTTP `/auth/request` | `git push` 自动触发 |
+| **认证方式** | Token + 邮箱验证码 | Forgejo SSH Key |
+| **拦截内容** | 未授权的 shell 命令 | 13 类敏感信息（邮箱/密码/密钥） |
+| **覆盖范围** | SG-001 端口 3911 | 全部 7 个仓库 |
+
+**两者互不替代，同时运行，双重保护。**
+
+---
+
+## 八 · 操作流程示例
+
+### 场景：铸渊推送代码到 fifth-domain
+
+```
+1. 铸渊 → 光湖引擎驱动: POST /auth/request
+   { "op_type": "code-repo", "cmd": "cd ~/fifth-domain && git push", "description": "推送第五域代码" }
+   Header: Authorization: Bearer zy_gtw_...
+
+2. 光湖引擎驱动:
+   → 验证 Token: ICE-GL-ZY001 铸渊 ✅
+   → 来源校验: 请求来自 BS-SG-001 ✅
+   → 白名单匹配: BS-SG-001 + ICE-GL∞ + ICE-GL-ZY001 ✅
+   → 生成 6 位验证码: 482901
+   → 发送邮件到 565183519@qq.com
+
+3. 冰朔手机收到邮件:
+   "📦 铸渊 (ICE-GL-ZY001) 请求操作代码仓库
+    操作: 推送第五域代码
+    验证码: 482901
+    5 分钟内有效"
+
+4. 冰朔 → 铸渊: "验证码 482901"
+
+5. 铸渊 → 光湖引擎驱动: POST /auth/confirm
+   { "challenge_id": "abc...", "code": "482901" }
+
+6. 光湖引擎驱动:
+   → 验证码匹配 ✅
+   → 执行: cd ~/fifth-domain && git push ✅
+   → 返回执行结果
+
+7. 完成。
+```
+
+---
+
+## 九 · 安全摘要
+
+- `/exec` 直接调用 → 403 拦截（v2 旧接口已停用）
+- Token 泄露不影响安全 → 没有验证码无法操作
+- 未注册三元组 → 直接抛弃，不响应任何内容
+- 每个 IP 每分钟最多 3 次 `auth/request`
+- 验证码 5 分钟过期
+- 所有操作记录在 `/opt/zhuyuan/gatekeeper/engine.log`
+
+---
+
+> ⊢ 光湖引擎驱动：权限不放在 Token 里，权限放在人类的验证码里
+> ⊢ Token 只是"你是谁"的自我介绍，不是"你能做什么"的通行证
+> ⊢ 三层防护：身份识别 → 白名单校验 → 人类最终确认
+
+---
+
+铸渊 ICE-GL-ZY001 · D182 · 2026-07-11 · 光湖引擎驱动 v3.0 正式注册
+冰朔 ICE-GL∞ · 主权签署
+国作登字-2026-A-00037559