docs: sync agents/readme/integration/setup with llm, speech and import-cancel

对练真LLM与语音接口、短信固定验证码、组织快照表写入 AGENTS.md 规则与 API_INTEGRATION/DEV_SETUP/README;导入任务取消同步进作战清单、迁移计划与 TechSpec。
2026-07-03 21:45:38 +08:00
parent 939fba85ff
commit e47f6a2f48
7 changed files with 33 additions and 27 deletions
@@ -12,10 +12,10 @@
 - 已验证：租户列表、验证码、`000000 / admin / admin123` 加密登录链路。
 - 管理端 MVP：首页与五个关键页面已落地，路由为 `/index`、`/recruit/interview`、`/train/practice`、`/knowledge/cases`、`/knowledge/sop`、`/knowledge/processing`。
 - 移动端 MVP：三端首页已拆到独立工程 `mobile/`，按 `docs/prototypes/员工端-首页.png`、`候选人端-首页.png`、`主管端-首页.png` 实现；路由为 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，并兼容 `/h5/employee`、`/h5/admin`；已接手机号短信登录、`GET /api/aihr/mobile/home/{role}` 首页 API，员工端“开始训练”可完成两轮三角色对练，记录落 `aihr_practice_session` 并刷新主管端待复盘列表、复盘详情、标记已复盘状态和员工能力画像，前端保留本地 fallback。
- 英雄路径：AI 面试出题、三角色对练、案例沉淀已接后端 seed API；SOP 知识库已接中文关键词 + MySQL Fulltext + Qdrant 混合召回，支持 txt/md/PDF/Word/Excel/PPT 上传到 MinIO 后解析成 fragment，并可按数据库 vector 模型配置写入 embedding 和 Qdrant 向量索引；模型配置页可查看向量库维度/点数并一键重建，配置缺失或外部 embedding 失败时用本地 `local-hash-v1` 兜底。
- 资料处理：已新增解析任务状态页，按 `aihr_knowledge_attach` 和 `aihr_knowledge_fragment` 展示等待解析、解析中、已完成、失败、片段数和向量化状态；页面支持多文件/浏览器目录选择，也支持从后端 `AIHR_IMPORT_ROOT` 下启动后台目录导入任务并轮询进度。
+- 英雄路径：AI 面试出题、案例沉淀已接后端 seed API；三角色对练已接真 LLM（数据库启用 chat 模型后客户回复与评分为真实生成，未配置回退 seed；asr/tts 配置后支持语音输入/播报）；SOP 知识库已接中文关键词 + MySQL Fulltext + Qdrant 混合召回，支持 txt/md/PDF/Word/Excel/PPT 上传到 MinIO 后解析成 fragment，并可按数据库 vector 模型配置写入 embedding 和 Qdrant 向量索引；模型配置页可查看向量库维度/点数并一键重建，配置缺失或外部 embedding 失败时用本地 `local-hash-v1` 兜底。
+- 资料处理：已新增解析任务状态页，按 `aihr_knowledge_attach` 和 `aihr_knowledge_fragment` 展示等待解析、解析中、已完成、失败、片段数和向量化状态；页面支持多文件/浏览器目录选择，也支持从后端 `AIHR_IMPORT_ROOT` 下启动后台目录导入任务、轮询进度并取消运行中任务。
 - 侧栏：MVP 阶段只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”，其余若依默认菜单暂时隐藏。
- 本地短信：真实阿里云短信参数放根目录 `.env.local`，由 `scripts/dev-backend.sh` 自动加载；不要把密钥写入 `application-dev.yml`。
+- 本地短信：真实阿里云短信参数放根目录 `.env.local`，由 `scripts/dev-backend.sh` 自动加载；不要把密钥写入 `application-dev.yml`。dev 未配短信时验证码固定 `123456`（`aihr.sms.dev-fixed-code`，prod 强制失效）。

 ## 快速启动

@@ -52,4 +52,4 @@

 ## 下一步

-五个管理端关键页面和移动端三端首页已接入后端 API，并在前端保留失败回退。下一步按 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) 继续接 RAG 引用回答与最小 chat；当前已落知识库表、移动端训练记录表 `aihr_practice_session`、员工训练历史、主管复盘列表、复盘详情、标记已复盘、能力画像、住宅 SOP MySQL Fulltext + Qdrant 混合召回、OSS-first 文档上传、txt/md/PDF/Word/Excel/PPT 解析、图片视觉 OCR（配置 vision/chat 模型后上传 jpg/png 等自动识别文字）、embedding 写入、向量库状态/重建、模型供应商/模型配置、资料处理状态页和后台目录导入任务，不整包搬 `ruoyi-chat`。
+五个管理端关键页面和移动端三端首页已接入后端 API，并在前端保留失败回退。下一步按 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) 继续接 RAG 引用回答与最小 chat；当前已落知识库表、移动端训练记录表 `aihr_practice_session`、员工训练历史、主管复盘列表、复盘详情、标记已复盘、能力画像、住宅 SOP MySQL Fulltext + Qdrant 混合召回、OSS-first 文档上传、txt/md/PDF/Word/Excel/PPT 解析、图片视觉 OCR（配置 vision/chat 模型后上传 jpg/png 等自动识别文字）、embedding 写入、向量库状态/重建、模型供应商/模型配置、资料处理状态页和后台目录导入任务取消，不整包搬 `ruoyi-chat`。