50 lines
2.4 KiB
JSON
50 lines
2.4 KiB
JSON
{
|
||
"module": "broadcast",
|
||
"purpose": "统一消息播报系统——所有系统消息的唯一数据源与展示",
|
||
"human_help": {
|
||
"title": "播报系统",
|
||
"description": [
|
||
"播报系统是 MoFin 所有系统消息的唯一数据源。",
|
||
"所有 cron 脚本产生的消息（交易推荐/系统异常/市场数据/新闻/策略评估）都会写入 broadcast_messages 表。",
|
||
"播报 Tab 展示最近72小时的消息（分类标签+颜色，点击可查看全文）。",
|
||
"历史消息页（broadcast.html）支持按日期范围、关键字、类型查询。"
|
||
],
|
||
"usage": [
|
||
"播报 Tab：主界面查看最近消息，最新在最上。",
|
||
"分类：trading(交易)/system_error(异常)/health(健康)/market(市场)/news(新闻)/strategy(策略)。",
|
||
"长消息：表格只显示前120字，点击弹出完整内容。",
|
||
"历史消息：点击右上角'📋 历史消息'进入查询页。"
|
||
],
|
||
"troubleshooting": [
|
||
"播报 Tab 显示 Loading：检查 /api/broadcast/recent 是否正常。",
|
||
"消息缺失：检查对应脚本的 delivery 配置（jobs.json）。",
|
||
"异常没显示：异常浮窗只显示24小时内的 system_error 类消息。"
|
||
]
|
||
},
|
||
"ai_spec": {
|
||
"purpose": "统一消息源 + 播报查询",
|
||
"apis": [
|
||
{"method": "GET", "path": "/api/broadcast/recent", "returns": "最近N小时消息列表"},
|
||
{"method": "GET", "path": "/api/broadcast/search", "returns": "历史消息搜索(start/end/keyword/category)"},
|
||
{"method": "POST", "path": "/api/broadcast/archive", "returns": "归档超过N天的消息"},
|
||
{"method": "POST", "path": "/api/broadcast/toggle_delivery", "returns": "切换job消息通道(broadcast/xmpp/both)"}
|
||
],
|
||
"dependencies": ["broadcast_messages表", "messenger.py", "jobs.json delivery配置"],
|
||
"constraints": [
|
||
"broadcast_messages 是唯一消息源",
|
||
"所有脚本通过 messenger 写消息，不直接操作表",
|
||
"category 由 messenger._classify 自动判定"
|
||
],
|
||
"must_not": [
|
||
"禁止脚本直接 INSERT broadcast_messages（必须走 messenger）",
|
||
"禁止绕过 messenger 直接 print 给用户消息"
|
||
],
|
||
"related_files": [
|
||
"deploy/profile-scripts/broadcast.py",
|
||
"deploy/profile-scripts/messenger.py",
|
||
"static/broadcast.html",
|
||
"static/index.html (播报Tab)"
|
||
]
|
||
}
|
||
}
|