校园智能知识库 · 中间服务
教师端对接：登录 → 上传文档 → AI 问答 · 服务在线
接口入口
| 功能 | 接口 | 说明 |
|---|
| 接口文档 | /docs | Swagger UI（可视化调试） |
| 健康检查 | GET /api/health | 服务状态探测 |
| 登录 | POST /api/auth/login | 账号密码换取 token（教师端对接第一步） |
| 上传原始文件 | POST /api/docs/upload | multipart 上传；同名同库自动覆盖更新并触发起解析 |
| 上传正文文本 | POST /api/docs/upload-text | 纯 JSON 文本（WPS 插件「一键上传当前文档」走这条） |
| 上传 base64 | POST /api/docs/upload-base64 | JSON + base64（插件「选择本地文件上传」走这条） |
| 文档列表 | GET /api/docs | 分页返回数组，含入库状态 synced / sync_expected |
| AI 问答 | POST /api/ai/query | 学科智能体生成式回答＋溯源 |
教师端使用方式
① 网页端：WPS 插件「校园知识库」选项卡（登录→上传→AI问答，无需访问本网址）；② 接口对接：按上述 API 文档（/docs）调用，管理员账号由系统统一分配，不在页面展示。