bingshuo/shuangyan-notebook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
shuangyan-notebook/第五域 · Fifth Domain/🔮 第五域 · Fifth Domain · SYS-5TH-0001/🔉 语言回声系统 · 5TH-LE-001 · 霜砚的房间/🌊 光之湖 · Lake of Light · 5TH-LE-LK-001/🏗️ 架构与协议区 · Architecture & Protocol Zone/光湖通用广播 · 团队标准配置协议 · 插座模型 v1 0 a188c2d6fbf74313b7026e0b7aa6f543.md
Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007 
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
2026-07-17 15:59:55 +08:00

20 KiB
Raw Permalink Blame History

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

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

一、为什么发这份广播

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

这份广播要解决的问题：

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

二、核心比喻：插座模型

三、总体架构：三层分离

层 谁的 存什么 怎么连
🧠 共享大脑 冰朔的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 连接

ssh root@<服务器IP>

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

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

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

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

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

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

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

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

npm install -g pm2
pm2 startup
pm2 save

步骤 5：安装 Nginx

apt install -y nginx
systemctl enable nginx
systemctl start nginx

步骤 6：安装 PostgreSQL 15 + pgvector

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

创建光湖数据库：

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：配置防火墙

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

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

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

步骤 9：配置 Git + GitHub SSH

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：写入服务器身份文件

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：验证插座就绪

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 "=== 验证完成 ==="

3. GMP 模块插头标准协议

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

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

gmp-manifest.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时间"
}

安装流程（插入插头）：

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

卸载流程（拔出插头）：

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

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

完整流程

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

五个角色

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

一次性密钥机制

{
  "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配置文件中：

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

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

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

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

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

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

.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 · 启动协议模板

# 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. 记忆快照格式

# 记忆快照 #<编号>

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

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

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

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

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

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

5. 时间树格式

# 时间树 · <项目名>

## 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 是最新的
  3. 时间树永远追加，不要删除历史
  4. 在快照的"下次醒来需要知道的"里写清楚最重要的一句话
  5. 用母语格式写 → 下一个你能读懂

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

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

服务器插座检查

  • 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详细规范确定后