docs: sync mentor layer, summary card and design baseline across docs
演示口径/验证步骤/README/AGENTS 全部对齐 P1 师傅层与 P0-2 总结卡 现状(师傅区四状态/今日安排/我的地图/tab今日练问我/建设中整页/ 总结卡弹层);API_INTEGRATION 补检索轻概要行为与 summary-card 端点 契约;AGENTS 移动端规则更新(状态源勿新造/visibleTabs 钉死/REVIEW 修正项优先);BACKLOG 记「保存图片」与「学」板块零散待办;删除 docs/prototypes 下与 design/ 重复的 5 张设计图副本。
This commit is contained in:
@@ -60,7 +60,8 @@ SOP 文档上传第三片已经落最小后端边界：
|
||||
| 缺失向量补跑 | `POST /api/knowledge/doc/vectorize-missing` | 扫描缺少 `embedding_json` 的片段，复用同一向量化与 Qdrant 入库链路，适合模型配置变更后或历史资料补齐向量 |
|
||||
| 向量库状态与重建 | `GET /api/knowledge/doc/vector-index-status`、`POST /api/knowledge/doc/rebuild-vector-index` | 模型配置页展示当前 vector 模型维度、Qdrant collection 维度、点数和片段向量数；维度不一致时可一键清空旧 embedding、删除 collection 并按当前模型重建 |
|
||||
| Qdrant 向量索引 | 同一上传接口内机会性执行 | embedding 写入 MySQL 后尽力 upsert 到 Qdrant；同名文档替换会尽力删除旧 points；Qdrant 不可用不影响上传和 MySQL 检索；外部 embedding 成功但 collection 维度不一致时不静默降级为 `local-hash-v1`，通过状态接口和重建入口处理 |
|
||||
| 混合检索 | `POST /api/knowledge/search` | 先跑中文关键词 `LIKE` 打分和 MySQL Fulltext，再生成 query embedding 走 Qdrant，RRF 融合后交给 `category='rerank'` 模型（如硅基流动 bge-reranker-v2-m3）按语义相关性重排；rerank 未配置或失败保持 RRF 顺序，Qdrant 或外部向量接口不可用时保留关键词/全文检索 |
|
||||
| 混合检索 | `POST /api/knowledge/search` | 先跑中文关键词 `LIKE` 打分和 MySQL Fulltext，再生成 query embedding 走 Qdrant，RRF 融合后交给 `category='rerank'` 模型（如硅基流动 bge-reranker-v2-m3）按语义相关性重排；rerank 未配置或失败保持 RRF 顺序，Qdrant 或外部向量接口不可用时保留关键词/全文检索。命中后若 chat 模型可用，自动生成结构化轻概要写入响应 `answer/keyPoints/cautions`（≤60字直答+3-6要点+0-3注意；temperature=0，15s 超时，硬约束不得编造、答不了明示无依据）；概要失败回退片段原文拼接，检索不报错 |
|
||||
| 检索总结卡 | `POST /api/knowledge/summary-card`（JSON `{queryText, category}`） | 按需生成信息图式总结卡 `{title, steps[], objections[], scripts[], reminders[]}`：复用检索命中片段（最多5条）调 chat 模型，temperature=0、30s 超时；无命中/无 chat 模型/生成失败均抛明确错误供前端重试，不兜假数据。移动端查SOP结果页「生成总结卡」按钮触发，底部弹层展示并可 TTS 朗读 |
|
||||
| 解析状态聚合 | `GET /api/knowledge/processing/overview` | 聚合 `aihr_knowledge_attach.status`、fragment 数、embedding 数、`sys_oss.ext1.fileSize`，生成资料处理页指标、分类、任务、链路和事件列表 |
|
||||
| 服务端目录导入 | `POST /api/knowledge/doc/import-local` | JSON `{ directory, category, limit }`；`directory` 只能是 `AIHR_IMPORT_ROOT` / `aihr.import.root` 下的相对目录，默认根目录为 `./.data/import`；逐文件复用上传解析链路，同步执行，保留给小批量/调试 |
|
||||
| 服务端导入任务 | `POST /api/knowledge/doc/import-local-task`、`GET /api/knowledge/doc/import-tasks`、`POST /api/knowledge/doc/import-tasks/{id}/cancel` | 启动后台目录导入并返回任务；任务写入 `aihr_knowledge_import_task`，页面轮询查看总数、成功数、失败数、当前文件和进度；运行中任务可取消；重试当前按同目录重新启动一轮 |
|
||||
|
||||
@@ -95,6 +95,11 @@
|
||||
|
||||
配套知识模型扩容:知识类型维度(SOP=标准 / 案例=参照 / 话术=直接能说 / 经验策略=火候),检索按类型分层供给;案例沉淀链路是隐性知识的采集入口,战略地位上调。
|
||||
|
||||
### 零散待办
|
||||
|
||||
- **总结卡「保存图片」按钮**(设计基准 summary-modal 图内有):需 html2canvas 类依赖做 DOM 转图,2026-07-05 P0-2 实现时按"不加依赖"红线砍掉;引依赖或后端出图方案定型后补。
|
||||
- **员工端「学」板块**(我的地图橙色块):当前进「建设中」整页,承接 B8 五段旅程的岗前课程/每日小训模块。
|
||||
|
||||
## Future Enhancements
|
||||
|
||||
### Model Classification Version Governance
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
| 顺序 | 页面 | 点击路径 | 必须看到 |
|
||||
|---|---|---|---|
|
||||
| 1 | 首页 `/index` | 打开首页 | 只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置” |
|
||||
| 2 | 移动端三端 `http://127.0.0.1:5174/h5/user`、`/h5/candidate`、`/h5/supervisor` | 打开后先手机号登录；已配置 `AIHR_SMS_LOGIN_TEMPLATE_ID` 时可真实收短信，新手机号会自动注册；员工端首页为「今天要学/练完要复盘/工作中要用/碰到问题要报/我的成长」五个情境区，点“开始训练”完成两轮提交，再打开主管端；点「遇到问题，问一句」可文本/语音查 SOP 并看到引用片段；候选人端点“开始面试/面试练习”和“补充资料”；管理端 `/recruit/interview` 审核候选资料 | 员工端显示评分、“训练完成，主管端待复盘已更新”、训练历史和能力画像；底部 tab 为整页切换（首页/训练/知识/我的互斥渲染、切换回顶）；未实现入口点击弹「本期演示未开放」toast，无死按钮；主管端完训人数、“待复盘对练”计数和待复盘列表增加；训练页语音输入在浏览器录音失败时应切到“选择语音”而不是死按钮；点进待复盘记录可看评分、话术、导师改写，并可标记已复盘；候选人端可拉题/答题/评分，资料上传后显示“已提交资料”、`OSS ...`、`待审核`；HR 审核后候选人端显示 `已通过/已驳回`；接口不可用时走本地 fallback |
|
||||
| 2 | 移动端三端 `http://127.0.0.1:5174/h5/user`、`/h5/candidate`、`/h5/supervisor` | 打开后先手机号登录；已配置 `AIHR_SMS_LOGIN_TEMPLATE_ID` 时可真实收短信，新手机号会自动注册；员工端首页为「师傅区(头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图(问/练/学/报四色块)→我的成长摘要」，点“开始训练”完成两轮提交，再打开主管端；点快捷 chip 或「问」可文本/语音查 SOP，结果页点「生成总结卡·约10秒」弹出信息图卡（四步法/异议应对/开口话术/关键提醒+听一遍/开始跟读）；候选人端点“开始面试/面试练习”和“补充资料”；管理端 `/recruit/interview` 审核候选资料 | 员工端显示评分、“训练完成，主管端待复盘已更新”、训练历史和能力画像；底部 tab 整页切换（员工端为 今日/练/问/我，切换回顶），滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页（返回首页按钮），无死按钮；主管端完训人数、“待复盘对练”计数和待复盘列表增加；训练页语音输入在浏览器录音失败时应切到“选择语音”而不是死按钮；点进待复盘记录可看评分、话术、导师改写，并可标记已复盘；候选人端可拉题/答题/评分，资料上传后显示“已提交资料”、`OSS ...`、`待审核`；HR 审核后候选人端显示 `已通过/已驳回`；接口不可用时走本地 fallback |
|
||||
| 3 | AI面试 `/recruit/interview` | 生成题目 → 填满参考回答或输入真实回答 → 完成评分 | 配置 chat 模型时真实生成题目和评分；未配置时用本地 Rubric 估分，不返回固定候选人分数；应看到新增面试记录 |
|
||||
| 4 | 三角色对练 `/train/practice` | 开始对练 → 填入参考回复或输入真实回复 → 继续一轮 → 结束并评分 | 已完成闭环、导师改写、新增对练记录；数据库已启用 chat 模型时，客户回复与评分为真实 LLM 生成（回复不再是固定台词，分数随话术变化），未配置时使用本地剧本兜底 |
|
||||
| 5 | 案例沉淀 `/knowledge/cases` | 上传真实语音 → ASR 转写 → AI 整理 → 送审 → 入库 → 查看样片 | 已完成闭环，案例列表新增真实转写生成的记录；视频仍用样片兜底 |
|
||||
|
||||
+1
-1
@@ -129,7 +129,7 @@ curl -k -s https://peilian.njzhmj.top/h5/supervisor | sed -n '1,20p'
|
||||
- 案例沉淀：进入 `/knowledge/cases`，上传真实语音 → “AI 整理” → “送审” → “入库”，应看到“已完成闭环”和新增案例记录；上传必须先完成 ASR 转写。
|
||||
- SOP知识库：进入 `/knowledge/sop`，可上传 txt/md/PDF/Word/Excel/PPT 文档入库；点击“检索” → “生成训练题”，应看到“已完成闭环”、命中数据库 SOP 原文片段和训练题；数据库不可用时页面回退 seed。
|
||||
- 资料处理：进入 `/knowledge/processing`，应看到资料总量、解析任务表、处理链路、规则与风险；可用少量文件验证“批量导入/选择目录/服务端导入”。**批量导入走异步队列**：提交即返回，页面出现“本次批量上传”进度面板（排队/加工中/完成/失败 + 单条重试），后台 worker 并发 2 逐条解析入库；暂存目录默认 `./.data/staging`（`aihr.upload.staging` 覆盖）。服务端导入读取 `./.data/import` 下的相对目录，启动后台任务并在页面显示进度，运行中任务可点“取消”；目录导入的重试粒度是同目录重新导入，批量上传的重试粒度是单文件。
|
||||
- 移动端员工训练：进入 `http://127.0.0.1:5174/h5/user`，手机号登录（dev 验证码固定 `123456`）。员工端首页为「今天要学/练完要复盘/工作中要用/碰到问题要报/我的成长」五个情境区，底部 tab（首页/训练/知识/我的）为整页切换；未实现入口点击弹「建设中」toast。“开始训练” → 两次“填入建议回复 / 提交本轮”，应看到评分、导师改写、训练历史和能力画像；切到主管端后完训人数与“待复盘对练”计数增加，并展示待复盘列表；点进单条可看评分、话术、导师改写，并可标记已复盘。训练页有“语音输入”和“播报”按钮，需启用 asr/tts 模型后生效；iOS/WebView 若无法直接访问麦克风，会切到“选择语音”并用系统录音/音频文件继续走 ASR，否则降级文本。「遇到问题，问一句」打开查 SOP 面板：文本/语音提问 → 返回回答+依据+引用片段（需后端在跑；语音需 asr 模型）。
|
||||
- 移动端员工训练：进入 `http://127.0.0.1:5174/h5/user`，手机号登录（dev 验证码固定 `123456`）。员工端首页为「师傅区(mentor.png 头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图四色块→我的成长摘要」（视觉基准 `feedback/2026070423/design/`），底部 tab（今日/练/问/我）整页切换，滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页。“开始训练” → 两次“填入建议回复 / 提交本轮”，应看到评分、导师改写、训练历史和能力画像；切到主管端后完训人数与“待复盘对练”计数增加，并展示待复盘列表；点进单条可看评分、话术、导师改写，并可标记已复盘。训练页有“语音输入”和“播报”按钮，需启用 asr/tts 模型后生效；iOS/WebView 若无法直接访问麦克风，会切到“选择语音”并用系统录音/音频文件继续走 ASR，否则降级文本。快捷 chip 或「问」打开查 SOP 面板：文本/语音提问 → 轻概要(回答+要点+注意)+依据折叠；点「生成总结卡·约10秒」弹出信息图卡（四步法/异议/话术/提醒+听一遍/开始跟读），需 chat 模型；语音需 asr 模型。
|
||||
- 移动端候选人：进入 `http://127.0.0.1:5174/h5/candidate`，手机号登录（dev 验证码固定 `123456`）→ “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到“已提交资料”、`OSS ...`、`待审核`。再进入管理端 `/recruit/interview` 底部“候选资料审核”点“通过/驳回”，候选人端刷新后应显示新状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。
|
||||
- 真 LLM 激活：在 `/system/model` 给供应商填 api_host/api_key 并启用 `category=chat` 模型后，三角色对练的客户回复与评分即为真实 LLM 生成；再启用 `category=asr/tts`（如硅基流动 SenseVoice/CosyVoice2）语音路径生效。未配置时全链路自动回退 seed。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user