--- 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)