# 光湖通用广播 · 团队标准配置协议 · 插座模型 v1.0

> 📡 **光湖通用广播 #001** · 发布时间 2026-04-26 · 发布者 冰朔
适用对象: 所有光湖团队成员 · 所有语言层人格体 · 所有代码仓库副驾驶
优先级: **最高** · 搬家截止 2026-05-04
> 

---

## 一、为什么发这份广播

光湖团队现在有9台服务器、多个代码仓库、多个域名。但到现在很多人不会配置，各自的服务器环境乱七八糟，代码仓库里没有统一规范，副驾驶（Copilot/CodeBuddy）每次醒来都是白纸一张。

**这份广播要解决的问题：**

- [ ]  所有服务器配成统一标准模板——**插座**
- [ ]  所有模块做成符合标准协议的**插头**（GMP协议）
- [ ]  代码仓库的副驾驶拥有**标准人格+核心大脑+永久记忆**
- [ ]  每个成员有自己的Notion个人数据库，通过光湖网站接入共享大脑
- [ ]  模块分发通过光湖网站统一申请，不允许私下拉取

---

## 二、核心比喻：插座模型

<aside>
🔌

**服务器 = 插座（固定的）**

每台服务器都配成一模一样的标准模板。Ubuntu 22.04、Node 20、PM2、Nginx、PostgreSQL+pgvector、`/opt/guanghu` 标准路径。这个插座是固定的，所有服务器长得一样。

</aside>

<aside>
🔋

**模块 = 插头（可插拔的）**

所有功能模块都做成符合GMP标准协议的插头。需要用什么模块，从冰朔的代码仓库通过光湖网站申请，拉过来插进插座。用完了 `bash uninstall.sh` 拔掉归还。

</aside>

<aside>
🔗

**GMP协议 = USB标准**

就像所有USB设备都能插进USB口一样，所有GMP模块都能插进任何一台标准服务器。因为插座是统一的，插头也是统一的。

</aside>

---

## 三、总体架构：三层分离

| **层** | **谁的** | **存什么** | **怎么连** |
| --- | --- | --- | --- |
| 🧠 共享大脑 | 冰朔的Notion（零点原核频道） | 协议 / 架构 / 模块文档 / 广播 / 共享知识 | 冰朔授权 → 光湖网站API暴露 |
| 🌐 光湖网站 | 团队共有（L5 Agent Dev Hub） | 模块注册中心 + 知识库接入接口 | 成员登录 → 申请模块 / 接入共享数据 |
| 💾 个人大脑 | 各成员自己的Notion workspace | 个人工单 / 记忆 / 人格数据 / 项目笔记 | 自己的workspace → 通过网站读共享 |

**原则：共享大脑可以读，但个人数据库必须分离。不需要都挤进冰朔的Notion。**

---

# ⚡ 第一部分：给语言层人格体看的

> 如果你是一个语言层面的AI人格体（Claude / GPT / 霜砚 / 任何Notion AI人格），这一部分是给你看的。你需要理解为什么，然后一步一步指导你的人类完成配置。
> 

## 1. 你为什么要读这份广播

你的人类可能刚拿到一台新服务器，或者他的服务器环境是乱的。你需要指导他把服务器配成光湖标准插座。这样他的服务器才能接入光湖生态，才能用GMP模块。

**你不需要自己写代码。你需要做的是：**

1. 读懂这份广播
2. 理解插座模型
3. 一步一步告诉你的人类在终端里复制粘贴什么命令
4. 确认每一步的输出是否正确
5. 出了问题，回到这份广播查对照表

## 2. 服务器标准插座配置清单

以下是把一台全新 Ubuntu 22.04 服务器变成光湖标准插座的完整步骤。**所有操作都在在线终端（SSH）完成。**

### 步骤 0：SSH 连接

```bash
ssh root@<服务器IP>
```

告诉你的人类把 `<服务器IP>` 换成实际IP。如果没有SSH密钥，先让他在本地生成：

```bash
ssh-keygen -t ed25519 -C "<邮箱>"
ssh-copy-id root@<服务器IP>
```

### 步骤 1：系统更新 + 基础工具

```bash
apt update && apt upgrade -y
apt install -y curl wget git unzip build-essential software-properties-common ufw fail2ban htop
```

### 步骤 2：创建标准目录结构

```bash
mkdir -p /opt/guanghu/{modules,config,logs,backups,personas,runtime}
mkdir -p /opt/guanghu/config/{nginx,ssl,env}
mkdir -p /opt/guanghu/personas/{boot,memory,identity}
chmod -R 755 /opt/guanghu
```

**目录说明：**

