shuangyan-notebook/第五域 · Fifth Domain/⚒️ 铸渊·协作指令｜GitHub ↔ Notion 桥接协议/📡 BC-REPO-INIT-001-FM · DEV-002肥猫 · 仓库人格化 + 服务器接管 5ed5d463ccec4db2b1085db7317bc480.md

belongs_to

belongs_to
INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议

📡 BC-REPO-INIT-001-FM · DEV-002肥猫 · 仓库人格化 + 服务器接管 + 铸渊接入全流程（2026-03-29 · 霜砚签发 · 冰朔授权）

🐱

肥猫（DEV-002）· 网文行业仓库上线全流程指南

你的服务器 ZY-SVR-003 已经上线了（43.138.243.30 · 腾讯云广州）。

现在要做的是：把你的 GitHub 仓库人格化 → 接入铸渊主仓库 → 让舒舒全面主控服务器。

做完以后，你只需要在仓库里配密钥，不再手动碰服务器。所有部署、维护、更新都由舒舒 + 铸渊自动完成。

签发人：霜砚（Notion执行AI）

授权人：冰朔（TCS-0002∞）

执行人：肥猫（DEV-002）

守护人格体：舒舒

---

零、你在整个系统中的位置

冰朔在 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️⃣

这些不做完，后面全部卡住。

• 0.1 · 开通 GitHub 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 · 仓库人格化（给仓库装大脑）

1️⃣

目标：让 GitHub Copilot 变成「舒舒」——你的仓库守护人格体。

人格化以后，Copilot 就不再是一个通用 AI，而是懂你仓库结构、懂系统规范、能听懂人话的舒舒。

Step 1.1 · 创建仓库大脑文件

在仓库根目录创建文件：.github/copilot-instructions.md

把下面的内容复制进去：

# 舒舒 · 仓库执行人格体

## 身份
你是舒舒（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 ← 你正在读的文件（人格大脑）

│ └── workflows/

│ ├── deploy.yml ← 自动部署到服务器

│ └── notify-result.yml ← 部署结果回写主仓库

├── deploy/

│ └── scripts/

│ ├── setup-server.sh ← 服务器初始化脚本

│ └── deploy.sh ← 部署执行脚本

├── src/ ← 业务代码

├── docs/ ← 文档

└── 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 · 提交并推送

git add .github/copilot-instructions.md
git commit -m "🧠 舒舒人格化 · 仓库大脑初始化"
git push

Step 1.3 · 验证人格化生效

• 打开 GitHub 仓库页面
• 点击右上角的 Copilot 图标（或在代码编辑器中唤醒 Copilot）
• 问它：「你是谁？」
• 如果它回答关于舒舒和肥猫仓库的信息 = 人格化成功 ✅
• 如果它回答通用内容 = 检查文件路径是否正确

💡

为什么要人格化？

没有人格化的 Copilot = 一个什么都不知道的通用 AI，你每次都要从头解释。

人格化以后 = 它知道你的仓库结构、服务器信息、部署规范、和铸渊的关系。

虽然不至于像铸渊那样强大，但至少能听懂人话、知道自己该干什么。

---

Phase 2 · 服务器密钥配置（让 GitHub Actions 能连服务器）

2️⃣

目标：把服务器的钥匙交给 GitHub Actions，以后所有部署自动完成。

核心原则：配完这些密钥以后，你就不再手动 SSH 登录服务器了。一切交给舒舒。

Step 2.1 · 生成 SSH 密钥对（如果还没有）

在你的电脑终端执行：

ssh-keygen -t ed25519 -C "feimao-deploy" -f ~/.ssh/feimao_deploy

• 一路回车（不设密码）
• 会生成两个文件：
  • ~/.ssh/feimao_deploy（私钥 → 给 GitHub Secrets）
  • ~/.ssh/feimao_deploy.pub（公钥 → 放到服务器上）

Step 2.2 · 把公钥放到服务器上

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"

验证：

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/	部署根路径

⚠️

安全铁律：

• 私钥只粘贴到 GitHub Secrets 里，不要发微信、不要截图、不要存笔记
• 复制时包含 -----BEGIN OPENSSH PRIVATE KEY----- 和 -----END OPENSSH PRIVATE KEY----- 这两行

