plan-sess_7f96803d-728b-42a3-ba40-6cd08853efbb.md 1.5 KB

拆分 api/routes.py 方案

将 917 行的单体文件按职责拆成 9 个独立模块 + 1 个路由组装入口。

新建 10 个文件

文件 职责 预计行数
api/models.py Pydantic 请求/响应模型 (4 个 class) ~35
api/prompts.py Fast 模式系统提示词 (2 个常量) ~60
api/chat_model.py LLM 模型实例缓存 _get_chat_model() ~75
api/sse_core.py SSE 核心工具: _cn_tool_desc, _sse_event_generator, _extract_text_content, _parse_todo_list, _clean_response ~180
api/fast_generators.py Fast 模式流式生成器: _fast_tun_sse_generator, _fast_device_sse_generator ~165
api/intent.py 意图分类: _classify_intent_by_agent() ~60
api/click_routes.py POST /interpret/click/tun + /device ~90
api/chat_routes.py POST /chat 统一对话入口 ~85
api/review_routes.py POST /vent/review/pdf ~35
api/session_routes.py GET /chat/history/, GET /sessions, DELETE /sessions/ ~55

修改 2 个文件

  • api/__init__.py: 重写为路由组装入口 — 创建主 Router,include_router() 所有子路由,export router
  • main.py 第 15 行: from api.routes import routerfrom api import router

删除 1 个文件

  • api/routes.py: 内容已全部迁出

不变项

  • 所有 API 路由路径、SSE 事件格式、请求/响应模型完全不变
  • 测试文件无需修改(注释中的 routes.py 引用后续可优化)