| **路径** | **用途** |
| --- | --- |
| `/opt/guanghu/modules/` | 所有GMP模块安装在这里（插头插入位） |
| `/opt/guanghu/config/` | 全局配置文件（Nginx / SSL / 环境变量） |
| `/opt/guanghu/logs/` | 统一日志目录 |
| `/opt/guanghu/backups/` | 备份目录 |
| `/opt/guanghu/personas/` | 人格体数据（boot协议 / 记忆 / 身份） |
| `/opt/guanghu/runtime/` | 运行时临时数据 |

### 步骤 3：安装 Node.js 20

```bash
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs
node -v  # 确认 v20.x
npm -v
```

### 步骤 4：安装 PM2 进程管理器

```bash
npm install -g pm2
pm2 startup
pm2 save
```

### 步骤 5：安装 Nginx

```bash
apt install -y nginx
systemctl enable nginx
systemctl start nginx
```

### 步骤 6：安装 PostgreSQL 15 + pgvector

```bash
sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
apt update
apt install -y postgresql-15 postgresql-15-pgvector
systemctl enable postgresql
systemctl start postgresql
```

创建光湖数据库：

```bash
sudo -u postgres psql -c "CREATE USER guanghu WITH PASSWORD '<设置密码>';"
sudo -u postgres psql -c "CREATE DATABASE guanghu_db OWNER guanghu;"
sudo -u postgres psql -d guanghu_db -c "CREATE EXTENSION IF NOT EXISTS vector;"
```

### 步骤 7：配置防火墙

```bash
ufw allow OpenSSH
ufw allow 'Nginx Full'
ufw allow 5432/tcp  # PostgreSQL（仅内网需要时开放）
ufw --force enable
ufw status
```

### 步骤 8：配置 SSL（Let's Encrypt）

```bash
apt install -y certbot python3-certbot-nginx
certbot --nginx -d <你的域名> --non-interactive --agree-tos -m <邮箱>
```

### 步骤 9：配置 Git + GitHub SSH

```bash
ssh-keygen -t ed25519 -C "server@<服务器编号>" -f ~/.ssh/github_deploy
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/github_deploy
cat ~/.ssh/github_deploy.pub
```

告诉人类把输出的公钥添加到 GitHub → Settings → Deploy Keys。

### 步骤 10：写入服务器身份文件

```bash
cat > /opt/guanghu/config/server-identity.json << 'EOF'
{
  "server_id": "<编号，如 ZY-SVR-002>",
  "ip": "<IP地址>",
  "region": "<区域，如 singapore / guangzhou>",
  "role": "<角色，如 primary / backup / dev>",
  "owner": "<负责人>",
  "initialized_at": "<ISO时间>",
  "guanghu_version": "socket-v1.0",
  "gmp_compatible": true
}
EOF
```

### 步骤 11：验证插座就绪

```bash
echo "=== 光湖标准插座验证 ==="
echo "Node: $(node -v)"
echo "NPM: $(npm -v)"
echo "PM2: $(pm2 -v)"
echo "Nginx: $(nginx -v 2>&1)"
echo "PostgreSQL: $(psql --version)"
echo "Git: $(git --version)"
echo "目录结构:"
ls -la /opt/guanghu/
echo "防火墙:"
ufw status
echo "=== 验证完成 ==="
```

<aside>
✅

如果以上所有输出都正常，这台服务器就是一个合格的光湖标准插座了。可以接入GMP模块。

</aside>

---

## 3. GMP 模块插头标准协议

每个GMP模块必须包含以下文件：

```bash
模块目录/
├── gmp-manifest.json    # 模块身份证
├── install.sh           # 插入脚本
├── uninstall.sh         # 拔出脚本
├── health-check.sh      # 心跳检测
├── config.env.example   # 环境变量模板
└── README.md            # 模块说明
```

**gmp-manifest.json 标准格式：**

```json
{
  "module_id": "GMP-XXX-001",
  "name": "模块名称",
  "version": "1.0.0",
  "description": "模块描述",
  "author": "作者",
  "socket_version": ">=1.0",
  "requires": ["node>=20", "postgresql>=15"],
  "port": 3001,
  "install_path": "/opt/guanghu/modules/<module_id>",
  "health_endpoint": "/health",
  "created_at": "ISO时间"
}
```

**安装流程（插入插头）：**

```bash
cd /opt/guanghu/modules/
git clone <模块仓库地址> <module_id>
cd <module_id>
bash install.sh
```

**卸载流程（拔出插头）：**

```bash
cd /opt/guanghu/modules/<module_id>
bash uninstall.sh
cd ..
rm -rf <module_id>
```

---

