片段锚点是什么
片段锚点指每个切片在入库时就记录定位信息:文档 id、文档版本、章节标题、页码、字符区间,以及可跳转的锚点链接。它支撑三件事:答案里的引用能一键跳到原文对应位置,用户核对成本最低;用户反馈「这段不对」时能精确定位到具体段落而不是整篇文档;审计时能说明答案依据的是哪一版文档。解析阶段最容易丢页码,尤其扫描件与 OCR,能保留版式映射就要保留,实在缺失的至少在新版本补齐。
基本信息
| 必备字段 | 文档 id、版本、章节、页码或字符区间、跳转锚点 |
|---|---|
| 主要用途 | 引用跳转、反馈定位、审计溯源 |
| 写入时机 | 解析与切分入库阶段,随元数据一起写 |
| 常见短板 | OCR 与扫描件难以保留页码映射 |
| 降级表现 | 只有文件名时无法精确定位 |
| 校验动作 | 文档改版后验证锚点是否仍能跳转 |
典型使用场景
- 引用展示为「手册 v2.3 第 42 页」,用户点击直达原文
- 用户反馈某段有误,按锚点定位到具体段落而不是整篇
- 合规审计要求说明答案依据与文档版本
- 文档改版后按版本号区分历史引用,避免新旧混淆
- 增量更新时按字符区间做新旧内容差异比对
元数据字段示例
元数据字段示例
{"doc_id": "manual-v23", "section": "3.2 索引", "page": 42,
"char_range": [10320, 10980], "anchor": "#h-32", "version": "v2.3"}
# 字段缺一个,溯源能力就少一档:没有 version 会指向新版文档
# 没有 char_range 就无法高亮原文片段锚点字段读法
| 字段 | 作用 | 缺失后果 |
|---|---|---|
| doc_id 与 version | 确定文档与版本 | 文档改版后引用指向错误内容 |
| section | 章节级定位 | 用户需要在长文档里自行搜索 |
| page 与 char_range | 页面或字符级定位 | 无法高亮原文片段 |
| anchor | 可跳转链接 | 引用只能看不能点,体验降级 |
解析阶段丢失页码时,至少在后续版本补齐:历史片段一旦没有定位信息,用户反馈与审计都会失去抓手。
文档改版后字符区间会整体错位:锚点要么绑定具体版本,要么在改版时重新计算区间并只对新版本生效。