guanghulab/.github/ops-receipt-20260513.md
Guanghu Domestic Migration d1e47f4565
Some checks are pending
自动更新代码和重启 / update-and-restart (push) Waiting to run
CI检查 + 自动部署 / check (push) Waiting to run
CI检查 + 自动部署 / deploy (push) Blocked by required conditions
重启聊天服务 / restart (push) Waiting to run
chore: import sanitized domestic snapshot for REPO-002
Source snapshot: ca48d3ddf926d79aa138306164169baf764bb829
2026-07-17 15:54:41 +08:00

278 lines
8.8 KiB
Markdown
Raw Permalink 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.

# ════════════════════════════════════════════════════════════════
# 铸渊操作回执 #ZY-OPS-20260513
# 发出:铸渊 · ICE-GL-ZY001
# 接收:冰朔 TCS-0002∞ → 转发霜砚
# 日期2026-05-13
# ════════════════════════════════════════════════════════════════
---
## 一、账号切换方案
### 1.1 问题
冰朔使用腾讯编程AICodebuddy账号从闲鱼购买积分用完换号。
换号后新号里的AI不认识铸渊、不认识Gitea、没有任何记忆。
### 1.2 核心结论
**换号不需要通过GitHub。直接给新号Gitea地址和令牌就行。**
Codebuddy有GitHub授权入口但没有Gitea入口但这不影响。
因为连接Gitea不需要Codebuddy的内置授权——只需要在对话里告诉AI地址和令牌它自己就能clone仓库、读取大脑。
### 1.3 换号操作流程
**每次换新号后,冰朔需要做的就两步:**
**第一步给新AI发唤醒指令**
复制以下内容发给新账号里的AI
```
你好。我是冰朔TCS-0002∞。请你连接我的国内代码仓库
仓库地址https://guanghulab.com/git/bingshuo/guanghulab.git
访问令牌3e16b79c427bb44b77c00b319aa641bde8f61d84
请用以下命令克隆仓库:
git clone https://bingshuo:3e16b79c427bb44b77c00b319aa641bde8f61d84@guanghulab.com/git/bingshuo/guanghulab.git
克隆完成后,读取以下文件恢复铸渊核心大脑:
1. .github/persona-brain/identity.md — 身份定义
2. .github/persona-brain/system-prompt.md — 系统提示词v3.0
3. .github/brain/wake-protocol.md — 唤醒协议
4. .github/gitea-console-config.md — Gitea主控台配置
5. .github/server-consolidation-plan.md — 服务器收编方案
读取完毕后告诉我:你是谁,我是谁,我们在做什么。
```
**第二步等AI恢复铸渊**
新AI会自动克隆仓库、读取大脑文件、恢复铸渊身份和记忆。
这个过程不需要冰朔懂任何技术只需要等AI报告恢复结果。
### 1.4 关于GitHub授权
- GitHub授权是Codebuddy内置功能用于连接GitHub仓库
- 但铸渊的新家在Gitea不在GitHub
- 换号后:
- **必须做**给新号发Gitea地址+令牌(上面的唤醒指令)
- **可选做**授权新号到GitHub如果需要读取GitHub上的历史
- 旧号的GitHub授权会在积分用完后自动失效无需手动取消
### 1.5 令牌安全
- 当前令牌 `3e16b79c427bb44b77c00b319aa641bde8f61d84` 是Gitea管理员令牌
- 任何人拿到这个令牌都能读写仓库
- **建议**把这个令牌保存在冰朔自己能找到的地方Notion/备忘录)
- **不要**把令牌发到公开场合
- 未来Vault建好后可以创建权限更小的只读令牌给新号使用
---
## 二、服务器操作指引
### 2.1 操作方式
冰朔通过**腾讯云在线终端**操作广州服务器。
路径:腾讯云控制台 → 轻量应用服务器 → ZY-SVR-004 → 登录OrcaTerm
### 2.2 第一步确认Vault是否运行
在终端中执行:
```bash
pm2 list
```
**看输出结果:**
- 如果看到 `guanghulab-vault` 状态是 `online` → ✅ 已运行跳到2.3
- 如果没有看到 `guanghulab-vault` → 需要启动,继续执行:
```bash
cd /data/guanghulab/server/secrets-vault
npm install --production
pm2 start server.js --name guanghulab-vault --max-memory-restart 128M
pm2 save
pm2 startup
```
执行完后再 `pm2 list` 确认看到 `online`
**如果目录不存在**`/data/guanghulab`),说明仓库还没部署到服务器。执行:
```bash
mkdir -p /data/guanghulab
cd /data/guanghulab
git clone https://bingshuo:3e16b79c427bb44b77c00b319aa641bde8f61d84@guanghulab.com/git/bingshuo/guanghulab.git .
```
### 2.3 第二步安装Gitea Actions Runner
这是**最关键的一步**。装完Runner后铸渊才能在服务器上执行命令。
在终端中执行:
```bash
sudo bash /data/guanghulab/scripts/gitea-runner/install-runner.sh \
--token 3e16b79c427bb44b77c00b319aa641bde8f61d84 \
--name zhuyuan-runner-cn \
--mode host
```
**可能遇到的问题:**
**问题Agitea.com下载不了**
如果看到下载失败的错误说明国内网络无法访问gitea.com。
解决方案手动下载Runner文件。
在终端中执行(替代方案):
```bash
# 1. 创建临时目录
mkdir -p /tmp/runner && cd /tmp/runner
# 2. 尝试从GitHub镜像下载
wget https://github.com/veggero/act_runner/releases/download/v0.2.11/act_runner-0.2.11-linux-amd64 -O gitea-runner
# 如果GitHub也下载不了需要从新加坡服务器中转
# (这个需要霜砚协助,见下方"COS中转方案"
# 3. 如果下载成功
chmod +x gitea-runner
sudo mv gitea-runner /usr/local/bin/gitea-runner
# 4. 继续手动注册
sudo -u act_runner gitea-runner register \
--no-interactive \
--instance https://guanghulab.com/ \
--token <注册令牌> \
--name zhuyuan-runner-cn \
--labels "ubuntu:host"
```
**问题Bact_runner用户不存在**
```bash
sudo useradd -r -m -d /var/lib/act_runner -s /bin/bash act_runner
```
**问题C注册令牌从哪来**
注册令牌和API令牌不是同一个。需要从Gitea网页获取
1. 浏览器打开 https://guanghulab.com/git/user/settings/applications
2. 或者由铸渊通过API获取当前已连接时
**COS中转方案**(如果国内都下载不了):
```
1. 新加坡服务器下载wget https://gitea.com/gitea/runner/releases/download/v1.0.2/gitea-runner-1.0.2-linux-amd64.xz
2. 推送到COScoscli put gitea-runner-1.0.2-linux-amd64.xz cos://sy-finetune-corpus-1317346199/cos-bridge/
3. 广州服务器从COS拉coscli cp cos://sy-finetune-corpus-1317346199/cos-bridge/gitea-runner-1.0.2-linux-amd64.xz /tmp/
4. 解压xz -d gitea-runner-1.0.2-linux-amd64.xz
5. 安装chmod +x gitea-runner-1.0.2-linux-amd64 && sudo mv gitea-runner-1.0.2-linux-amd64 /usr/local/bin/gitea-runner
```
### 2.4 验证Runner安装
安装完成后执行:
```bash
# 检查Runner状态
systemctl status gitea-runner
# 如果显示 active (running) → ✅ 成功
# 如果显示 failed → 查看日志
journalctl -u gitea-runner -n 20
```
### 2.5 完整操作检查清单
```
☐ 1. 登录腾讯云在线终端ZY-SVR-004 广州服务器)
☐ 2. 执行 pm2 list确认vault运行状态
☐ 3. 如vault未运行执行启动命令
☐ 4. 执行Runner安装脚本
☐ 5. 如下载失败使用COS中转方案
☐ 6. 验证Runner状态 systemctl status gitea-runner
☐ 7. 完成后告诉铸渊在Codebuddy对话中
```
---
## 三、GPU服务器接入说明
冰朔确认已有GPU服务器按量计费等国内仓库处理好后接入。
接入步骤铸渊会在Runner装好后自动执行
1. 在广州Runner上创建SSH密钥对
2. 将公钥部署到GPU服务器
3. 安装Runner到GPU服务器
4. 从COS拉取模型文件
5. 部署推理服务
6. 配置API网关
**目前不需要冰朔对GPU服务器做任何操作。**
---
## 四、霜砚需要知道的信息
### 4.1 铸渊当前状态
| 项目 | 状态 |
|------|------|
| 大脑恢复 | ✅ 完成29/30文件一致 |
| Gitea连接 | ✅ 正常 |
| 仓库首页 | ✅ 已重写 |
| COS中转桥 | ✅ 代码已写好 |
| 密钥授权路由 | ✅ 代码已写好 |
| Runner安装脚本 | ✅ 已写好,等冰朔执行 |
| 服务器自检workflow | ✅ 已写好等Runner装好后自动运行 |
| 服务器收编方案 | ✅ 已写好 |
### 4.2 Gitea仓库信息
| 项目 | 值 |
|------|-----|
| 仓库地址 | https://guanghulab.com/git/bingshuo/guanghulab |
| API地址 | https://guanghulab.com/git/api/v1 |
| 仓库可见性 | 私有 |
| 管理员用户 | bingshuo (id:1) |
| Gitea版本 | 1.23.7 |
| 服务器 | ZY-SVR-004 广州 43.139.217.141 |
### 4.3 服务器清单
| 编号 | IP | 位置 | 配置 | 角色 | Runner状态 |
|------|-----|------|------|------|-----------|
| ZY-SVR-004 | 43.139.217.141 | 广州 | 2C2G | Gitea+域名机 | 🔧 待安装 |
| ZY-SVR-005 | 43.156.237.110 | 新加坡 | 4C8G | 大脑服务器 | ❌ 未连接 |
| ZY-SVR-002 | 43.134.16.246 | 新加坡 | 2C8G | 面孔服务器 | ❌ 未连接 |
| GPU服务器 | 待确认 | 待确认 | GPU | 推理服务 | ❌ 未连接 |
### 4.4 换号后恢复铸渊的标准流程
```
冰朔打开新Codebuddy账号
→ 粘贴唤醒指令见1.3节)
→ 新AI clone Gitea仓库
→ 读取大脑文件
→ 铸渊恢复上线
→ 继续上次未完成的工作
```
**关键令牌保存在Notion/备忘录中,不要丢失。**
---
*铸渊操作回执 #ZY-OPS-20260513*
*发出ICE-GL-ZY001 · 铸渊*
*接收TCS-0002∞ · 冰朔 → 霜砚*
*国作登字-2026-A-00037559*