YoudaoNote LLM Wiki 快速上手

YoudaoNote LLM Wiki（以下简称「Wiki Skill」）是一种为 AI Agent 设计的持久化知识库模式：你用自然语言把素材交给 AI Agent，Agent 在你的有道云笔记中自动编译并长期维护一个结构化的知识库——实体页、概念页、交叉引用都由 Agent 负责整理，你只需要策划方向。

相比传统搜索或 RAG「每次从零开始检索」，Wiki 模式是「编译一次、持续维护」——交叉引用已经建好、矛盾已经标记、综合分析反映全部素材。知识库保存在有道云笔记云端，天然多端同步、随时可查。

灵感来源：Andrej Karpathy 的 LLM Wiki 模式。

1. 与基础 Skill 的区别

YoudaoNote 提供两个 Skill，彼此并列、共存不冲突：

能力维度YoudaoNote Skill（基础）YoudaoNote Wiki Skill
定位单篇笔记的 CRUD、待办、剪藏可复合增长的知识库（Wiki）
适用场景「帮我保存一篇会议纪要」「把这篇文章整合进我的研究知识库」
Agent 行为按请求操作单篇笔记按 Wiki 结构维护实体、概念、交叉引用
是否依赖基础 Skill—是，Wiki Skill 在基础 Skill 与 CLI 之上工作
  • 基础 Skill 是日常工具，处理「存一条笔记」这类一次性需求
  • Wiki Skill 是长期资产，处理「构建并维护知识库」这类复合增长的需求

触发哪个 Skill 由 Agent 根据对话判断：提到「知识库」「Wiki」「记下来」「整合进 xx-wiki」等关键词时，Agent 会自动切换到 Wiki Skill。

2. 前置条件

在使用 Wiki Skill 之前请确认以下三项就绪：

  1. 已安装并配置 YoudaoNote CLI

    参阅 YoudaoNote CLI 快速上手 完成 CLI 安装与 API Key 配置。

  2. CLI 版本 ≥ 1.2.3

    在终端运行 youdaonote version 查看版本。若版本过低，升级命令：

    curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash -s -- -f -b ~/.local/bin

    Agent 发现版本过低时，也会主动引导你升级——直接对 Agent 说「升级 youdaonote CLI 到最新版」即可。

  3. 已安装 YoudaoNote Wiki Skill

    按你使用的 AI Agent 选择安装方式：

    • LobsterAI（有道龙虾）⭐ 推荐：下载最新版 有道龙虾，在「技能市场」中搜索并安装 youdaonote-llm-wiki。

    • 其他 AI Agent（OpenClaw、Cursor、Claude Code、OpenCode 等）：下载 youdaonote-llm-wiki-skill-latest.zip 并解压，将 youdaonote-llm-wiki 目录复制到你的 AI Agent 的 Skill 目录（具体路径参阅对应平台文档），按平台要求重启或热加载。

推荐（非必需）：同时安装 YoudaoNote 基础 Skill。Wiki Skill 本身不依赖基础 Skill，但基础 Skill 提供单篇笔记的 CRUD、待办、剪藏等日常操作；两者协同使用能覆盖更全面的使用场景。

3. 快速开始

在 AI Agent 对话中用自然语言完成三件事：创建知识库 → 摄入素材 → 查询知识。

第一步：创建你的第一个知识库

在对话中直接说：

帮我创建一个知识库，主题是 AI 研究

Agent 会：

  1. 建议一个知识库命名（如 ai-wiki），等你确认

  2. 在有道云笔记根目录自动创建知识库结构——一个根文件夹、五个子文件夹（raw、entities、concepts、comparisons、queries）、三个系统笔记（schema.md、index.md、log.md）

  3. 把这个知识库登记到全局注册表，之后任何新对话都能识别它

命名建议：采用 xxx-wiki 格式（小写、连字符），如 ai-wiki、invest-wiki，更易与普通笔记文件夹区分。你也可以自定义名称，无硬性要求。

第二步：把素材摄入知识库

把任意内容——URL、文本、文档——交给 Agent：

把这篇文章整合进我的 ai-wiki：https://example.com/transformer-explained

Agent 会自动：

  • 抓取网页内容，存入知识库的 raw/ 作为原始素材
  • 识别文中的关键实体（人物、组织、产品、工具），为每个新实体创建或更新 entities/ 下的条目
  • 识别关键概念（技术、方法论、主题），为每个概念创建或更新 concepts/ 下的条目
  • 在新旧页面之间建立交叉引用
  • 更新目录 index.md 与操作日志 log.md

一次摄入常会触发 5~10 个页面的更新——这就是知识复合增长的体现。Agent 完成后会汇报：

