用途
Knowledge Connect 用于分析语雀（Yuque）知识库中的文档，发现笔记之间的隐藏关联——包括相似主题、互补内容、共享概念等，并建议交叉引用链接，帮助用户构建相互连接的知识网络。
主要能力
- 分析单篇文档、整个知识库或跨知识库的文档。
- 从每篇文档中提取：主题、关键概念、提出的问题、引用来源、所属领域。
- 两两比对文档，识别以下关联类型：
- 🔄 同主题：从不同角度覆盖同一主题的文档。
- 🧩 互补：一篇文档回答了另一篇提出的问题。
- 📚 顺序：构成自然阅读顺序的文档。
- 🌱 演进：同一主题的早期与后期思考。
- 🔗 共享概念：引用同一关键概念的文档。
- 输出关联地图，包含关联类型、关联强度（星级）和具体关联说明。
- 列出暂未发现明显关联的“孤岛文档”。
- 在用户确认后，可在相关文档末尾追加“相关笔记”区块，添加交叉引用链接。
使用方式
该技能依赖 yuque-mcp 服务器提供的以下工具：
yuque_list_books— 列出用户的知识库yuque_list_docs— 列出知识库中的所有文档yuque_get_doc— 读取文档内容用于分析yuque_search— 搜索可能相关的文档yuque_update_doc— 向文档添加交叉引用链接
工作流程：
- 确定范围：用户提供单篇文档链接、指定某个知识库，或要求跨知识库分析。对于后两种情况，先调用
yuque_list_books列出知识库，再用yuque_list_docs列出目标知识库中的文档。 - 分析文档：对范围内每篇文档调用
yuque_get_doc获取内容，提取主题、关键概念、问题、引用和领域。 - 发现关联：两两比对文档，识别上述五类关联。单篇文档分析时，还会调用
yuque_search搜索相关文档。 - 呈现关联地图：以表格形式展示关联组，包含文档标题、关联类型、关联强度，并给出关联说明和具体交叉引用建议。同时列出孤岛文档和整体建议。
- 添加交叉引用（可选）：询问用户是否自动添加交叉引用链接。确认后，对每篇需要添加的文档调用
yuque_get_doc读取原文，在末尾追加“相关笔记”区块，再通过yuque_update_doc写回。追加内容格式如下：
---
## 📎 相关笔记
- 🔄 [相关文档标题](链接) — [一句话说明关联]
- 🧩 [相关文档标题](链接) — [一句话说明关联]
*由 AI 分析生成的关联推荐 — YYYY-MM-DD*
适用场景
- 用户想查找笔记之间的关联，例如说“帮我找找文档之间的关联”“哪些笔记是相关的”“connect my notes”。
- 用户刚写完一篇文档，想将其与相关笔记链接，例如说“这篇文档和哪些笔记有关”“find related documents”。
- 用户想从现有笔记构建知识图谱。
限制与注意事项
- 始终使用用户所用的语言回答（中文或英文）。
- 关联强度应基于实际内容重叠，而非仅标题相似。
- 需具体说明文档为何相关，避免笼统的“它们相关”。
- 不要强行建立关联；若两篇文档没有实质关联，不应链接。
- 对于大型知识库（超过 50 篇文档），建议按主题领域分批分析。
- “孤岛文档”区块有助于用户识别需要补充上下文的笔记。
- 添加交叉引用时，绝不修改原有内容，只在末尾追加。
- 对于有 3 篇及以上相关笔记的主题，建议创建索引/枢纽文档。
错误处理：
- 文档未找到（404）：跳过该文档并在报告中注明。
- 权限不足（403）：告知用户可能缺少访问该文档的权限。
- 知识库为空：提示“该知识库还没有文档，先写几篇笔记再来分析关联吧”。
- 知识库文档少于 3 篇：提示“文档数量较少，建议积累更多笔记后再做关联分析，效果会更好”。
yuque_update_doc失败：在对话中展示建议的交叉引用，供用户手动添加。- 一次分析的文档过多：建议缩小范围，例如“知识库文档较多，建议先选一个主题方向分析”。