refactor: 客服agent的切片结构调整重构

2026-09-11 17:31:16 +08:00
parent b1b764eac9
commit e561c97a4e
20 changed files with 3309 additions and 230 deletions
@@ -54,7 +54,7 @@ uvicorn main:app --reload --port 8000
 - **异常路由**：业务抛 `ApiError` 子类，全局处理器转统一响应（400/401/403/404 保留 HTTP 状态码，1001+ 业务码返回 HTTP 200）。
 - **日志**：`logs/info.log`、`logs/error.log` 按天滚动，自动带 trace_id，身份证/手机号脱敏。
 - **四库职责**（开发计划 §1）：MySQL 业务 / Milvus 向量 / Neo4j 图谱 / Redis 缓存·会话·事件·锁。
- **LLM 统一客户端**（`tool/llm.py`）：`LLM_MODE=ollama | api` 双模式，底层均走 OpenAI 兼容 `/v1` 端点，业务只调 `chat(messages)` / `embed(texts)`。内置：指数退避重试（1s/2s/4s）、主模型失败自动切 `LLM_FALLBACK_CHAT_MODEL`、再失败抛 `LLMFailError`（§1001）由调用方兜底话术。自检：`python test_llm.py`。
+- **LLM 统一客户端**（`tool/llm.py`）：`LLM_MODE=auto | ollama | api`，底层均走 OpenAI 兼容 `/v1` 端点，业务只调 `chat(messages)` / `embed(texts)`。`auto`（默认）按 `.env` 填写情况组成后端链：本地 Ollama 优先，`LLM_API_KEY` 配齐则作为兜底。内置：指数退避重试（1s/2s/4s）、主模型失败自动切 `LLM_FALLBACK_CHAT_MODEL`、本地后端耗尽自动切 API 后端（embed 不跨后端，向量空间不兼容）、全部失败抛 `LLMFailError`（§1001）由调用方兜底话术。自检：`python test_llm.py`。
 - **数据访问**：service 不直接写 SQL，统一走 `repositories/`（会话经 `config.deps.get_db` 注入）；新表照 `repositories/sys_config.py` 复制一个仓储 + 一个 ORM 模型。
 - **JWT 鉴权**：`POST /api/auth/login`（username/password）签发 token（仅存 user_id+exp，HS256）；任意路由加 `Depends(get_current_user)`（`api/deps.py`）即自动校验 Bearer token → 按 user_id 回查 `sys_user` → 注入用户对象（401 无效/过期/不存在，403 禁用）。密码哈希用 stdlib PBKDF2（`service/auth.py`），SEED 测试用户可看 `test_auth.py`。生产务必替换 `JWT_SECRET`（≥32 字节）。