From 3c9fee6c14af9bac3f6aa88237e20c53d88da585 Mon Sep 17 00:00:00 2001 From: xxm Date: Sat, 22 Aug 2026 16:54:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=BA=A2=E7=BA=BF13=E2=80=94=E2=80=94?= =?UTF-8?q?=E8=82=A1=E7=A5=A8=E4=BB=A3=E7=A0=81=E6=98=AF=E5=94=AF=E4=B8=80?= =?UTF-8?q?=E6=9D=83=E5=A8=81=E6=A0=87=E8=AF=86,=E5=90=8D=E7=A7=B0?= =?UTF-8?q?=E5=8F=AA=E6=98=AF=E6=98=BE=E7=A4=BA=E5=B1=9E=E6=80=A7(?= =?UTF-8?q?=E7=A6=81=E6=AD=A2name=E5=8C=B9=E9=85=8D/join,name=E7=BC=BA?= =?UTF-8?q?=E5=A4=B1=E7=A6=81=E6=AD=A2=E7=94=A8code=E5=86=92=E5=85=85,?= =?UTF-8?q?=E5=8A=A3=E5=8C=96=E7=94=B1hygiene=E5=91=A8=E9=A2=91=E8=87=AA?= =?UTF-8?q?=E6=84=88)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/dev-spec.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/dev-spec.md b/docs/dev-spec.md index 18173d56..f3ad8a9b 100644 --- a/docs/dev-spec.md +++ b/docs/dev-spec.md @@ -26,6 +26,7 @@ 10. **监控查"活"不查"在"** — 健康检查必须验证**数据新鲜度**（DB 表 MAX(时间列)）而非"文件存在/进程存在"。文件 mtime、进程存活都不构成健康证据——数据 24h 不更新才是事故。禁止拿遗留文件的 mtime 当管道健康指标（"数据管道停滞14天"假警报的根因） 11. **批量 LLM 调用禁止走 hermes gateway agent 通道** — hermes gateway 的 `/v1/chat/completions` **不是透传**，是完整 agent 运行时：每个请求创建带工具（terminal/websearch/patch）的 agent 会话，可能螺旋几十轮、累积 150k+ token，客户端超时后服务端仍空转，重试会叠加新会话形成自我 DDoS（2026-07-21 603288 事件：单次重评螺旋 35 分钟、44 次 terminal 调用）。所有批量/脚本化 LLM 调用必须经 `llm_client.call_llm()`：**OCG 上游直连为主**（裸 completion，key 运行时从 hermes config.yaml 读取，不落盘），gateway 仅作应急兜底。新增 LLM 调用点一律复用 `llm_client`，禁止手写 HTTP 调用 12. **告警信噪比纪律** — 所有系统 XMPP 告警必须经 `alert_helper.notify()`，禁止直 POST :5805。两级通道：**ACTION**（买入信号/重点推荐/需人工核查）直通不限速、🚨 前缀独立成条，**永不被限速**；**INFO**（部署/卫生/修复/监控报备）同类 30 分钟限 1 条、≤8 行、24h 内容去重（同一问题不重复轰炸）。有意义的信号（重点推荐操作）绝不允许被纯通知淹没；通知型信息零问题 = 零消息（沉默即正常） +13. **股票代码是唯一权威标识，名称只是显示属性** — 任何匹配/join/去重/外键必须基于 `code`，禁止基于 `name`。名称随时可变：ST 加摘帽、XD/XR/DR 除权息标记（当日所有行情源的简称都被截断，拿不到干净名）、公司改名。写库时 name 缺失必须先查 stocks 已有真名、再腾讯 quote 兜底（`mofin_db.fetch_stock_name_tencent`），**禁止拿 code 冒充 name**；名称劣化由 `stock_name_hygiene` 周频任务自愈（2026-08-22 名称治理确立，当日审计确认全系统表结构/代码/前端均无 name 匹配点） ---