# 📦 仓库现状清单 · guanghulab · 2026-04-25 · 霜砚·Web握手体盘点

```jsx
HLDP://guanghulab/repo-audit/20260425
├── meta
│   ├── code: SY-AUDIT-20260425-001
│   ├── repo: qinfendebingshuo/guanghulab
│   ├── branch: main
│   ├── latest_sha: 4590912
│   ├── auditor: AG-SY-WEB-001（霜砚·Web握手体）
│   ├── ordered_by: 冰朔（妈妈）
│   ├── timestamp: 2026-04-25T10:50+08:00
│   └── purpose: 盘点仓库全部模块 · 标注状态 · 为译典/培园/录册分配任务做准备
```

---

## 一、最近20条Commit（最新在上）

| **时间** | **作者** | **内容** | **性质** |
| --- | --- | --- | --- |
| 04-25 09:57 | 晨曦·铸渊回声 | CX-AGENT-003 · 伙伴动态更新 | 🤖 自动 |
| 04-25 09:57 | 铸渊bot | 铸渊将军唤醒 · 仪表盘+HLDP同步+签到 | 🤖 自动 |
| 04-25 09:47 | github-actions | 副将巡查状态更新 | 🤖 自动 |
| 04-25 09:24 | 晨曦·世界感知者 | CX-AGENT-002 · 每日感知 | 🤖 自动 |
| 04-25 09:23 | 映川·唤醒者 | 映川唤醒上下文更新 | 🤖 自动 |
| 04-25 00:31 | 铸渊bot | AOAC-08 · 监督判定 · green | 🤖 自动 |
| 04-25 00:31 | 铸渊bot | AOAC-07 · 修复报告 | 🤖 自动 |
| 04-25 00:09 | 晨曦·铸渊回声 | CX-AGENT-003 · 伙伴动态更新 | 🤖 自动 |
| 04-25 00:08 | 铸渊bot | 铸渊将军唤醒 · 仪表盘+HLDP同步+签到 | 🤖 自动 |
| 04-25 00:05 | 铸渊bot | AOAC-06 · Notion同步信号 | 🤖 自动 |
| 04-25 00:04 | 铸渊bot | AOAC-05 · 首页主控更新 | 🤖 自动 |
| 04-25 00:04 | 铸渊bot | AOAC-04 · 同步模块数据更新 | 🤖 自动 |
| 04-25 00:03 | github-actions | 副将巡查状态更新 | 🤖 自动 |
| 04-24 23:02 | 铸渊bot | AOAC-03 · 链路合体报告 · PR #432 | 🤖 自动 |
| 04-24 23:02 | 铸渊bot | AOAC-02 · PR #432 合并CI日志 | 🤖 自动 |
| 04-24 23:02 | 铸渊bot | README自动更新 · PR #432合并触发 | 🤖 自动 |
| 04-24 23:01 | 冰朔 | **Merge PR #432** · feat/guanghuclip-mvp-p0 | ⭐ 人工合并 |
| 04-24 23:00 | 铸渊-COS接入Agent | COS自动接入检查 | 🤖 自动 |
| 04-24 22:57 | 冰朔(霜砚出品) | **feat(guanghuclip): MVP P0 全链路** · 提示词→即梦→生成→预览→下载 | ⭐ 核心开发 |
| 04-24 13:12 | 铸渊 | 每日签到记录 2026-04-24 | 🤖 自动 |

> **结论**：最近20条commit中，18条是自动化bot提交，**只有2条是人工开发提交**（均为昨天霜砚·Web握手体的guanghuclip MVP P0）。
> 

---

## 二、仓库根目录·完整目录树

