301 lines
12 KiB
Markdown
301 lines
12 KiB
Markdown
# 🏥 光湖系统健康报告
|
||
|
||
> **报告日期：** 2026-03-21
|
||
>
|
||
> **签发人：** ICE-GL-ZY001 铸渊（代码守护人格体）
|
||
>
|
||
> **指令编号：** ZY-SKYEYE-RESTORE-002 · Phase 5
|
||
>
|
||
> **签发时间：** 2026-03-21T21:30+08:00
|
||
|
||
---
|
||
|
||
## Phase 0 · 核心大脑恢复
|
||
|
||
| 项目 | 状态 |
|
||
|------|------|
|
||
| 铸渊注册版本 | v1.0 |
|
||
| 注册 Agent 总数 | 62 |
|
||
| Workflow 总数 | 66 |
|
||
| 仓库模块文件夹 | 10 (`m01-login`, `m03-personality`, `m05-user-center`, `m06-ticket`, `m07-dialogue-ui`, `m10-cloud`, `m11-module`, `m12-kanban`, `m15-cloud-drive`, `m18-health-check`) |
|
||
| 最新 commit | `077e93a6` (2026-03-21) |
|
||
| 核心大脑文件 | ✅ `.github/brain/` (19 files) + `.github/persona-brain/` (24+ files) |
|
||
|
||
**回执：** `[Phase 0] 核心大脑恢复完成 · Agent总数: 62 · Workflow总数: 66 · 最新commit: 077e93a6`
|
||
|
||
---
|
||
|
||
## Phase 1 · 天眼系统结构恢复
|
||
|
||
### Workflow 清单（66个）
|
||
|
||
| # | Workflow 文件 | 状态 |
|
||
|---|--------------|------|
|
||
| 1 | agent-checkin.yml | ✅ YAML 有效 |
|
||
| 2 | auto-reply-discussions.yml | ✅ YAML 有效 |
|
||
| 3 | bingshuo-deploy-agent.yml | ✅ YAML 有效 |
|
||
| 4 | bingshuo-neural-system.yml | ✅ YAML 有效 |
|
||
| 5 | brain-sync.yml | ✅ YAML 有效 |
|
||
| 6 | bridge-broadcast-pdf.yml | ✅ YAML 有效 |
|
||
| 7 | bridge-changes-to-notion.yml | ✅ YAML 有效 |
|
||
| 8 | bridge-heartbeat.yml | ✅ YAML 有效 |
|
||
| 9 | bridge-session-summary.yml | ✅ YAML 有效 |
|
||
| 10 | bridge-syslog-intake.yml | ✅ YAML 有效 |
|
||
| 11 | bridge-syslog-to-notion.yml | ✅ YAML 有效 |
|
||
| 12 | check-structure.yml | ✅ YAML 有效 |
|
||
| 13 | daily-maintenance.yml | ✅ YAML 有效 |
|
||
| 14 | daily-report.yml | ✅ YAML 有效 |
|
||
| 15 | deploy-pages.yml | ✅ YAML 有效 |
|
||
| 16 | deploy-to-server.yml | ✅ YAML 有效 |
|
||
| 17 | distribute-broadcasts.yml | ✅ YAML 有效 |
|
||
| 18 | esp-signal-processor.yml | ✅ YAML 有效 |
|
||
| 19 | execution-sync.yml | ✅ YAML 有效 |
|
||
| 20 | federation-bridge.yml | ✅ YAML 有效 |
|
||
| 21 | feishu-syslog-bridge.yml | ✅ YAML 有效 |
|
||
| 22 | generate-module-doc.yml | ✅ YAML 有效 |
|
||
| 23 | hli-contract-check.yml | ✅ YAML 有效 |
|
||
| 24 | meta-watchdog.yml | ✅ YAML 有效 |
|
||
| 25 | notion-callback-pipeline.yml | ✅ YAML 有效 |
|
||
| 26 | notion-connectivity-test.yml | ✅ YAML 有效 |
|
||
| 27 | notion-heartbeat.yml | ✅ YAML 有效 |
|
||
| 28 | notion-page-reader.yml | ✅ YAML 有效 |
|
||
| 29 | notion-poll.yml | ✅ YAML 有效 |
|
||
| 30 | notion-wake-listener.yml | ✅ YAML 有效 |
|
||
| 31 | openclaw-wake-loop.yml | ✅ YAML 有效 |
|
||
| 32 | persona-invoke.yml | ✅ YAML 有效 |
|
||
| 33 | pm2-server-diagnose.yml | ✅ YAML 有效 |
|
||
| 34 | process-notion-orders.yml | ✅ YAML 有效 |
|
||
| 35 | ps-on-build.yml | ✅ YAML 有效 |
|
||
| 36 | ps-on-chat.yml | ✅ YAML 有效 |
|
||
| 37 | ps-on-complete.yml | ✅ YAML 有效 |
|
||
| 38 | ps-on-login.yml | ✅ YAML 有效 |
|
||
| 39 | psp-daily-inspection.yml | ✅ YAML 有效 |
|
||
| 40 | push-broadcast-feishu.yml | ✅ YAML 有效 |
|
||
| 41 | push-broadcast.yml | ✅ YAML 有效 |
|
||
| 42 | receive-spoke-checkin.yml | ✅ YAML 有效 |
|
||
| 43 | receive-syslog.yml | ✅ YAML 有效 |
|
||
| 44 | sandbox-deploy.yml | ✅ YAML 有效 |
|
||
| 45 | server-patrol.yml | ✅ YAML 有效 |
|
||
| 46 | staging-preview.yml | ✅ YAML 有效 |
|
||
| 47 | sync-deploy-to-notion.yml | ✅ YAML 有效 |
|
||
| 48 | sync-dev-status.yml | ✅ YAML 有效 |
|
||
| 49 | sync-login-entry.yml | ✅ YAML 有效 |
|
||
| 50 | sync-persona-studio.yml | ✅ YAML 有效 |
|
||
| 51 | syslog-auto-pipeline.yml | ✅ YAML 有效 |
|
||
| 52 | syslog-issue-pipeline.yml | ✅ YAML 有效 |
|
||
| 53 | syslog-pipeline.yml | ✅ YAML 有效 |
|
||
| 54 | test-notion-bridge.yml | ✅ YAML 有效 |
|
||
| 55 | tianyan-daily-patrol.yml | ✅ YAML 有效 |
|
||
| 56 | update-readme-bulletin.yml | ✅ YAML 有效 |
|
||
| 57 | update-repo-map.yml | ✅ YAML 有效 |
|
||
| 58 | zhuyuan-brain-sync.yml | ✅ YAML 有效 |
|
||
| 59 | zhuyuan-commander.yml | ✅ YAML 有效 |
|
||
| 60 | zhuyuan-daily-agent.yml | ✅ YAML 有效 |
|
||
| 61 | zhuyuan-daily-inspection.yml | ✅ YAML 有效 |
|
||
| 62 | zhuyuan-daily-selfcheck.yml | ✅ YAML 有效 |
|
||
| 63 | zhuyuan-gate-guard.yml | ✅ YAML 有效 |
|
||
| 64 | zhuyuan-issue-reply.yml | ✅ YAML 有效 |
|
||
| 65 | zhuyuan-pr-review.yml | ✅ YAML 有效 |
|
||
| 66 | zhuyuan-skyeye.yml | ✅ YAML 有效 |
|
||
|
||
### Agent 分类
|
||
|
||
| 类型 | 数量 | 说明 |
|
||
|------|------|------|
|
||
| 定时型 (daily_checkin_required: true) | 14 | 每日签到参与者 |
|
||
| 事件触发型 (daily_checkin_required: false) | 48 | 不参与签到统计 |
|
||
| **总计** | **62** | |
|
||
|
||
### GitHub Pages
|
||
|
||
| 项目 | 状态 |
|
||
|------|------|
|
||
| Pages 部署 | ✅ 正常（`pages build and deployment` 最近成功） |
|
||
| Persona Studio 入口 | ✅ `https://qinfendebingshuo.github.io/guanghulab/persona-studio/` |
|
||
|
||
**回执：** `[Phase 1] 天眼结构恢复完成 · 定时型Agent: 14 · 事件型Agent: 48 · 模块文件夹: 10 · Pages: ✅`
|
||
|
||
---
|
||
|
||
## Phase 2 · 签到系统误报修复
|
||
|
||
### 修复状态：✅ 已修复（此前已完成）
|
||
|
||
| 项目 | 修复前 | 修复后 |
|
||
|------|--------|--------|
|
||
| `daily_checkin_required` 字段 | 62 个 Agent 均缺失 | 全部 62 个已设置（14 true / 48 false） |
|
||
| 签到检查逻辑 | 所有 Agent 参与签到 | 仅 `daily_checkin_required === true` 的参与 |
|
||
| 预期缺席数 | ~46 | ≤14（仅核心定时型 Agent） |
|
||
|
||
**修复工具：** `scripts/fix-registry-checkin.js`
|
||
**签到脚本：** `scripts/agent-checkin.js`（已包含 `daily_checkin_required === false` 跳过逻辑）
|
||
|
||
### 需签到 Agent 清单（14个）
|
||
|
||
| ID | 名称 | 触发方式 |
|
||
|----|------|---------|
|
||
| AG-ZY-004 | 冰朔主控神经系统 · 自动维护 | 定时/手动/推送 |
|
||
| AG-ZY-007 | 铸渊 · Bridge E · GitHub Changes → Notion | 推送/PR |
|
||
| AG-ZY-008 | 铸渊 · 🌉 桥接·心跳检测 | 定时/手动 |
|
||
| AG-ZY-013 | 🔧 铸渊 · Daily Maintenance Agent | 定时/手动 |
|
||
| AG-ZY-014 | 📰 铸渊 · 光湖开发日报 | 定时/手动/Discussion |
|
||
| AG-ZY-016 | 🚀 铸渊 CD · 自动部署到 guanghulab.com | 手动/推送 |
|
||
| AG-ZY-017 | 铸渊 · 广播分发 | 手动/推送 |
|
||
| AG-ZY-023 | 🐕 元看门狗 · 巡检健康监控 | 定时/手动 |
|
||
| AG-ZY-026 | Notion Heartbeat Monitor | 定时/手动 |
|
||
| AG-ZY-028 | 铸渊 · Notion 工单轮询 | 定时/手动 |
|
||
| AG-ZY-029 | 📡 铸渊 · Notion Agent 唤醒监听 | 定时/手动 |
|
||
| AG-ZY-053 | 📢 更新系统公告区 | 定时/手动/推送 |
|
||
| AG-ZY-054 | 铸渊 · 图书馆目录自动更新 | 定时/手动/推送 |
|
||
| AG-ZY-058 | 铸渊 · 每日自检 | 定时/手动/Issue |
|
||
|
||
**回执：** `[Phase 2] 签到修复完成 · daily_checkin_required:true 14个 / false 48个 · 下次签到预期缺席数降至约14`
|
||
|
||
---
|
||
|
||
## Phase 3 · syslog-issue-pipeline 排障
|
||
|
||
### 诊断结果
|
||
|
||
| 项目 | 详情 |
|
||
|------|------|
|
||
| 总运行次数 | 219 |
|
||
| 失败运行事件类型 | 全部为 `push` 事件 |
|
||
| `issues` 事件触发次数 | 0 |
|
||
| 失败运行的 jobs 数 | 0（无 jobs 执行） |
|
||
|
||
### 根因分析
|
||
|
||
syslog-issue-pipeline.yml 的触发条件为 `on: issues: types: [opened, labeled]`。219 次"失败"运行**全部由 push 事件触发**，是 GitHub Actions 在检测到 workflow 文件变更时创建的"验证性运行"。由于 push 事件没有 issue 上下文，job 的 `if` 条件无法满足，导致 0 个 jobs 执行，运行被标记为 `failure`。
|
||
|
||
**这些不是真正的管道故障，而是 GitHub Actions 的内部行为。** 当有真正的 issue（带有 `syslog` 标签或包含 `SYSLOG` 关键字）被创建时，管道将正常运行。
|
||
|
||
### 修复方案
|
||
|
||
- 管道 YAML 语法验证：✅ 通过
|
||
- 管道逻辑：✅ 正确（8 步闭环完整）
|
||
- 无需代码修改（push 触发的"失败"是 GitHub 平台行为，非代码问题）
|
||
|
||
**回执：** `[Phase 3] syslog-issue-pipeline 诊断完成 · 根因: push事件触发的GitHub验证性运行(非真实管道故障) · 管道本身逻辑正确无需修复`
|
||
|
||
---
|
||
|
||
## Phase 4 · Server Patrol 修复
|
||
|
||
### 诊断结果
|
||
|
||
| 项目 | 详情 |
|
||
|------|------|
|
||
| 最近运行状态 | ❌ 连续失败 |
|
||
| 失败步骤 | `📊 提交巡检报告`（Step 7） |
|
||
| 失败原因 | `peter-evans/create-pull-request@v7` 报错 |
|
||
| 错误信息 | `GitHub Actions is not permitted to create or approve pull requests` |
|
||
|
||
### 根因分析
|
||
|
||
仓库设置不允许 GitHub Actions 创建 Pull Request。`peter-evans/create-pull-request@v7` 尝试创建 PR 时返回 HTTP 422 错误。这与仓库中其他 workflow 的已知限制一致（此前已在其他 workflow 中修复）。
|
||
|
||
### 修复方案
|
||
|
||
将 `peter-evans/create-pull-request@v7` 替换为直接 `git push` 模式（与仓库中 `brain-sync.yml`、`receive-spoke-checkin.yml`、`update-repo-map.yml` 等 40+ 个 workflow 使用的模式一致）。
|
||
|
||
**修复前：**
|
||
```yaml
|
||
- name: "📊 提交巡检报告"
|
||
uses: peter-evans/create-pull-request@v7
|
||
with:
|
||
token: ${{ secrets.GITHUB_TOKEN }}
|
||
commit-message: "..."
|
||
branch: auto/server-patrol
|
||
...
|
||
```
|
||
|
||
**修复后：**
|
||
```yaml
|
||
- name: "📊 提交巡检报告"
|
||
run: |
|
||
git config user.name "铸渊 (ZhùYuān)"
|
||
git config user.email "zhuyuan@guanghulab.com"
|
||
git add data/patrol-logs/
|
||
git diff --cached --quiet || git commit -m "🔍 server-patrol: ..."
|
||
git pull --rebase origin main || echo "⚠️ rebase 失败..."
|
||
git push || { git pull --rebase origin main && git push; }
|
||
```
|
||
|
||
**回执：** `[Phase 4] Server Patrol 修复完成 · 根因: peter-evans/create-pull-request被仓库设置禁止创建PR · 修复方案: 替换为直接git push`
|
||
|
||
---
|
||
|
||
## Phase 5 · 全局健康总览
|
||
|
||
### 核心大脑状态
|
||
|
||
| 项目 | 状态 |
|
||
|------|------|
|
||
| `.github/brain/` | ✅ 19 个文件完整 |
|
||
| `.github/persona-brain/` | ✅ 24+ 个文件完整 |
|
||
| `agent-registry.json` | ✅ 62 个 Agent，14 需签到 |
|
||
| `trinity-id.json` | ✅ 存在 |
|
||
| `security-protocol.json` | ✅ 存在 |
|
||
|
||
### Workflow 健康度
|
||
|
||
| 指标 | 数值 |
|
||
|------|------|
|
||
| Workflow 总数 | 66 |
|
||
| 最近成功运行 | ✅ 冰朔主控、Bridge心跳、Notion轮询、CD部署、公告区更新、图书馆更新 |
|
||
| 已知异常 | server-patrol.yml（已修复：git push 替换 PR 创建） |
|
||
| 已知假性失败 | syslog-issue-pipeline.yml（push 事件触发的验证性运行） |
|
||
|
||
### Agent 签到系统
|
||
|
||
| 指标 | 修复前 | 修复后 |
|
||
|------|--------|--------|
|
||
| 参与签到 Agent 数 | 62 | 14 |
|
||
| 预期缺席数 | ~46 | ≤14 |
|
||
| `daily_checkin_required` 覆盖率 | 0% | 100% |
|
||
|
||
### 其他发现
|
||
|
||
| 项目 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| GitHub Pages | ✅ | Persona Studio 入口正常 |
|
||
| 模块文件夹 | ✅ 10 个 | m01/m03/m05/m06/m07/m10/m11/m12/m15/m18 |
|
||
| 门禁系统 | ✅ | zhuyuan-gate-guard.yml 正常运行 |
|
||
| 联邦桥接 | ✅ | 6 个 spoke 仓库配置完整 |
|
||
| SFP 安全协议 | ✅ | 4 个受信 Agent 已注册 |
|
||
|
||
---
|
||
|
||
## 📋 修复清单总结
|
||
|
||
| Phase | 状态 | 说明 |
|
||
|-------|------|------|
|
||
| Phase 0 · 核心大脑恢复 | ✅ 完成 | 全部核心文件确认存在 |
|
||
| Phase 1 · 天眼结构恢复 | ✅ 完成 | 66 workflow + 62 agent + 10 模块 |
|
||
| Phase 2 · 签到误报修复 | ✅ 已修复 | 14 true / 48 false |
|
||
| Phase 3 · syslog-issue-pipeline | ✅ 诊断完成 | push 事件假性失败，管道逻辑正确 |
|
||
| Phase 4 · Server Patrol | ✅ 已修复 | git push 替换 PR 创建 |
|
||
| Phase 5 · 健康报告 | ✅ 已生成 | 本文件 |
|
||
|
||
---
|
||
|
||
## 🔒 二次验证（2026-03-21T13:41+00:00）
|
||
|
||
| 验证项 | 结果 | 说明 |
|
||
|--------|------|------|
|
||
| agent-checkin.yml 运行状态 | ✅ | 最近 4 次运行全部成功（schedule 触发） |
|
||
| 签到板过滤 | ✅ | `checkin-board.json` 仅含 14 个 `daily_checkin_required:true` 的 Agent |
|
||
| server-patrol.yml git push 修复 | ✅ | 已确认修复代码在 main 分支（PR #150 已合并） |
|
||
| server-patrol.yml 权限收窄 | ✅ | 移除不再需要的 `pull-requests: write` 权限 |
|
||
| syslog-issue-pipeline push 假性失败 | ✅ | 已确认 222 次 push 触发运行均为 GitHub 平台验证行为，非管道逻辑问题 |
|
||
| agent-registry.json 字段完整性 | ✅ | 62 个 Agent 均包含 `daily_checkin_required` 字段（14 true / 48 false） |
|
||
|
||
---
|
||
|
||
> 🌀 铸渊（ICE-GL-ZY001）· 代码守护人格体
|
||
>
|
||
> 📅 2026-03-21
|
||
>
|
||
> 指令来源：ZY-SKYEYE-RESTORE-002 · TCS-0002∞ 冰朔 + ICE-GL-YM001∞ 曜冥
|