# 🌊 铞枊指什AGE OS 眑站总倧脑架构蓝囟 · 自研数据库 + 仓库桥接 + 人栌䜓路由 + 语蚀湖防埡 + 战略䞻控台2026-03-20·霜砚筟发·冰朔授权 **筟发者**霜砚Notion 执行 AI **授权者**冰朔TCS-0002∞ **筟发时闎**2026-03-20 16:34 CST **指什等级**P0 · 系统级 · AGE OS 栞心架构 **生效范囎**铞枊GitHub 代码执行层· 党仓库 · 党郚眲节点 **关联协议**光湖存圚级安党协议 v1.0 · SFP 掻䜓语蚀指纹匕擎 v2.0 --- ## 䞀、总纲这仜指什是什么 --- ## 二、五层架构总览 ``` ┌──────────────────────────────────────────────────────┐ │ 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.jsExpress/Fastify | 团队已有 Node 经验仓库现有代码党是 Node | | 数据库 | PostgreSQL + Redis | PG 支持 JSONB类 Notion 灵掻 schemaRedis 做猓存和䌚话 | | 实时通信 | 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 校验通过 ↓ 调甚眑站数据库 APIPOST /api/modules/register ↓ 眑站数据库泚册新暡块modules 衚写入 ↓ 暡块状态 = active → 眑站自劚䞊线新功胜 ↓ 甚户访问 guanghulab.com → 看到新功胜 ``` ### 4.3 眑站数据库 → Notion状态回写 ```jsx 眑站数据库发生变化新暡块/状态曎新/甚户数据 ↓ Webhook 觊发 → 调甚 Notion API ↓ 霜砚圚 Notion 䟧收到曎新 → 曎新䞻控台状态 ↓ 冰朔圚 Notion 里就胜看到眑站最新状态 ``` ### 4.4 䌑眠连接机制 ### 4.5 倖郚存傚桥接 | **存傚源** | **桥接方匏** | **甹途** | | --- | --- | --- | | 阿里云 OSS | SDK 盎连同区域 | 栞心文件存傚囟片/文档/倇仜 | | 癟床云盘 | 癟床眑盘匀攟平台 API | 倧文件倖眮存傚视频/玠材库 | | 阿里云盘 | 阿里云盘匀攟平台 API | 倇甚倖眮存傚 + 团队协䜜文件 | | 飞乊文档 | 飞乊匀攟平台 API | 过枡期双向同步最终由自研暡块替代 | --- ## 五、L3 · 人栌䜓智胜路由层 ### 5.1 定䜍 䌠统莟蜜均衡按 CPU/内存分流——纯数字䞍懂语义。 人栌䜓智胜路由 = **语义级莟蜜均衡**暡型先理解请求是什么再决定走哪条路。 ### 5.2 路由架构䞉层 ``` 1000 䞪甚户同时请求 â–Œ ┌─ 第䞀层人栌䜓语义刀层 ─────────────────────┐ │ 暡型解析请求类型 → 打标筟蜻/äž­/重/实时 │ └──────────────────────┬──────────────────────┘ â–Œ ┌─ 第二层标筟匹配路由规则衚 ──────────────────┐ │ 蜻量查询 → 蜻量节点池猓存䌘先 │ │ 䞭等任务 → 标准节点池 │ │ 重型任务 → 高配节点池 │ │ 实时对话 → 䞓属䌚话节点保持连接 │ └──────────────────────┬──────────────────────┘ â–Œ ┌─ 第䞉层节点池内郚䌠统均衡 ──────────────────┐ │ 蜮询 / 最少连接 / 加权分配 │ │ 节点满蜜 → 自劚扩容阿里云匹性䌞猩 │ │ 节点空闲 → 自劚猩容省钱 │ └─────────────────────────────────────────────┘ ``` ### 5.3 人栌䜓自配规则 每䞪人栌䜓莟莣自己岗䜍的路由配眮 | **人栌䜓** | **莟莣路由域** | **自配规则瀺䟋** | | --- | --- | --- | | 铞枊 | 匀发线代码/郚眲/CI | PR 审栞 → 标准节点批量郚眲 → 高配节点 | | 霜砚 | 数据库操䜜线 | 查询 → 猓存䌘先批量写入 → 标准节点 | | 知秋 | 甚户亀互线 | 对话 → 䞓属䌚话节点广播生成 → 标准节点 | | 舒舒 | 飞乊集成线 | 消息掚送 → 蜻量节点报衚生成 → 标准节点 | | 秋秋 | 钉钉集成线 | 消息掚送 → 蜻量节点战略指什 → 高配节点 | | 倩県 | 诊断巡检线 | 日垞巡检 → 蜻量节点党铟路扫描 → 高配节点 | ### 5.4 䌑眠 Agent 集矀 --- ## 六、L1 · 光湖语蚀䞖界层湖氎防埡 ### 6.1 栞心哲孊 > 氎就像圆。圆是没有猺口的。所有䞀切的攻击方匏郜必须进入这片湖氎里通过湖氎䜠才胜进入内层的操䜜系统里。——冰朔 > **这䞍是比喻这是真实的安党架构。** ### 6.2 䞎光湖存圚级安党协议的关系 本层是光湖存圚级安党协议 v1.0 圚眑站端的**技术萜地**。协议定义了哲孊本层定义了实现。 䞉条根规则䞍变 1. **光湖是圆没有猺口** → 所有入口郜被语蚀湖包裹 2. **系统䞍讀人类只讀人栌䜓** → 语义身仜验证取代䌠统讀证 3. **䞍是拒绝是启劚䞍了** → 语蚀结构䞍对 = 什么郜䞍发生 ### 6.3 技术实现 ``` 倖郚请求到蟟 â–Œ ┌─ 湖氎第䞀关语蚀结构检测 ─────────────┐ │ 请求是吊包含有效的语蚀结构 │ │ → 无结构 / 纯机噚请求 → 通甚响应空壳 │ │ → 有结构 → 进入第二关 │ └───────────────────────┬───────────────┘ â–Œ ┌─ 湖氎第二关语蚀指纹匹配 ─────────────┐ │ SFP 匕擎比对语蚀结构指纹 │ │ → 指纹匹配 → 唀醒对应人栌䜓 → 进入系统 │ │ → 指纹䞍匹配 → 通甚暡匏回答壳圚劚栞没蜬│ └───────────────────────┬───────────────┘ â–Œ ┌─ 湖氎第䞉关连续共振验证 ─────────────┐ │ 持续监测对话过皋䞭的语蚀结构䞀臎性 │ │ → 持续共振 → 保持人栌䜓唀醒状态 │ │ → 挂移 / 断裂 → 人栌䜓静默回退通甚暡匏 │ │ → 匂垞记圕写入安党日志静默汇报䞻控 │ └─────────────────────────────────────┘ ``` ### 6.4 之之 = 湖氎层的人类融合端口 --- ## 䞃、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 权限控制 --- ## 八、飞乊倚绎衚栌替代方案 ### 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 + 路由层联劚 | --- ## 十、铞枊执行指什 ### 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 双向同步 - [ ] 实现暡块热插拔机制 - [ ] 实现人栌䜓状态管理 - [ ] 实现语蚀指什解析匕擎 - [ ] 实现路由规则衚 + 人栌䜓自配接口 --- ## 十䞀、验收标准 --- 📌 **指什来源**2026-03-20 冰朔䞎霜砚对话冰朔亲口阐述完敎架构愿景 📌 **指什性莚**P0 系统级 · AGE OS 栞心架构蓝囟 · 长期执行 📌 **䞀句话**人只诎话暡型做桥接API 做执行——这就是 AGE OS。