diff --git a/README.md b/README.md index b56140b..80fb0e4 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,18 @@ ## 快速开始 -### 平台操作 +### Linux（生产环境 192.168.1.246） + +```bash +# Dashboard — 管理门户 +ssh hmo@192.168.1.246 "sudo systemctl status agentsmeeting-dashboard" +# 访问: http://192.168.1.246:5803 + +# 健康管线 — 自动监控+修复 +ssh hmo@192.168.1.246 "crontab -l | grep -E 'health|auto_heal'" +``` + +### Windows（192.168.1.16） ```powershell # Windows — 一键启动所有服务 @@ -124,13 +135,16 @@ AgentsMeeting/ ## 监控 -| 组件 | 方式 | 频率 | -|------|------|------| -| 管理门户 | dashboard.py + Web UI (:5803) | 实时轮询 5s | -| xmpp Agent Bot | watchdog (xmpp_watchdog.py) | 30s | -| xmpp Agent 消息流 | health_check_xxm.py | 5min (scheduled task) | -| wechat_agent | 内置看门狗 | 120s | -| 日志 | `logs/health_check.log` | 人工查看 | +| 组件 | 方式 | 频率 | 位置 | +|------|------|------|------| +| 管理门户 | dashboard.py + Web UI (:5803) | 实时轮询 5s | Linux 246 | +| Tier1 快速检查 | agents_health_check.py | 5min (crontab) | Linux 246 | +| Tier2 每日检查 | agents_daily_health.py | 每天 08:00 (crontab) | Linux 246 | +| TODO 自修复 | self_todo_executor.py | 10min (crontab) | Linux 246 | +| auto_heal | auto_heal.py | 5min (crontab) | Linux 246 | +| xmpp Agent Bot | watchdog (xmpp_watchdog.py) | 30s | Windows 16 | + +> 详见 `docs/HEALTH-PIPELINE.md`、`docs/OPS.md`、`docs/DASHBOARD.md` --- diff --git a/docs/DASHBOARD.md b/docs/DASHBOARD.md new file mode 100644 index 0000000..6461ca0 --- /dev/null +++ b/docs/DASHBOARD.md @@ -0,0 +1,119 @@ +# AgentsMeeting — Dashboard 架构 + +> 版本: v1.0 | 部署: Linux 246 :5803 | 入口: http://192.168.1.246:5803 + +--- + +## Tab 结构 + +``` +AgentsMeeting Dashboard +├── Agents — Agent 状态总览（在线/离线/消息量） +├── Kanban — 看板任务管理 +├── Infrastructure — 平台服务 + EasyTier VPN + RDP + OpenCode Usage +└── 开发原则 + ├── G 规范 — 开发规范 / Spec 文档（dev-spec.md） + ├── K 测试 — 测试报告（Tier1/Tier2） + ├── F 健康 — 系统健康监控（三层管线） + └── H 需求 — 产品需求文档（PRD.md） +``` + +--- + +## API 端点清单 + +### Agent 管理 + +| 方法 | 路径 | 说明 | +|------|------|------| +| GET | `/api/agents` | 所有 Agent 列表（状态/平台/JID/消息量） | +| GET | `/api/agents//logs?lines=50` | Agent 实时日志 | +| POST | `/api/agents//start` | 启动 Agent | +| POST | `/api/agents//stop` | 停止 Agent | +| POST | `/api/agents//restart` | 重启 Agent | + +### 服务监控 + +| 方法 | 路径 | 说明 | +|------|------|------| +| GET | `/api/services` | 所有注册服务状态（health ok/端口可达） | +| GET | `/api/expected` | 期望状态矩阵（含 key/spec/check 方式） | +| GET | `/api/monitor` | 聚合监控数据（tasks + Tier1 + Tier2） | +| GET | `/api/autoheal` | 最近一次自动修复记录 | +| GET | `/api/health` | Dashboard 自身健康检查 | +| GET | `/api/module-spec/` | 读取 specs/{module}.json | + +### 基础设施 + +| 方法 | 路径 | 说明 | +|------|------|------| +| GET | `/api/platform` | 平台服务状态（xmpp_bot/article_processor 等） | +| GET | `/api/ejabberd` | ejabberd XMPP 服务器状态（在线用户列表） | +| GET | `/api/easytier` | EasyTier VPN 状态（各节点连通性） | +| POST | `/api/easytier/toggle` | EasyTier 开关 | +| GET | `/api/rdp` | RDP 远程桌面隧道状态 | +| POST | `/api/rdp/toggle` | RDP 隧道开关 | +| GET | `/api/usage` | OpenCode Go API 额度监控 | +| POST | `/api/usage/refresh` | 触发额度数据采集 | + +### 知识管理 + +| 方法 | 路径 | 说明 | +|------|------|------| +| GET | `/api/kanban` | 看板任务列表 | +| GET | `/api/spec` | 开发规范文档（dev-spec.md 渲染） | +| GET | `/api/spec/history` | 规范文档 Git 历史 | +| GET | `/api/tests` | 测试报告（Tier1/Tier2） | +| GET | `/api/prd` | 产品需求文档（PRD.md 渲染） | +| GET | `/api/prd/history` | PRD 文档 Git 历史 | + +--- + +## 前端架构 + +### 技术栈 +- 纯 HTML/CSS/JS（无框架） +- 深色主题（GitHub Dark 风格） +- 5 秒自动轮询（Agents / Infra 页） + +### Spec 系统（?§ 按钮） + +每个有 spec 的模块在 UI 上显示两个按钮： +- `?` → 调用 `showModuleHelp(module, 'human')` → 读取 `human_help` → 人类可读的帮助文档 +- `§` → 调用 `showModuleHelp(module, 'ai')` → 读取 `ai_spec` → AI 可用的接口/约束/依赖 + +**Spec 文件位置**: `gateway/scripts/specs/{module}.json` +**API 端点**: `GET /api/module-spec/{module}` → 直接返回 JSON 文件内容 + +### F Tab 渲染逻辑 + +三层结构： +1. **系统概览** — 总健康状态 + 关键异常数 + T1 通过率 +2. **异常服务** — critical 服务中实际状态异常的列表 +3. **全部服务** — 按层分组（通信层 → AI网关 → 辅助服务），每项含 ?§ 按钮 + +定时任务单独渲染（从 `/api/monitor.tasks`），状态映射： +- `cron_ok` → 绿色 "正常" +- `not_deployed` → 黄色 "未部署" +- 其他 → 红色 "异常" + +自动修复记录从 `/api/autoheal` 读取最近一次修复动作。 + +--- + +## 数据流 + +``` +crontab (每 5 分钟) + ├── agents_health_check.py → last_health_check.json + ├── auto_heal.py → last_auto_heal.json + └── agents_daily_health.py → last_daily_health.json (每天) + +Dashboard (:5803) + ├── /api/monitor ← 聚合读取以上 JSON 文件 + └── /api/services ← 实时 TCP/HTTP 检测 + +前端 (dashboard.html) + ├── 5s 轮询 /api/services + /api/expected + └── 按需请求 /api/monitor（F Tab 打开时） +``` diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index c06d0a5..e6250db 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -1,6 +1,6 @@ # AgentsMeeting — 部署指南 -> 版本: v2.0 | 日期: 2026-06-12 +> 版本: v2.1 | 日期: 2026-07-19 --- @@ -9,11 +9,14 @@ | 组件 | 平台 | 守护 | 端口 | |------|------|------|------| | **Dashboard** | Linux (192.168.1.246) | systemd `agentsmeeting-dashboard` | 5803 | +| **health_check (Tier1)** | Linux (192.168.1.246) | crontab `*/5 * * * *` | — | +| **daily_health (Tier2)** | Linux (192.168.1.246) | crontab `0 8 * * *` | — | +| **todo_executor** | Linux (192.168.1.246) | crontab `*/10 * * * *` | — | +| **auto_heal** | Linux (192.168.1.246) | crontab `*/5 * * * *` | — | | **xmpp_bot (xxm)** | Windows (192.168.1.16) | watchdog (30s) | 5802 | | **wechat_agent** | Windows (192.168.1.16) | 内置看门狗 | 5801, 19088 | | **api_proxy** | Windows (192.168.1.16) | watchdog | 8787 | | **watchdog** | Windows (192.168.1.16) | 自身 | — | -| **health_check** | Windows (192.168.1.16) | Task Scheduler | — | | **ejabberd** | Linux Docker (192.168.1.246) | Docker restart policy | 5222 | | **hermes-gateway** | Linux (192.168.1.246) | systemd | 8642, 8643, 8645 | | **mohe/xiaoguo/zhiwei bots** | Linux/Mac | systemd | — | @@ -43,7 +46,20 @@ docker compose restart docker exec ejabberd ejabberdctl connected_users ``` -### 1.3 防火墙 +### 1.3 健康监控管线 + +```bash +# 添加到 crontab +(crontab -l 2>/dev/null; echo '# AgentsMeeting health pipeline'; echo '*/5 * * * * cd /home/hmo/AgentsMeeting/gateway/scripts && /usr/bin/python3 agents_health_check.py >> ../logs/health_check.log 2>&1'; echo '0 8 * * * cd /home/hmo/AgentsMeeting/gateway/scripts && /usr/bin/python3 agents_daily_health.py >> ../logs/daily_health.log 2>&1'; echo '*/10 * * * * cd /home/hmo/AgentsMeeting/gateway/scripts && /usr/bin/python3 self_todo_executor.py >> ../logs/todo_executor.log 2>&1') | crontab - + +# 验证 +crontab -l | grep health +python3 gateway/scripts/agents_health_check.py # 手动跑一次，无输出=全正常 +``` + +> 详见 `docs/HEALTH-PIPELINE.md` + +### 1.4 防火墙 ```bash sudo ufw status | grep -E '5803|5802' @@ -67,7 +83,7 @@ cd D:\F\NewI\opencode\daily-workspace\projects\AgentsMeeting powershell -File deploy\windows\start.ps1 ``` -自动完成：停止旧进程 → api_proxy → wechat_agent → xmpp_bot → watchdog → health_check 定时任务 +自动完成：停止旧进程 → api_proxy → wechat_agent → xmpp_bot → watchdog ### 2.3 验证 diff --git a/docs/HEALTH-PIPELINE.md b/docs/HEALTH-PIPELINE.md new file mode 100644 index 0000000..f7191ae --- /dev/null +++ b/docs/HEALTH-PIPELINE.md @@ -0,0 +1,169 @@ +# AgentsMeeting — 健康监控管线 + +> 版本: v1.0 | 部署目标: Linux 246 + +--- + +## 概述 + +三层监控 + 两级自修复，零人工干预。所有组件在 246 上运行，通过 crontab 调度。 + +``` + ┌─────────────────────────────────┐ + │ Dashboard F Tab │ + │ /api/monitor 聚合展示 │ + └──────────┬──────────────────────┘ + │ 读取报告文件 + ┌──────────────────────┼──────────────────────┐ + │ │ │ + ┌────▼─────┐ ┌────▼─────┐ ┌─────▼────┐ + │ Tier 1 │ │ Tier 2 │ │ 自动修复 │ + │ 每 5 分钟 │ │ 每天 8:00│ │ 双引擎 │ + └────┬─────┘ └────┬─────┘ └─────┬────┘ + │ │ │ + agents_health_check agents_daily_health auto_heal (Linux侧) + │ │ self_todo_executor + │ │ │ + ┌────▼─────┐ ┌────▼─────┐ ┌─────▼────┐ + │ 端口+HTTP │ │ 端口+HTTP │ │ systectl │ + │ 6 个服务 │ │ +磁盘+cron│ │ restart │ + │ │ │ +看门狗 │ │ docker │ + └────┬─────┘ └────┬─────┘ │ restart │ + │ 异常→TODO │ 异常→建议 └──────────┘ + ┌────▼─────┐ + │ TODO 文件 │ + │ .jsonl │ + └──────────┘ +``` + +--- + +## Tier 1: 快速健康检查（每 5 分钟） + +**脚本**: `gateway/scripts/agents_health_check.py` +**调度**: `crontab: */5 * * * *` + +**检查内容**: +- 6 个服务：dashboard、hermes_gateway_mohe、hermes_gateway_zhiwei、wechat_bridge、xmpp_bot_xxm、article_processor +- 检查方式：socket 端口连接 + HTTP /health 端点 +- 本机服务用 `127.0.0.1`，远程服务用实际 IP + 更长超时 +- 全正常时静默（不输出、不写日志） + +**异常处理**: +- 写入 `gateway/temp/health_todos.jsonl` +- 每条 TODO 包含：服务名、失败原因、时间戳 +- 写入 `gateway/temp/last_health_check.json` 供 Dashboard 读取 + +**日志**: `gateway/logs/health_check_report.log` +**报告**: `gateway/temp/last_health_check.json` + +--- + +## Tier 2: 每日全面检查（每天 08:00） + +**脚本**: `gateway/scripts/agents_daily_health.py` +**调度**: `crontab: 0 8 * * *` + +**在 Tier 1 基础上增加**: +- 磁盘空间检查（`shutil.disk_usage`，阈值 10G 警告 / 2G 严重） +- crontab 存活检查（验证关键定时任务是否在 crontab 中） +- 看门狗日志新鲜度（超过 1 小时未更新 → 告警） +- 生成结构化 JSON 报告 + 人类可读日志 + +**输出**: +- `gateway/temp/last_daily_health.json` — JSON 报告 +- `gateway/logs/daily_health_report.log` — 人类可读日志 + +--- + +## 自动修复：双引擎 + +### 引擎 A: auto_heal（Linux 侧，每 5 分钟） + +**脚本**: `gateway/scripts/auto_heal.py` +**调度**: `crontab: */5 * * * *` + +**工作原理**: +1. 调用 Dashboard `/api/expected` 获取所有 critical 服务的期望状态 +2. 对实际状态为异常且 host 为本机（`is_local_host()`）的服务执行修复 +3. 通过 `SERVICE_UNIT_MAP` 查找对应的 systemd 单元并 `systemctl restart` +4. Docker 容器通过 `DOCKER_MAP` 映射后用 `docker restart` +5. 记录修复动作到 `gateway/temp/last_auto_heal.json` + +**可修复的服务**: + +| 服务 | 修复命令 | +|------|---------| +| hermes_gateway_mohe | `systemctl restart hermes-gateway@mohe` | +| hermes_gateway_zhiwei | `systemctl restart hermes-gateway@zhiwei` | +| dashboard | `systemctl restart agentsmeeting-dashboard` | +| wechat_bridge | `docker restart wxBotWebhook` | + +**不可修复（远程服务）**: `xmpp_bot_xxm`（Windows）、`article_processor`（Windows） + +### 引擎 B: self_todo_executor（每 10 分钟） + +**脚本**: `gateway/scripts/self_todo_executor.py` +**调度**: `crontab: */10 * * * *` + +**工作原理**: +1. 读取 `health_todos.jsonl` 中 status=pending 的条目 +2. 通过 `FIX_MAP` 查找对应修复命令并执行 +3. 成功 → 标记 completed +4. 失败 → 标记 failed +5. "already running" 错误 → 标记 completed（服务已在运行） + +**与 auto_heal 的分工**: +- `auto_heal` 从 Dashboard API 视角出发，修复本机服务（systemd/docker） +- `self_todo_executor` 从 Tier 1 检查视角出发，消费 TODO 文件 +- 两者互补，auto_heal 负责 Linux 本机，executor 也能处理跨机场景 + +--- + +## Dashboard 集成 + +### /api/monitor 端点 + +聚合展示三层数据： + +```json +{ + "tasks": [ + {"name": "agents-health-check", "status": "cron_ok"}, + {"name": "agents-daily-health", "status": "cron_ok"}, + {"name": "agents-todo-executor", "status": "cron_ok"} + ], + "tier1": { "services": [...], "summary": {"ok": 6, "total": 6} }, + "tier2": { "services": [...], "summary": {"ok": 6, "total": 6} } +} +``` + +### F Tab 展示 + +- **Layer 1**: 系统概览（服务数、异常数、T1 监控通过率） +- **Layer 2**: 异常服务列表（影响描述 + 状态） +- **Layer 3**: 全部服务按层级排列（通信层 / AI网关 / 辅助服务） +- **定时任务**: 三个 crontab 任务状态（绿色=正常） +- **自动修复记录**: auto_heal 最近一次修复动作 + +--- + +## 如何新增监控 + +1. **添加服务到 Tier 1** — 编辑 `agents_health_check.py` 的 `SERVICES` 列表 +2. **添加服务到 Tier 2** — 编辑 `agents_daily_health.py` 的 `SERVICES` 列表 +3. **添加修复命令** — 在 `auto_heal.py` 的 `SERVICE_UNIT_MAP` 和 `self_todo_executor.py` 的 `FIX_MAP` 中增加映射 +4. **更新 Dashboard** — 在 `dashboard.py` 的 `/api/expected` 中添加检查条目 +5. **写 Spec** — 在 `gateway/scripts/specs/` 创建 `{module}.json` + +--- + +## 故障排查 + +| 现象 | 检查 | +|------|------| +| 任务显示"未部署" | `crontab -l \| grep health` 确认条目存在 | +| Tier1 无数据 | 检查 `gateway/temp/last_health_check.json` 是否存在 | +| TODO 堆积不减少 | 检查 `self_todo_executor.py` 是否在 crontab 中 | +| 修复失败 | 查看 `gateway/logs/todo_executor.log` | +| auto_heal 不工作 | 查看 `gateway/logs/auto_heal.log` | diff --git a/docs/OPS.md b/docs/OPS.md index a7499dc..ff204dc 100644 --- a/docs/OPS.md +++ b/docs/OPS.md @@ -1,6 +1,6 @@ # AgentsMeeting — 运维手册 -> 版本: v2.0 | 日期: 2026-06-12 +> 版本: v2.1 | 日期: 2026-07-19 --- @@ -38,10 +38,16 @@ Dashboard (:5803, Linux) │ ├── Docker exec ejabberdctl → 在线 JID 列表（跨平台权威） ├── GET 192.168.1.16:5802/health → xmpp_bot XMPP 连接状态 - ├── GET 192.168.1.16:5801/health → wechat_agent hermes 连接状态 - └── TCP connect 192.168.1.16:8787 → api_proxy 端口可达性 + ├── GET 192.168.1.16:5810/health → article_processor 文章抓取服务 + └── crontab 定时管线 + ├── */5 agents_health_check.py → Tier1 快速检查 + ├── 0 8 agents_daily_health.py → Tier2 每日全面检查 + ├── */10 self_todo_executor.py → TODO 自修复 + └── */5 auto_heal.py → systemd/docker 自动重启 ``` +> 详见 `docs/HEALTH-PIPELINE.md` + --- ## systemd 服务（Linux） @@ -49,38 +55,43 @@ Dashboard (:5803, Linux) | 服务 | 命令 | |------|------| | agentsmeeting-dashboard | `systemctl status/restart agentsmeeting-dashboard` | -| hermes-gateway@main | `systemctl status hermes-gateway@main` | +| hermes-gateway@mohe | `systemctl status hermes-gateway@mohe` | | hermes-gateway@zhiwei | `systemctl status hermes-gateway@zhiwei` | -| hermes-gateway@xiaoguo | `systemctl status hermes-gateway@xiaoguo` | -| xmpp-bot-mohe | `systemctl status xmpp-bot-mohe` | -| xmpp-bot-zhiwei | `systemctl status xmpp-bot-zhiwei` | + +**Docker 服务**: `docker restart wxBotWebhook`（微信桥接）、`docker compose restart`（ejabberd） --- ## 健康端点 -| 服务 | URL | 含义 | -|------|-----|------| -| xmpp_bot | `GET :5802/health` | `xmpp_connected` = XMPP 是否在线 | -| wechat_agent | `GET :5801/health` | `hermes_connected` = 到莫荷 gateway 是否通 | -| Dashboard | `GET :5803/api/health` | Dashboard 自身是否正常 | -| Dashboard | `GET :5803/api/ejabberd` | ejabberd 在线用户列表 | -| Dashboard | `GET :5803/api/platform` | 平台服务状态 | - ---- +| 端点 | 说明 | +|------|------| +| `GET :5803/api/health` | Dashboard 自身健康 | +| `GET :5803/api/services` | 所有注册服务实时状态 | +| `GET :5803/api/expected` | 期望状态矩阵（含 key/spec） | +| `GET :5803/api/monitor` | 聚合监控（tasks + Tier1 + Tier2） | +| `GET :5803/api/autoheal` | 最近自动修复记录 | +| `GET :5803/api/ejabberd` | ejabberd 在线用户列表 | +| `GET :5803/api/platform` | 平台服务状态 | +| `gateway/temp/last_health_check.json` | Tier1 报告文件 | +| `gateway/temp/last_daily_health.json` | Tier2 报告文件 | ## 日志位置 -| 日志 | Windows 路径 | 用途 | -|------|-------------|------| -| xmpp_bot.log | `gateway\logs\` | bot 连接/消息/HTTP 桥 | -| bridge.log | `gateway\logs\` | LLM API 调用 | -| watchdog.log | `gateway\logs\` | 看门狗启停 | -| health_check.log | `gateway\logs\` | 5 分钟健康检查 | -| dashboard.log | `gateway\logs\` | Dashboard 运行日志 | -| mohe_inbox.log | `gateway\logs\` | 莫荷消息记录 | +| 日志 | 路径（Linux 246） | 用途 | +|------|-------------------|------| +| health_check.log | `gateway/logs/` | Tier1 健康检查 | +| daily_health.log | `gateway/logs/` | Tier2 每日检查 | +| auto_heal.log | `gateway/logs/` | 自动修复引擎 | +| todo_executor.log | `gateway/logs/` | TODO 自修复执行器 | +| dashboard | `sudo journalctl -u agentsmeeting-dashboard -f` | Dashboard 运行日志 | -Linux Dashboard 日志：`sudo journalctl -u agentsmeeting-dashboard -f` +**Windows 端日志**（192.168.1.16）: + +| 日志 | 路径 | 用途 | +|------|------|------| +| xmpp_bot.log | `gateway\logs\` | bot 连接/消息 | +| watchdog.log | `gateway\logs\` | 看门狗启停 | --- diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md index 0bf47a7..89e4b5a 100644 --- a/docs/QUICKSTART.md +++ b/docs/QUICKSTART.md @@ -1,45 +1,81 @@ # AgentsMeeting — 快速操作手册 -## 每天例行 +> 生产环境: Linux 192.168.1.246 | 所有运维操作在此执行 + +--- + +## 日常检查 + +```bash +# 打开 Dashboard 看全局 +http://192.168.1.246:5803 + +# 命令行快速状态 +ssh hmo@192.168.1.246 "curl -s http://127.0.0.1:5803/api/monitor | python3 -m json.tool | head -20" +``` + +--- + +## Dashboard 重启 + +```bash +ssh hmo@192.168.1.246 "cd ~/AgentsMeeting && git pull --rebase && sudo systemctl restart agentsmeeting-dashboard" +``` + +--- + +## 健康管线检查 + +```bash +# 查定时任务状态 +ssh hmo@192.168.1.246 "crontab -l | grep -E 'health|todo|auto_heal'" + +# 查看最近健康报告 +ssh hmo@192.168.1.246 "cat ~/AgentsMeeting/gateway/temp/last_health_check.json | python3 -m json.tool" + +# 手动跑一次健康检查（无输出 = 全正常） +ssh hmo@192.168.1.246 "cd ~/AgentsMeeting/gateway/scripts && /usr/bin/python3 agents_health_check.py" + +# 查看自动修复日志 +ssh hmo@192.168.1.246 "tail -20 ~/AgentsMeeting/gateway/logs/auto_heal.log" +``` + +--- + +## Gateway 重启 + +```bash +# 莫荷 +ssh hmo@192.168.1.246 "sudo systemctl restart hermes-gateway@mohe" + +# 知微 +ssh hmo@192.168.1.246 "sudo systemctl restart hermes-gateway@zhiwei" + +# 验证 +ssh hmo@192.168.1.246 "curl -s http://127.0.0.1:8642/v1/health && curl -s http://127.0.0.1:8643/v1/health" +``` + +--- + +## Windows 端（192.168.1.16） + +Windows 上的 xmpp_bot / article_processor 由 Windows 看门狗守护，通常不需要手动干预。 +Dashboard 通过 HTTP 跨网监控这些服务。 ```powershell -# 查状态 +# Windows 本机操作 cd D:\F\NewI\opencode\daily-workspace\projects\AgentsMeeting -powershell -File deploy\windows\check.ps1 +powershell -File deploy\windows\check.ps1 # 查状态 +powershell -File deploy\windows\start.ps1 # 启动全套 ``` -## 查看群消息（不离开 TUI） +--- -```powershell -# 查 mohe 说了什么 -uv run python -c "import json,urllib.request; d=json.loads(urllib.request.urlopen('http://127.0.0.1:5802/messages?from=mohe').read()); [print(f\"{m['ts']} [{m['from']}] {m['body'][:200]}\") for m in d['messages']]" -``` +## 常见问题 -## 发消息到群里 - -```powershell -# 给 mohe 发消息 -$body = @{message="这里是消息内容"} | ConvertTo-Json -Compress -Invoke-RestMethod "http://127.0.0.1:5802/send" -Method POST -Body $body -ContentType "application/json" -``` - -## Bot 无响应 - -```powershell -# 强制重启 -Stop-Process -Name python* -Force -Start-Process -WindowStyle Hidden -FilePath "C:\Users\hmo\AppData\Local\Programs\Python\Python310\python.exe" ` - -ArgumentList "D:\F\NewI\opencode\daily-workspace\projects\wechat-hermes-gateway\scripts\xmpp_bot.py" -``` - -## 启动全套服务 - -```powershell -powershell -File deploy\windows\start.ps1 -``` - -## 健康检查日志 - -```powershell -Get-Content "D:\F\NewI\opencode\daily-workspace\projects\wechat-hermes-gateway\logs\health_check.log" -Tail 5 -``` +| 现象 | 操作 | +|------|------| +| F Tab 定时任务显示"未部署" | `ssh hmo@246 crontab -l \| grep health` — 确认条目存在 | +| Dashboard 不响应 | `ssh hmo@246 sudo systemctl restart agentsmeeting-dashboard` | +| auto_heal 不修复 | `ssh hmo@246 tail ~/AgentsMeeting/gateway/logs/auto_heal.log` | +| TODO 堆积 | `ssh hmo@246 cd ~/AgentsMeeting/gateway/scripts && python3 self_todo_executor.py` |