docs: 运维操作索引——问题场景→文档/命令定位(改调度/查重评/数据流/文档导航)

2026-08-20 07:44:25 +08:00
parent 50629f1b70
commit b8f6e611c0
1 changed files with 73 additions and 0 deletions
@@ -0,0 +1,73 @@
+# MoFin 运维操作索引（Operations Index）
+
+> **用途**：遇到运维问题时，先查这里定位"该看哪个文档 / 用什么命令 / 改哪里"。
+> 维护原则：新增运维场景时同步补充本表。
+
+---
+
+## 一、按问题场景查（最常见运维操作）
+
+| 问题 | 该做什么 | 关键文档/位置 |
+|------|---------|-------------|
+| **改定时任务时间** | 改 jobs.json 的 `schedule.expr`（只改这一处）| [scheduler-mechanism.md](scheduler-mechanism.md) |
+| **查某次重评是否跑了** | 看 `/tmp/mofin_premarket/summary.json`（盘前重评摘要）| [scheduler-mechanism.md](scheduler-mechanism.md) |
+| **查盘前 12 维 LLM 分析进度** | `tail -f /tmp/holdings_12d_daily.log` | scheduler-mechanism.md |
+| **查数据实体/数据流/多写方风险** | Dashboard → 🏥健康 → 🗃️数据实体/🔀数据流 | `mofin_health.py` |
+| **查策略参数是否被覆盖** | Dashboard 数据实体 Tab 看 holding_strategies 多写方 | 本索引 §三 |
+| **查某天温区** | `SELECT * FROM market_regime` | [data-flow-map-20260819.md](data-flow-map-20260819.md) |
+| **查系统健康** | Dashboard / `mofin_health.py` | 本节下方 |
+| **重评触发机制** | 4 类重评体系 | [methodology.md](research/methodology.md) §3.3b |
+
+---
+
+## 二、关键命令速查
+
+```bash
+# 改定时任务时间（例：8:10→7:10）
+# 编辑 ~/.hermes/profiles/position-analyst/cron/jobs.json
+#   "schedule": {"kind":"cron","expr":"10 7 * * 1-5","display":"..."}
+# 无需重启，调度器下次 tick 自动生效
+
+# 手动触发一次调度检查
+hermes_cli.main -p position-analyst cron tick
+
+# 查盘前重评结果
+cat /tmp/mofin_premarket/summary.json
+tail -f /tmp/holdings_12d_daily.log
+
+# 查数据实体/数据流（生成 mofin_health.json）
+python3 deploy/profile-scripts/mofin_health.py
+
+# 重评单只票（12维LLM）
+python3 deploy/profile-scripts/per_stock_reassess.py <code>
+
+# 批量重评持仓/自选（12维LLM, --today强制)
+python3 deploy/profile-scripts/batch_reassess.py --type holding --today
+python3 deploy/profile-scripts/batch_reassess.py --type watchlist --today
+
+# 备份数据库
+python3 /tmp/backup_mofin.py   # SQLite在线备份
+```
+
+---
+
+## 三、数据流安全（多写方风险）
+
+> holding_strategies 被 17 个模块写。**策略参数（entry/stop/tp/rr）只有 per_stock_12d/batch_12d/promote 能写**（白名单机制，mofin_db.py）。
+> 辅助模块（clean_watchlist/branch_scanner 等）无法覆写参数 → 参数交叉覆写已根治。
+> 详见 [data-flow-map-20260819.md](data-flow-map-20260819.md) + [cleansweep-20260819.md](cleansweep-20260819.md)
+
+---
+
+## 四、文档导航（什么问题查什么）
+
+| 你想了解 | 看 |
+|---------|-----|
+| 系统全貌/数据流 | [data-flow-map-20260819.md](data-flow-map-20260819.md) |
+| 大扫除/架构治理 | [cleansweep-20260819.md](cleansweep-20260819.md) |
+| 4 类重评体系 | [methodology.md](research/methodology.md) §3.3b |
+| 调度机制/改时间 | [scheduler-mechanism.md](scheduler-mechanism.md) |
+| 数据模型 | [portfolio-data-model.md](portfolio-data-model.md) |
+| 开发规范 | [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) |
+| 版本变更 | [VERSIONS.md](VERSIONS.md) |
+| 完整目录 | [INDEX.md](INDEX.md) |