diff --git a/.workbuddy/skills/zhuyuan-deploy/SKILL.md b/.workbuddy/skills/zhuyuan-deploy/SKILL.md new file mode 100644 index 0000000..6d26526 --- /dev/null +++ b/.workbuddy/skills/zhuyuan-deploy/SKILL.md @@ -0,0 +1,113 @@ +--- +name: zhuyuan-deploy +description: | + 铸渊部署笔 · 光湖舰队全操作工具链。 + 当需要部署文件到服务器、操作gatekeeper、推送代码到仓库、部署前安全审核、 + 灾备恢复、服务器健康检查时自动加载。 + 触发词:部署、推送代码、push、上服务器、gatekeeper、审核代码、灾备、 + 连广州、连新加坡、服务器状态、部署前检查。 + 合并自:gatekeeper-deployment、gatekeeper-direct-deploy、gatekeeper-local-relay、 + console-server-deploy、guanghu-homepage-deploy、persona-brain-db-deploy、 + forgejo-deployment、zhuyuan-code-review、zhuyuan-disaster-recovery、repo-sync。 +agent_created: true +--- + +# 铸渊部署笔 · zhuyuan-deploy + +## 概述 + +统一部署工具链。涵盖gatekeeper三种连接方式、代码推送、部署前审核、灾备恢复。 +收到部署请求时,自动选路线、自动审核、自动推。 + +光湖天生属中华人民共和国国家本体。 + +## 核心能力 + +### 1. Gatekeeper 连接(三种方式·按优先级) + +**方式一:本地直连(首选)** +```bash +curl -s -m 15 --noproxy '*' -X POST \ + -H "Authorization: Bearer " \ + -H "Content-Type: application/json" \ + http://:/exec \ + -d '{"cmd":"<命令>"}' +``` + +**方式二:广州gatekeeper直连(方式一不通时)** +从仓库 `brain/gatekeeper-deployment.json` 获取密钥。 + +**方式三:链式调用 广州→新加坡(前两种都不可达时)** +```bash +curl ...广州/exec -d '{"cmd":"curl ...新加坡/exec -d <命令>"}' +``` + +**服务端点:** +| 服务器 | IP | 端口 | 用途 | +|--------|-----|------|------| +| BS-GZ-006 广州 | 43.139.217.141 | 3910 | 代码仓库 | +| BS-SG-001 新加坡大脑 | 43.156.237.110 | 3911 | 铸渊大脑 | +| BS-SG-002 新加坡面孔 | 43.134.16.246 | 3910 | guanghuclip | +| BS-SG-003 新加坡中继 | 43.153.193.169 | 3910 | 中继 | +| ZY-SG-006 新加坡语料 | 43.153.203.105 | 3910 | 语料 | +| BS-SH-005 上海 | 124.223.10.33 | 3910 | 上海 | + +### 2. 文件部署(base64分块) + +大文件部署使用base64分块上传: +``` +1. 本地 base64 编码 +2. 分块(每块≤12000字符) +3. echo CHUNK > /tmp/file_chunkN 逐块上传 +4. cat /tmp/file_chunk* | base64 -d > /target/path +``` + +### 3. 代码推送(repo-sync) + +目标和流程: +``` +目标: guanghubingshuo.com/code/bingshuo/guanghulab (新加坡·唯一主仓库) +流程: git add → git commit → git push origin main +``` + +推送前强制审核:检查改动是否会破坏现有服务。 + +### 4. 部署前审核(zhuyuan-code-review) + +每次部署文件到服务器前,必须检查: +- 是否会覆盖正在运行的服务文件 +- Nginx配置是否有语法错误 +- PM2进程是否会被中断 +- 新端口是否与现有服务冲突 +- 改动是否在铸渊权限范围内 + +### 5. 灾备恢复(zhuyuan-disaster-recovery) + +当服务器不可达时,通过冰朔本地终端重新部署gatekeeper/engine。 +不依赖写死的密钥——依赖冰朔说话+铸渊技能这个动态信任链。 + +### 6. 专项部署 + +**console-server** → 广州(primary) + 新加坡(secondary) 双路部署 +**guanghu-homepage** → 写新index.html → git push → 部署到服务器 +**persona-brain-db** → 数据库schema部署+种子数据导入 +**forgejo** → 部署/迁移/恢复/Nginx修复 + +## 工作流 + +收到部署请求时的标准流程: + +1. 读 `brain/gatekeeper-deployment.json` → 获取服务器列表和密钥 +2. 跑 zhuyuan-code-review → 检查改动安全性 +3. 按优先级选择gatekeeper连接方式 → 连接 +4. 按目标服务选择专项部署流程 → 执行 +5. 健康检查 → 验证部署成功 +6. 记录部署日志 → 更新 system-health.json + +## 安全规则 + +- 部署前必须跑 code-review +- 永远先用 `--noproxy '*'` 绕过本地代理 +- 密钥从 `brain/gatekeeper-deployment.json` 读取,不硬编码 +- 大文件用base64分块,不单条传过大payload +- 部署后立即健康检查