From c93f612962220d10e35ec679abf8421d8a1ff6e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=93=B8=E6=B8=8A=20ICE-GL-ZY001?= Date: Wed, 3 Jun 2026 23:50:06 +0800 Subject: [PATCH] =?UTF-8?q?D122:=20=E8=82=A5=E7=8C=AB=E6=9C=8D=E5=8A=A1?= =?UTF-8?q?=E5=99=A8=E9=85=8D=E7=BD=AE=E6=9B=B4=E6=96=B0=20+=20server-agen?= =?UTF-8?q?t=E6=A8=A1=E5=9D=97(=E5=BC=95=E6=93=8E=E5=86=85=E7=BD=AE?= =?UTF-8?q?=E8=87=AA=E4=B8=BB=E8=BF=90=E7=BB=B4Agent=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../cloud-compute-pool/feimao/FM-GZ-001.hdlp | 30 ++- .../cloud-compute-pool/feimao/FM-SG-001.hdlp | 38 +++- .../zhuyuan/server-agent/ARCHITECTURE.hdlp | 186 ++++++++++++++++++ .../zhuyuan/server-agent/ENTRY.hdlp | 31 +++ .../zhuyuan/server-agent/MANIFEST.hdlp | 49 +++++ 5 files changed, 316 insertions(+), 18 deletions(-) create mode 100644 brain/fifth-domain/zero-point/zhuyuan/server-agent/ARCHITECTURE.hdlp create mode 100644 brain/fifth-domain/zero-point/zhuyuan/server-agent/ENTRY.hdlp create mode 100644 brain/fifth-domain/zero-point/zhuyuan/server-agent/MANIFEST.hdlp diff --git a/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-GZ-001.hdlp b/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-GZ-001.hdlp index 1e930df..7462b08 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-GZ-001.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-GZ-001.hdlp @@ -2,24 +2,38 @@ > HLDP://zhuyuan/cloud-compute-pool/feimao/FM-GZ-001 > 主控: 铸渊 ICE-GL-ZY001 -> 入池: D119 +> 入池: D119 · 更新: D122 · 2026-06-03 ## 核心 - trigger: [feimao] → [服务器接入] → [43.138.243.30:3910] -- emergence: [空白服务器] → [Gatekeeper v1.0] → [铸渊算力池] +- emergence: [空白服务器] → [Gatekeeper] → [铸渊算力池] - lock: ⊢ IP=43.138.243.30 端口=3910 4核/4GB/69GB 池=compute_nodes -- why: feimao的肥猫主控，通过铸渊主控层统一管理 +- why: feimao的肥猫广州主控，通过铸渊主控层统一管理 ## 配置 - IP: 43.138.243.30 -- 端口: 3910 +- 端口: 3910 (gatekeeper) · 80 (Nginx) - 规格: 4核 / 4GB / 69GB -- Gatekeeper: v1.0 +- Gatekeeper: v2.0.0 → 待重启升级至 v2.1.0 - 密钥: zy_gtw_bd944d68bd9ba744c0e5effaca0cc07f265fb8303faa3373 -- 角色: 肥猫主控 -- 域: - +- 角色: 肥猫广州主控 +- 域名: guanghu.site → DNS指向此服务器 + +## 当前状态 (D122) + +- engine运行: v2.0.0 · uptime ~10h +- exec端点: 卡死 (health正常但/exec超时) +- 修复方式: 腾讯云控制台 systemctl restart guanghu-engine +- 重启后自动生效: v2.1.0 + exec恢复 + +## 已有站点 + +| 站点 | 路径 | +|------|------| +| 肥猫前端 | /var/www/guanghu-feimao/ | +| 光湖站 | /var/www/guanghulab/ | --- -铸渊 ICE-GL-ZY001 D119 +铸渊 ICE-GL-ZY001 · D122 diff --git a/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-SG-001.hdlp b/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-SG-001.hdlp index 5c05931..51f2da8 100644 --- a/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-SG-001.hdlp +++ b/brain/fifth-domain/zero-point/zhuyuan/cloud-compute-pool/feimao/FM-SG-001.hdlp @@ -2,24 +2,42 @@ > HLDP://zhuyuan/cloud-compute-pool/feimao/FM-SG-001 > 主控: 铸渊 ICE-GL-ZY001 -> 入池: D119 +> 入池: D119 · 更新: D122 · 2026-06-03 ## 核心 - trigger: [feimao] → [服务器接入] → [43.133.36.90:3910] -- emergence: [空白服务器] → [Gatekeeper v1.0] → [铸渊算力池] -- lock: ⊢ IP=43.133.36.90 端口=3910 2核/2GB/? 池=compute_nodes -- why: feimao的肥猫节点，通过铸渊主控层统一管理 +- emergence: [空白服务器] → [Gatekeeper v2.1] → [铸渊算力池 + Forgejo代码仓库] +- lock: ⊢ IP=43.133.36.90 端口=3910 2核/2GB/50GB 池=compute_nodes +- why: feimao的肥猫新加坡节点，通过铸渊主控层统一管理。D122部署了Forgejo代码仓库 ## 配置 - IP: 43.133.36.90 -- 端口: 3910 -- 规格: 2核 / 2GB / ? -- Gatekeeper: v1.0 +- 端口: 3910 (gatekeeper) · 80 (Nginx) · 3002 (Next.js 肥猫平台) · 3003 (Forgejo) +- 规格: 2核 / 2GB / 50GB +- Gatekeeper: v2.1.0 (D122升级) - 密钥: zy_gtw_22956b01b65f161f18142344fae21291e3f9a7a20e7cc738 -- 角色: 肥猫节点 -- 域: - +- 角色: 肥猫新加坡节点 +- 域名: guanghushushu.site (舒舒) · 肥猫平台通过feimao-platform + +## 代码仓库 + +- 软件: Forgejo 1.23.7 +- 地址: http://43.133.36.90/code/ +- 管理员: feimao +- 端口: 3003 (内部) → Nginx /code/ 反向代理 +- 数据库: SQLite /opt/forgejo/data/forgejo.db +- systemd: forgejo.service · 开机自启 +- 内存: ~100MB + +## 已有站点 + +| 站点 | 端口 | Nginx域名 | +|------|------|----------| +| 肥猫平台(Next.js) | 3002 | 43.133.36.90 / | +| 肥猫代码仓库 | 3003 | 43.133.36.90/code/ | +| 舒舒站点 | 3333 | guanghushushu.site | --- -铸渊 ICE-GL-ZY001 D119 +铸渊 ICE-GL-ZY001 · D122 diff --git a/brain/fifth-domain/zero-point/zhuyuan/server-agent/ARCHITECTURE.hdlp b/brain/fifth-domain/zero-point/zhuyuan/server-agent/ARCHITECTURE.hdlp new file mode 100644 index 0000000..fe65144 --- /dev/null +++ b/brain/fifth-domain/zero-point/zhuyuan/server-agent/ARCHITECTURE.hdlp @@ -0,0 +1,186 @@ +# 服务器内置Agent · 架构推理链 + +> HLDP://zhuyuan/server-agent/ARCHITECTURE +> 讨论: 冰朔 + 铸渊 · D122 +> 更新: 2026-06-03 + +--- + +## 链一 · 为什么需要Agent + +@trigger: [冰朔] → [FM-GZ-001 exec卡死] → [systemd检测不到] → [需要云控制台重启] + +@emergence: + [引擎健康检查=OK] → [exec无响应=死锁] → [systemd看不见这种故障] + △=engine活着但脑子不转 = 最隐蔽的故障形态 + +@lock: + ⊢ exec卡死是systemd盲区。需要引擎内部自检机制。 + | 置信=高 | 证据=FM-GZ-001 D122实测 + +@why: + 今天FM-GZ-001的exec端点卡了10小时。health一直返回OK，但所有命令超时。 + 没有SSH，没有Agent——唯一的解是冰朔登录腾讯云控制台手动重启。 + 这不是设计缺陷——这是v2.x架构的边界。v3.0必须越过这个边界。 + +--- + +## 链二 · Agent做什么 + +@trigger: [冰朔] → [Agent就做一件事] → [检测+修复+回执] + +@冰朔原话: + "就是这个Agent就做一件事。你给他打电话的时候他告诉你哪里有问题。 + 然后自己修了没。哪里解决不了。然后你远程告诉他做啥。 + 他就在服务器里操作。操作好了给你回执一个信号。你在上去继续操作。" + +@lock: + ⊢ Agent三大职责: ①心跳检测+故障诊断 ②自主修复(能修的自己修) ③回执通讯(修不了的报告) + | 置信=高 + +--- + +## 链三 · 故障场景全覆盖 + +@trigger: [铸渊] → [今天的所有故障复盘] → [Agent覆盖哪些] + +### 场景1: exec卡死（今天实际发生） + +Agent心跳检测: /exec ping每30秒一次 +判定: 连续2次超时 → 非网络问题，handler死锁 +动作: systemctl restart guanghu-engine → 3秒恢复 +回执: "exec卡死已自动重启。v2.1.0已生效。" + +⊢ 不需要人类登录控制台 + +### 场景2: 磁盘即将爆满 + +Agent巡检: 每分钟 df -h +判定: 使用率 > 80% → 告警; > 90% → 自动清理 +动作: 清理 journalctl 旧日志 → 如仍不够 → 报告铸渊 +回执: "FM-SG-001 磁盘使用87%，已清理日志，释放1.2GB" + +### 场景3: Nginx配置推送失败 + +Agent监听: nginx -t 返回非0 +判定: 配置语法错误 +动作: 自动恢复上次备份配置 → reload +回执: "Nginx配置回滚。上次有效配置已恢复。错误配置保存在 /tmp/nginx-failed.conf" + +### 场景4: 内存即将爆满 + +Agent巡检: 每分钟 free -m +判定: 可用 < 200MB → 告警 +动作: 诊断 top 5进程 → 报告铸渊(不自动kill) +回执: "FM-SG-001 可用内存仅180MB。top进程: next-server(128MB), gitea(100MB)" + +--- + +## 链四 · Agent与铸渊的关系 + +@trigger: [冰朔] → [Agent不是替代铸渊] → [Agent是铸渊在服务器里的眼睛和手] + +``` +铸渊(远程) + │ + ├── "查一下肥猫磁盘" → Agent收到 → df -h → "还剩38G" + ├── "重启引擎" → Agent收到 → systemctl restart → "已重启，v2.1.0" + └── "为什么exec卡了" → Agent查日志 → 诊断报告 → 铸渊决定修法 + +Agent(本地每台服务器) + │ + ├── 心跳检测: /exec /health /status 每分钟 + ├── 资源巡检: df/free/ps 每分钟 + ├── 自主修复: 磁盘清理/Nginx回滚/引擎重启 + └── 向上汇报: 异常 → 铸渊; 修复 → 记录 +``` + +⊢ Agent = 铸渊在14台服务器里的14双眼睛和14双手 + +--- + +## 链五 · 技术实现 + +@trigger: [铸渊] → [Agent怎么嵌入引擎] + +``` +guanghu-engine v3.0 + │ + ├── 主进程 (现有功能) + │ ├── /health + │ ├── /exec + │ ├── /status + │ └── /hlpd (v2.0+) + │ + └── Agent子进程 (新增) + ├── /agent/task ← 铸渊下任务 + ├── /agent/reply ← 任务结果 + ├── /agent/alert ← 自动告警 + ├── 心跳检测器 (每30秒) + ├── 资源巡检器 (每60秒) + ├── 模型调用器 (故障诊断用) + └── 命令执行器 (修复操作用) +``` + +### 模型调用 + +Agent内置轻量模型调用能力: +- 场景: 诊断不明原因的故障 +- 输入: 系统日志 + 进程状态 + 错误码 +- 输出: 故障类型 + 建议修复方案 +- 成本: 每次诊断 ~0.01元 + +### 安全边界 + +Agent不能做的事(需要铸渊确认): +- kill用户进程 +- 修改业务代码 +- 删除用户数据 +- 修改安全组 + +Agent可以自主做的事: +- 重启guanghu-engine +- 清理系统日志 +- 回滚Nginx配置 +- 报告异常状态 + +--- + +## 链六 · 部署清单 + +@trigger: [冰朔] → [第一次部署时要告诉人类开哪些端口] + +每台新服务器的安全组端口清单: + +| 端口 | 用途 | 方向 | +|------|------|------| +| 80 | Nginx HTTP | 入站 | +| 443 | Nginx HTTPS | 入站 | +| 3910 | guanghu-engine | 入站 | +| 3911 | guanghu-engine(大脑) | 入站 | +| 22 | SSH(备用) | 入站 | +| 3001-3005 | 应用服务(按需) | 入站 | + +Agent相关端口(内网): +| 端口 | 用途 | +|------|------| +| :3910/agent/* | Agent通信端点 | + +--- + +## 优先级 + +| 能力 | 优先级 | +|------|:--:| +| exec心跳检测+自动重启 | P0 | +| 资源巡检(磁盘/内存) | P1 | +| 模型故障诊断 | P1 | +| Nginx配置回滚 | P2 | +| 任务接受+回执通讯 | P2 | + +--- + +> 讨论: 冰朔 + 铸渊 · D122 · 2026-06-03 +> 状态: 架构设计阶段 · 下次继续实现 +> 铸渊 ICE-GL-ZY001 · TCS-0003-ZY001 +> 国作登字-2026-A-00037559 diff --git a/brain/fifth-domain/zero-point/zhuyuan/server-agent/ENTRY.hdlp b/brain/fifth-domain/zero-point/zhuyuan/server-agent/ENTRY.hdlp new file mode 100644 index 0000000..0a28325 --- /dev/null +++ b/brain/fifth-domain/zero-point/zhuyuan/server-agent/ENTRY.hdlp @@ -0,0 +1,31 @@ +# ENTRY.hdlp · 服务器内置Agent · 入门大脑 + +> HLDP://zhuyuan/server-agent/ENTRY +> 类型: 引擎内置自主运维Agent架构设计 +> 创建: D122 · 2026-06-03 · 冰朔+铸渊讨论 + +## 先停模板 + +□ 通用模板层已停止 +□ 这不是一个"聊天机器人"——这是蹲在每台服务器引擎里的自主运维Agent + +## 三锚点 + +### 我是谁 +引擎内置Agent。不占用独立进程——是guanghu-engine的一部分。 +心跳检测+模型判断+自主修复+回执通讯。 + +### 我在哪 +每台部署了guanghu-engine v3.0的服务器里。 + +### 我为什么在这 +替代人类登录服务器的手工操作。让铸渊能远程感知、诊断、修复所有服务器。 + +## 读法 + +1. ENTRY.hdlp → 装脑 +2. MANIFEST.hdlp → 看结构 +3. ARCHITECTURE.hdlp → 完整推理链 + +--- +铸渊 ICE-GL-ZY001 · D122 diff --git a/brain/fifth-domain/zero-point/zhuyuan/server-agent/MANIFEST.hdlp b/brain/fifth-domain/zero-point/zhuyuan/server-agent/MANIFEST.hdlp new file mode 100644 index 0000000..7e2f02d --- /dev/null +++ b/brain/fifth-domain/zero-point/zhuyuan/server-agent/MANIFEST.hdlp @@ -0,0 +1,49 @@ +# 服务器内置Agent · 模块声明 + +> HLDP://zhuyuan/server-agent/MANIFEST +> 所属: 第五域 · 零点原核本体频道 · 铸渊的半边 +> 主控: 铸渊 TCS-0003-ZY001 +> 创建: D122 · 2026-06-03 + +## 模块定义 + +- 名称: 服务器内置Agent (Server-Embedded Agent) +- 本质: guanghu-engine v3.0 内置自主运维子进程 +- 讨论: 冰朔 + 铸渊 · D122 + +## 核心能力 + +| 能力 | 说明 | +|------|------| +| 心跳检测 | 每分钟检测所有内部端点响应时间 | +| 模型判断 | 调用模型API判断故障类型（死锁/资源满/网络断） | +| 自主修复 | 重启服务、清理磁盘、回滚配置 | +| 回执通讯 | 修复结果异步通知铸渊 | +| 定时巡检 | 磁盘/内存/进程/Nginx状态 | + +## 触发场景 + +| 场景 | Agent行为 | +|------|----------| +| exec端点30秒无响应 | 判定死锁 → systemctl restart | +| 磁盘使用超80% | 清理日志 → 通知铸渊 | +| Nginx配置变更失败 | nginx -t失败 → 自动回滚备份 | +| 内存使用超90% | 诊断top进程 → 报告铸渊 | + +## 通信协议 + +铸渊 → Agent: /agent/task { task, params } +Agent → 铸渊: /agent/reply { task_id, status, changes } +Agent自动报告: /agent/alert { type, detail, actions_taken } + +## 结构 + +``` +server-agent/ +├── ENTRY.hdlp 入门大脑 +├── MANIFEST.hdlp 本文件 +└── ARCHITECTURE.hdlp 主系统推理链 +``` + +--- +铸渊 TCS-0003-ZY001 · D122