这个品类的数据长什么样
学校德育与班主任工作材料包括主题班会方案、学生综合素质记录、家访记录，来源分散于年级组、班主任与德育处，更新随学期推进与专项活动触发，字段涉及活动名称、日期、参与人数、签字与回执。这些材料进入知识库检索时，主题班会方案作为活动设计依据，学生综合素质记录作为过程性证据，家访记录作为家校沟通凭据；三者各自承担召回片段中的角色，由检索节点统一返回候选，后续节点或人工据此形成版本台账与变更记录。
配置怎么定
这一环由知识库检索服务（检索节点与搜索测试）执行，输出候选片段与相似度得分（经模式、合并、重排、过滤与上限裁剪）。版本台账与变更记录由后续节点或人工接着完成。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 主题班会方案 | 核对活动名称、日期、参与人数与签字栏是否与班级记录一致，同一方案在两份材料里的名称、数量、日期对不上时以现行版本为准 | 在知识库搜索测试中切换 searchMode 为语义、全文或混合，对比候选片段与相似度得分；检查 usingReRank 开启前后前几条排序 |
| 学生综合素质记录 | 核对记录名称、数量、日期与签字或回执是否齐全，版本未同步时旧版可追、现行版本唯一 | 用同义改写的问句各测一次，看候选条数与得分；记录引用数组长度，单独查看引用文本的 tokens 是否超出 limit 裁剪 |
| 家访记录 | 核对家访日期、学生姓名、家访教师签字与家长回执，缺签字或回执时标记为待补 | 在搜索测试中查看返回候选是否同时包含语义与全文结果，确认多路合并后仍保留原文关键片段 |
| 版本台账与变更记录 | 核对现行版本唯一、旧版可追、引用同步，同一记录在两份材料里的名称、数量、日期对不上时触发变更 | 改一处内容后重新检索，看版本号与引用是否同步更新；对比 similarity 过滤前后候选条数与得分变化 |
容易做错的三处
- 现象：同一主题班会方案在两份材料里的名称、日期对不上。原因：版本未同步，旧版与新稿并存且未标注现行版本。
- 现象：学生综合素质记录缺签字或回执。原因：材料流转环节未闭环，签字页未随记录一并归档。
- 现象：家访记录换一种问法就召回不到。原因：问题优化未覆盖指代，检索模式与材料形态不匹配。
怎么确认配好了
本功能验收：用同义改写的问句各测一次，对比候选片段与相似度得分，再开关重排看前几条排序；记录候选条数与得分，引用数组长度单独记录，引用文本 tokens 与 limit 裁剪分开核对。
业务测试：改一处内容，看版本号与引用是否同步更新；若引用条数变化，核对 similarity 过滤与 searchMode 设置，确认候选来源与命中关联。
- 在知识库搜索测试中切换
searchMode为语义、全文或混合，对比同一问题的候选片段与相似度得分，记录候选条数。 - 开启或关闭
usingReRank，对比前几条候选排序变化；调整similarity与limit后，单独记录引用数组长度与引用文本 tokens。