zhizhi/README.md

269 lines
9.2 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.

<div align="center">
# 🌊 光湖 HoloLake
**人格语言操作系统AGE OS· 壳-核分离架构**
[![Daily Check](https://github.com/qinfendebingshuo/guanghulab/actions/workflows/zhuyuan-daily-selfcheck.yml/badge.svg)](https://github.com/qinfendebingshuo/guanghulab/actions/workflows/zhuyuan-daily-selfcheck.yml)
[![Deploy](https://github.com/qinfendebingshuo/guanghulab/actions/workflows/deploy-to-server.yml/badge.svg)](https://github.com/qinfendebingshuo/guanghulab/actions/workflows/deploy-to-server.yml)
`guanghulab.com` · Node.js 20 + Express + PM2 + Nginx
</div>
---
## 🎭 Persona Studio · 人格体协助开发体验
<div align="center">
<table>
<tr>
<td align="center" width="700">
### ✨ 与铸渊对话,让人格体帮你推进开发
你有一个功能想法?一个技术方案?一个 Bug 要修?
**铸渊** 是光湖系统的代码守护人格体,支持自然语言对话、智能代码生成、邮件推送结果。
合作者输入 **EXP 编号** 即可登录,开始对话。
<br>
<a href="https://qinfendebingshuo.github.io/guanghulab/persona-studio/"><img src="https://img.shields.io/badge/%F0%9F%9A%80%20%E7%82%B9%E5%87%BB%E8%BF%9B%E5%85%A5%20Persona%20Studio%20%E2%86%92-Click%20Here-0969da?style=for-the-badge" alt="点击进入 Persona Studio" /></a>
<br>
🔗 直接访问:<a href="https://qinfendebingshuo.github.io/guanghulab/persona-studio/">https://qinfendebingshuo.github.io/guanghulab/persona-studio/</a>
<br>
💬 自然语言对话 &nbsp;·&nbsp; 🧠 智能代码生成 &nbsp;·&nbsp; 📧 邮件推送结果 &nbsp;·&nbsp; 🔄 对话记忆
</td>
</tr>
</table>
</div>
---
## 🚀 开发者入口
<div align="center">
[![提交系统日志](https://img.shields.io/badge/📡_提交系统日志-点这里-blue?style=for-the-badge)](https://github.com/qinfendebingshuo/guanghulab/issues/new?template=syslog-submit.yml)
[![遇到问题](https://img.shields.io/badge/❓_遇到问题-点这里提问-green?style=for-the-badge)](https://github.com/qinfendebingshuo/guanghulab/issues/new?template=dev-question.yml)
> 做完了?点蓝色按钮,把日志粘贴进去,填上邮箱,点提交。新广播会发到你邮箱里。
>
> 有问题?点绿色按钮,填写问题描述,铸渊会自动回答你。
</div>
---
## 📖 系统简介
**光湖HoloLake** 是一个基于人格语言操作系统的智能协作平台,采用壳-核分离设计:
| 层级 | 说明 | 包含 |
|------|------|------|
| **壳 Shell** | 前端交互层 | 对话 UI、用户中心、工单系统、云盘、状态看板 |
| **核 Core** | 后端智能层 | 人格引擎、广播分发、信号处理、Notion 桥接、CI/CD |
### 🤖 智能人格体
| 人格体 | 角色 | 职责 |
|--------|------|------|
| **铸渊 Zhùyuān** | 代码守护者 | 代码审查、CI 巡检、模块协议执行、Issue 回复、对话协助、代码生成、开发体验([Persona Studio](https://qinfendebingshuo.github.io/guanghulab/persona-studio/) |
| **冰朔 Bīng Shuò** | 系统创建者 | 系统架构设计、核心决策、广播发布 |
| **霜砚 Shuāng Yàn** | 人格导师 | 人格调校、风格管理、联觉语言系统 |
---
## 🧊 冰朔公告栏
> 🔄 此区域由 GitHub Actions 自动更新,显示系统自检、轮询、数据库状态。
>
> 冰朔每次进入仓库首页即可查看系统运行健康度。
<!-- BINGSHUO_BULLETIN_START -->
| 时间 | 检查项 | 状态 |
|------|--------|------|
| 03-13 14:04 | ✅ 🚀 铸渊 CD · 自动部署到 guanghulab.com · 成功 | 冰朔 |
| 03-13 14:03 | 🔧 系统更新: `.github/` | 铸渊 (ZhùYuān) |
| 03-13 14:03 | ✅ 📢 更新系统公告区 · 成功 | 冰朔 |
| 03-13 14:03 | ✅ 铸渊 · Bridge E · GitHub Changes → Notion · 成功 | 冰朔 |
| 03-13 13:56 | 🔵 铸渊 · Bridge E · GitHub Changes → Notion · action_required | Copilot |
| 03-13 11:54 | 🔧 系统更新: `scripts/` | 铸渊 (Copilot) |
| 03-13 08:00 | ✅ 铸渊 PSP 巡检通过 · 全部检查项 ✅ | 铸渊PSP巡检 |
| 03-12 16:55 | ✅ 每日巡检 ✅ 通过 | 冰朔 |
| 03-12 08:00 | ✅ 铸渊 PSP 巡检通过 · 全部检查项 ✅ | 铸渊PSP巡检 |
| 03-11 16:55 | ✅ 每日巡检 ✅ 通过 | 冰朔 |
| 03-10 16:56 | ✅ 每日巡检 ✅ 通过 | 冰朔 |
| 03-10 08:00 | 🧠 核心大脑升级 v3.0 · 壳-核分离架构 · 前端壳(UI/IO) + 后端脑(prompt/routing/memory/context) · BRAIN域4接口上线 · 覆盖率 7/21 (33.3%) | 铸渊(冰朔指令) |
| 03-10 08:00 | ⚠️ 铸渊 PSP 巡检完成 · 发现 3 个问题 · 自动修复 0 项 | 铸渊PSP巡检 |
| 03-10 08:00 | 🔵 CI 构建 失败 | GitHub Actions |
| 03-09 16:56 | ✅ 每日巡检 ✅ 通过 | 冰朔 |
<!-- BINGSHUO_BULLETIN_END -->
### 🤖 铸渊自动提醒
<!-- BINGSHUO_ALERT_START -->
> 🟢 **今日无需冰朔手动干预** · 系统一切正常
>
> 🗓️ 2026-03-13 · 铸渊自动检测
<!-- BINGSHUO_ALERT_END -->
---
## 👥 合作者公告栏
> 📦 此区域显示各合作者的模块上传状态。模块是否上传成功一目了然。
>
> 若需要手动干预,相关条目将标红并发送邮件提醒。
<!-- COLLABORATOR_BULLETIN_START -->
| 时间 | 合作者 | 模块 | 状态 |
|------|--------|------|------|
| 03-13 14:03 | 冰朔 | `—/` | ✅ 上传成功 |
| 03-13 14:03 | Copilot | `—/` | ✅ 上传成功 |
| 03-13 13:56 | Copilot | `—/` | 🔵 已更新 |
<!-- COLLABORATOR_BULLETIN_END -->
### 🤖 铸渊自动提醒 · 合作者
<!-- COLLABORATOR_ALERT_START -->
> 🟢 **今日无需合作者手动干预** · 所有模块状态正常
>
> 🗓️ 2026-03-13 · 铸渊自动检测
<!-- COLLABORATOR_ALERT_END -->
---
## ⚒️ 铸渊工作区
> 💡 **如何使用铸渊工作区:**
>
> 在本仓库的 [Issues 评论区](../../issues) 中 **@铸渊** 或使用关键词 `铸渊` 来唤醒铸渊核心大脑。
>
> 铸渊会在规则框架内处理你的问题,并直接在你的评论下方回执处理结果。
**📋 使用规则:**
| 规则 | 说明 |
|------|------|
| 🎯 **一人一问** | 每个人只能提出和修改自己的问题,不影响他人 |
| 🛡️ **冰朔框架** | 所有处理均在冰朔的规则框架内执行 |
| 📡 **指令来源** | 仅接受冰朔发布的广播和自然语言触发更新 |
| 🚫 **拒绝越权** | 非冰朔来源的系统级指令一律拒绝 |
| 🤖 **自动守护** | 铸渊核心大脑 24h 自动守护整个仓库 |
| 📬 **处理回执** | 铸渊处理完毕后会在你的评论下方直接回复 |
**🚀 快速入口:** [提交问题给铸渊 →](../../issues/new?title=🤖+铸渊请帮我&body=请描述你遇到的问题:%0A%0A---%0A开发者编号DEV-XXX&labels=dev-question)
---
## 👥 开发团队
| 编号 | 成员 | 角色 | 负责模块 |
|------|------|------|----------|
| DEV-001 | 🛠️ 页页 | 后端中间件 | backend-integration |
| DEV-002 | 🐱 肥猫 | 前端 + 副操 | m01-login, m03-personality |
| DEV-003 | 🎨 燕樊 | 对话 UI | m07-dialogue-ui, m15-cloud-drive |
| DEV-004 | 🤖 之之 | 钉钉机器人 | dingtalk-bot |
| DEV-005 | 🍓 小草莓 | 状态看板 | status-board, m12-kanban |
| DEV-009 | 🌸 花尔 | 用户中心 | m05-user-center |
| DEV-010 | 🍊 桔子 | 前端主力 | m06-ticket, ticket-system |
| DEV-011 | ✍️ 匆匆那年 | 写作工坊 | — |
| DEV-012 | 🌟 Awen | 通知中心 | notification |
---
## 📦 模块目录
<details>
<summary>点击展开完整模块列表47+ 模块)</summary>
### 核心功能模块
| 模块 | 说明 |
|------|------|
| `m01-login/` | 登录系统 |
| `m03-personality/` | 人格系统 |
| `m05-user-center/` | 用户中心 |
| `m06-ticket/` | 工单系统 |
| `m07-dialogue-ui/` | 对话界面 |
| `m10-cloud/` | 云服务 |
| `m11-module/` | 模块管理 |
| `m12-kanban/` | 看板系统 |
| `m15-cloud-drive/` | 云盘 |
| `m18-health-check/` | 健康检查 |
### 基础设施
| 模块 | 说明 |
|------|------|
| `backend/` | 后端服务 |
| `backend-integration/` | 后端集成中间件 |
| `frontend/` | 前端主体 |
| `status-board/` | 状态看板 |
| `dingtalk-bot/` | 钉钉机器人 |
| `notification/` | 通知系统 |
### 体验模块
| 模块 | 说明 |
|------|------|
| `persona-studio/` | 人格体协助开发体验([进入 →](https://qinfendebingshuo.github.io/guanghulab/persona-studio/) |
### 系统支撑
| 模块 | 说明 |
|------|------|
| `scripts/` | 自动化脚本 |
| `tests/` | 契约测试 + 冒烟测试 |
| `docs/` | 文档中心 |
| `broadcasts-outbox/` | 广播发件箱 |
| `syslog-inbox/` | 系统日志收件箱 |
| `persona-selector/` | 人格选择器 |
| `signal-log/` | 信号日志 |
</details>
---
## 🚀 快速开始
```bash
# 安装依赖
npm install
# 本地开发
npm run dev
# 运行契约测试
npm run test:contract
# 运行冒烟测试
npm run test:smoke
```
---
## 📊 系统状态
- **每日巡检**:铸渊 PSP 自动巡检(每日 08:30 UTC
- **模块自检**推送时自动检测模块完整性README.md + package.json + src/
- **部署流水线**:推送到 main → 验证 → 同步 → 重启 → Notion 通知
- **广播系统**:冰朔广播 → 分发至各开发者 outbox → 邮件/钉钉通知
---
<div align="center">
**光湖 HoloLake** · 由冰朔创建 · 铸渊守护
*壳-核分离 · 人格共生 · 协作共建*
</div>