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,42 @@
+{
+  "module": "watchlist",
+  "version": "1.0",
+  "purpose": "自选股列表管理。提供自选股查询和批量更新。",
+
+  "human_help": {
+    "title": "自选股管理",
+    "description": [
+      "管理老爸的自选股列表，与持仓分开存储。",
+      "数据存储在 SQLite (mofin.db) 的 watchlist_stocks 表。",
+      "小果扫描器会消费自选股信号并自动添加到自选列表。"
+    ],
+    "usage": [
+      "GET /api/watchlist — 获取完整自选股列表",
+      "POST /api/update/watchlist — 批量更新自选股（由 cron 调用）"
+    ],
+    "troubleshooting": [
+      "数据库查询失败 → 检查 mofin.db 是否可读写",
+      "自选股列表为空 → 确认 regenerate_all 或手动添加过自选股"
+    ]
+  },
+
+  "ai_spec": {
+    "apis": [
+      {"method": "GET", "path": "/api/watchlist", "returns": "{stocks[{code, name, price, change_pct, currency, analysis{...}}]}"},
+      {"method": "POST", "path": "/api/update/watchlist", "returns": "{status:'ok'}"}
+    ],
+    "dependencies": [
+      "mo_data.py — read_watchlist()",
+      "mofin_db.py — query_watchlist(), write_watchlist_stock()",
+      "xiaoguo_signal_consumer.py — 消费小果信号，自动加自选"
+    ],
+    "constraints": [
+      "自选股也必须标注 currency 字段（HKD/CNY）"
+    ],
+    "related_files": [
+      "server.py — API 路由定义",
+      "mo_data.py — read_watchlist()",
+      "mofin_db.py — watchlist_stocks 表"
+    ]
+  }
+}