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,48 @@
+{
+  "module": "evaluation",
+  "version": "1.0",
+  "purpose": "策略评估系统。提供策略双维度评估结果查询、手动触发评估和准确率统计。",
+
+  "human_help": {
+    "title": "策略评估",
+    "description": [
+      "评估每只股票策略的有效性，来自 strategy_evaluator.py（每周六 21:00 自动运行）。",
+      "支持手动触发评估（POST /api/evaluation/trigger）。",
+      "评估数据主源为 evaluation.json，备选为 decisions.json 中的 evaluation 字段。"
+    ],
+    "usage": [
+      "GET /api/evaluation — 获取全部策略评估结果",
+      "POST /api/evaluation/trigger — 手动触发策略评估（执行 strategy_evaluator.py）",
+      "GET /api/stats/accuracy — 获取准确率统计数据",
+      "GET /api/feedback — 获取策略反馈数据"
+    ],
+    "troubleshooting": [
+      "评估数据为空 → 确认 strategy_evaluator.py 已运行过",
+      "触发失败 → 检查 strategy_evaluator.py 路径是否正确"
+    ]
+  },
+
+  "ai_spec": {
+    "apis": [
+      {"method": "GET", "path": "/api/evaluation", "returns": "[{code, name, type, current, evaluations[{date, dimension, score, reason}]}]"},
+      {"method": "POST", "path": "/api/evaluation/trigger", "returns": "{status:'ok', output, error} — 执行 strategy_evaluator.py，timeout 60s"},
+      {"method": "GET", "path": "/api/stats/accuracy", "returns": "accuracy_stats.json 内容"},
+      {"method": "GET", "path": "/api/feedback", "returns": "strategy_feedback.json 内容"}
+    ],
+    "dependencies": [
+      "strategy_evaluator.py — 双维度评估脚本（cron: 周六 21:00）",
+      "evaluation.json — 评估结果主数据源",
+      "accuracy_stats.json — 准确率统计",
+      "strategy_feedback.json — 反馈数据"
+    ],
+    "constraints": [
+      "POST /api/evaluation/trigger 会阻塞最多 60 秒",
+      "评估数据优先读 evaluation.json，fallback 读 decisions.json 的 evaluation 字段"
+    ],
+    "related_files": [
+      "server.py — /api/evaluation, /api/evaluation/trigger, /api/stats/accuracy, /api/feedback",
+      "strategy_evaluator.py",
+      "strategy_feedback.py"
+    ]
+  }
+}