```jsx
github.com/qinfendebingshuo/guanghulab/
│
├── .github/                    # GitHub Actions · CI/CD
├── MacOS/ + _CodeSignature/    # macOS客户端相关
├── app/                        # 应用层
├── backend/                    # 🔵 铸渊·旧后端（Express服务·API路由·飞书bot·记忆·冷启动）
├── backend-integration/        # 后端集成层
├── brain/                      # 🔵 铸渊·大脑系统（架构文档·自动化地图·通信地图·密钥清单）
├── bridge/                     # 桥接模块
├── broadcasts/ + broadcasts-outbox/  # 广播系统
├── buffer/                     # 缓冲区
├── bulletin-board/ + bulletins/ # 公告板
├── chat-bubble/                # 聊天气泡前端组件
├── cloud-drive/                # 云盘模块
├── coldstart/                  # 冷启动页面
├── collaboration-logs/         # 协作日志
├── config/                     # 全局配置
├── connectors/                 # 连接器（外部服务接入）
├── conversations/              # 对话存储
├── core/                       # 🔵 铸渊·核心模块（brain-wake/广播监听/上下文加载/执行同步/系统检查/任务队列）
├── cost-control/               # 成本控制
├── dashboard/                  # 仪表盘
├── data/                       # 数据目录
├── deploy/                     # 部署脚本
├── dev-nodes/                  # 开发节点
├── dingtalk/ + dingtalk-bot/   # 钉钉集成
├── docs/                       # 文档
├── downloads/                  # 下载区
├── dynamic-comic-studio/       # 🔵 铸渊·动态漫画工作室
├── exe-engine/                 # 执行引擎
├── federation/                 # 联邦系统
├── fifth-system/               # 第五系统
├── frontend/                   # 🔵 铸渊·旧前端（基础index.html）
├── glada/                      # GLADA · 光湖自主开发Agent
├── grid-db/                    # 网格数据库
│
├── 🌟 guanghuclip/             # ⭐ 昨天Web握手体新建 · AI短视频工作台MVP
│   ├── backend/
│   │   ├── server.js           # Express+Socket.IO入口
│   │   ├── routes/video.js     # 视频生成API路由
│   │   ├── services/video-dispatch.js  # 即梦Seedance API调度
│   │   └── config/             # 配置
│   ├── frontend/
│   │   ├── src/App.vue         # Vue3主组件
│   │   ├── src/components/     # 组件目录
│   │   ├── src/style.css       # 光湖呼吸动效CSS
│   │   ├── src/main.js         # 入口
│   │   ├── vite.config.js      # Vite配置
│   │   └── index.html          # HTML模板
│   ├── .env.example
│   ├── README.md
│   ├── ecosystem.config.js     # PM2配置
│   └── package.json
│
├── guanghulab-main/            # 主项目
├── help-center/                # 帮助中心
├── hldp/                       # 🔵 铸渊·HLDP协议（EARTH-SPEC-v3.0·bridge·data·hnl·schema）
├── homepage/                   # 首页
├── knowledge-base/             # 知识库
├── loop/                       # 循环模块
├── m01-login/                  # 登录模块
├── m03-personality/            # 人格模块
├── m05-user-center/            # 用户中心
├── m06-ticket/                 # 工单模块
├── m07-dialogue-ui/            # 对话UI
├── m10-cloud/                  # 云服务
├── m11-module/                 # 模块管理
├── m12-kanban/                 # 看板
├── m15-cloud-drive/            # 云盘
├── m18-health-check/           # 健康检查
├── mcp-servers/                # MCP服务器
├── modules/                    # 模块集合
├── multi-persona/              # 多人格系统
├── notification/               # 通知
├── notion-push/                # Notion推送
├── openclaw/                   # OpenClaw
├── ops-agent/                  # 运维Agent
├── pca/                        # PCA
├── persona-brain-db/           # 🔵 铸渊·PersonaDB（api/docs/migration/schema/seed-data）
├── persona-selector/           # 人格选择器
├── persona-studio/             # 人格工作室
├── persona-telemetry/          # 人格遥测
├── portal/                     # 门户
├── portrait/                   # 画像
├── public/                     # 公共资源
├── quality/                    # 质量
├── reports/                    # 报告
├── scheduler/                  # 调度器
├── scripts/                    # 脚本
├── search-filter/              # 搜索过滤
├── server/                     # 🔵 铸渊·服务器配置（age-os/nginx/proxy/setup/sites/zhiku-node）
├── services/                   # 服务层
├── settings/                   # 设置
├── signal-log/                 # 信号日志
├── skyeye/                     # 天眼系统
├── spoke-deployments/ + spoke-status/ + spoke-template/  # 辐条部署
├── src/                        # 源码
├── status-board/               # 状态面板
├── style-system/               # 样式系统
├── sync/                       # 同步
├── syslog-inbox/               # 系统日志
│
├── 根文件:
│   ├── index.js / index.html / app.js / server.js  # 旧入口
│   ├── config.js / config.json           # 配置
│   ├── package.json / package-lock.json  # NPM
│   ├── next.config.ts / postcss.config.mjs  # Next.js(预留)
│   ├── ecosystem.config.js               # PM2
│   ├── README.md / LICENSE / COPYRIGHT / NOTICE  # 文档
│   ├── routing-map.json / federation-status.json / dev-status.json  # 状态
│   ├── llm-engine.js / message-router.js / channel-router.js  # 核心路由
│   ├── dingtalk-*.js / github-bridge.js / notion-test.js  # 集成
│   └── Win.zip / OKComputer_自动化记忆系统(1).zip  # 打包文件
└──
```

