feat: introduce spec system + dashboard + health pipeline (AgentsMeeting template)

2026-07-19 10:50:34 +08:00
parent 81c6dd2314
commit 747fdfe467
19 changed files with 1826 additions and 0 deletions
@@ -0,0 +1,99 @@
+# MoFin — 部署指南
+
+> 版本: v1.0 | 部署目标: Linux 192.168.1.246
+
+---
+
+## 部署概览
+
+| 组件 | 守护方式 | 端口 | 说明 |
+|------|---------|------|------|
+| **server.py** | systemd `mofin-api` | 8899 | 持仓情报 API（已有，不动） |
+| **dashboard.py** | systemd `mofin-dashboard` | 5804 | 管理门户（新增） |
+| **health_check** | crontab `*/5 * * * *` | — | Tier1 健康检查（新增） |
+
+---
+
+## 1. Dashboard 部署
+
+### 1.1 创建 systemd 服务
+
+```bash
+sudo tee /etc/systemd/system/mofin-dashboard.service << 'EOF'
+[Unit]
+Description=MoFin Dashboard
+After=network.target
+
+[Service]
+Type=simple
+User=hmo
+WorkingDirectory=/home/hmo/MoFin
+Environment=MOFIN_ROOT=/home/hmo/MoFin
+ExecStart=/usr/bin/python3 /home/hmo/MoFin/dashboard.py
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
+EOF
+```
+
+### 1.2 启动
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now mofin-dashboard
+sudo systemctl status mofin-dashboard
+```
+
+### 1.3 验证
+
+```bash
+curl http://127.0.0.1:5804/api/health
+curl http://127.0.0.1:5804/api/services | python3 -m json.tool
+# 浏览器访问: http://192.168.1.246:5804
+```
+
+---
+
+## 2. 健康管线部署
+
+```bash
+# 添加到 crontab
+(crontab -l 2>/dev/null; echo '# MoFin health pipeline'; echo '*/5 * * * * cd /home/hmo/MoFin && /usr/bin/python3 agents_health_check.py >> gateway/logs/health_check_cron.log 2>&1') | crontab -
+
+# 验证
+crontab -l | grep health
+```
+
+---
+
+## 3. 防火墙
+
+```bash
+sudo ufw status | grep -E '8899|5804'
+# 如果未开放:
+# sudo ufw allow 5804/tcp
+```
+
+---
+
+## 4. 部署后验证清单
+
+- [ ] `curl http://127.0.0.1:5804/api/health` → `{"status":"ok"}`
+- [ ] `curl http://127.0.0.1:5804/api/services` → 返回 5 个服务状态
+- [ ] 浏览器打开 `http://192.168.1.246:5804` → Services Tab 显示服务状态
+- [ ] Dashboard F 健康 Tab → 定时任务状态显示正常
+- [ ] 点击各模块 ?§ 按钮 → 弹出 spec 帮助内容
+- [ ] `python3 agents_health_check.py` → 无输出（全正常）
+
+---
+
+## 5. 故障恢复
+
+| 问题 | 命令 |
+|------|------|
+| Dashboard 挂了 | `ssh hmo@246 'sudo systemctl restart mofin-dashboard'` |
+| 健康检查不运行 | `ssh hmo@246 'crontab -l \| grep health'` |
+| MoFin API 挂了 | `ssh hmo@246 'sudo systemctl restart mofin-api'` |
+| 知微 Gateway 挂了 | `ssh hmo@246 'sudo systemctl restart hermes-gateway@zhiwei'` |