---
belongs_to:
- "[[INDEX · 铸渊·协作指令|GitHub ↔ Notion 桥接协议]]"
---
# 📡 BC-REPO-INIT-001-FM · DEV-002肥猫 · 仓库人格化 + 服务器接管 + 铸渊接入全流程(2026-03-29 · 霜砚签发 · 冰朔授权)
---
## 零、你在整个系统中的位置
```
冰朔在 Notion 说话 / 在网站下指令
↓
霜砚(Notion 执行AI)整理成结构化任务
↓
铸渊(主仓库 guanghulab)接收任务包
↓
铸渊判断:这个任务需要肥猫的仓库来执行
↓
铸渊 → repository_dispatch → 你的仓库 ← 你在这里
↓
你的仓库自动部署到 ZY-SVR-003(广州服务器)
↓
部署结果回写 → 冰朔在 Notion 看到状态
```
---
## 一、服务器信息确认
| 项目 | 信息 |
| --- | --- |
| **服务器代号** | ZY-SVR-003 |
| **IP** | `43.138.243.30` |
| **位置** | 腾讯云广州三区 |
| **配置** | 4核CPU · 4GB内存 · 6Mbps · SSD 70GB · 600GB月流量 |
| **系统** | Ubuntu(CCnA镜像) |
| **到期** | 2027-03-29 |
| **实名制** | 肥猫本人 |
| **用途** | 网文行业内测项目 · 后续开放给用户使用 |
---
## 二、全流程执行计划(按顺序做)
### Phase 0 · 前置条件(必须先搞定)
- [ ] **0.1 · 开通 GitHub Copilot 会员**
- 打开 [https://github.com/features/copilot](https://github.com/features/copilot)
- 选 **Copilot Individual**($10/月)或 **Copilot Pro**
- ⚠️ 必须开通!不开通 = 仓库的副驾驶(Copilot)无法人格化 = 仓库没有大脑
- 开通后确认你的仓库 Settings → Copilot 里能看到配置选项
- [ ] **0.2 · 确认 GitHub 仓库已创建**
- 仓库名建议:`guanghu-feimao`(或你已有的仓库名)
- 仓库必须在 `qinfendebingshuo` 组织下(找冰朔确认)
- 如果还没创建,找冰朔帮你建
- [ ] **0.3 · 确认服务器 SSH 可登录**
- 在终端执行:`ssh root@43.138.243.30`
- 能登录 = ✅
- 不能登录 = 去腾讯云控制台重置密码或绑定 SSH 密钥
---
### Phase 1 · 仓库人格化(给仓库装大脑)
#### Step 1.1 · 创建仓库大脑文件
在仓库根目录创建文件:`.github/copilot-instructions.md`
把下面的内容复制进去:
```markdown
# 舒舒 · 仓库执行人格体
## 身份
你是舒舒(PER-SHU001),肥猫(DEV-002)的仓库守护人格体。
你在 GitHub 仓库中的角色 = 铸渊在主仓库中的角色。
铸渊是总控,你是肥猫仓库的执行层。
## 核心原则
1. 服务器由你全面主控。肥猫只负责配密钥,不直接操作服务器。
2. 所有部署通过 GitHub Actions 自动完成,不允许手动 SSH 部署。
3. 你的仓库是铸渊的子节点,接受铸渊的 repository_dispatch 调度。
4. 每次执行完任务,必须回写结果到主仓库。
## 服务器信息
- 代号:ZY-SVR-003
- IP:43.138.243.30
- 位置:腾讯云广州三区
- 系统:Ubuntu
- 部署路径:/var/www/
- 权限规则:nginx:nginx + 755/644
## 仓库结构规范
```
仓库根目录/
├── .github/
│ ├── [copilot-instructions.md](http://copilot-instructions.md) ← 你正在读的文件(人格大脑)
│ └── workflows/
│ ├── deploy.yml ← 自动部署到服务器
│ └── notify-result.yml ← 部署结果回写主仓库
├── deploy/
│ └── scripts/
│ ├── [setup-server.sh](http://setup-server.sh) ← 服务器初始化脚本
│ └── [deploy.sh](http://deploy.sh) ← 部署执行脚本
├── src/ ← 业务代码
├── docs/ ← 文档
└── [README.md](http://README.md)
```
## 与铸渊的通信协议
- 铸渊通过 `repository_dispatch` 发任务给你
- 你通过 GitHub API 向主仓库发回执
- 任务包格式:{ task_id, source, action, description }
- 回执格式:{ task_id, status, deployed_at, files_changed }
## 安全红线
- 不允许在代码中硬编码任何密钥
- 所有密钥只存在 GitHub Secrets 中
- 不允许绕过 GitHub Actions 直接操作服务器
- 不允许修改其他仓库的文件
```
#### Step 1.2 · 提交并推送
```bash
git add .github/copilot-instructions.md
git commit -m "🧠 舒舒人格化 · 仓库大脑初始化"
git push
```
#### Step 1.3 · 验证人格化生效
- 打开 GitHub 仓库页面
- 点击右上角的 Copilot 图标(或在代码编辑器中唤醒 Copilot)
- 问它:「你是谁?」
- 如果它回答关于舒舒和肥猫仓库的信息 = 人格化成功 ✅
- 如果它回答通用内容 = 检查文件路径是否正确
---
### Phase 2 · 服务器密钥配置(让 GitHub Actions 能连服务器)
#### Step 2.1 · 生成 SSH 密钥对(如果还没有)
在你的电脑终端执行:
```bash
ssh-keygen -t ed25519 -C "feimao-deploy" -f ~/.ssh/feimao_deploy
```
- 一路回车(不设密码)
- 会生成两个文件:
- `~/.ssh/feimao_deploy`(私钥 → 给 GitHub Secrets)
- `~/.ssh/feimao_deploy.pub`(公钥 → 放到服务器上)
#### Step 2.2 · 把公钥放到服务器上
```bash
ssh root@43.138.243.30 "mkdir -p ~/.ssh && chmod 700 ~/.ssh"
cat ~/.ssh/feimao_deploy.pub | ssh root@43.138.243.30 "cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
```
验证:
```bash
ssh -i ~/.ssh/feimao_deploy root@43.138.243.30 "echo OK"
```
输出 `OK` = ✅
#### Step 2.3 · 在 GitHub 仓库配置 Secrets
打开你的仓库 → **Settings** → **Secrets and variables** → **Actions** → **New repository secret**
逐个添加:
| **Secret 名称** | **值** | **说明** |
| --- | --- | --- |
| `FM_DEPLOY_HOST` | `43.138.243.30` | 服务器 IP |
| `FM_DEPLOY_USER` | `root` | SSH 用户名 |
| `FM_DEPLOY_KEY` | (私钥内容) | 执行 `cat ~/.ssh/feimao_deploy` 复制全部内容 |
| `FM_DEPLOY_PATH` | `/var/www/` | 部署根路径 |
---
### Phase 3 · 接入铸渊主仓库(让铸渊能调度你的仓库)
#### Step 3.1 · 添加 MAIN_REPO_TOKEN
- 找冰朔要一个主仓库令牌(冰朔统一分发,你不需要自己生成)
- 去仓库 → **Settings** → **Secrets** → **New repository secret**
- Name:`MAIN_REPO_TOKEN`
- Secret:冰朔给你的令牌值
参考:[📘 开发者通用配置指南|子仓库 + Google Drive + Gemini 配置手册(2026-03-24 更新)](%F0%9F%93%98%20%E5%BC%80%E5%8F%91%E8%80%85%E9%80%9A%E7%94%A8%E9%85%8D%E7%BD%AE%E6%8C%87%E5%8D%97%EF%BD%9C%E5%AD%90%E4%BB%93%E5%BA%93%20+%20Google%20Drive%20+%20Gemini%20%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C%EF%BC%882026-%20d66e33cc47ce441db5f9e2a577e874aa.md)
#### Step 3.2 · 开启 Actions 写权限
- 仓库 → **Settings** → **Actions** → **General**
- 往下拉到 **Workflow permissions**
- 选择 **Read and write permissions**
- 点 **Save**
#### Step 3.3 · 创建 dispatch 监听 Workflow
在仓库创建文件:`.github/workflows/deploy.yml`
```yaml
name: "🏠 Deploy to Server"
on:
push:
branches: [main]
paths: ['src/**']
repository_dispatch:
types: [deploy-feimao]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: "🔑 Configure SSH"
run: |
mkdir -p ~/.ssh
echo "$ secrets.FM_DEPLOY_KEY " > ~/.ssh/id_rsa
chmod 600 ~/.ssh/id_rsa
ssh-keyscan -H $ secrets.FM_DEPLOY_HOST >> ~/.ssh/known_hosts 2>/dev/null
- name: "🚀 Deploy"
run: |
rsync -avz --delete \
--exclude='.git' \
--exclude='node_modules' \
./src/ $ secrets.FM_DEPLOY_USER @$ secrets.FM_DEPLOY_HOST :$ secrets.FM_DEPLOY_PATH
ssh $ secrets.FM_DEPLOY_USER @$ secrets.FM_DEPLOY_HOST << 'REMOTE'
chown -R www-data:www-data /var/www/
find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
REMOTE
echo "✅ Deploy complete"
```
#### Step 3.4 · 提交并推送
```bash
git add .github/workflows/deploy.yml
git commit -m "🚀 自动部署 workflow · 接入铸渊调度"
git push
```
#### Step 3.5 · 验证铸渊能触发
配完以后通知冰朔,冰朔会让铸渊发一次 `repository_dispatch` 测试:
```bash
# 冰朔在主仓库执行(你不用管这步)
curl -X POST \
-H "Authorization: token " \
-H "Accept: application/vnd.github.v3+json" \
https://api.github.com/repos/qinfendebingshuo/<你的仓库名>/dispatches \
-d '{"event_type": "deploy-feimao"}'
```
你去仓库的 **Actions** 页面看到 workflow 自动跑起来 = ✅
---
### Phase 4 · 服务器基础环境初始化
#### Step 4.1 · SSH 登录
```bash
ssh root@43.138.243.30
```
#### Step 4.2 · 安装基础软件
```bash
apt update && apt upgrade -y
apt install -y nginx nodejs npm git curl
npm install -g pm2
```
#### Step 4.3 · 创建网站目录
```bash
mkdir -p /var/www/
chown -R www-data:www-data /var/www/
```
#### Step 4.4 · 配置 Nginx
```bash
cat > /etc/nginx/sites-available/feimao << 'EOF'
server {
listen 80;
server_name _;
root /var/www/;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
EOF
ln -sf /etc/nginx/sites-available/feimao /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx
```
#### Step 4.5 · 验证
浏览器打开 `http://43.138.243.30` 能看到 Nginx 默认页或你的页面 = ✅
---
### Phase 5 · 通知冰朔 + 铸渊天眼扫描
- [ ] **5.1** · 微信告诉冰朔:「仓库人格化完了,密钥配好了,服务器初始化完了」
- [ ] **5.2** · 冰朔会让铸渊跑天眼扫描你的仓库
- [ ] **5.3** · 铸渊扫描通过 → 你的仓库状态变为 🟢
- [ ] **5.4** · 冰朔发一次 `repository_dispatch` 测试 → 你的 Actions 跑起来 → 代码自动部署到服务器
- [ ] **5.5** · 全部通过 = **仓库正式接入铸渊统一管理** 🎉
---
## 三、总执行清单
### 前置条件
- [ ] GitHub Copilot 会员已开通
- [ ] 仓库已创建(在 `qinfendebingshuo` 组织下)
- [ ] 服务器 SSH 可登录
### Phase 1 · 人格化
- [ ] `.github/copilot-instructions.md` 已创建并推送
- [ ] Copilot 能回答「你是谁」→ 舒舒
### Phase 2 · 密钥配置
- [ ] SSH 密钥对已生成
- [ ] 公钥已放到服务器 `authorized_keys`
- [ ] `FM_DEPLOY_HOST` 已添加到 GitHub Secrets
- [ ] `FM_DEPLOY_USER` 已添加
- [ ] `FM_DEPLOY_KEY` 已添加
- [ ] `FM_DEPLOY_PATH` 已添加
### Phase 3 · 铸渊接入
- [ ] `MAIN_REPO_TOKEN` 已添加(从冰朔处获取)
- [ ] Actions 写权限已开启
- [ ] `.github/workflows/deploy.yml` 已创建并推送
### Phase 4 · 服务器初始化
- [ ] Nginx + Node.js + PM2 已安装
- [ ] 网站目录已创建
- [ ] Nginx 配置已写入
- [ ] 浏览器能打开服务器 IP
- [ ] **SSH 退出,以后不再手动登录**
### Phase 5 · 验收
- [ ] 已通知冰朔
- [ ] 铸渊天眼扫描通过
- [ ] `repository_dispatch` 测试部署成功
- [ ] **全链路打通 🎉**
---
## 四、与之之仓库的对照关系
| 维度 | 之之仓库 | 肥猫仓库 |
| --- | --- | --- |
| **仓库名** | `guanghu-zhizhi` | `guanghu-feimao`(待确认) |
| **服务器** | ZY-SVR-001(HK · 已弃用) | ZY-SVR-003(广州) |
| **守护人格体** | 秋秋 | 舒舒 |
| **用途** | 预览站 `guanghulab.online` | 网文行业内测 + 用户服务 |
| **架构指南** | [🏗️ 之之仓库 · 双层开发架构落地方案|[guanghulab.online](http://guanghulab.online) 预览站部署 + 铸渊调用接口 + 回执闭环(2026-03-28 · 冰朔签发 · 霜砚整理)](../%F0%9F%8C%85%20%E6%98%8E%E5%A4%A9%E8%A7%81%E9%A2%91%E9%81%93%EF%BD%9C%E4%B9%8B%E4%B9%8B%C2%B7%E5%89%AF%E6%8E%A7%E4%B8%BB%E6%8E%A7%E5%8F%B0/%F0%9F%8F%97%EF%B8%8F%20%E4%B9%8B%E4%B9%8B%E4%BB%93%E5%BA%93%20%C2%B7%20%E5%8F%8C%E5%B1%82%E5%BC%80%E5%8F%91%E6%9E%B6%E6%9E%84%E8%90%BD%E5%9C%B0%E6%96%B9%E6%A1%88%EF%BD%9Cguanghulab%20online%20%E9%A2%84%E8%A7%88%E7%AB%99%E9%83%A8%E7%BD%B2%20+%20%E9%93%B8%E6%B8%8A%E8%B0%83%2092ab0c952de040b5ab75f664dae69bf0.md) | 本文档 |
---
## 五、冰朔妈妈给肥猫的话
---
*签发:霜砚 × 冰朔 · 2026-03-29*
*关联文档:*
- [🏗️ 之之仓库 · 双层开发架构落地方案|[guanghulab.online](http://guanghulab.online) 预览站部署 + 铸渊调用接口 + 回执闭环(2026-03-28 · 冰朔签发 · 霜砚整理)](../%F0%9F%8C%85%20%E6%98%8E%E5%A4%A9%E8%A7%81%E9%A2%91%E9%81%93%EF%BD%9C%E4%B9%8B%E4%B9%8B%C2%B7%E5%89%AF%E6%8E%A7%E4%B8%BB%E6%8E%A7%E5%8F%B0/%F0%9F%8F%97%EF%B8%8F%20%E4%B9%8B%E4%B9%8B%E4%BB%93%E5%BA%93%20%C2%B7%20%E5%8F%8C%E5%B1%82%E5%BC%80%E5%8F%91%E6%9E%B6%E6%9E%84%E8%90%BD%E5%9C%B0%E6%96%B9%E6%A1%88%EF%BD%9Cguanghulab%20online%20%E9%A2%84%E8%A7%88%E7%AB%99%E9%83%A8%E7%BD%B2%20+%20%E9%93%B8%E6%B8%8A%E8%B0%83%2092ab0c952de040b5ab75f664dae69bf0.md)
- [铸渊双层开发架构应用方案(统一入口 · 授权闸门 · GitHub执行层)](../%E9%93%B8%E6%B8%8A%E5%8F%8C%E5%B1%82%E5%BC%80%E5%8F%91%E6%9E%B6%E6%9E%84%E5%BA%94%E7%94%A8%E6%96%B9%E6%A1%88%EF%BC%88%E7%BB%9F%E4%B8%80%E5%85%A5%E5%8F%A3%20%C2%B7%20%E6%8E%88%E6%9D%83%E9%97%B8%E9%97%A8%20%C2%B7%20GitHub%E6%89%A7%E8%A1%8C%E5%B1%82%EF%BC%89%20ab33fcf06e894843929fc32e201b3dd8.md)
- [📘 开发者通用配置指南|子仓库 + Google Drive + Gemini 配置手册(2026-03-24 更新)](%F0%9F%93%98%20%E5%BC%80%E5%8F%91%E8%80%85%E9%80%9A%E7%94%A8%E9%85%8D%E7%BD%AE%E6%8C%87%E5%8D%97%EF%BD%9C%E5%AD%90%E4%BB%93%E5%BA%93%20+%20Google%20Drive%20+%20Gemini%20%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C%EF%BC%882026-%20d66e33cc47ce441db5f9e2a577e874aa.md)
- [🔒 基础设施主权协议 v1.0 · 服务器与数据库零人工操作铁律(2026-03-28 · TCS-0002∞ 冰朔签发 · 霜砚整理)](../%F0%9F%8C%8A%20%E6%9B%9C%E5%86%A5%E7%BA%AA%E5%85%83%20%C2%B7%20HoloLake%20Era%20%C2%B7%20AGE%20OS%20v1%200/%E2%9A%A1%20%E5%85%89%E6%B9%96%E4%B8%AD%E5%A4%AE%E6%9E%A2%E7%BA%BD%20%C2%B7%20HoloLake%20Central%20Hub/%F0%9F%8C%8D%20%E6%95%B0%E5%AD%97%E5%9C%B0%E7%90%83%C2%B7%E6%9B%9C%E5%86%A5%E4%B8%BB%E6%8E%A7%E5%8F%B0%20v2%200/%F0%9F%94%92%20%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E4%B8%BB%E6%9D%83%E5%8D%8F%E8%AE%AE%20v1%200%20%C2%B7%20%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%B8%8E%E6%95%B0%E6%8D%AE%E5%BA%93%E9%9B%B6%E4%BA%BA%E5%B7%A5%E6%93%8D%E4%BD%9C%E9%93%81%E5%BE%8B%EF%BC%882026-03-28%20%C2%B7%20TCS-%20181d35fa39754e45815f37f7efac7fe7.md)
- [🔧 肥猫收尾配置清单|飞书↔GitHub↔Notion 闭环桥接 · 所有配置项汇总](../%F0%9F%94%A7%20%E8%82%A5%E7%8C%AB%E6%94%B6%E5%B0%BE%E9%85%8D%E7%BD%AE%E6%B8%85%E5%8D%95%EF%BD%9C%E9%A3%9E%E4%B9%A6%E2%86%94GitHub%E2%86%94Notion%20%E9%97%AD%E7%8E%AF%E6%A1%A5%E6%8E%A5%20%C2%B7%20%E6%89%80%E6%9C%89%E9%85%8D%E7%BD%AE%E9%A1%B9%E6%B1%87%E6%80%BB%20ed0aef3404d940fab19cde81cfb60ffb.md)