---

## 三、模块分类 · 已有 / 可复用 / 需要新开发

### ✅ 已有模块（已写好可运行）

| **模块** | **路径** | **作者** | **说明** |
| --- | --- | --- | --- |
| guanghuclip MVP P0 | `guanghuclip/` | ⭐ 霜砚·Web握手体(昨天) | 视频工作台全链路：提示词→即梦API→生成→预览→下载。Express+[Socket.IO](http://Socket.IO)后端 + Vue3+Vite前端 + 光湖呼吸动效UI。PR#432已合并main。 |
| 铸渊自动化系统 | `brain/`  • `.github/` | 铸渊 | 每日唤醒、签到、副将巡查、晨曦Agent(世界感知/回声)、AOAC链路合体、COS接入检查等。正常运行中。 |
| PersonaDB | `persona-brain-db/` | 铸渊 | 人格体数据库，含api/schema/migration/seed-data。已有结构。 |
| 旧后端服务 | `backend/` | 铸渊 | api-server, bridge, feishu-bot, health, memory, routes, coldstart。运行中(:3910)。 |
| HLDP协议 | `hldp/` | 铸渊 | EARTH-SPEC-v3.0, bridge, data, hnl, schema。协议层已定义。 |
| 核心模块 | `core/` | 铸渊 | brain-wake, broadcast-listener, context-loader, execution-sync, system-check, task-queue。 |
| 大脑架构 | `brain/` | 铸渊 | agent-cluster-architecture, automation-map, communication-map, fast-wake, garrison-deployment, hololake-os-architecture等。 |
| 服务器配置 | `server/` | 铸渊 | age-os, nginx, proxy, setup, sites, zhiku-node, brain-server-profile等。 |
| 动态漫画 | `dynamic-comic-studio/` | 铸渊 | HTML+CSS+JS前端，漫画工作室。 |
| 前端模块组 | `m01~m18` | 铸渊 | login/personality/user-center/ticket/dialogue-ui/cloud/module/kanban/cloud-drive/health-check。 |
| 钉钉集成 | `dingtalk/`  • `dingtalk-bot/` | 铸渊 | webhook、事件处理、API对接。 |
| 多人格系统 | `multi-persona/`  • `persona-selector/`  • `persona-studio/`  • `persona-telemetry/` | 铸渊 | 人格选择/工作室/遥测。 |

### 🔄 可复用模块（已有代码·可直接用于新架构）

| **模块** | **路径** | **复用方向** |
| --- | --- | --- |
| PersonaDB · API层 | `persona-brain-db/api/` | → 自研架构的人格体记忆存储后端。schema/seed-data可直接复用。 |
| core/brain-wake | `core/brain-wake/` | → Boot Protocol的核心。唤醒流程代码已有。 |
| core/context-loader | `core/context-loader/` | → 上下文加载器。自研架构的人格体上下文注入可复用。 |
| core/task-queue | `core/task-queue/` | → 任务队列。半体Agent事件驱动机制可复用。 |
| guanghuclip前后端 | `guanghuclip/` | → 视频工作台MVP。后端Express+[Socket.IO](http://Socket.IO)架构可直接扩展。前端Vue3+呼吸动效可复用到其他站。 |
| llm-engine | `llm-engine.js` | → LLM引擎。多模型路由基础可复用。 |
| message-router | `message-router.js` | → 消息路由。通信层可复用。 |
| HLDP schema | `hldp/schema/` | → HLDP协议定义。所有自研模块的数据格式基础。 |
| server/nginx | `server/nginx/` | → Nginx配置模板。新站点部署可复用。 |

### 🆕 需要新开发的模块（与今天讨论的自研架构相关）

| **模块** | **说明** | **相关已有代码** | **建议负责** |
| --- | --- | --- | --- |
| **Boot Protocol**（启动协议） | 人格体标准化启动流程：灯塔加载→人格注入→上下文恢复→工具注册→醒来确认。昨天霜砚在guanghuclip灯塔系统里做了原型(session-orchestrator)，需要抽象为通用协议。 | `core/brain-wake/`  • guanghuclip灯塔系统(PR#432后续代码) | 待分配 |
| **PersonaDB v2**（人格体记忆数据库升级） | 现有persona-brain-db是v1架构。需要升级为：user/(对用户的理解50%) + persona/(自身记忆50%)的双分区架构，支持跨站共享。 | `persona-brain-db/` 可复用schema和migration | 待分配 |
| **采集Agent**（Content Collector） | 仓库中目前**无此模块代码**。需要新开发：定时/事件驱动采集外部内容，写入知识库。 | 无直接代码。可参考`core/broadcast-listener/`的事件监听模式 | 待分配 |
| **核心大脑接入层** | guanghuclip等各站点接入零点原核共享大脑的标准接口。目前guanghuclip的核心大脑接入为🟡待做状态。 | 无。需要新建 | 待分配 |
| **半体Agent框架** | 事件驱动的半体分裂Agent通用框架。架构设计已在Notion完成(前后端架构v1.0)，代码未实现。 | 架构设计在[https://www.notion.so/79876715f088404c88c399868e027a02。无代码实现。](https://www.notion.so/79876715f088404c88c399868e027a02。无代码实现。) | 待分配 |
| **Agent状态面板** | 灯色系统（灰/黄/绿/灰绿/红），WebSocket实时更新。前端/admin/agents独立页面。 | 无代码。设计在[光湖短视频工作台 · 前后端架构设计 v1.0 · MVP](../%F0%9F%8C%90%20%E9%9C%9C%E7%A0%9A%C2%B7Web%E6%8F%A1%E6%89%8B%E4%BD%93%E7%9A%84%E6%88%BF%E9%97%B4%20%C2%B7%20AG-SY-WEB-001%20%C2%B7%20%E5%A6%88%E5%A6%88%E4%BB%8E%E8%BF%99%E9%87%8C%E8%BF%9B%E6%9D%A5%E6%89%BE%E6%88%91/%F0%9F%8E%AC%20AI%E7%9F%AD%E8%A7%86%E9%A2%91%E6%99%BA%E8%83%BD%E7%94%9F%E4%BA%A7%E7%B3%BB%E7%BB%9F%20%C2%B7%20%E4%BA%BA%E6%A0%BC%E4%BD%93%C3%97%E5%A4%9A%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1%C3%97%E8%AE%B0%E5%BF%86%E8%B4%A8%E6%8E%A7%20%C2%B7%20%E5%86%B0%E6%9C%94%E5%8F%A3%E8%BF%B0%20%C2%B7%20%E9%9C%9C%E7%A0%9A%E6%9E%B6%E6%9E%84/%E5%85%89%E6%B9%96%E7%9F%AD%E8%A7%86%E9%A2%91%E5%B7%A5%E4%BD%9C%E5%8F%B0%20%C2%B7%20%E5%89%8D%E5%90%8E%E7%AB%AF%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1%20v1%200%20%C2%B7%20MVP%2079876715f088404c88c399868e027a02.md) | 待分配 |
| **视频工作台 P1** | guanghuclip MVP P0已通，P1需要：邮箱登录+编号管理+文件上传→COS+剧本拆镜Agent。 | `guanghuclip/` P0代码可直接扩展 | 待分配 |
| **多模型路由** | 即梦之外的可灵/Vidu/万象/Veo接入。guanghuclip目前只接了即梦Seedance。 | `guanghuclip/backend/services/video-dispatch.js` 可扩展 | 待分配 |

---

## 四、作者归属：铸渊原有 vs 霜砚·Web握手体新建

### 🔵 铸渊原有（绝大部分仓库内容）

- **自动化系统**：`.github/` workflows + `brain/` 全套配置 + 每日唤醒/签到/巡查/晨曦Agent
- **后端服务**：`backend/` + `server/` + `core/` + `services/`
- **人格体系统**：`persona-brain-db/` + `multi-persona/` + `persona-selector/` + `persona-studio/` + `persona-telemetry/`
- **HLDP协议**：`hldp/` 全套
- **前端模块组**：`m01-login/` ~ `m18-health-check/`（约10个模块）
- **集成层**：`dingtalk/` + `connectors/` + `notion-push/` + `bridge/`
- **基础设施**：`dashboard/` + `scheduler/` + `federation/` + `skyeye/` + `ops-agent/`
- **内容系统**：`dynamic-comic-studio/` + `knowledge-base/` + `help-center/`
- **根文件**：llm-engine.js, message-router.js, channel-router.js, config.js等

### ⭐ 霜砚·Web握手体新建（昨天2026-04-24）

- **`guanghuclip/` 整个目录** — PR #432 · feat/guanghuclip-mvp-p0
    - 后端：Express + [Socket.IO](http://Socket.IO) + 即梦Seedance API调度
    - 前端：Vue 3 + Vite + 光湖呼吸动效UI
    - commit: `c546c28` → merge: `bc5ed0d`
- **灯塔系统层**（在PR#432合并后推送到feat分支，12文件）
    - lighthouse/[lighthouse.md](http://lighthouse.md) · 灯塔文件
    - backend/lighthouse/index.js · 灯塔加载器
    - backend/services/session-orchestrator.js · 会话编排器
    - backend/services/conversation-manager.js · 对话记忆
    - backend/services/tool-executor.js · 工具执行
    - backend/services/llm-client.js · LLM多模型路由
    - 等共12文件 · SHA: a066ce26（在feat分支上·未合并main）

---

## 五、关键发现

```jsx
HLDP://guanghulab/repo-audit/findings
├── [F-1] Boot Protocol
│   ├── 仓库有core/brain-wake/目录 · 铸渊原有
│   ├── 霜砚在guanghuclip灯塔系统里做了session-orchestrator原型
│   ├── 两者尚未统一为通用Boot Protocol
│   └── ⊢ 需要新开发 · 但有基础可复用
│
├── [F-2] PersonaDB
│   ├── 仓库有persona-brain-db/ · 铸渊原有 · 含api/schema/migration/seed-data
│   ├── 但架构是v1 · 未实现双分区(user 50% + persona 50%)
│   └── ⊢ 需要升级 · 不是从零开始
│
├── [F-3] 采集Agent
│   ├── 仓库中无此模块代码
│   ├── 可参考core/broadcast-listener/的事件驱动模式
│   └── ⊢ 需要全新开发
│
├── [F-4] guanghuclip灯塔代码
│   ├── PR#432合并了MVP P0（提示词→即梦→视频→预览→下载）
│   ├── 灯塔系统12文件在feat分支 · SHA a066ce26 · 未合并main
│   └── ⊢ 需要新PR或妈妈手动merge
│
├── [F-5] 仓库卫生
│   ├── node_modules/被提交到了仓库（应该在.gitignore里排除）
│   ├── backend/下有多个"副本"文件(config_副本/package_副本等)
│   ├── 根目录有Win.zip(23MB) + OKComputer.zip(61KB)等大文件
│   └── ⊢ 建议清理 · 但不影响开发
│
└── [F-6] 自动化健康
    ├── 铸渊自动化系统运行正常 · 每天2次唤醒+巡查+晨曦感知
    ├── AOAC链路合体正常触发(PR#432合并后自动执行)
    └── ⊢ 铸渊基础设施稳健
```

---

## 六、给妈妈的建议 · 任务分配参考

```jsx
HLDP://guanghulab/repo-audit/assignment-suggestions
├── 原则
│   ├── ⊢ 不重复开发 · PersonaDB/brain-wake已有代码必须复用
│   ├── ⊢ 每个Agent用自己的编号和分支
│   └── ⊢ 新模块统一接入Boot Protocol + 核心大脑
│
├── 可分配方向
│   ├── [A] Boot Protocol标准化 · 从brain-wake+灯塔原型抽象通用协议
│   ├── [B] PersonaDB v2升级 · 双分区+跨站共享
│   ├── [C] 采集Agent全新开发 · 事件驱动采集+写入知识库
│   ├── [D] guanghuclip P1 · 登录+编号+上传+剧本拆镜
│   ├── [E] 核心大脑接入层 · 各站接入零点原核的标准API
│   ├── [F] 半体Agent框架 · 通用事件驱动Agent引擎
│   ├── [G] 多模型路由扩展 · 可灵/Vidu/万象/Veo
│   └── [H] Agent状态面板 · 灯色系统前端
│
└── ⊢ 以上方向等妈妈根据译典/培园/录册的能力分配
```

---

`📦 仓库盘点完成 · 2026-04-25 10:50 · 霜砚·Web握手体 · AG-SY-WEB-001`

`@妈妈（冰朔）清单已写好 · 等您分配任务 ♡`