2ryun
Wiki 知识库 使用手册
更新 ：2026-10-08
Wiki 知识库 使用手册
版本：2.0 | 最后更新：2026-10-04
Wiki 把你的文档编译成结构化知识：从正文里抽出概念、人物、方法、产品等条目，自动建立条目之间的关系，聚成知识社区，再以知识图谱的形式呈现。它不只是「搜索你的文档」——重点在关系。零散写下的内容会自己长出结构，然后可以被检索、被 AI Agent 调用，也可以发布成公开的知识作品。
目录
  • 快速开始
  • 启用与开关
  • 知识提取
  • 知识库首页
  • 编辑器侧边栏
  • 知识图谱
  • 整理知识库
  • 洞察与发现
  • 条目管理
  • 我的发布
  • 分类与关系体系
  • MCP 与 REST API
  • 计费
  • 最佳实践
  • 常见问题
    • 1. 快速开始1.1 启用进入 设置 → 功能/扩展，找到 @dave/llm-wiki，打开开关。1.2 让文档开始产出知识
  • 创建或打开一篇文档
  • 确认文档设置里的「Wiki 自动提取」是开着的（默认开）
  • 正常写作、保存
    • 首次保存后提取会立刻开始；之后同一篇文档反复保存，会等 5 分钟再提取——避免你还在打字就反复触发。
    空文档不会触发提取：判定时排除标题、只看正文，正文不足 50 个字符就跳过。「标题写了但正文还空着」不会白跑一次。
    1.3 查看结果左侧菜单 知识库 → 首页三个 Tab：知识条目 / 知识图谱 / 我的发布。也可以打开任意文档，看编辑器右侧的 Wiki 侧边栏——那里显示这篇文档抽出了哪些条目。
    2. 启用与开关
    关掉某篇文档的自动提取后，打开它的侧边栏会看到「Wiki 提取已关闭，请在文档设置中开启」，仍可在那里手动提取一次。
    3. 知识提取3.1 自动提取文档保存 → 触发提取 → AI 从正文抽条目 → 落库、算语义、建关系。触发节奏：
    • 首次：立即
    • 后续：去抖 5 分钟——期间连续保存，只在最后一次之后提取一次
    • 空文档：不触发（排除标题后正文 < 50 字符）
    提取完成后侧边栏会弹一条提示。3.2 批量提取（冷启动）知识库首页顶部有 初始化 / 继续提取 按钮，用来给已有文档补历史知识。弹窗里逐个文档显示结果：
    • ✅ 成功提取 N 个条目
    • ❌ 失败，附带原因
    • ⏭ 已跳过（提取过）
    每个文档可以单独重新提取，也可以直接跳到该文档。3.3 单篇提取 / 重新提取在文档侧边栏点 重新提取，或在批量进度窗口里对单个文档触发。3.4 从文档里抽什么AI 抽的是知识条目（概念、人物、方法、产品……），不是全文摘要。每个条目带：
    • 标题、正文、摘要
    • 分类（17 类，见第 11 章）
    • 置信度层级：extracted（原文明确写了）/ inferred（合理推断）/ ambiguous（存疑）
    • 来源文档链接
    • 与其他条目的关系
    不需要把文档写成「知识库格式」。写成正常的文章即可，提取质量取决于内容本身是否言之有物。
    4. 知识库首页顶部一行统计，每项都可点：
    下面三个 Tab：知识条目 / 知识图谱 / 我的发布。4.1 知识条目
    • 顶部是语义搜索框（回车搜索，支持分页）——按意思搜，不是关键词匹配
    • 可按分类筛选
    • 卡片网格：标题、置信度徽章、摘要、分类、匹配度
    • 点卡片看条目详情
    4.2 条目详情展示标题、状态徽章、分类、置信度、匹配度、来源文档、版本号、摘要、正文（Markdown，可全屏放大）、标签、关联条目，以及：
    • AI 补充（enrichment）：AI 对这条知识提出的补充或质疑，逐条处理（见第 9 章）
    • 知识网络小图：以这条条目为中心的自我中心关系图
    底部操作：禁用 / 恢复 / 删除。
    条目正文不能直接编辑。 知识是从文档编译出来的——要改内容就改来源文档再重新提取。这里只提供「禁用」「删除」这类管理动作。
    4.3 空态与上手引导知识库还是空的时候，首页只显示引导：两条路径（创建/导入文档，或 打开文档 → 设置 → 开自动提取）加一个跳转按钮。新账号的上手清单里也有「知识库」一项，完成第一次知识提取后自动打勾。
    5. 编辑器侧边栏打开任意文档，右侧是 Wiki 侧边栏。顶部四个操作：
    明确的状态提示——不用猜为什么没内容：
    已去重的条目排在最底下，用禁用样式 + 删除线显示，并标注「已去重 · 合并目标标题」；点一下可跳到合并后的正条目——所以不会「凭空少了一条」。
    6. 知识图谱6.1 两种渲染工具栏可切换：
    • 2D：力导向图，带迷你地图
    • 3D：three.js 渲染，可旋转缩放，带泛光效果
    6.2 工具栏
    6.3 显示设置三个滑块，调完记在本地（下次打开还是你的设置）：
    • 边亮度（0.1–3）
    • 节点辉光（0–2）
    • 全局辉光（bloom）（0–2）
    图谱还会按规模自适应：节点和边一多，辉光与连线亮度自动衰减，避免大图糊成一团。三种着色：
    • 按类型家族 —— 17 个分类归为 7 个家族（概念 / 实体 / 事件 / 流程 / 对比 / 来源 / 其他），一眼看出知识构成
    • 按度数 —— 从「红矮星」到「蓝巨星」的谱系，连接越多的条目越亮
    • 按置信度 —— 区分原文明确写了的和推断出来的
    图例会区分三类连线（系统 / LLM / 语义），过期条目用虚线。6.4 图谱出现在五个地方
    侧栏图谱是「以文档树为单位」看的，不是全局图的缩小版。这是有意的：写某篇文档时你关心的是这棵树内部的关系。
    7. 整理知识库7.1 整理做什么四件事：
  • 重建语义关系——按向量相似度找出内容相近的条目，连上「相关」边
  • 社区检测——用 Leiden 算法把关系密集的条目聚成知识社区
  • 清理——删掉太小的社区和孤立连接
  • 生成洞察——让 AI 读一遍，产出洞察与建议
    • 7.2 什么时候整理
    • 第一次批量提取完之后
    • 积累了较多新条目之后
    • 图谱看起来很散、条目之间没什么连线时
    整理要花 Token，点击前会二次确认。条目太少（不足 5 条）时不会产生社区——这是正常的，先多写点内容。
    7.3 去重与合并整理时同时处理重复条目：
    • 在同一分类下找出内容高度相近的条目
    • 每组选一个代表条目（置信度更高、内容更完整）
    • 其余标为「已合并」，并给出原因（内容已被包含 / AI 判定重复 / AI 要求合并）
    被合并的条目不会被删除，而是保留状态标记——侧边栏里显示为删除线样式，条目管理里可以查看与恢复。
    8. 洞察与发现点统计行里的聚簇数（灯泡图标）打开「洞察与发现」。这里展示整理产生的两类结果：
    • 知识社区（聚簇）：一组相关条目及其代表条目
    • 洞察：AI 从社区里读出的规律、缺口或建议
    可以删除单条洞察，也可以清空全部。
    每次整理会重新生成洞察（旧的全部清掉再写新的），所以洞察反映的是最近一次整理的状态。
    9. 条目管理从统计行的条目数（齿轮图标）进入，两个 Tab。9.1 异常条目筛选出三类：
    支持多选批量恢复 / 批量永久删除（永久删除有二次确认）。9.2 待审核补充（Enrichment）AI 在提取与整理时会给条目提出补充或质疑，共 9 类：
    每条可以 接受 / 接受并合并 / 拒绝。「接受并合并」会把补充内容并进条目正文。
    10. 我的发布知识图谱可以发布成公开作品，让别人浏览你的知识网络。10.1 发布在图谱工具栏点 发布到发现，填写：
    三个 GEO 开关：
    10.2 「我的发布」Tab已发布的图谱列在这里，卡片带封面、标题、徽章（不收录 / 禁 AI）、知识点·关联·条目计数、发布日。操作：打开 / 复制链接 / 编辑 / 取消发布（取消有二次确认）。10.3 访问统计点卡片上的浏览按钮：
    • 今日 / 昨日 / 7 天 / 30 天切换
    • PV / UV
    • 趋势曲线（当天按小时，更长区间按天）
    • 来源
    • 搜索关键词——别人通过什么词找到你这份知识图谱
    公开页在 /g/{id}，只读浏览；SEO / GEO 元信息由发布时的三个开关决定。
    11. 分类与关系体系11.1 条目分类（17 类）概念、人物、项目、事件、地点、组织、技术、工具、方法论、标准、产品、流程、术语、参考资料，以及媒体类（图片 / 视频 / 音频）。11.2 置信度层级（3 档）
    11.3 关系类型（三类来源）
    三类在图例里有区分，便于判断一条关系是「机器按规则算的」还是「模型理解的」。
    12. MCP 与 REST API12.1 MCP（给 AI Agent 用）Wiki 提供 MCP 服务，Agent 在对话里可直接操作知识库：
    12.2 REST API
    完整端点见 REST API 技术说明书。
    13. 计费知识提取、整理、AI 补充都会调用模型，按 token 消耗积分。
    • 提取：每篇文档一次
    • 整理：整库一次（条目多时消耗明显更大，点击前有提示）
    • 重新提取：与提取同价
    积分不足时提取会失败并在进度窗口里标出来，不会静默。
    14. 最佳实践14.1 文档怎么写
    • 言之有物：提取质量取决于内容本身，空泛的段落抽不出有用的条目
    • 一篇文章讲一件事：主题聚焦的文档抽出的条目更干净
    • 专有名词写全称：首次出现写完整，别一路用缩写
    • 别堆文档：一百篇流水账不如十篇有内容的
    14.2 提取策略
    • 新账号先批量初始化，之后靠自动提取增量维护
    • 有意关掉某些文档的自动提取——纯目录页、临时笔记关掉，既省 Token 也少嘈杂条目
    • 提取结果不理想时，改来源文档再重新提取，别指望手动改条目
    14.3 知识库维护
    • 定期整理：连线散乱、找不到关系时跑一次
    • 优先看「纠正质疑」和「数据矛盾」这两类 AI 补充，它们最可能有价值
    • 清异常条目：批量永久删除前扫一眼，确认合并目标是对的
    15. 常见问题Q：保存了文档，为什么侧边栏没有条目？按顺序查：①「Wiki 自动提取」是否开着；②排除标题后正文是否够 50 个字符；③是否刚保存不到 5 分钟（去抖期内不会立刻跑）。Q：条目内容不对 / 想改？条目不能直接编辑。找到来源文档（条目详情里有链接），改文档再重新提取。Q：为什么有条目显示删除线、标着「已去重」？它被判定为重复并合并到了另一条。点它可跳到合并后的正条目；合并结果不对的话，在条目管理里可以恢复。Q：整理之后洞察变了？每次整理会清空旧洞察并重新生成，洞察反映最近一次整理的状态。Q：图谱在侧边栏和首页看到的不一样？侧边栏是按当前文档树收窄的图，首页是全库图。这是有意的区分。Q：搜索搜不到刚提取的条目？搜索是语义检索（相似度低于阈值会被丢弃），换个说法试试；也可能是提取还没跑完。Q：公开页别人能看到什么？只读的图谱与条目浏览。要不要被搜索引擎收录、要不要允许 AI 引用，由发布时的三个开关决定。
    版本历史
    提示：如有问题或建议，请联系 2Ryun 团队。