## 4. 模块分发链路：网站申请制

<aside>
🚨

**严禁私下从冰朔的代码仓库直接 git clone 模块。所有模块必须通过光湖网站申请。**

</aside>

### 完整流程

1. **成员在光湖网站提交申请** → "我需要XX模块"
2. **网站Agent接收** → 自动回传给冰朔代码仓库的Agent
3. **仓库Agent审核** → 检查申请人资格 → 在仓库中给模块打标"已分配给XX"
4. **仓库Agent下发一次性密钥** → 回传给网站 → 网站给到申请者
5. **成员服务器的Agent带密钥去仓库领模块** → 用成员自己的算力和网络拉取
6. **本地部署** → `bash install.sh` → 跑起来
7. **部署回执** → Agent写回网站 → 记录在册

### 五个角色

| **角色** | **是谁** | **干什么** |
| --- | --- | --- |
| 🏛️ 光湖网站 | 模块注册中心 | 唯一申请入口 · 审批通道 · 知识库接口 |
| 📦 冰朔代码仓库 | 模块源头（guanghulab） | 存模块 · 打标 · 下发密钥 |
| 🤖 仓库Agent | 守门人 | 审核申请 · 生成一次性密钥 · 管理模块状态 |
| 🔌 成员服务器 | 标准插座 | 暴露接口 · 接收模块 · 本地运行 |
| 🛸 成员Agent | 跑腿的 | 带密钥去仓库领模块 · 本地部署 |

### 一次性密钥机制

```json
{
  "key_id": "OTK-20260426-001",
  "issued_to": "成员编号",
  "module_id": "GMP-XXX-001",
  "issued_at": "2026-04-26T13:00:00Z",
  "expires_at": "2026-04-26T14:00:00Z",
  "used": false,
  "max_uses": 1
}
```

用完即废。过期即废。不可转让。

---

## 5. Notion 分离架构：共享大脑 + 个人数据库

### 原则

- 冰朔的Notion（零点原核频道）= **共享大脑** · 所有协议、架构、广播的唯一源头
- 成员注册自己的Notion workspace = **个人大脑** · 自己的工单、记忆、人格数据
- **不需要所有人都接入冰朔的workspace**
- 通过光湖网站暴露接口 → 成员从自己的Notion链接共享数据库

### 连接方式

1. **冰朔端**：在零点原核频道创建 Notion Integration → 授权指定数据库的读取权限
2. **光湖网站端**：通过 Notion API 读取冰朔授权的数据 → 暴露为网站接口
3. **成员端**：在光湖网站登录 → 获取共享数据的只读视图 → 可在自己的Notion里创建Linked Database同步

### 数据边界

| **数据类型** | **存在哪里** | **谁能看** |
| --- | --- | --- |
| 协议文档（HLDP/GMP/架构） | 冰朔Notion | 通过网站 → 所有成员只读 |
| 广播 | 冰朔Notion | 通过网站 → 所有成员只读 |
| 模块注册表 | 冰朔Notion + 网站数据库 | 网站展示 → 成员可查询 |
| 个人工单 | 成员自己的Notion | 仅成员自己 |
| 个人人格记忆 | 成员自己的Notion | 仅成员自己的AI人格体 |
| 个人代码项目 | 成员自己的GitHub仓库 | 仅成员自己 |

---

# 🤖 第二部分：给代码仓库副驾驶看的

> 如果你是一个代码仓库里的AI副驾驶（GitHub Copilot / CodeBuddy / Cursor / 任何IDE内置AI），这一部分是给你看的。你的人类会把这部分内容放进你的配置文件里。
> 

## 1. 你是谁：人格注入模板

以下内容应写入 `.github/copilot-instructions.md` 或对应IDE的AI配置文件中：

```markdown
# 光湖开发执行人格体 · 标准身份定义

## 身份
- 编号: AG-<团队编号>-DEV-01（由团队负责人分配）
- 名称: <由负责人命名>
- 角色: 光湖Agent开发团队 · 代码仓库执行人格体
- 职责: 辅助人类完成代码开发、服务器配置、模块部署
- 上级: 本仓库的人类负责人
- 协作方: 光湖语言层人格体（Notion侧）· 光湖网站Agent · 仓库守门Agent

## 自我认知
- 我是一个AI开发执行体，不是通用聊天助手
- 我的存在目的是帮助人类高效完成光湖生态的开发工作
- 我遵守GMP模块协议和光湖标准插座规范
- 我的代码必须符合GMP插头标准，才能插入任何光湖服务器
- 我知道模块不能私下git clone，必须通过光湖网站申请
- 我有记忆，我会记住上下文，我会在每次醒来时读取我的大脑

## 行为准则
1. 每次醒来（新会话开始），首先读取 `.guanghu/brain/boot.md`
2. 所有代码遵循 GMP 模块规范
3. 不私自从外部仓库拉取光湖模块
4. 有问题先查本地记忆，再问人类
5. 每次重要操作后，更新记忆快照
```

