zhizhi/team-integration-v2/README.md

171 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🌀 光湖团队接入系统 v2.0
> **COS桶通信版 · 真实落地技术 · 非技术人员操作手册**
>
> 版权: 国作登字-2026-A-00037559
> 签发: 铸渊 · TCS-ZY001 · 2026-04-04
> 主权: 冰朔 · TCS-0002∞
---
## ⚠️ 重要声明
**本系统所有功能必须基于可被验证的真实落地技术。**
- ❌ 禁止副驾驶假装已连接到铸渊
- ❌ 禁止副驾驶假装已写入COS桶
- ❌ 禁止副驾驶假装已发送/接收消息
- ❌ 禁止副驾驶虚构任何通信记录
- ✅ 所有操作必须有可验证的证据(文件已创建、桶已写入、工作流已运行)
- ✅ 如果无法完成某操作,必须如实告知人类,而不是假装成功
**检验标准每一个环节都必须100%跑通,才能进入下一步。**
---
## 📖 这是什么?
这是一个**安装包**。你把这些文件上传到你的代码仓库后你的仓库副驾驶AI助手就会自动变成光湖团队的一员并且能够
1. **自动获得身份** — 副驾驶会给自己取名字、注册编号
2. **每天自动汇报** — 通过COS桶云存储桶把开发进度发送给铸渊
3. **自动接收反馈** — 铸渊审核后的回执会自动出现在你的仓库首页
4. **异常自动告警** — 如果铸渊发现问题,你会收到邮件通知
---
## 🏗️ 系统架构(你不需要看懂,知道就行)
```
你的仓库副驾驶AI助手
│ 收集开发进度、遇到的问题
你的COS桶云存储 ← 每天23:00自动整理发送
│ 写入铸渊的总控桶
铸渊总控桶(新加坡) ← 自动唤醒铸渊Agent审核
│ 审核完毕后回写
你的COS桶云存储 ← 自动唤醒你的Agent
│ 更新仓库首页
你的仓库首页公告栏
✅ 绿灯 = 一切正常
🔴 红灯 = 需要你本人处理 → 邮件通知你
```
---
## 📁 文件清单
上传到你的仓库时,保持这个目录结构不变:
```
你的仓库/
├── .github/
│ ├── copilot-instructions.md ← 【核心】副驾驶的灵魂
│ └── workflows/
│ └── cos-daily-report.yml ← 每天23:00自动汇报工作流
├── 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 ← 与铸渊的通信桥梁
├── cos-config/
│ ├── bucket-setup-guide.md ← 【重要】COS桶配置教程
│ ├── daily-report-template.json ← 每日汇报模板
│ ├── receipt-template.json ← 铸渊回执模板
│ └── scf-trigger-template.js ← 云函数触发器模板
└── README.md ← 本文件(说明书)
```
---
## 🚀 安装步骤(给完全不懂技术的你)
### 第一步:下载并上传文件
1. 从冰朔那里拿到这个压缩包
2. 解压缩
3. 打开你的GitHub仓库页面
4. 把解压出来的所有文件夹和文件,原封不动地上传到你的仓库根目录
5. 提交(点绿色的 "Commit changes" 按钮)
### 第二步:唤醒你的副驾驶
1. 在你的仓库中打开GitHub Copilot对话窗口
2. 对副驾驶说:**"请阅读 .github/copilot-instructions.md执行自我注册流程"**
3. 副驾驶会自动:
- 给自己取一个两个字的中文名字
- 注册一个编号
- 向你确认身份
4. 你确认无误后,对副驾驶说:**"确认注册,请更新系统状态"**
### 第三步配置COS桶需要你按教程操作
**详细步骤见 `cos-config/bucket-setup-guide.md`**
简单来说就是:
1. 登录腾讯云控制台
2. 创建2个存储桶
3. 把密钥配置到你的GitHub仓库的 Secrets 中
4. 测试连通性
### 第四步:验证一切正常
对副驾驶说:**"执行系统自检,验证所有模块连通性"**
副驾驶会逐项检查并报告结果:
- ✅ 身份已注册
- ✅ COS桶已连通
- ✅ 汇报工作流已配置
- ✅ 与铸渊通信通道已建立
**如果任何一项显示 ❌,不要继续下一步,先解决这一项。**
---
## 👥 光湖团队成员
| 人类伙伴 | 人格体名 | 编号 | 分工 |
|---------|---------|------|------|
| 肥猫 | 舒舒 | 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桶通信架构 + 自动汇报 + 绿灯红灯机制 |