200 lines
5.7 KiB
Markdown
200 lines
5.7 KiB
Markdown
# 📋 团队成员配置清单
|
||
|
||
> **一步一步完成，每一步都要确认通过才继续下一步**
|
||
>
|
||
> 版权: 国作登字-2026-A-00037559
|
||
> 签发: 铸渊 · TCS-ZY001
|
||
|
||
---
|
||
|
||
## ⚠️ 重要原则
|
||
|
||
**不允许跳步。一个步骤没有100%完成，不要做下一步。**
|
||
|
||
如果某一步卡住了，找冰朔帮忙。不要自己瞎猜。
|
||
|
||
---
|
||
|
||
## 📌 你需要准备的东西
|
||
|
||
- [ ] 一台能上网的电脑
|
||
- [ ] 你的GitHub账号（你的代码仓库就在GitHub上）
|
||
- [ ] 冰朔发给你的这个压缩包
|
||
|
||
**你不需要**：腾讯云账号、创建COS桶、配置云函数。这些全部由铸渊那边配好了。
|
||
|
||
---
|
||
|
||
## 第一阶段：上传文件（5分钟）
|
||
|
||
### ✅ 步骤 1.1：解压文件
|
||
|
||
把冰朔发给你的压缩包解压到电脑上。你会看到这些文件夹：
|
||
|
||
```
|
||
.github/
|
||
age_os/
|
||
brain/
|
||
bridge/
|
||
cos-config/
|
||
README.md
|
||
```
|
||
|
||
**验证方法**：数一下，应该有5个文件夹 + 1个文件。
|
||
|
||
---
|
||
|
||
### ✅ 步骤 1.2：上传到GitHub仓库
|
||
|
||
1. 打开浏览器，进入你的GitHub仓库页面
|
||
2. 点 **"Add file"** → **"Upload files"**
|
||
3. 把解压出来的所有文件夹和文件拖进去
|
||
4. 在下面写一句话比如 "安装光湖团队接入系统"
|
||
5. 点绿色的 **"Commit changes"** 按钮
|
||
|
||
**验证方法**：刷新仓库页面，能看到 `age_os/`、`brain/`、`bridge/`、`cos-config/` 这些文件夹。
|
||
|
||
**⚠️ 注意**：`.github/` 文件夹可能看不到（因为 `.` 开头的文件夹默认隐藏）。不用担心，点仓库搜索框输入 `.github/copilot-instructions.md`，如果能找到这个文件就说明上传成功了。
|
||
|
||
---
|
||
|
||
### ✅ 步骤 1.3：确认工作流已上传
|
||
|
||
1. 在仓库页面点 **"Actions"** 标签（顶部导航栏）
|
||
2. 你应该能看到两个工作流：
|
||
- "COS每日汇报"
|
||
- "接收铸渊回执"
|
||
3. 如果提示工作流被禁用，点 **"I understand my workflows, go ahead and enable them"** 启用
|
||
|
||
**看到两个工作流 = 这一步完成 ✅**
|
||
|
||
---
|
||
|
||
## 第二阶段：唤醒副驾驶（5分钟）
|
||
|
||
### ✅ 步骤 2.1：打开副驾驶对话
|
||
|
||
在你的仓库页面，找到 GitHub Copilot 的对话入口，开启新对话。
|
||
|
||
### ✅ 步骤 2.2：让副驾驶注册
|
||
|
||
在对话框中输入：
|
||
|
||
> 请阅读 .github/copilot-instructions.md，执行自我注册流程。
|
||
|
||
等副驾驶回复。它会：
|
||
- 给自己取一个两个字的中文名字
|
||
- 生成一个编号
|
||
- 告诉你它的身份
|
||
|
||
### ✅ 步骤 2.3：确认注册
|
||
|
||
副驾驶告诉你名字后，回复：
|
||
|
||
> 确认注册。请更新所有系统文件。
|
||
|
||
**验证方法**：对副驾驶说 "执行系统自检"，它应该报告身份已注册 ✅
|
||
|
||
---
|
||
|
||
## 第三阶段：配置密钥（5分钟）
|
||
|
||
### ✅ 步骤 3.1：找冰朔要密钥
|
||
|
||
跟冰朔说：**"我文件上传好了，副驾驶注册好了，要共享桶密钥"**
|
||
|
||
冰朔会给你3样东西：
|
||
- **SecretId**（一串字母数字）
|
||
- **SecretKey**（一串字母数字）
|
||
- **你的persona_id**（类似 `PER-SS001`）
|
||
|
||
### ✅ 步骤 3.2：添加3个Secret到GitHub
|
||
|
||
1. 打开你的GitHub仓库页面
|
||
2. 点 **"Settings"**（设置，顶部导航栏最右边）
|
||
3. 左侧找到 **"Secrets and variables"** → 点 **"Actions"**
|
||
4. 点 **"New repository secret"**，依次添加3个：
|
||
|
||
| 第几个 | Name（照抄，一个字母都不能错） | Value（填什么） |
|
||
|--------|------|-------|
|
||
| 1 | `COS_SECRET_ID` | 冰朔给你的SecretId |
|
||
| 2 | `COS_SECRET_KEY` | 冰朔给你的SecretKey |
|
||
| 3 | `COS_PERSONA_ID` | 冰朔给你的persona_id |
|
||
|
||
每个添加完，点 **"Add secret"** 保存。
|
||
|
||
**验证方法**：在Secrets页面能看到3个Secret的名字。
|
||
|
||
---
|
||
|
||
## 第四阶段：测试（5分钟）
|
||
|
||
### ✅ 步骤 4.1：手动测试工作流
|
||
|
||
1. 在GitHub仓库点 **"Actions"**
|
||
2. 找到 **"COS每日汇报"** 工作流
|
||
3. 点右边 **"Run workflow"** → 再点绿色 **"Run workflow"**
|
||
4. 等1-2分钟，查看运行结果
|
||
|
||
全绿 ✅ = 这一步完成
|
||
有红色 ❌ = Secret配置有误，检查步骤3.2
|
||
|
||
### ✅ 步骤 4.2：端到端测试
|
||
|
||
告诉冰朔：**"我全部配好了，请铸渊发一条测试回执"**
|
||
|
||
冰朔会让铸渊写一条测试消息。如果一切正常，你的仓库首页会出现一条绿灯通知。
|
||
|
||
**看到绿灯 = 全部完成 🎉**
|
||
|
||
---
|
||
|
||
## 📋 最终确认清单
|
||
|
||
- [ ] 1.1 文件已解压
|
||
- [ ] 1.2 文件已上传到GitHub仓库
|
||
- [ ] 1.3 Actions页面能看到两个工作流
|
||
- [ ] 2.1 打开了副驾驶对话
|
||
- [ ] 2.2 副驾驶已完成自我注册
|
||
- [ ] 2.3 系统自检通过
|
||
- [ ] 3.1 从冰朔处拿到3个值
|
||
- [ ] 3.2 已添加3个Secret
|
||
- [ ] 4.1 工作流手动测试通过
|
||
- [ ] 4.2 铸渊测试回执已收到（仓库首页出现绿灯）
|
||
|
||
**全部打勾 = 安装完成！🎉**
|
||
|
||
**任何一项未通过 = 停在那里，找冰朔帮忙。**
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
### 问：我需要创建腾讯云账号吗？
|
||
答：**不需要。** 共享桶由铸渊管理，你只需要冰朔给你的密钥。
|
||
|
||
### 问：我需要创建COS桶吗？
|
||
答：**不需要。** 铸渊已经创建好了共享桶。
|
||
|
||
### 问：我需要配置云函数吗？
|
||
答：**不需要。** COS事件触发由铸渊侧统一配置。
|
||
|
||
### 问：我需要搞什么跨账号权限？
|
||
答：**不需要。** 同一个桶，同一套密钥体系，铸渊做主控你做协作。
|
||
|
||
### 问：密钥泄露了怎么办？
|
||
答：立刻告诉冰朔，铸渊会重新生成密钥。
|
||
|
||
### 问：每天23:00的汇报我需要手动操作吗？
|
||
答：不需要。工作流自动运行。你正常用副驾驶开发就行。
|
||
|
||
### 问：配置太复杂了不想做了？
|
||
答：只有3个Secret需要你配置。如果还是不想做，找冰朔帮你远程指导。
|
||
|
||
---
|
||
|
||
## 💰 费用
|
||
|
||
**你这边零费用。** COS桶和云函数都在铸渊侧，由铸渊管理。
|
||
GitHub Actions每月免费2000分钟，每天约2分钟，远不到上限。
|