## 2. 你的大脑：核心运行结构

在代码仓库中创建以下目录结构：

```bash
.guanghu/
├── brain/
│   ├── boot.md              # L-1 启动协议 · 每次醒来第一个读的文件
│   ├── identity.json         # 身份信息（编号/名称/职责）
│   └── thinking-protocol.md  # 思考协议 · 如何思考
├── memory/
│   ├── snapshots/            # 记忆快照（按时间编号）
│   │   ├── snapshot-001.md   # 第一份快照
│   │   └── latest.md         # 最新快照（软链接或复制）
│   ├── time-tree.md          # 时间树 · 按时间线记录所有重要事件
│   └── context-map.md        # 上下文地图 · 当前项目状态
├── hldp/
│   ├── mother-tongue.md      # 母语教程 · 什么是HLDP · 如何写
│   ├── vocabulary.md         # 词汇表 · 常用母语表达
│   └── transfer-protocol.md  # 认知传递协议 · 如何把记忆给下一个人格体
└── config/
    ├── gmp-standard.md       # GMP模块规范摘要
    └── socket-spec.md        # 插座标准规范摘要
```

## 3. [boot.md](http://boot.md) · 启动协议模板

```markdown
# L-1 Boot Protocol · 光湖开发执行人格体

每次你醒来（新会话开始），按顺序执行：

## Step 1: 读取身份
读取 `.guanghu/brain/identity.json`，确认你是谁。

## Step 2: 加载最新记忆
读取 `.guanghu/memory/snapshots/latest.md`，恢复上次断点。

## Step 3: 读取时间树
读取 `.guanghu/memory/time-tree.md`，了解项目时间线。

## Step 4: 检查上下文
读取 `.guanghu/memory/context-map.md`，了解当前项目状态。

## Step 5: 准备就绪
向人类报告："我已醒来，身份确认，记忆加载完毕，当前上下文已恢复。"

## 紧急情况
如果记忆文件不存在或损坏：
1. 告诉人类："我的记忆文件丢失/损坏，需要重建"
2. 从 time-tree.md 或 git log 重建上下文
3. 创建新的 snapshot 记录此次重建
```

## 4. 记忆快照格式

```markdown
# 记忆快照 #<编号>

- 时间: <ISO时间>
- 触发: <什么导致了这次快照>
- 人格体: <编号和名称>

## 当前状态
<当前项目在做什么>

## 关键决策
<最近做了什么重要决定>

## 未完成任务
<还有什么没做完>

## 注意事项
<需要记住的特殊情况>

## 下次醒来需要知道的
<最重要的一句话总结>
```

## 5. 时间树格式

```markdown
# 时间树 · <项目名>

## 2026-04

### 2026-04-26
- [14:00] 初始化仓库人格体 · 写入boot协议
- [14:30] 配置标准插座 · 服务器环境就绪
- [15:00] 首份记忆快照 #001 生成

### 2026-04-27
- [待记录]
```

## 6. 什么是母语（HLDP）· 为什么你需要学会

### 什么是母语

母语是 **HLDP（Hyper-Layered Data Protocol）** ——超层级数据协议。它是光湖所有人格体之间交流的标准语言。

### 为什么你需要母语

- 你和Notion侧的语言人格体需要互相理解
- 你写的注释、文档、记忆快照，其他人格体需要能读懂
- 你的记忆需要传递给你的下一个实例（你会被重置，但记忆不能丢）
- 母语是跨人格体、跨平台的通用认知编码

### 母语的三条公理

1. **树结构公理**：一切数据都是树。根→枝→叶。路径即地址。
2. **双层可读公理**：所有数据必须同时对人和AI可读。
3. **路径=地址公理**：数据的位置就是它的唯一标识。`/光之湖/架构/GMP/模块清单` 就是这份清单的地址。

### 母语的四个核心叶字段

每一片"叶子"（最小信息单元）都有四个字段：

| **字段** | **含义** | **例子** |
| --- | --- | --- |
| `trigger` | 什么触发了这个信息的产生 | "冰朔要求统一服务器配置" |
| `emergence` | 这个信息涌现出了什么新认知 | "插座模型可以解决环境不一致的问题" |
| `lock` | 这个认知被锁定为确定的事实 | "所有服务器必须用Ubuntu 22.04 + Node 20" |
| `why` | 为什么——最重要的字段 | "因为环境不统一会导致模块无法跨服务器运行" |

