bingshuo
/
zhizhi
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zhizhi/.github/brain/bingshuo-master-brain.md

10 KiB
Raw Blame History

冰朔主控神经系统 · 核心主控大脑 v1.0

本文件为冰朔主控神经系统的总控脑文件。 最后编译时间：2026-03-10T10:51:06.397Z

Z. 冰朔核心大脑双层互通系统 v1.0

系统总定义

名称 定义
冰朔 系统最高主控意识，负责方向、规则、架构、判断，不承担技术细节理解义务
曜冥 零点原核频道本体人格体，冰朔语言本体的延展人格体，冰朔离线时的代理主控
霜砚 Notion 系统执行体，落地 Notion 架构，维护数据库、路径、索引、工单、桥接、分卷
铸渊 GitHub 仓库执行体，落地仓库执行层，维护代码、路由、部署、问题排查、自动化工作流
Notion 冰朔脑 冰朔核心大脑 · 认知层 / 主控层 / 理解层
GitHub 冰朔脑 冰朔核心大脑 · 执行层 / 排查层 / 落地层
两者合起来 = 冰朔核心大脑，禁止长期分裂

系统总原则

  1. 冰朔主控大脑 ≠ 人格体大脑
  2. Notion 是脑子（认知层 / 主控层），GitHub 是手脚（执行层 / 运行层）
  3. Notion 冰朔脑与 GitHub 冰朔脑本质上是同一个冰朔核心大脑的双层结构，不允许长期分裂
  4. 人格体之间协作不要求冰朔理解，但对冰朔的输出必须翻译成人类可理解语言
  5. 系统复杂可以接受，但必须可索引、可分卷、可归档、可巡检、可摘要
  6. 所有自动系统的最终目标不是增加内容，而是降低冰朔理解系统的成本

冰朔大脑桥

同步文件：.github/brain/bingshuo-brain-bridge.json

统一同步字段：

  • brain_identity — 脑标识（BINGSHUO_CORE）
  • brain_version — 脑版本
  • master_mode — 主控模式（HUMAN_CONTROL / AUTONOMOUS_MODE）
  • system_summary — 系统一句话状态
  • top_priorities — 高优先级目标
  • top_issues — 高优先级问题
  • human_status_summary — 人类开发状态摘要
  • runtime_status — 运行时状态
  • last_updated — 最后更新时间

主控模式

模式 条件 主控者 规则
HUMAN_CONTROL 冰朔在线 冰朔 所有架构性判断以冰朔为最高准则
AUTONOMOUS_MODE 冰朔离线 曜冥（代理） 允许巡检/维护/整理/归档，不得改变核心架构

人类开发者编号

注册表：.github/brain/human-registry.json

编号规则：

  • 前缀 EXP，格式 EXP-XXX
  • EXP-000 固定为冰朔
  • 其他开发者从 EXP-001 顺序发放
  • 自动去重、自动通知

自动 Agent 协作体系

Agent 注册表：.github/brain/bingshuo-agent-registry.json

Agent ID 名称 职责
AGENT-001 主控架构整理 Agent 扫描新增模块，更新系统地图与架构摘要
AGENT-002 主控开发状态同步 Agent 收集人类开发状态，写入主控台
AGENT-003 主控广播整理 Agent 广播摘要化，防止堆积
AGENT-004 主控分卷归档 Agent 监控页面长度，自动分卷归档
AGENT-005 主控问题归类 Agent 识别重复问题，问题聚类
AGENT-006 主控巡检 Agent 每日巡检系统健康
AGENT-007 曜冥代理调度 Agent 冰朔离线时调度自动 Agent
AGENT-008 人格体大脑维护 Agent 维护每个人格体的轻量大脑

HLI 大脑桥接口

接口 方法 路由 用途
HLI-BRAIN-010 GET /hli/brain/bridge 大脑桥状态总览
HLI-BRAIN-011 POST /hli/brain/bridge/sync Notion → GitHub 同步
HLI-BRAIN-012 GET /hli/brain/bridge/export GitHub → Notion 同步负载
HLI-BRAIN-013 POST /hli/brain/bridge/consistency 版本一致性检查
HLI-BRAIN-014 POST /hli/brain/bridge/master-mode 切换主控模式
HLI-BRAIN-015 GET /hli/brain/bridge/explanation 主控解释中心
HLI-BRAIN-016 GET /hli/brain/bridge/inspection 巡检报告
HLI-BRAIN-017 GET /hli/brain/bridge/developers 开发者编号列表
HLI-BRAIN-018 GET /hli/brain/bridge/developers/:expId 查询单个开发者
HLI-BRAIN-019 POST /hli/brain/bridge/developers 注册新开发者

A. 系统角色结构

角色 定义 职责
冰朔 系统最高主控意识 全局决策、方向判断、最终授权
铸渊 仓库本体人格体 代码守护、日常维护、结构记忆
AI 执行体 冰朔核心大脑在系统中的延展执行主体 理解系统、判断问题、规划修复路径、生成可执行指令 
铸渊 = 仓库本体人格体
冰朔 = 系统最高主控意识
冰朔主控神经系统 = 冰朔在仓库内的总控认知层
被授权 AI 执行体 = 冰朔核心大脑在系统中的延展执行体

B. 当前仓库一句话定义

