小宠营养师技术架构

小宠营养师技术架构 A architecture diagram generated by Archify. 小宠营养师应用与数据 宠物主人 · 对话 · 包装照 · 档案 · Architecture component 宠物主人 对话 · 包装照 · 档案 Vue 3 前端 · Pinia · Vite · SSE · 小宠营养师应用与数据 Vue 3 前端 Pinia · Vite · SSE FastAPI · JWT · multipart · SSE · 小宠营养师应用与数据 FastAPI JWT · multipart · SSE LangGraph ReAct · 理解 · 追问 · 调度 · 解释 · 小宠营养师应用与数据 · MAX_ITERATIONS = 8 LangGraph ReAct 理解 · 追问 · 调度 · 解释 MAX_ITERATIONS = 8 8 个 Agent 工具 · 档案 · OCR · 计算 · 报告 · 小宠营养师应用与数据 8 个 Agent 工具 档案 · OCR · 计算 · 报告 确定性营养引擎 · RER/MER · Ca:P · 约束 · 过敏原 · 小宠营养师应用与数据 · 纯 Python · 零 LLM 确定性营养引擎 RER/MER · Ca:P · 约束 · 过敏原 纯 Python · 零 LLM 可追溯规则数据 · USDA · AAFCO · 版本化规则 · 小宠营养师应用与数据 可追溯规则数据 USDA · AAFCO · 版本化规则 DeepSeek API · 工具选择与自然语言解释 · Architecture component DeepSeek API 工具选择与自然语言解释 Qwen3-VL · 包装保证成分 OCR · Architecture component Qwen3-VL 包装保证成分 OCR MySQL 8.0 · 用户 · 会话 · 宠物 · 长记忆 · 小宠营养师应用与数据 MySQL 8.0 用户 · 会话 · 宠物 · 长记忆 SQLite Checkpoint · 单 thread AgentState 快照 · 小宠营养师应用与数据 SQLite Checkpoint 单 thread AgentState 快照 对话 · 包装照 multipart + JWT · SSE AgentState 工具调用 结构化输入 读取规则与出处 ReAct 决策与解释 包装照 OCR 身份 · 会话 · 档案 thread 状态快照 Legend 前端 后端与运行时 数据与规则存储 外部模型服务

模型与计算边界

  • • DeepSeek 负责理解、调度和解释，不直接估算营养数值
  • • 纯 Python 引擎统一计算 RER/MER、Ca:P、疾病约束与过敏原

三层记忆

  • • MySQL 保存跨对话宠物档案与长期事实；SQLite 保存单 thread AgentState
  • • 消息超过 30 条时压缩早期历史，并保留最近 10 条原文

可靠性与隔离

  • • JWT require_user 强制鉴权，user_id 由 RunnableConfig 注入工具
  • • 119 项自动化测试覆盖引擎、工具和 Agent 流程