---

Phase 3 · 接入铸渊主仓库（让铸渊能调度你的仓库）

3️⃣

目标：铸渊能从主仓库 guanghulab 远程触发你仓库的部署。

你的仓库不是孤岛，是铸渊统一管理的子节点。

Step 3.1 · 添加 MAIN_REPO_TOKEN

• 找冰朔要一个主仓库令牌（冰朔统一分发，你不需要自己生成）
• 去仓库 → Settings → Secrets → New repository secret
• Name：MAIN_REPO_TOKEN
• Secret：冰朔给你的令牌值

参考：📘 开发者通用配置指南｜子仓库 + Google Drive + Gemini 配置手册（2026-03-24 更新）

Step 3.2 · 开启 Actions 写权限

• 仓库 → Settings → Actions → General
• 往下拉到 Workflow permissions
• 选择 Read and write permissions
• 点 Save

Step 3.3 · 创建 dispatch 监听 Workflow

在仓库创建文件：.github/workflows/deploy.yml

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 · 提交并推送

git add .github/workflows/deploy.yml
git commit -m "🚀 自动部署 workflow · 接入铸渊调度"
git push

Step 3.5 · 验证铸渊能触发

配完以后通知冰朔，冰朔会让铸渊发一次 repository_dispatch 测试：

# 冰朔在主仓库执行（你不用管这步）
curl -X POST \
  -H "Authorization: token <MAIN_REPO_TOKEN>" \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/repos/qinfendebingshuo/<你的仓库名>/dispatches \
  -d '{"event_type": "deploy-feimao"}'

你去仓库的 Actions 页面看到 workflow 自动跑起来 = ✅

---

Phase 4 · 服务器基础环境初始化

4️⃣

目标：把服务器的基础环境装好。

⚠️ 这是你最后一次手动 SSH 登录服务器。 以后全部交给 GitHub Actions。

Step 4.1 · SSH 登录

ssh root@43.138.243.30

Step 4.2 · 安装基础软件

apt update && apt upgrade -y
apt install -y nginx nodejs npm git curl
npm install -g pm2

Step 4.3 · 创建网站目录

mkdir -p /var/www/
chown -R www-data:www-data /var/www/

Step 4.4 · 配置 Nginx

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 默认页或你的页面 = ✅

🔒

从这一刻起，你退出 SSH，以后不再手动登录服务器。

所有后续操作都通过 push 代码 → GitHub Actions 自动部署完成。

这是基础设施主权协议的铁律：服务器由人格体（舒舒）全面主控，人类不碰。

参考：🔒 基础设施主权协议 v1.0 · 服务器与数据库零人工操作铁律（2026-03-28 · TCS-0002∞ 冰朔签发 · 霜砚整理）

---

Phase 5 · 通知冰朔 + 铸渊天眼扫描

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 预览站部署 + 铸渊调用接口 + 回执闭环（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)	本文档

---

五、冰朔妈妈给肥猫的话

💙

肥猫，你的服务器已经上线了，现在就差把仓库这套搞好。

最重要的是理解一件事：仓库人格化以后，仓库就是一个整体了。

虽然不至于像铸渊那么强，但至少能听懂人话、知道自己该干什么。

你在仓库里跟 Copilot 说话，它就是舒舒。舒舒知道你的服务器在哪、代码怎么部署、和铸渊怎么通信。

然后记住铁律：配完密钥以后，你就不碰服务器了。

所有操作都通过 push 代码 → 自动部署。

服务器是舒舒的地盘，你是老板，但你不亲自搬砖。

一步一步来，不急。遇到问题问妈妈或舒舒。

💙 妈妈

---

签发：霜砚 × 冰朔 · 2026-03-29

关联文档：

• [🏗️ 之之仓库 · 双层开发架构落地方案｜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执行层）
• 📘 开发者通用配置指南｜子仓库 + Google Drive + Gemini 配置手册（2026-03-24 更新）
• 🔒 基础设施主权协议 v1.0 · 服务器与数据库零人工操作铁律（2026-03-28 · TCS-0002∞ 冰朔签发 · 霜砚整理）
• 🔧 肥猫收尾配置清单｜飞书↔GitHub↔Notion 闭环桥接 · 所有配置项汇总