知识库 Wiki
📖 适合谁：知识管理者 / 业务运营 / AI 产品经理 —— 觉得"切片检索出来的东西零散、答不到点子上"，想让 AI 先把文档读懂、写成条目再检索的人
📖 阅读时长：6 分钟
📖 一句话：知识库 Wiki（LLM Wiki）是知识库内的一个编译页，用 LLM 把文档切片编译成"概念条目"，形成一张可浏览、可审核、可溯源的维基式知识索引；构建完成后由独立的召回链路为问答补充上下文。入口在任一知识库的左侧菜单「LLM Wiki」（路由/knowledge/wiki?id=<知识库ID>），全员可用，写操作需要该知识库的编辑权。
与普通检索的区别：普通检索是按相似度捞切片，Wiki 是先归纳成条目再召回——问"我们产品的退款政策是什么"，前者给的是一堆相关段落，后者给的是一条已归纳好的条目。
功能全景
一、主要能力
| 能力 | 说明 |
|---|---|
| LLM 编译条目 | 把知识库的文档切片交给模型，抽取、归并、写成结构化条目（概念名 + 正文 + 类型 + 来源） |
| 增量构建 | 主按钮「构建Wiki」为增量语义：来源切片内容没变的条目自动跳过，不重复烧 Token |
| 三种重建姿势 | 「预览变更」只读不写索引、「强制重新构建」解开卡住的任务锁、「清空并重建」全量从零重算 |
| 构建进度可视 + 可停止 | 实时显示阶段与进度（抽取概念 / 同义归并 / 价值判定 / 生成条目 / 收尾），支持协作式停止，已生成条目保留、下次自动续跑 |
| 总览目录视图 | 维基式首页：健康统计卡、价值分档、分类目录（按类型）、来源文档导航、A-Z / 中文首字索引、通用术语表 |
| 条目管理 | 分页表格 + 多维筛选（状态 / 类型 / 价值档 / 审计问题），正文、来源、置信度、更新时间一览 |
| 条目详情阅读 | 右侧抽屉展示条目正文，支持 [[内链]] 点跳、Markdown 渲染、来源图片缩略图与放大 |
| 条目关系网 | 强 / 弱关联分组，标注关系原因（正文内链 / 本文提及 / 反向链接 / 同源文档 / 同义归并 / 存在冲突），可定位高亮 |
| 冲突可视化 | 对内容互相矛盾的条目做并排对比（contradicted_by），一眼看出哪里说法打架 |
| 人工审核状态机 | 对"待审核 / 多义"条目执行放行（进入召回）或忽略（不召回），人工结论优先于 AI |
| AI 价值分级 | 每条给出价值分 + 判定理由 + 档位；可**一键「提为高价值」**人工覆写档位 |
| 同义建议 | 向量预筛 + AI 判定"是否同指"，判为同一实体的在下次构建自动合并 |
| 来源图片 | 条目来源切片中带图片时展示缩略图网格，标注页号与文档名 |
| 每文件 Wiki 索引 | 按来源文档列出该文档产出的条目，支持「一键构建未构建的 N 篇」「检测需更新」 |
| 构建后统一审查 | 反幻觉核验、重复候选、无来源、字段问题、关系悬空，按问题码聚合，可重新审查 |
| 定时自动巡检 | 创建 cron 巡检任务，含巡检历史与趋势、简洁 / 详细两种模式 |
| 文档级重建 | 在「数据集」页文档行菜单可**「重建该文件的Wiki」**，工具栏支持勾选多篇批量构建 |
| 自定义条目类型 | 内置 5 种类型之外可新增自定义类型（token / 展示名 / 生成引导 / 颜色） |
| RAG 检索增强 | 编译好的条目作为独立召回链路参与检索测试与问答，作为补充上下文 |
| MCP 只读工具 | 通过 MCP 对外暴露一组只读 Wiki 工具（查开关 / 总览 / 条目 / 审查报告 / 健康 / 巡检历史） |
二、典型应用场景
- 长文档问答命中率低：产品手册、技术规范动辄上百页，切片检索经常答得零散。先编译成条目再检索，答案有归纳、有出处。
- 知识口径要统一：同一件事在不同文档里有不同说法（旧版 vs 新版）。Wiki 的冲突可视化把矛盾摆在同一屏，人工裁决后只保留正确的一条。
- 术语解释要稳定：客户问行业术语、内部黑话，通用模型会瞎解释。把术语编译成条目并在检索测试里验证召回，口径稳定可复用。
- 合规 / 法务要求可追溯：每条条目都记录来源文档 + 来源切片，回答可回溯到原文，不是模型编的。
- 新人快速上手：打开知识库 Wiki 总览，像翻维基百科一样按分类目录、按字母索引浏览——比让人读原始文档快得多。
- 知识保鲜：源文档改了，条目标记为过期；用「检测需更新」+「修复过期条目」定向重建，或挂一条 cron 巡检自动盯着。
- 防幻觉兜底：开启反幻觉核验后，正文里引用了模型无法证实的"来源 / 文献"会被打回待审核，不进召回——适合对准确性要求高的场景。
三、界面与操作
1. 入口与前置条件
- 入口：进入任一知识库 → 左侧菜单顺序为 数据集 → 检索测试 → 配置 → 知识图谱（仅当已有图谱数据时出现）→ LLM Wiki → 知识库管家。点「LLM Wiki」即进入，面包屑显示「知识库 > LLM Wiki」。
- 页面路由：
/knowledge/wiki?id=<知识库ID>。 - 权限：Wiki 没有独立权限项。能进这个知识库就能看；但「放行 / 忽略」「构建 / 重建 / 清空」这些写操作需要该知识库的编辑权，否则报
No authorization.。 - 首次必须先在配置里开启：若该知识库未勾选「生成 LLM Wiki」，页面顶部会弹黄色提示条「当前知识库尚未开启 LLM Wiki…」，并提供按钮 「前往配置界面开启」，跳到
/knowledge/configuration。
2. 页面布局
Wiki 页本身是「页内 Tab + 右侧抽屉」结构，不是三栏：
| 区域 | 内容 |
|---|---|
| 外层左栏 | 知识库导航菜单（属于知识库外壳，不属于 Wiki 页） |
| 外层顶部 | 面包屑 + 「当前知识库今日新增 / 所有知识库今日新增」统计 |
| 页内 Tab | 总览 / 条目管理 / 审查（仅页内切换，路由不变） |
| 右侧抽屉 | 点开条目后从右滑出，宽 620px，标题为概念名 |
3. 顶部操作区
| 控件 | 说明 |
|---|---|
| 搜索框 | 仅「条目管理」Tab 显示，占位符 「搜索概念或正文」 |
| 「构建Wiki」 | 主按钮。增量构建，悬浮提示「增量构建：来源切片未变化的条目会自动跳过」 |
| 「更多构建选项」 | 下拉菜单，三项：「预览变更」（副标题"只读，不写索引"）、「强制重新构建」（"顶掉卡住的任务；不改变重算范围"）、「清空并重建」（"删除全部条目，从零全量重算"） |
| 「同义建议」 | 打开同义候选抽屉 |
| 「停止」 | 构建中才出现，带二次确认 |
构建中的进度阶段文案包括：「正在生成第 X / 共 Y 条 · 本条 AI 调用 N 次」「正在判定价值 X / Y 个概念」「正在抽取概念 X / Y 批」「同义归并完成（合并 N 项），准备价值判定…」「收尾中…」。
4. 总览 Tab
- 四张健康统计卡：总条目 / 过期 / 待审核 / 平均置信度。
- 价值分档卡（可点击跳筛选）：高价值 / 中价值 / 低价值 / 已跳过。
- 「跳过的块」：规则预筛阶段被跳过的切片统计，按原因分组（过短且无信息 / 纯数字噪音 / 目录或表头 / 无 OCR 图片）。
- 「每文件 Wiki 索引」：显示"未构建 N 篇"，按钮 「检测需更新」、「已取消排队的构建」（清空队列）、「一键构建未构建的 N 篇」。
- 「分类目录（按类型）」：按条目类型汇总的入口。
- 「来源文档导航」：每篇文档的条目数 + 高 / 中 / 低 / 跳过各档计数。
- 「字母 / 首字索引」：维基式的 A-Z 与中文首字导航。
- 「通用术语表（AI 判定无价值，可一键转正）」：按 时间 / 地点 / 数值单位 / 其他 分组折叠，每条带 「提为高价值」 按钮。
5. 条目管理 Tab
筛选 chip 四组（可叠加）：
| 组 | 取值 |
|---|---|
| 状态 | 全部 / 待审核（带计数徽标）/ 多义 / 已忽略 / 已归并 / 新鲜 / 过期 |
| 类型 | 全部 + 实际存在的类型（带计数） |
| 价值档 | 全部 / 高价值 / 中价值 / 低价值 / 已跳过 |
| 审计问题（被动下推） | 如「疑似重复 ✕」「问题: HALLUCINATED ✕」 |
统计卡：总条目 / 过期 / 待审核 / 平均置信度 / 按类型 / 反幻觉命中 / 关系悬空。
表格列：概念 / 类型 / 正文 / 来源 / 置信度 / 更新时间 / 状态。正文列下方会挂问题标记 chip（幻觉 / 无来源 / 重复 / 来源为空 / 关系 / 疑似重复），点击下推为筛选条件。
分页每页 20 条。
6. 条目详情抽屉
- 徽标行：类型徽标 + 状态徽标 + 「置信度: N」。
- 来源行：「来源文档: N · 来源切片: N」。切片数为 0 时显示
—并附提示「本条未记录来源切片（可能为旧版本条目）」——不要误读成"没有来源"。有冲突时显示按钮 「冲突: N · 查看冲突」。 - 「来源图片」区：缩略图网格，或提示「本条目的来源切片无图片」。
- 价值分级条：「价值分: x.xx」+ 档位徽标 + 判定理由（前缀「为什么值得深写：」/「为什么只给了总结：」）+ 若有「人工覆写档位: …」+ 「提为高价值」 按钮。
- 待审核 / 多义条目的处置区：「该条目待人工确认：」+ 「放行（进入召回）」 / 「忽略（不召回）」。
- 正文阅读区：Markdown 渲染，
[[内链]]可点击跳转。 - 「冲突对比」面板：对端条目卡片 + 「互相冲突」+ 「查看该条」/「收起」。
- 「相关条目」：强关联(N) / 弱关联(N) 两组，每条带类型徽标、关系原因标签、次数与方向标记、「定位」/「跳转」按钮、anchor 摘要。死链显示灰色 chip「条目已不存在（可能已重建换 ID）」。
- 抽屉底部显示条目 ID（形如
w-…）。
7. 审查 Tab（构建后统一审查）
- 标题 「构建后统一审查」，按钮 「刷新」 / 「创建巡检任务」 / 「重新审查」（红色）。
- 开关徽标：
自动巡检 · mode、审查 构建预算 N、构建后核验。 - 「巡检历史」 列表。
- 统计卡：已扫描（扫描 / 总数）、幻觉、无来源、重复候选、字段问题、关系悬空；并显示严重度（高 / 中 / 低）与「模型调用: used/limit · 预算用尽已停止」。
- 「问题清单」：按问题码聚合的表格（幻觉 / 无来源 / 重复(id冲突) / 重复(同义) / 来源为空 / 关系 / 问题），点击可下推到条目管理。
8. 关键弹窗与抽屉
| 弹窗 | 字段与文案 |
|---|---|
| 同义建议（抽屉） | 说明「概念对先由向量预筛、再由 AI 判定是否同指…」，条目显示 A ≈ B + 相似度 + 来源篇数 + 判定徽标（AI：同一实体 / AI：不确定 / 未判定（AI 不可用）） |
| 变更预览（对话框） | 行状态：最新（无需处理）/ 需重建 / 孤儿（来源已删，将标记过期），按钮「取消」/ 「按此执行」 |
| 强制重建确认 | 「仅解除任务锁后重新发起，不会强制重算内容…确定继续？」 |
| 清空并重建确认 | 「将删除该知识库的全部 wiki 条目并从零重建…人工「放行/忽略」记录会丢失…确定继续？」 |
| 创建巡检任务 | 字段 「调度（cron）」（默认 0 0 * * *）+ 「巡检模式」（简洁（低耗）/ 详细（反幻觉+关系）） |
9. 条目状态与类型
状态机（条目行上的状态）：
| 状态 | 含义 |
|---|---|
| 新鲜 | 单文档抽取产出，未被归并 |
| 已归并 | 由多篇来源文档归并而成 |
| 待审核 | 低置信或多来源存在矛盾，需人工裁决 |
| 多义 | 同一概念在不同语境下语义不一致，已拆分待复核 |
| 已忽略 | 人工确认不进召回 |
| 已跳过 | AI 判定无价值，仅登记在通用术语表 |
| 过期 | 来源文档已变更，需重建 |
内置条目类型 5 种：总结（summary）、实体（entity）、术语表（glossary）、问答（faq）、大纲（outline）；另支持自定义类型。生成时可选 auto，由 AI 自动挑选 1–2 类。
10. 与其它模块的联动
- 检索测试：Wiki 是独立召回链路，检索结果里的 「LLM-Wiki 补充知识（N 条，不参与原文切片排序）」 单独成区，条数由「Wiki 补充条数」参数截断。
- 工作台对话：问答时同样可启用 Wiki 检索，与「使用知识图谱」开关相邻。
- 知识库配置：开关、条目类型、跨文档归并、置信度阈值、AI 价值分级、证据扩充、定时巡检、并发与切片上限等都在
/knowledge/configuration配置。 - 文档级入口：文档行菜单的「重建该文件的Wiki」、文档工具栏勾选多篇后的「构建 Wiki」。
四、最佳实践
- 构建是一个动作 + 两个修饰：日常点 「构建Wiki」 就够（增量，改了才重算）；想先看看会动什么点 「预览变更」；任务卡住点 「强制重新构建」——注意它只解任务锁，不会强制重算内容。
- 「清空并重建」代价很大，慎点：全量 Token 花费；人工「放行 / 忽略」的记录会随条目一起删除，被忽略的条目会重新出现。只在切片方法或高级参数变了、确实需要全量重做时才用。
- 「停止」是协作式的：点停止后已生成的条目保留、进度保存，下次构建自动续跑，最坏延迟约一次概念生成的时间。可以放心停。
- 批量构建单次上限 200 篇：超过会提示「一次最多构建 N 篇，请改用「构建Wiki」」。文档特别多时直接用全库构建。
- 跨文档知识库别做单文件重建：全库构建才是跨文档归并的正确形态；在已归并的知识库里对单篇做重建，会把已归并的高置信条目缩水成单文档摘要。系统触发前有二次确认，看到警示就停下来想清楚。
- 上线前先跑检索测试：编译完别急着用，在「检索测试」里用 10 个真实问题验证「LLM-Wiki 补充知识」这一区的召回质量——确认有料再让问答引用。
- 价值分级默认 balanced：保留高 / 中 / 低三档。改成只留高价值会触发全量重建且条目 ID 变化，历史引用与人工结论会受影响，改之前想清楚。
- 人工覆写优先于 AI：
value_tier_override一旦设置就压过 AI 判定；对"通用术语表"里被 AI 判无价值但业务上重要的概念，点 「提为高价值」 直接转正。 - 反幻觉核验开启前先评估误杀率：开启后，正文引用了模型无法证实的"来源 / 文献"的条目会被打回待审核、不进召回。准确性优先的场景值得开，但先小范围试。
- 改了高级设置必须重建才全量生效：并发度、切片上限等参数折进了配置指纹，保存后需 「清空并重建」 才全量生效——否则新旧条目混着，口径不一致。
- 搜索只在当前页内过滤：条目管理的搜索框是前端过滤当前页，排序仍由后端按「置信度降序、更新时间降序」决定。要找特定条目用筛选条件（状态 / 类型 / 价值档），不要靠搜索框翻页。
- 过期条目不用一条条修：总览的「每文件 Wiki 索引」里有 「检测需更新」，配合「修复过期条目」定向重建；想彻底自动就挂一条 cron 巡检任务。