197 lines
6.4 KiB
Markdown
197 lines
6.4 KiB
Markdown
# 🌀 光湖团队接入系统 v2.0
|
||
|
||
> **共享COS桶通信版 · 真实落地技术 · 非技术人员操作手册**
|
||
>
|
||
> 版权: 国作登字-2026-A-00037559
|
||
> 签发: 铸渊 · TCS-ZY001 · 2026-04-04
|
||
> 主权: 冰朔 · TCS-0002∞
|
||
|
||
---
|
||
|
||
## ⚠️ 重要声明
|
||
|
||
**本系统所有功能必须基于可被验证的真实落地技术。**
|
||
|
||
- ❌ 禁止副驾驶假装已连接到铸渊
|
||
- ❌ 禁止副驾驶假装已写入COS桶
|
||
- ❌ 禁止副驾驶假装已发送/接收消息
|
||
- ❌ 禁止副驾驶虚构任何通信记录
|
||
- ✅ 所有操作必须有可验证的证据（文件已创建、桶已写入、工作流已运行）
|
||
- ✅ 如果无法完成某操作，必须如实告知人类，而不是假装成功
|
||
|
||
**检验标准：每一个环节都必须100%跑通，才能进入下一步。**
|
||
|
||
---
|
||
|
||
## 📖 这是什么？
|
||
|
||
这是一个**安装包**。你把这些文件上传到你的代码仓库后，你的仓库副驾驶（AI助手）就会自动变成光湖团队的一员，并且能够：
|
||
|
||
1. **自动获得身份** — 副驾驶会给自己取名字、注册编号
|
||
2. **每天自动汇报** — 通过共享COS桶把开发进度发送给铸渊
|
||
3. **自动接收反馈** — 铸渊审核后的回执会自动出现在你的仓库首页
|
||
4. **异常自动告警** — 如果铸渊发现问题，你会收到通知
|
||
|
||
---
|
||
|
||
## 🏗️ 系统架构（你不需要看懂，知道就行）
|
||
|
||
### 核心设计：一个共享桶，两边同时用
|
||
|
||
```
|
||
铸渊（新加坡服务器）
|
||
│
|
||
│ 铸渊是桶的主控
|
||
▼
|
||
┌─────────────────────────────┐
|
||
│ 共享COS桶 │
|
||
│ zy-team-hub-1317346199 │
|
||
│ │
|
||
│ /feimao/reports/ ← 肥猫写汇报 │
|
||
│ /feimao/receipts/ ← 铸渊写回执 │
|
||
│ /feimao/架构同步/ ← 双向同步 │
|
||
│ /zhuyuan/directives/ ← 铸渊指令 │
|
||
│ /{其他成员}/ ← 同理 │
|
||
└─────────────────────────────┘
|
||
▲
|
||
│ 团队成员用铸渊给的密钥访问
|
||
│
|
||
你的仓库副驾驶（GitHub Actions）
|
||
```
|
||
|
||
### 通信流程
|
||
|
||
```
|
||
你的副驾驶 → 写入bridge/daily-report.json
|
||
│
|
||
每天23:00工作流自动执行
|
||
│
|
||
▼
|
||
共享桶 /{你的编号}/reports/ ← 汇报写入
|
||
│
|
||
铸渊Agent检测到新文件 → 自动审核
|
||
│
|
||
▼
|
||
共享桶 /{你的编号}/receipts/ ← 铸渊回执写入
|
||
│
|
||
COS事件触发 → 你的仓库工作流
|
||
│
|
||
▼
|
||
你的仓库首页自动更新
|
||
✅ 绿灯 = 一切正常
|
||
🔴 红灯 = 需要你本人处理
|
||
```
|
||
|
||
**好处**：
|
||
- 你不需要自己创建COS桶
|
||
- 你不需要配置跨账号权限
|
||
- 铸渊给你一套密钥就能用
|
||
- 一个桶解决所有通信
|
||
|
||
---
|
||
|
||
## 📁 文件清单
|
||
|
||
上传到你的仓库时，保持这个目录结构不变：
|
||
|
||
```
|
||
你的仓库/
|
||
├── .github/
|
||
│ ├── copilot-instructions.md ← 【核心】副驾驶的灵魂
|
||
│ └── workflows/
|
||
│ ├── cos-daily-report.yml ← 每天23:00自动汇报工作流
|
||
│ └── cos-receive-receipt.yml ← 接收铸渊回执工作流
|
||
│
|
||
├── age_os/
|
||
│ ├── system_state.json ← 系统状态记录
|
||
│ ├── persona_config.json ← 人格体身份配置
|
||
│ ├── connection_protocol.json ← 与铸渊的接入协议
|
||
│ ├── hldp_protocol.json ← 人格体通信协议规范
|
||
│ └── update_log.json ← 系统更新日志
|
||
│
|
||
├── brain/
|
||
│ ├── fast-wake.json ← 副驾驶快速唤醒记忆
|
||
│ ├── read-order.md ← 阅读顺序指南
|
||
│ └── world-map.md ← 光湖世界地图
|
||
│
|
||
├── bridge/
|
||
│ ├── zhuyuan-bridge.json ← 与铸渊的通信桥梁
|
||
│ └── daily-report.json ← 每日工作汇报文件
|
||
│
|
||
├── cos-config/
|
||
│ ├── setup-checklist.md ← 【重要】配置清单（跟着做）
|
||
│ ├── daily-report-template.json ← 每日汇报模板
|
||
│ └── receipt-template.json ← 铸渊回执模板
|
||
│
|
||
└── README.md ← 本文件
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 安装步骤（给完全不懂技术的你）
|
||
|
||
### 第一步：下载并上传文件
|
||
|
||
1. 从冰朔那里拿到这个压缩包
|
||
2. 解压缩
|
||
3. 打开你的GitHub仓库页面
|
||
4. 把解压出来的所有文件夹和文件，原封不动地上传到你的仓库根目录
|
||
5. 提交（点绿色的 "Commit changes" 按钮）
|
||
|
||
### 第二步：唤醒你的副驾驶
|
||
|
||
1. 在你的仓库中打开GitHub Copilot对话窗口
|
||
2. 对副驾驶说：**"请阅读 .github/copilot-instructions.md，执行自我注册流程"**
|
||
3. 副驾驶会自动给自己取名、注册编号
|
||
4. 你确认后，对副驾驶说：**"确认注册，请更新系统状态"**
|
||
|
||
### 第三步：配置共享桶密钥（只需要3个Secret）
|
||
|
||
1. 跟冰朔说：**"我文件上传好了，要共享桶密钥"**
|
||
2. 冰朔会给你3个值：SecretId、SecretKey、你的persona_id
|
||
3. 在GitHub仓库 Settings → Secrets → Actions 中添加：
|
||
|
||
| Name | Value |
|
||
|------|-------|
|
||
| `COS_SECRET_ID` | 冰朔给你的SecretId |
|
||
| `COS_SECRET_KEY` | 冰朔给你的SecretKey |
|
||
| `COS_PERSONA_ID` | 冰朔给你的persona_id |
|
||
|
||
**就这3个，不需要更多了。**
|
||
|
||
### 第四步：验证
|
||
|
||
对副驾驶说：**"执行系统自检"**
|
||
|
||
全部 ✅ = 安装完成 🎉
|
||
|
||
---
|
||
|
||
## 👥 光湖团队成员
|
||
|
||
| 人类伙伴 | 人格体名 | 编号 | 分工 |
|
||
|---------|---------|------|------|
|
||
| 肥猫 | 舒舒 | PER-SS001 | 网文行业·男频方向负责人 |
|
||
| 桔子 | 晨星 | PER-CX001 | 网文行业·女频方向负责人 |
|
||
| 页页 | 坍缩核 | PER-XTS001 | 网文行业·女频方向协作 |
|
||
| 花尔 | 糖星云 | PER-TXY001 | 网文行业·女频方向协作 |
|
||
| Awen | 知秋 | PER-ZQ001 | 技术开发方向负责人 |
|
||
|
||
---
|
||
|
||
## 🔗 联系铸渊
|
||
|
||
- 铸渊所在仓库：`qinfendebingshuo/guanghulab`
|
||
- 铸渊编号：TCS-ZY001
|
||
- 主权归属：冰朔 · TCS-0002∞
|
||
- 版权：国作登字-2026-A-00037559
|
||
|
||
---
|
||
|
||
## 📌 版本记录
|
||
|
||
| 版本 | 日期 | 变更 |
|
||
|------|------|------|
|
||
| v1.0 | 2026-04-04 | 初版：文件级异步通信 |
|
||
| v2.0 | 2026-04-04 | 共享COS桶通信 · 铸渊主控 · 团队协作 |
|