cat-shark
a5a1b848d0
LLM 无法可靠输出完整嵌套树 JSON（之前的 matchedTree）， 实际返回格式与预期不符导致前端对比展示异常。 修复： - prompt 要求 AI 只输出平铺列表：matches（匹配对）、missedTitles、 extraNodes、recallRatio、evaluation，不再要求输出树结构 - matches 中的 standardTitle 明确要求与标准导图逐字一致 - 用户消息末尾追加明确提示「请输出 JSON（只包含五个字段）」
lpt-ai
LPT 学习进度跟踪系统的独立 AI 服务。将 LLM 相关能力从 Java 主服务中剥离，便于独立迭代、增加安全层与沙箱。
能力
| 端点 | 方法 | 说明 |
|---|---|---|
/health |
GET | 健康检查，返回 LLM 可用状态 |
/ai/aggregate-report |
POST | 将学习残片聚合为学习报告 |
/ai/generate-mind-map |
POST | 从报告/残片生成思维导图大纲 |
快速开始
cp .env.example .env
# 编辑 .env，填入 LLM_API_KEY
npm install
npm run dev
未配置 LLM_API_KEY 时服务可启动，但 AI 端点返回 503，由调用方（Java 后端）降级到内置规则。
请求示例
curl -X POST http://localhost:5199/ai/aggregate-report \
-H "Content-Type: application/json" \
-d '{
"taskName": "Java 并发编程",
"expectation": "理解线程池核心参数",
"fragments": [
{"content": "corePoolSize 是核心线程数，即使空闲也不回收"},
{"content": "workQueue 满了之后才会创建超过 core 的线程"}
]
}'
架构位置
LPT 前端 (Vue) ──► LPT 后端 (Java/Spring Boot) ──► lpt-ai (TS/Fastify) ──► SiliconFlow API
Java 后端是唯一调用方；本服务不直接暴露给前端，不做鉴权（部署在内网）。
后续规划
- 输入内容安全过滤（Prompt 注入防护）
- 输出审核
- 多模型路由（按任务复杂度选择模型）
- 用量与成本监控
- SSE 流式输出