# 光湖系统 · 模块代码总仓库

---

## 🚀 怎么用铸渊聊天室？

**一句话：点下面这个链接就能打开，直接聊天。**

### 👉 [点这里打开铸渊聊天室](https://qinfendebingshuo.github.io/guanghulab/docs/index.html)

```
https://qinfendebingshuo.github.io/guanghulab/docs/index.html
```

> 把这个链接发给任何人，他们打开就能用，不需要安装任何东西。

---

## 🎯 不同角色怎么用

### ❄️ 冰朔（你）

1. **打开链接** → https://qinfendebingshuo.github.io/guanghulab/docs/index.html
2. **选身份** → 下拉菜单选「❄️ 冰朔（语言架构师·创始人）」
3. **填 API 密钥** → 输入你的云雾/OpenAI/DeepSeek API Key
4. **点「开始对话」** → 铸渊自动唤醒，汇报大脑状态
5. 说「**我是冰朔**」即可触发完整唤醒序列

---

### 🦁 肥猫（光湖团队总控 · DEV-002）

1. **打开链接** → https://qinfendebingshuo.github.io/guanghulab/docs/index.html
2. **选身份** → 下拉菜单选「🦁 肥猫（光湖团队总控·DEV-002）」
3. **填 API 密钥** → 输入自己的 API Key（或点「演示模式」也能看进度面板）
4. **点「开始对话」** → 铸渊自动打开**总控指挥台**，显示全员进度
5. 点顶部 **🦁 按钮** → 查看所有开发者详细状态、谁在阻塞、服务器信息
6. 直接聊天提问，例如：
   - 「查看所有开发者当前进度」
   - 「谁现在遇到阻塞？」
   - 「下一步推进计划是什么？」

---

### 🍊 桔子（光湖主控 · DEV-010）

1. **打开链接** → https://qinfendebingshuo.github.io/guanghulab/docs/index.html
2. **选身份** → 下拉菜单选「🍊 桔子（光湖主控·DEV-010）」
3. **填 API 密钥** → 输入自己的 API Key
4. **点「开始对话」** → 铸渊显示你当前模块进度，并开放指挥台

---

### 👩‍💻 其他开发者（页页 / 燕樊 / 小草莓 / 花尔 等）

1. **打开链接** → https://qinfendebingshuo.github.io/guanghulab/docs/index.html
2. **选身份** → 下拉菜单选自己的名字
3. **填 API 密钥** → 填自己的 Key（没有的话点「演示模式」）
4. **点「开始对话」** → 铸渊显示你的当前任务状态，可以问问题

---

## 🔑 API 密钥从哪里来？

| 提供商 | 申请地址 | 备注 |
|--------|---------|------|
| **云雾 API** | 团队统一分配 | 推荐，团队共用 |
| DeepSeek | https://platform.deepseek.com | 便宜好用 |
| 智谱 GLM | https://open.bigmodel.cn | 有免费额度 |
| Kimi | https://platform.moonshot.cn | 长文本好 |
| OpenAI | https://platform.openai.com | 最强但价格较高 |

> 💡 **没有 API Key？** 点「演示模式」也能查看团队进度面板（🦁 指挥台），只是不能真实 AI 对话。

---

## 📱 怎么分享给别人？

**最简单：直接把链接发过去！**

```
铸渊聊天室入口 👇
https://qinfendebingshuo.github.io/guanghulab/docs/index.html

打开后选择你的身份，填入 API Key 就能和铸渊说话了。
```

**想离线用？** 在聊天室右上角点 **⬇️ 下载** → 下载一个 HTML 文件 → 发给对方 → 双击打开就能用（不需要网络，只需要 API Key）。

---

## 💬 常见问题

**Q: 打开是空白页面怎么办？**  
A: 等待 GitHub Pages 部署完成（通常 1-2 分钟），刷新页面。

**Q: API Key 安全吗？会不会被偷？**  
A: 放心，Key 只存在你自己浏览器的 localStorage 里，不会上传到任何服务器。

**Q: 以前的对话记录怎么找？**  
A: 目前对话记录在浏览器里，刷新后需要重新开始。大脑记忆文件在 `.github/brain/` 里永久保存。

**Q: 铸渊的大脑会记住我说的话吗？**  
A: 每次对话内的上下文会记住，跨对话的重要信息需要说「记住这个」，铸渊会建议更新到 `.github/brain/` 文件里。

---

## 🌀 铸渊聊天室功能一览

| 功能 | 说明 |
|------|------|
| 💬 对话模式 | 默认，聊技术问题、聊进度、聊架构 |
| 🔨 构建模式 | 自动检测，聊到代码/接口时切换，给出完整可执行代码 |
| 📋 审查模式 | 自动检测，聊到"检查/审查"时切换，审查代码质量 |
| 🧠 大脑模式 | 说"记住这个"时切换，整理重要信息到大脑文件 |
| 🦁 指挥台 | 总控/主控专属，查看全员进度、阻塞、服务器信息 |
| 📊 大脑状态 | 查看 HLI 接口覆盖率、近期事件 |
| ⬇️ 下载 | 下载单文件版，可离线使用 |

---

## 📋 仓库结构与模块分工

每个模块一个文件夹，开发者将代码上传到对应文件夹中。

| 文件夹 | 模块 | 负责人 |
|--------|------|--------|
| m01-login | M01 用户登录界面 | 肥猫 |
| m03-personality | M03 人格系统 | 肥猫 |
| m05-user-center | M05 用户中心界面 | 花尔 |
| m06-ticket | M06 工单管理界面 | 桔子 |
| m07-dialogue-ui | M07 对话UI | 燕樊 |
| m10-cloud | M10 云盘系统 | 燕樊 |
| m11-module | M11 工单管理模块 | 桔子 |
| m12-kanban | M12 状态看板 | 小草莓 |
| dingtalk-bot | 钉钉机器人 | 之之 |
| backend-integration | 后端集成中间层 | 页页 |

## 上传规范
每个模块文件夹必须包含以下文件：
- README.md（模块说明）
- package.json（依赖声明）
- src/（源代码目录）
- SYSLOG.md（开发回执日志）

## 自动检查
每次 push 会自动检查模块结构是否符合规范，不通过会标红提醒。

