---
description: 代码按功能分包，禁止不同职责堆进同一个上帝文件
alwaysApply: true
---

# 分模块，不要堆在一起

进程可以合并（一个 HTTP、一个 Worker），**源码必须按职责分包**。禁止往入口文件或 `util` 无限追加。

新功能先归包再写。单文件已含两类职责且明显膨胀：拆开，不要继续加。

| 包 | 只做什么 |
|---|---|
| 通道 | 企微/H5 验签解析、inbox/outbox |
| 路由 | DeepSeek A、RouteDecision |
| handlers | 一类意图一个文件 |
| graph | 节点分文件，禁止万行 `graph.py` |
| llm / jobs | 队列与槽，LibreOffice 单独槽 |
| 主账客户端 | 只打主账 API，不直连 TMS/MySQL |

跨包只走公开接口。现网 `graph.py` / `wecom_business.py` 类上帝文件：改动时拆出触及部分，禁止再往里堆新功能。