149 lines
5.4 KiB
Markdown
149 lines
5.4 KiB
Markdown
# 光湖系统 · 模块代码总仓库
|
||
|
||
---
|
||
|
||
## 🚀 怎么用铸渊聊天室？
|
||
|
||
**一句话：点下面这个链接就能打开，直接聊天。**
|
||
|
||
### 👉 [点这里打开铸渊聊天室](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 会自动检查模块结构是否符合规范，不通过会标红提醒。
|
||
|