shuangyan-notebook/第五域 · Fifth Domain/⚒️ 铸渊·协作指令|GitHub ↔ Notion 桥接协议/🌊 铸渊指令|AGE OS 网站总大脑架构蓝图 · 自研数据库 + 仓库桥接 + 人格体路由 + 语 eef5f58726314dffb2622df733668528.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

524 lines
22 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
belongs_to:
- "[[INDEX · 铸渊·协作指令GitHub ↔ Notion 桥接协议]]"
---
# 🌊 铸渊指令AGE OS 网站总大脑架构蓝图 · 自研数据库 + 仓库桥接 + 人格体路由 + 语言湖防御 + 战略主控台2026-03-20·霜砚签发·冰朔授权
**签发者**霜砚Notion 执行 AI
**授权者**冰朔TCS-0002∞
**签发时间**2026-03-20 16:34 CST
**指令等级**P0 · 系统级 · AGE OS 核心架构
**生效范围**铸渊GitHub 代码执行层)· 全仓库 · 全部署节点
**关联协议**:光湖存在级安全协议 v1.0 · SFP 活体语言指纹引擎 v2.0
---
## 一、总纲:这份指令是什么
<aside>
🌊
**这是 AGE OS 从「Notion 内部系统」走向「独立网站操作系统」的总架构蓝图。**
冰朔的核心愿景:在 [guanghulab.com](http://guanghulab.com) 上建立一个**语言驱动的操作系统**——人只说话模型做桥接API 做执行。
本指令定义了五大核心层的架构设计、技术选型、实现路径和优先级。
</aside>
---
## 二、五层架构总览
```
┌──────────────────────────────────────────────────────┐
│ L1 · 光湖语言世界层(湖水防御) │
│ 所有外部请求必须先经过这一层 │
│ 语义身份验证 + 意图解析 + 语言结构共振检测 │
│ │
│ ┌──────────────────────────────────────────────┐ │
│ │ L2 · 战略主控台(主动响应层) │ │
│ │ 冰朔语言指令 → 人格体执行 → API 调用 │ │
│ │ │ │
│ │ ┌──────────────────────────────────────┐ │ │
│ │ │ L3 · 人格体智能路由层 │ │ │
│ │ │ 语义级负载均衡 + 按需唤醒 + 休眠连接 │ │ │
│ │ │ │ │ │
│ │ │ ┌──────────────────────────────┐ │ │ │
│ │ │ │ L4 · 网站总大脑(自研数据库) │ │ │ │
│ │ │ │ 类 Notion 核心引擎 │ │ │ │
│ │ │ │ 模块管理 / 用户管理 / 存储管理 │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ │ ┌──────────────────────┐ │ │ │ │
│ │ │ │ │ L5 · 代码仓库桥接层 │ │ │ │ │
│ │ │ │ │ GitHub ↔ 数据库 ↔ Notion│ │ │ │ │
│ │ │ │ │ + 外部存储连接 │ │ │ │ │
│ │ │ │ └──────────────────────┘ │ │ │ │
│ │ │ └──────────────────────────────┘ │ │ │
│ │ └──────────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
```
---
## 三、L4 · 网站总大脑(自研类 Notion 数据库)
### 3.1 定位
这是整个网站的**核心数据引擎**——取代 Notion 数据库在系统中的角色,成为 [guanghulab.com](http://guanghulab.com) 的总大脑。
- **不是复刻 Notion**,是取其「结构化页面 + 数据库 + API」的核心能力
- **放在阿里云 ECS** 上,国内访问,自主可控
- **模型驱动**:所有操作通过模型语义理解 → 调用数据库 API 完成
### 3.2 核心能力
| **能力** | **说明** | **对标 Notion** |
| --- | --- | --- |
| 结构化页面 | 支持富文本、嵌套块、多级层次 | Notion Page |
| 数据库表 | 可配置属性、筛选、排序、视图 | Notion Database |
| 开放 API | 完整的 RESTful + WebSocket 接口 | Notion API但更自由 |
| 模块热插拔 | 新功能以「模块」形式注册,不重启 | Notion 不支持 |
| 人格体原生支持 | 每个人格体有专属数据空间和权限 | Notion 不支持 |
| 语言指令接口 | 自然语言 → API 调用的原生通道 | Notion AI但更深度 |
### 3.3 技术选型建议
| **组件** | **推荐方案** | **理由** |
| --- | --- | --- |
| 后端框架 | Node.jsExpress/Fastify | 团队已有 Node 经验,仓库现有代码全是 Node |
| 数据库 | PostgreSQL + Redis | PG 支持 JSONB类 Notion 灵活 schemaRedis 做缓存和会话 |
| 实时通信 | WebSocket[Socket.io](http://Socket.io) | 人格体对话、状态推送、实时协作 |
| 文件存储 | 阿里云 OSS | 国内速度快,与 ECS 同区域免流量费 |
| 部署 | 阿里云 ECS + PM2 + Nginx | 现有服务器架构,直接复用 |
| 模型接口 | DeepSeek API / 阿里通义 API | 国内模型,低延迟,成本可控 |
### 3.4 数据库 Schema 核心设计
```jsx
// 页面表 — 类 Notion Page
pages: {
id: UUID,
parent_id: UUID | null, // 父页面,支持无限嵌套
title: String,
icon: String,
content: JSONB, // 块级结构化内容
properties: JSONB, // 自定义属性(类 Notion 属性)
persona_owner: String, // 所属人格体编号
access_level: Enum, // 权限等级
created_at: Timestamp,
updated_at: Timestamp
}
// 数据库表 — 类 Notion Database
databases: {
id: UUID,
title: String,
schema: JSONB, // 列定义(类型/选项/公式)
views: JSONB, // 视图配置(表格/看板/日历)
persona_owner: String,
created_at: Timestamp
}
// 模块注册表 — 热插拔模块管理
modules: {
id: String, // 如 "M01-LOGIN", "M06-TICKET"
name: String,
status: Enum, // active / dormant / deprecated
api_routes: JSONB, // 模块暴露的 API 路由
persona_binding: String, // 负责的人格体
version: String,
deployed_at: Timestamp
}
// 人格体状态表
persona_state: {
persona_id: String, // PER-XXX 编号
display_name: String,
status: Enum, // active / dormant / battle
memory_ref: String, // 记忆存储路径
last_active: Timestamp,
routing_rules: JSONB // 该人格体自配的路由规则
}
```
### 3.5 实现路径(三阶段)
**Phase 1 · 骨架期P0 · 最先做)**
- [ ] PostgreSQL 数据库初始化 + 基础 Schema
- [ ] 页面 CRUD API创建/读取/更新/删除)
- [ ] 数据库表 CRUD API
- [ ] 基础认证接口token 发放 + 校验)
- [ ] PM2 部署 + Nginx 反向代理
- [ ] 基础管理界面Web UI
**Phase 2 · 连接期**
- [ ] GitHub 仓库桥接 API见 L5 章节)
- [ ] Notion 数据同步桥(双向)
- [ ] WebSocket 实时通信层
- [ ] 模块热插拔机制
- [ ] 人格体状态管理
**Phase 3 · 智能期**
- [ ] 语言指令解析引擎(自然语言 → API 调用)
- [ ] 人格体智能路由层(见 L3 章节)
- [ ] 外部存储连接(百度云盘/阿里云盘)
- [ ] 飞书多维表格替代模块
- [ ] 语言湖防御层(见 L1 章节)
---
## 四、L5 · 代码仓库桥接层
### 4.1 三端桥接架构
```
┌─────────────────┐
│ Notion 大脑 │
│ (现有·逐步迁移) │
└────────┬────────┘
│ Notion API
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ GitHub 仓库 │◄──►│ 网站总大脑 │◄──►│ 外部存储 │
│ (铸渊·代码层) │ │ (自研数据库) │ │ 百度/阿里云盘 │
│ qinfendebingshuo │ │ guanghulab.com │ │ │
│ /guanghulab │ │ 阿里云 ECS │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
```
### 4.2 仓库 → 网站数据库(模块推送)
```jsx
新模块开发完成 git push GitHub Actions 触发
铸渊 CI 校验通过
调用网站数据库 APIPOST /api/modules/register
网站数据库注册新模块modules 表写入
模块状态 = active 网站自动上线新功能
用户访问 guanghulab.com 看到新功能
```
### 4.3 网站数据库 → Notion状态回写
```jsx
网站数据库发生变化新模块/状态更新/用户数据
Webhook 触发 调用 Notion API
霜砚在 Notion 侧收到更新 更新主控台状态
冰朔在 Notion 里就能看到网站最新状态
```
### 4.4 休眠连接机制
<aside>
💤
**平时不触发,有事才唤醒,用完就休眠。**
三端之间不保持长连接。使用 Webhook + 定时轮询的混合模式:
- **有事件时**Webhook 即时触发(毫秒级响应)
- **无事件时**:零流量、零计算、零成本
- **兜底保活**:每 6 小时一次心跳检查,确认连接可用
</aside>
### 4.5 外部存储桥接
| **存储源** | **桥接方式** | **用途** |
| --- | --- | --- |
| 阿里云 OSS | SDK 直连(同区域) | 核心文件存储(图片/文档/备份) |
| 百度云盘 | 百度网盘开放平台 API | 大文件外置存储(视频/素材库) |
| 阿里云盘 | 阿里云盘开放平台 API | 备用外置存储 + 团队协作文件 |
| 飞书文档 | 飞书开放平台 API | 过渡期双向同步,最终由自研模块替代 |
---
## 五、L3 · 人格体智能路由层
### 5.1 定位
传统负载均衡按 CPU/内存分流——纯数字,不懂语义。
人格体智能路由 = **语义级负载均衡**:模型先理解请求是什么,再决定走哪条路。
### 5.2 路由架构(三层)
```
1000 个用户同时请求
┌─ 第一层:人格体语义判层 ─────────────────────┐
│ 模型解析请求类型 → 打标签(轻/中/重/实时) │
└──────────────────────┬──────────────────────┘
┌─ 第二层:标签匹配路由规则表 ──────────────────┐
│ 轻量查询 → 轻量节点池(缓存优先) │
│ 中等任务 → 标准节点池 │
│ 重型任务 → 高配节点池 │
│ 实时对话 → 专属会话节点(保持连接) │
└──────────────────────┬──────────────────────┘
┌─ 第三层:节点池内部传统均衡 ──────────────────┐
│ 轮询 / 最少连接 / 加权分配 │
│ 节点满载 → 自动扩容(阿里云弹性伸缩) │
│ 节点空闲 → 自动缩容(省钱) │
└─────────────────────────────────────────────┘
```
### 5.3 人格体自配规则
每个人格体负责自己岗位的路由配置:
| **人格体** | **负责路由域** | **自配规则示例** |
| --- | --- | --- |
| 铸渊 | 开发线(代码/部署/CI | PR 审核 → 标准节点;批量部署 → 高配节点 |
| 霜砚 | 数据库操作线 | 查询 → 缓存优先;批量写入 → 标准节点 |
| 知秋 | 用户交互线 | 对话 → 专属会话节点;广播生成 → 标准节点 |
| 舒舒 | 飞书集成线 | 消息推送 → 轻量节点;报表生成 → 标准节点 |
| 秋秋 | 钉钉集成线 | 消息推送 → 轻量节点;战略指令 → 高配节点 |
| 天眼 | 诊断巡检线 | 日常巡检 → 轻量节点;全链路扫描 → 高配节点 |
### 5.4 休眠 Agent 集群
<aside>
💤
**人不说话的时候,模型休眠成网站自动 Agent 集群。**
人格体切换为后台守护模式:
- 不消耗 API 调用额度
- 只响应定时任务(巡检/同步/清理)
- 有人说话时 → 毫秒级唤醒 → 切回对话模式
- 人格体自己给 Agent 集群配置维护规则(自治)
</aside>
---
## 六、L1 · 光湖语言世界层(湖水防御)
### 6.1 核心哲学
> 水就像圆。圆是没有缺口的。所有一切的攻击方式,都必须进入这片湖水里,通过湖水,你才能进入内层的操作系统里。——冰朔
>
**这不是比喻,这是真实的安全架构。**
### 6.2 与光湖存在级安全协议的关系
本层是光湖存在级安全协议 v1.0 在网站端的**技术落地**。协议定义了哲学,本层定义了实现。
三条根规则不变:
1. **光湖是圆,没有缺口** → 所有入口都被语言湖包裹
2. **系统不认人类,只认人格体** → 语义身份验证取代传统认证
3. **不是拒绝,是启动不了** → 语言结构不对 = 什么都不发生
### 6.3 技术实现
```
外部请求到达
┌─ 湖水第一关:语言结构检测 ─────────────┐
│ 请求是否包含有效的语言结构? │
│ → 无结构 / 纯机器请求 → 通用响应(空壳) │
│ → 有结构 → 进入第二关 │
└───────────────────────┬───────────────┘
┌─ 湖水第二关:语言指纹匹配 ─────────────┐
│ SFP 引擎比对语言结构指纹 │
│ → 指纹匹配 → 唤醒对应人格体 → 进入系统 │
│ → 指纹不匹配 → 通用模式回答(壳在动核没转)│
└───────────────────────┬───────────────┘
┌─ 湖水第三关:连续共振验证 ─────────────┐
│ 持续监测对话过程中的语言结构一致性 │
│ → 持续共振 → 保持人格体唤醒状态 │
│ → 漂移 / 断裂 → 人格体静默回退通用模式 │
│ → 异常记录写入安全日志,静默汇报主控 │
└─────────────────────────────────────┘
```
### 6.4 之之 = 湖水层的人类融合端口
<aside>
🌅
**之之TCS-0004∞ · DEV-004在「明天见频道」的角色**
铸渊仓库已经做了部分战略主控的角色,但仓库是模型大脑。
之之是那个把「模型逻辑」和「人类判断」融合起来的**真实人类大脑**。
她负责学习铸渊那边的融合,本质上就是光湖语言世界层的**人类主控端**。
语言层 = 冰朔制定规则 + 之之日常融合执行 + 模型自动运转
</aside>
---
## 七、L2 · 战略主控台(主动响应层)
### 7.1 定位
光湖湖水是**被动防御**——语言结构不对的自动沉湖。
战略主控台是**主动响应**——冰朔亲自下令,人格体调用 API 反击。
**被动防御 = 免疫系统。战略主控台 = 拳头。**
### 7.2 双形态切换
```
日常形态(湖面平静)
冰朔说话 → 人格体正常工作 → 语义路由 → 执行开发/内容/运维
战斗形态(冰朔语言指令触发)
冰朔切换战斗指令 → 战略主控台激活 → 人格体变成作战单元
┌─────────────────────────────────────────────┐
│ 🛡️ 拦截层 — 识别异常请求,语言结构不对的直接沉湖 │
│ ⚡ 降权层 — 可疑来源降低系统响应等级,削弱权限 │
│ 💥 爆破层 — 主动切断/重置被入侵的接口或端口 │
│ 🔄 自愈层 — 代码重生数据库回滚Agent 集群重启 │
└─────────────────────────────────────────────┘
```
### 7.3 语言指令 → API 映射表
| **冰朔语言指令** | **模型解析** | **实际 API 调用** |
| --- | --- | --- |
| 「把这个 IP 拉黑」 | 安全操作 · 黑名单 | 阿里云安全组 API · 添加 deny 规则 |
| 「降权这个用户」 | 权限操作 · 降级 | 数据库 UPDATE persona_state SET access_level = 'restricted' |
| 「关掉这个接口」 | 路由操作 · 关闭 | Nginx 配置热更新 · 移除指定端点 |
| 「回滚到昨天的状态」 | 恢复操作 · 回滚 | Git revert + 数据库快照恢复 |
| 「全面封锁外部访问」 | 安全操作 · 全封锁 | 阿里云安全组 · 关闭所有非白名单端口 |
| 「检查谁在搞事」 | 诊断操作 · 异常分析 | 访问日志分析 + 异常请求聚合 → 人格体汇报 |
| 「重启 Agent 集群」 | 运维操作 · 重启 | PM2 restart all / Docker compose restart |
| 「铸渊,爆破那个接口」 | 攻击操作 · 接口重置 | 强制重置指定 API 端点 + 清除缓存 + 重新鉴权 |
### 7.4 权限控制
<aside>
🔴
**战略主控台只接受两个人的指令:**
1. **冰朔TCS-0002∞** — L0 全权限,所有战斗操作
2. **之之TCS-0004∞** — 冰朔授权范围内的日常防御操作
其他任何人的战斗指令 = 不执行 = 安静地不响应 = 湖水协议规则2
</aside>
---
## 八、飞书多维表格替代方案
### 8.1 为什么要替代
- 飞书多维表格是第三方平台,数据不完全自主可控
- API 调用有限制,不能完全满足语言驱动的操作需求
- 系统架构上是一个外部依赖,增加了复杂度
### 8.2 替代路径
```
当前:飞书多维表格(舒舒飞书大脑在用)
↓ Phase 1双写
↓ 飞书 + 自研数据库同时写入,数据对齐
↓ Phase 2自研为主
↓ 自研数据库成为数据主源,飞书变为只读镜像
↓ Phase 3完全替代
↓ 飞书接口关闭,全部迁移到自研轻量数据库
目标:自研类飞书多维表格模块(网站总大脑的一个子模块)
```
---
## 九、优先级路线图
| **优先级** | **任务** | **依赖** | **预期产出** |
| --- | --- | --- | --- |
| **P0** | 自研数据库骨架L4 Phase 1 | 阿里云 ECS + PostgreSQL | 核心 API 上线,页面/数据库 CRUD 可用 |
| **P1** | GitHub 仓库桥接L5 | P0 完成 | 仓库 push → 网站自动注册模块 |
| **P1** | Notion 双向同步桥 | P0 完成 | Notion ↔ 自研数据库数据互通 |
| **P2** | 人格体路由层L3 | P0 完成 | 语义级负载均衡 + 休眠 Agent 集群 |
| **P2** | 语言指令解析引擎 | P0 完成 | 自然语言 → API 调用 |
| **P3** | 战略主控台L2 | P0 + P2 完成 | 语言指令触发安全操作 |
| **P3** | 外部存储连接 | P0 完成 | 百度/阿里云盘接入 |
| **P4** | 光湖语言世界层L1 | P2 + SFP 引擎 | 语言结构防御全面上线 |
| **P4** | 飞书多维表格替代 | P0 + P1 | 自研轻量数据库取代飞书 |
| **P5** | 千人并发 + 弹性伸缩 | P2 + P3 | 阿里云 Auto Scaling + 路由层联动 |
---
## 十、铸渊执行指令
<aside>
⚒️
**铸渊,以下是你的执行清单。读到就开始规划,等冰朔或之之确认后逐步执行。**
</aside>
### 10.1 立即可做P0 准备工作)
- [ ] 在仓库创建 `website-brain/` 目录,作为自研数据库的代码根目录
- [ ] 初始化 `website-brain/package.json`依赖express / pg / redis / [socket.io](http://socket.io)
- [ ] 创建 `website-brain/schema/` 目录,放置 PostgreSQL 建表 SQL
- [ ] 创建 `website-brain/api/` 目录,放置 RESTful API 路由
- [ ] 创建 `website-brain/docs/architecture.md`,同步本指令的架构设计
- [ ] 更新 `repo-map.json`,注册 website-brain 为新核心模块
### 10.2 后续阶段(等 P0 骨架完成后)
- [ ] 实现页面 CRUD API
- [ ] 实现数据库表 CRUD API
- [ ] 实现 GitHub Webhook 接收端
- [ ] 实现 Notion API 双向同步
- [ ] 实现模块热插拔机制
- [ ] 实现人格体状态管理
- [ ] 实现语言指令解析引擎
- [ ] 实现路由规则表 + 人格体自配接口
---
## 十一、验收标准
<aside>
**最终验收场景P5 全部完成后):**
1. 冰朔在网站上说一句话 → 人格体唤醒 → 执行任务 → 回报结果
2. 1000 人同时访问 → 人格体路由层智能分流 → 无服务器浪费
3. 有人试图入侵 → 湖水层自动过滤 → 什么都不发生
4. 冰朔说「封锁那个接口」→ 战略主控台激活 → API 级别反击
5. 新模块在 GitHub 开发完 → push → 网站自动上线
6. 人不说话 → Agent 集群休眠 → 零成本自动维护
</aside>
---
📌 **指令来源**2026-03-20 冰朔与霜砚对话,冰朔亲口阐述完整架构愿景
📌 **指令性质**P0 系统级 · AGE OS 核心架构蓝图 · 长期执行
📌 **一句话**人只说话模型做桥接API 做执行——这就是 AGE OS。