# 🌀 光湖团队接入系统 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桶通信 · 铸渊主控 · 团队协作 |