跳转到主要内容
千问AI平台 home page
文档

结合 Obsidian 搭建本地知识库

使用 Qoder CLI 与 Qoderian 插件，将 Obsidian 笔记库改造为可由 AI 整理和维护的本地知识库

Qoder CLI 可在终端中读取当前目录的 Markdown 文件、分析目录结构并生成内容。结合 Obsidian 与 Qoderian 插件，可以让 Qoder CLI 直接在 Obsidian 笔记库中执行整理、归档、可视化等操作，将 Obsidian 从笔记工具升级为可由 AI 协作维护的本地知识库。
Qoderian 插件基于 MIT 许可的开源项目 Claudian 二次开发，针对 Qoder Agent SDK 进行了适配。Qoderian 开源仓库地址：github.com/QoderAI/Qoderian。

前提条件

  1. 已安装 Obsidian。
  2. 已安装 Qoder CLI，详见接入客户端/开发工具。

步骤一：安装并启用 Qoderian 插件

  1. 在 Obsidian 中打开设置 > 第三方插件，关闭安全模式（首次使用第三方插件需手动关闭）。Obsidian 对社区插件设有代码审查、开源、社区监督与用户反馈机制，关闭安全模式前可留意页面上的风险说明。
关闭安全模式设置，含第三方插件风险说明
  1. 在社区插件市场中搜索并安装 Qoderian。
社区插件市场搜索并安装 Qoderian
  1. 在已安装插件列表中启用 Qoderian。
在已安装插件列表中启用 Qoderian
启用后，Obsidian 左侧会出现 Qoderian 图标。点击图标，右侧会出现 Qoderian 对话面板。对话默认关联当前正在查看的文件，无需额外配置，只要本机已安装 Qoder CLI 即可直接使用。 可以直接通过对话下发任务，例如让 Qoder CLI 将当前文章整理为一份思维导图，它会在同一目录下生成结果文件。
Qoderian 对话面板下发任务并生成思维导图结果

步骤二：整理网页剪藏内容

  1. 安装 Obsidian 官方的 Web Clipper 浏览器插件（在浏览器插件市场搜索安装），用于将网页内容保存为 Markdown 文件存入 Obsidian 笔记库。
浏览器插件市场中的 Obsidian Web Clipper
  1. 浏览网页时，点击 Web Clipper 图标即可将当前页面保存到 Obsidian。
使用 Web Clipper 将网页保存到 Obsidian
  1. 积累一定数量的剪藏后，在 Qoderian 对话面板中下发整理指令，例如： 
    把 A 文件夹里的文章都过一遍，提炼核心观点，存到 B 文件夹
Qoder CLI 会读取指定文件夹下的所有文件，提炼要点并按统一格式输出到目标文件夹。
Qoder CLI 整理网页剪藏内容并输出到目标文件夹

步骤三：配置整理规则

若需要固定的整理风格与规范，可让 Qoder CLI 在笔记库根目录创建 AGENTS.md： 
帮我新建一个 AGENTS.md，用来管理这个 Obsidian 知识库的整理规则
Qoder CLI 会在当前 vault 根目录下创建项目级记忆文件 AGENTS.md。配置完成后，后续下发整理指令时会自动遵循其中定义的规范，无需重复说明要求。 如需调整规则，直接在 Obsidian 文件列表中打开 AGENTS.md，像编辑普通笔记一样修改即可。
AGENTS.md 文件内容示例，定义知识库整理规则

步骤四：生成可视化图表

  1. 在设置 > 第三方插件 > 社区插件市场中搜索并安装 Excalidraw 插件，用于在 Obsidian 中创建手绘风格的图表、流程图和结构图。
社区插件市场搜索并安装 Excalidraw
  1. 安装图表生成 Skill：将 Skill 仓库地址提供给 Qoder CLI 并要求安装： 
    请帮我安装这个 skill：https://github.com/coleam00/excalidraw-diagram-skill
向 Qoder CLI 提供 Skill 仓库地址并完成安装
  1. 安装完成后，通过斜杠命令调用该 Skill 生成图表： 
    /excalidraw-diagram 请根据当前这篇笔记，生成一个适合教学展示的手绘风格流程图
生成完成后即可在 Obsidian 中查看和编辑 Excalidraw 图表。
生成的 Excalidraw 手绘风格流程图