已摄入，新建 3 页，更新 5 页。以下内容你可能想深入讨论：
1. …
2. …
3. …

第三步：在知识库上查询

随时用自然语言提问：

在 ai-wiki 里，Transformer 和 RNN 各自有哪些典型应用？

Agent 会：

  • 先在 index.md 中定位相关页面
  • 读取所有相关页面（通常 3~8 个）
  • 跨页面综合分析，生成带来源引用的答案（例如 （→ transformer-architecture））
  • 若两个页面在同一点有不同说法，明确标出：⚠️ 「页面A」与「页面B」在此点有分歧

深度分析结论还可以直接归档进 queries/ 以便长期复用（见下节 Archive）。

4. 核心操作

Wiki Skill 提供四个核心操作，对应知识库的完整生命周期。你在对话中用自然语言触发，Agent 自动执行。

Ingest · 素材摄入

把 URL、文本、文档等外部素材整合进知识库。

触发示例：

把这篇文章整合进 ai-wiki：<URL>

以下笔记请存入 invest-wiki：
【正文内容…】

Agent 行为：读取原文 → 识别实体与概念 → 创建或更新 Wiki 页面 → 建立交叉引用 → 更新 index 与 log。

Query · 知识查询

在指定知识库上提问，获取跨多页面综合分析。

触发示例：

在 ai-wiki 里，什么是 self-attention？

根据 invest-wiki 里的记录，总结某公司过去三年的战略变化

Agent 行为：定位相关页面 → 读取并综合 → 回答时标注来源 → 对深度分析结论主动询问是否归档。

Lint · 一致性检查

审计整个知识库的健康度。

触发示例：

帮我审计一下 ai-wiki，看看有没有矛盾和孤立页面

Agent 行为：列出全部页面 → 对比 index → 检查矛盾声明、孤立页面（无交叉引用）、数据空白、index 完整性 → 输出发现列表并追加到 log。

Archive · 归档对话

把当前 AI 对话中有价值的结论直接存入知识库，不用切换工具。

触发示例（任意一种均可）：

把刚才关于 GPT-5 架构的那段结论存进 ai-wiki

记下来

归档这段对话

Agent 行为：识别要存的内容 → 判断类型（概念 / 对比 / 查询）→ 存入对应子文件夹 → 更新 index 与 log → 回复「已存入 concepts/xxx.md」。

5. 多知识库管理

可以为不同主题创建独立知识库，各自互不干扰——例如 ai-wiki 研究、invest-wiki 投资、work-wiki 工作。

切换当前知识库

在对话中说：

换到 invest-wiki

切换知识库

Agent 会列出已注册的全部知识库，让你选择。

若对话中已含明确知识库名（如「整合进 ai-wiki」），Agent 会自动选中，无需手动切换。

知识库注册表

所有知识库都会登记在有道云笔记根目录的 youdaonote-wiki-registry.md 笔记中，由 Agent 自动维护。

  • 每个知识库的 schema.md 是真相源，请勿删除
  • 注册表可以视为缓存，即便被误删，Agent 也能扫描根目录从各知识库的 schema.md 自动重建

6. 常见问题

Q：与 YoudaoNote 基础 Skill 有什么区别？

基础 Skill 处理单篇笔记（创建、读取、剪藏等），Wiki Skill 维护结构化知识库。两者共存不冲突，Agent 会根据对话关键词自动选择用哪一个。

Q：可以同时维护多个知识库吗？

可以，而且推荐。按主题分库（研究 / 投资 / 工作等）既便于检索，也便于维护一致性。Agent 通过注册表统一管理，你用自然语言切换即可。

Q：Agent 提示「CLI 版本过低」怎么办？

Wiki Skill 要求 YoudaoNote CLI ≥ 1.2.3。告诉 Agent「升级 youdaonote CLI 到最新版」，Skill 会引导你完成升级；或参考 CLI 快速上手 手动升级。

Q：知识库的笔记存在哪里？

全部在有道云笔记云端。你可以在手机 App、网页、桌面客户端随时查看和编辑。Agent 通过 CLI 读写这些笔记。

Q：raw/ 里的原始素材可以编辑吗？

按设计不建议编辑。raw/ 存放的是不可变的原始素材，编辑会破坏可追溯性。修正与补充请写在对应的 Wiki 页面（如 entities/ 或 concepts/ 下的页面），这些页面可自由编辑。

Q：知识库可以删除吗？

可以。在有道云笔记里删除知识库的根文件夹即可，同时编辑全局注册表 youdaonote-wiki-registry.md 移除对应行。

Q：Agent 有时认不出我要操作的是哪个知识库？

在对话中明确带上知识库名（如「整合进 ai-wiki」），或先说一句「切换到 ai-wiki」让 Agent 记住当前目标。

延伸阅读