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桶通信 · 铸渊主控 · 团队协作 |
|