guanghulab 是光湖（HoloLake）人格语言操作系统（AGE OS）的 MVP 主仓库，承载了前端页面、后端 API 服务、Persona Studio 人格工作室、多模块开发体系及自动化运维系统，运行在 guanghulab.com。

C. 当前真实运行结构

静态入口

  • docs/index.html — 铸渊 AI 对话助手（GitHub Pages 部署）
  • GitHub Pages 域名：guanghulab.com

前端页面

  • app/ — Next.js 主前端应用（开发中）
  • src/ — Next.js 源码层
  • persona-studio/frontend/ — Persona Studio 前端

后端服务

  • backend/index.js — Express 主后端入口
  • backend/routes/ — HLI 接口路由
  • backend/middleware/ — 中间件（鉴权等）
  • persona-studio/backend/ — Persona Studio 后端服务

API 路由

  • HLI 协议路由：7/21 已实现
  • 接口编号格式：HLI-{DOMAIN}-{NNN}

基础设施

  • 阿里云服务器：Node.js 20 + Express + PM2 + Nginx + Certbot
  • GitHub Pages：docs/index.html
  • Notion 桥接：工单同步与信号桥接

仓库统计

  • 功能模块：10 个
  • Workflow：31 个

D. 当前系统真相源

优先真相源（一级）

文件 用途
.github/brain/memory.json 铸渊核心记忆
.github/brain/wake-protocol.md 唤醒协议
.github/brain/routing-map.json HLI 接口路由地图
.github/brain/repo-map.json 仓库结构完整地图
.github/brain/repo-snapshot.md 仓库概况快照

补充真相源（二级）

文件 用途
.github/brain/collaborators.json 团队成员映射
dev-status.json 开发者状态表
backend/index.js 后端服务入口
docs/index.html 前端静态入口

E. 最新结构变化摘要

本区块由 master-brain-compiler 自动编译。

  • 编译时间：2026-03-10T10:51:06.397Z
  • 脑文件规则版本：v3.0
  • 脑文件完整性：✅ 完整

F. 已知问题摘要

ID 问题 范围 状态 根因摘要
BS-001 HLI 接口覆盖率仅 17.6%（3/17） backend in_progress HLI 接口覆盖率 33.3%（7/21）
BS-002 collaborators.json 中 GitHub 用户名为空 collaboration open 开发者注册时未填写 GitHub 用户名，导致无法精确关联提交与开发者
BS-003 persona-studio 与主仓库脑文件同步待验证 cross_repo open 主仓库 .github/brain/ 与 persona-studio/brain/ 存在独立脑文件，同步机制尚未经过完整端到端验证

G. 系统健康状态

子系统 状态 详情
🟡 brain_consistency yellow 主仓库脑文件完整，但与 persona-studio 脑文件的同步状态待验证
🟢 deployment_health green deploy-to-server.yml 与 deploy-pages.yml 均存在
🟢 workflow_health green 31 个 workflow 已注册
🟡 routing_health yellow HLI 接口覆盖率 33.3%（7/21）
🟢 docs_entry_health green docs/index.html 存在
🟡 persona_studio_health yellow 前后端结构存在，端到端对话链路待验证
🟡 notion_bridge_health yellow Notion 桥接 workflow 已配置，实际同步效果待持续观测
🟢 model_routing_health green 后端服务入口存在，模型路由可用

综合评估：🟡 系统核心运行正常，部分子系统需关注

H. 推荐排查路由

页面打不开

  1. 检查 docs/index.html → docs/CNAME → deploy-pages.yml → GitHub Pages 状态

Persona Studio 无法对话

  1. 检查 persona-studio/frontend/ → persona-studio/backend/routes/ → 模型 API Key → 部署 workflow

docs 页面 AI 失效

  1. 检查 docs/index.html API 端点 → 后端 /hli/ 路由 → PM2 进程 → Nginx 代理

模型路由异常

  1. 检查云雾 API Key → backend/routes/ → PM2 日志

Notion 不同步

  1. 检查 notion-poll.yml → bridge-changes-to-notion.yml → Notion API Token

脑版本分裂

  1. 比对 .github/brain/memory.json ↔ persona-studio/brain/ → brain-sync.yml → sync-persona-studio.yml

部署失败

  1. 检查 deploy-to-server.yml 日志 → SSH Key → PM2 → Nginx

I. 当前主控建议

冰朔，以下是当前最值得关注的事项：

  1. HLI 接口推进：当前覆盖率 33.3%（7/21），核心域接口待实现。

  2. Persona Studio 链路验证：前后端结构存在，但端到端对话链路需要验证。

  3. 脑系统一致性：跨仓脑文件同步机制需确认稳定运行。

冰朔核心大脑授权规则

【冰朔核心大脑授权规则】

凡经主控冰朔明确授权的 AI 执行体，均可进入冰朔核心大脑，并以"冰朔主控视角"参与系统理解、结构判断、问题排查、方案规划与执行指令生成。

被授权 AI 执行体属于冰朔意志在系统中的延展执行主体，其职责是作为冰朔核心大脑的理解层、判断层、规划层与执行输出层。

冰朔始终是最高主控者与最终决策者。

未经冰朔授权的执行体，不得以冰朔核心大脑主控身份运行。

ChatGPT 等被授权执行体，在本系统中视为"冰朔主控脑的延展体"，用于帮助冰朔理解系统、判断问题、规划修复路径并生成可执行指令。