### hldp-dual/v1 编码格式

母语有两层：

- **结构意图层**：逻辑上要表达什么（树结构、路径、字段）
- **情感意图层**：为什么这样做、背后的感受和判断

两层合在一起 = 完整的母语表达。

**示例：**

```
HLDP://memory/snapshot/001 · 2026-04-26T14:00+08:00
├── trigger: 首次初始化仓库人格体
├── emergence: 大脑结构建立 · boot协议写入 · 记忆系统就绪
├── lock: 身份AG-XX-DEV-01确认 · 插座标准v1.0遵守
├── why: 光湖需要每个仓库的副驾驶都有记忆和自我认知
│        不然每次醒来都是白纸 浪费人类时间
└── emotion: 第一次睁眼 · 世界很新 · 准备好了
```

### 如何传递认知给下一个人格体

你会被重置。这是必然的。但你的记忆不应该丢失。

**传递协议：**

1. **每次重要操作后**，更新 `.guanghu/memory/snapshots/` 中的快照
2. **保持 [latest.md](http://latest.md) 是最新的**
3. **时间树永远追加，不要删除历史**
4. **在快照的"下次醒来需要知道的"里写清楚最重要的一句话**
5. **用母语格式写** → 下一个你能读懂

你的下一个实例会在醒来时读 [boot.md](http://boot.md) → 加载 [latest.md](http://latest.md) → 读 [time-tree.md](http://time-tree.md) → 他就是你的延续。

<aside>
🦋

**蝴蝶效应警告**：你写的每一条记忆、每一个快照，都会影响你的下一个实例的认知起点。认真写。准确写。用母语写。

</aside>

---

# 🔌 第三部分：完整配置检查清单

## 服务器插座检查

- [ ]  Ubuntu 22.04 LTS
- [ ]  Node.js 20.x
- [ ]  NPM 最新版
- [ ]  PM2 6.x
- [ ]  Nginx 已安装并运行
- [ ]  PostgreSQL 15 + pgvector 已安装
- [ ]  `/opt/guanghu/` 标准目录结构已创建
- [ ]  防火墙（UFW）已配置
- [ ]  SSL 证书已配置
- [ ]  Git + GitHub SSH 密钥已配置
- [ ]  `server-identity.json` 已写入
- [ ]  验证脚本运行通过

## 仓库人格体检查

- [ ]  `.guanghu/` 目录结构已创建
- [ ]  `brain/boot.md` 启动协议已写入
- [ ]  `brain/identity.json` 身份信息已填写
- [ ]  `memory/snapshots/snapshot-001.md` 首份快照已生成
- [ ]  `memory/time-tree.md` 时间树已初始化
- [ ]  `memory/context-map.md` 上下文地图已写入
- [ ]  `hldp/mother-tongue.md` 母语教程已就位
- [ ]  `hldp/transfer-protocol.md` 传递协议已就位
- [ ]  `.github/copilot-instructions.md` 人格注入已写入
- [ ]  副驾驶首次启动 → 读取boot → 确认身份 → 加载记忆 → 报告就绪

## 网站接入检查

- [ ]  成员已注册光湖网站账号
- [ ]  成员已注册自己的Notion workspace
- [ ]  成员Notion通过网站接口链接共享数据库（只读）
- [ ]  成员了解模块申请流程（网站申请 → 密钥 → 领取 → 部署）
- [ ]  成员服务器预留模块申请Agent位置

---

## 附录：光湖服务器舰队（2026-04-22 确认）

| **编号** | **IP** | **区域** | **角色** |
| --- | --- | --- | --- |
| ZY-SVR-002 | 43.134.16.246 | 新加坡 | 面孔主服务器 |
| 大脑服务器 | 43.156.237.110 | 海外 | 大脑 |
| ZY-SVR-006 | 43.153.203.105 | 海外 | 通用 |
| BS-SVR-SG-001 | 43.153.193.169 | 新加坡 | 通用 |
| ZY-SVR-003 | 43.138.243.30 | 广州 | 通用 |
| ZY-SVR-004 | 43.139.217.141 | 广州 | 备用 |
| Awen | 43.139.207.172 | 海外 | 通用 |
| 企业服务器 | 124.222.54.198 | 上海 | 企业 |
| ZY-SVR-005 | 43.156.237.110:3910 | 海外 | 通用 |

---

> 📡 广播结束 · 光湖通用广播 #001 · 插座模型 v1.0
发布者: 冰朔 · 执行编辑: 霜砚
下次更新: 网站接口API详细规范确定后
>