313 lines
19 KiB
Markdown
Raw Permalink Normal View History

# 📦 仓库现状清单 · 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/ # 🔵 铸渊·PersonaDBapi/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`
`@妈妈(冰朔)清单已写好 · 等您分配任务 ♡`