From b8f6e611c09906ed064975719f4af8b0d380a56f Mon Sep 17 00:00:00 2001 From: xxm Date: Thu, 20 Aug 2026 07:44:25 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=BF=90=E7=BB=B4=E6=93=8D=E4=BD=9C?= =?UTF-8?q?=E7=B4=A2=E5=BC=95=E2=80=94=E2=80=94=E9=97=AE=E9=A2=98=E5=9C=BA?= =?UTF-8?q?=E6=99=AF=E2=86=92=E6=96=87=E6=A1=A3/=E5=91=BD=E4=BB=A4?= =?UTF-8?q?=E5=AE=9A=E4=BD=8D(=E6=94=B9=E8=B0=83=E5=BA=A6/=E6=9F=A5?= =?UTF-8?q?=E9=87=8D=E8=AF=84/=E6=95=B0=E6=8D=AE=E6=B5=81/=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=AF=BC=E8=88=AA)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/operations-index.md | 73 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 docs/operations-index.md diff --git a/docs/operations-index.md b/docs/operations-index.md new file mode 100644 index 00000000..dcde2f3f --- /dev/null +++ b/docs/operations-index.md @@ -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 + +# 批量重评持仓/自选（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) |