[优化] 工具整理

2026-10-02 14:56:38 +08:00 · 2026-03-14 15:03:05 +08:00
parent f1476610f6
commit 605a70b428
26 changed files with 316 additions and 240 deletions
@@ -71,13 +71,15 @@
 * `model/`：模型定义与持久化
 * `router/`：路由注册
 * `middleware/`：认证、鉴权、限流等横切逻辑
-* `common/`：配置与通用工具
+* `common/`：配置、全局运行时状态与初始化入口
+* `utils/`：纯工具函数与通用 helper；按功能聚合，多个同类 helper 应拆到对应子目录

 禁止：

 * 在 `controller/` 堆积业务逻辑
 * 在 `middleware/` 中实现业务流程
 * 为简单需求新增平台层抽象
+* 在 `common/` 混放不依赖全局状态的纯工具实现

 ### 3.2 Agent