CC

Obsidian AI Agent 配置指南：Claudian + Obsidian Skills

Thu, 18 Jun 2026 00:00:00 GMT

1. 核心组件

Claudian: Obsidian 第三方插件（暂未上架官方市场），适配 Claude Code。
Obsidian Skills: 由 Obsidian CEO (Kepano) 发布的 Skill 包，赋予 AI 处理 Canvas、Markdown 及数据库的能力。

2. 环境部署流程

2.1 安装 Claudian 插件 (手动旁加载)

获取文件: 访问 GitHub 仓库 claudian，下载以下三个核心文件：
- main.js
- manifest.json
- styles.css
放置插件:
- 进入 Obsidian 仓库根目录。
- 路径导航: .obsidian -> plugins。
- 新建文件夹命名为 claudian。
- 将上述三个文件放入该文件夹。
启用: 重启 Obsidian，在“第三方插件”中开启 Claudian。

2.2 配置模型参数

打开 Claudian 设置页。
基础设置: 设置 User Name (如 Jason)。
自定义AI模型: 使用智谱GLM或DeepSeek来替换Claude模型。

ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_API_KEY=你的智谱api key
ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-4.6

连通性验证:
- Ctrl/Cmd + P 调出命令面板 -> 输入 claudian -> 选择 Open chat view。
- 发送“你好”，若回复正常则^1配置成功。

2.3 部署 Obsidian Skills

下载: 访问 GitHub 仓库 kepano/obsidian-skills，下载 ZIP 包并解压。
安装:
- 复制解压后的 skills 文件夹。
- 进入 Obsidian 仓库根目录。
- 进入或新建 .claude 隐藏文件夹。
- 粘贴 skills 文件夹 (最终路径: [Vault Root]/.claude/skills/)。
验证: 在 Claudian 对话框输入 /skills，应显示以下三个 Skill:
- obsidian-markdown: 处理专有 Markdown 语法。
- json-canvas: 生成/编辑无限画布。
- obsidian-bases: 数据库管理。

3. 实战应用与技巧

3.1 典型用例：生成知识图谱

指令: “使用无限画布 canvas 画出地中海饮食的知识结构图，并保存到根目录。”
流程: AI 自动调用 json-canvas skill -> 分析逻辑 -> 在根目录直接生成 .canvas 文件。

3.2 优化

由于 Skill 定义为英文，中文指令可能导致匹配偏差，建议方案：

显式指令: 在 Prompt 中明确指定工具名 (如“请使用 json-canvas skill...”)。
系统提示词 (System Prompt): 在插件设置中添加规则 —— “收到指令后优先思考并匹配最合适的 Skill”。

4. 理念解析：Why Local Agent?

官方态度 (Stephan Ango/Kepano):
- 发布渠道: 选择在个人 GitHub 账号而非 Obsidian 官方账号发布，体现了“非官方强制”的定位。
- 核心哲学: 知行合一。坚持 Local-first 和 Privacy-first，不构建封闭的官方 AI 环境，也不参与 AI 军备竞赛。
差异化优势:
- 不同于 Notion 的云端封闭生态。
- Obsidian 文件完全本地化，鼓励用户基于隐私安全，“手搓”适合自己的 AI Agent。

Git 进阶操作：版本管理与分支管理

Sun, 05 Apr 2026 00:00:00 GMT

版本管理：

精细化历史查询：如何只看某一个文件的修改历史。
版本回退：如何安全或强力地让文件、甚至整个知识库回到过去。
内容追溯：如何知道笔记中的某句话是何时、为何写下的。

分支管理：

创建与切换分支
合并分支
解决文件冲突

一、Git Log：如何查看单个文件的“成长日记”

核心操作

最基础的命令是在 git log 后面跟上 -- 和文件路径。-- 是一个好习惯，它能明确告诉 Git 后面跟的是文件路径，而不是分支名。

命令 · 基本用法：查看特定文件的所有 commit 记录
git log -- <文件路径>
示例:
git log -- "我的读书笔记.md"

让输出信息更友好

默认的 log 信息对非技术用户不太友好，我们可以用参数来美化它。

命令 · 单行清爽模式 以单行形式展示，只看 commit 哈希值和标题，非常清爽。
git log --oneline -- <文件路径>

命令 · 查看修改统计 展示更详细的统计信息，能看到每次提交具体增加了哪些行、删除了哪些行。
git log --stat -- <文件-路径>

命令 · 查看具体修改内容 (最实用) 这是最强大的参数，-p 是 --patch 的缩写，它会展示每一次提交具体修改了什么内容。
git log -p -- <文件路径>

Git 版本回退：文件级“后悔药”与提交级“时光机”

在知识管理中，我们难免会写错东西或误删内容。Git 提供了多种“后悔药”，但它们的用途和场景完全不同。对于 Obsidian 用户来说，最常用、最重要的是针对单个文件的回退。

首先，我们用一个表格来快速对比这三个命令的核心区别：

| 命令 | 主要作用域 | 是否修改历史 | 核心比喻 | | --------------- | ----------------- | ----------------------------- | ----------------------------------- | | git restore | File (文件) | 否 (只修改工作区/暂存区) | 橡皮擦 (擦掉文件的特定修改) | | git revert | Commit (提交) | 否 (创建新提交) | 会计师 (做一笔反向操作来冲账) | | git reset | Commit (提交) | 是 (移动指针，可丢弃提交) | 时光机 (直接回到过去，未来消失) |

一、文件级后悔药：git restore (Obsidian 用户最常用)

git restore 是专门为恢复文件而生的命令，它从不触碰你的提交历史，非常安全。它有两个核心功能，覆盖了我们 95% 的日常“反悔”需求。

功能1：丢弃工作区的修改 (橡皮擦)

提示 · 场景：我不小心修改了一篇笔记，但还没提交 (commit)，现在想撤销所有改动，让它恢复到上次保存到版本库时的样子。

这就像用橡皮擦擦掉你在笔记上的草稿，让它变回干净的版本。

命令 · 丢弃本地修改
git restore <文件路径>
示例:
git restore "我的读书笔记.md"

功能2：从历史中恢复文件 (时光机捞取)

提示 · 场景：我需要找回某篇笔记在几天前某个版本的内容，但又不想影响知识库里其他任何文件。

这就像坐上时光机，去到过去，只把那一个文件“捞”回来。

命令 · 从指定 commit 中恢复文件
git restore --source=<commit哈希值> <文件路径>
示例:
git restore --source=1a2b3c4 "我的读书笔记.md"
执行后，这个文件的内容就变回了 1a2b3c4 时的样子。这个“恢复”本身会成为一个新的本地修改，你可以检查后再次提交。

二、提交级后悔药：git revert 与 git reset

这两个命令更强大，也更危险，因为它们操作的对象是整个 Commit (提交)，会一次性影响一批文件的修改。在 Obsidian 的日常使用中，这种情况较少见，但了解它有助于应对重大失误。

警告 · 核心区别

git revert 和 git reset 针对的是整个提交记录，不是单个文件。

如果你只是想恢复某个文件，请永远优先使用 git restore。

如果你确定要撤销一整批修改（一个 Commit），那么更推荐使用 git revert。

The Safe Choice: git revert (安全的会计师)

它通过创建一个新的提交来抵消旧的错误提交，不会修改历史，非常安全。

成功 · git revert (推荐)

比喻：像会计师做一笔反向操作来冲账，所有记录都清晰可查。

场景：当你需要撤销一个已经推送到远程（如 Gitee/GitHub）的提交时，这是唯一推荐的做法。

命令：git revert <commit哈希值>

The Nuclear Option: git reset (危险的时光机)

它会真实地修改历史，让你的知识库强制回到过去某个时间点，之后的提交记录会被抛弃。

危险 · git reset (谨慎使用)

比喻：像启动时光机，回到过去，之后发生的一切都烟消云散。

场景：只应在你自己本地、还未推送分享的提交上使用，用来清理凌乱的本地历史。绝对不要对已推送的提交使用！

命令：git reset --hard <commit哈希值>

三、Git Blame：甩锅！

这个功能的名字有点吓人，但对于知识管理来说，它不是用来“指责”(Blame)，而是用来“追溯”的。（如果是软件开发：那我就是来甩锅的）

核心操作

命令 · git blame 命令行操作
git blame <文件路径>
示例:
git blame "项目A策划案.md"

它的输出会显示文件的每一行内容，并在行首标注出：修改这一行的 commit 哈希值、作者、以及修改日期。

Git 分支管理核心命令笔记

分支是 Git 的最强大的功能，它允许你创建独立的开发线进行工作，做到平行开发，互不干扰。

一、查看与切换分支

命令 · 列出所有本地分支
git branch
当前所在的分支会以 * 标记。

命令 · 创建新分支
git branch <分支名>
示例: git branch feature/new-article

这只创建了分支，你当前的位置并未移动。当前在main分支下，就是从main分支下创建出一个新分支，但你依然停留在main分支下，你需要手动切换到这个新分支。

从指定分支中，创建一个分支：git branch <新分支名> <源分支> 比如：git branch hotfix/login-bug main 意思就是从main分支中，创建一个叫hotfix/login-bug的新分支。对于个人Obsidian用户，大多情况下都在main分支上，想要创建新分支就直接用git branch <分支名>就可以了

命令 · 切换到指定分支
git switch <分支名>
示例: git switch feature/new-article

这是推荐的现代命令。旧命令 git checkout <分支名> 同样有效。

提示 · 创建并立即切换 (常用)
git switch -c <分支名>
示例: git switch -c bugfix/typo-in-note

这一个命令等同于 git branch 和 git switch 两步操作。

二、合并与删除分支

当分支的工作完成后，将其成果合并回主线 (main 或 master)。

信息 · 合并分支的标准流程

首先，切换回你的主分支。 git switch main

然后，执行合并命令，将目标分支的成果合并进来。 git merge <要合并的分支名> 示例: git merge feature/new-article

命令 · 删除已合并的分支
git branch -d <分支名>
示例: git branch -d feature/new-article

-d 是 --delete 的缩写，它会安全地检查该分支是否已被合并。如果有没有被合并的修改，它会阻止删除。

三、解决合并冲突

当你和主分支修改了同一个文件的同一处时，git merge 会失败并提示冲突。

危险 · 解决冲突的标准流程

打开冲突文件。 Git 会在文件中用特殊标记标出冲突区域： <<<<<<< HEAD (你当前分支的修改)

<另一分支名> (被合并分支的修改)

手动编辑文件。 删除所有 Git 添加的特殊标记行，只保留你最终想要的内容。

标记冲突已解决。 使用 git add 命令将修改后的文件加入暂存区。 git add <冲突文件的路径>

完成合并。 执行 git commit 命令，Git 会自动生成一个合并提交信息，直接保存即可。此时，冲突解决完毕。

Obsidian 官方 CLI 命令全景速查表

Sun, 05 Apr 2026 00:00:00 GMT

核心执行逻辑说明：

基础格式：obsidian <命令> 参数名=参数值标记参数
含有空格的值必须加双引号，例如：content="Hello world"。
标记参数（如 open, inline, total）不需要赋值，写上就代表启用。
以下表格中 file=Recipe 代表对库中名为 Recipe 的文件执行操作，实际使用时需要替换为你库中真实存在的文件名。

Obsidian CLI 典型自动化应用场景与工作流

| 工作流名称 | 功能简介 | 涉及的 CLI 命令 | | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- | | **1. 全局极速闪记 ** | 痛点：记录一闪而过的灵感时，打开软件、等插件加载、找文件太慢。方案：在 Raycast、Alfred 甚至手机捷径中绑定一段终端脚本。输入文字后，脚本在后台直接调用 CLI，将文字无感追加到今天的日记末尾。完全不需要唤醒 Obsidian 界面。 | obsidian daily:append content="灵感内容" | | 2. 播客/视频沉浸式知识榨取 | 痛点：看完 YouTube 视频后，手动整理笔记并建立待办事项费时费力。方案：把链接丢给 OpenClaw 或 Telegram 机器人。AI 提取字幕并总结后，调用 CLI 直接使用你的“媒体笔记模板”创建新文件，并把提取出的行动项自动打上标签，插入到当天的日记中。 | obsidian create name="视频名" template="Media"obsidian daily:append content="- [ ] 待办项" | | **3. AI 收件箱自动分拣员 ** | 痛点：平时用 Web Clipper 随手剪藏的网页堆积在 Inbox 文件夹，变成“赛博垃圾场”。方案：利用 n8n 建立定时任务，让大模型批量阅读 Inbox 里的文件。理解内容后，通过 CLI 规范化注入 YAML 属性（如作者、分类），最后安全地将文件重命名并移动到对应的归档文件夹。CLI 会自动更新全库的双链，绝不断链。 | obsidian files folder="Inbox"obsidian read file="未命名"obsidian property:set name="category" value="AI"obsidian move file="旧名" to="新路径" | | 4. 绝对隐私的本地 RAG 对话助理 | 痛点：搭建向量数据库（Chroma/Milvus）太繁琐，且每次笔记更新都要重新 Embedding（向量化）。方案：在本地运行 Claude Code 或本地大模型，赋予其 CLI 执行权限。AI 会根据你的提问，自主使用带有上下文的全局搜索指令，并通过提取反向链接顺藤摸瓜，构建准确的背景知识库后再回答，完全零配置。 | obsidian search:context query="关键词"obsidian backlinks file="检索到的文件"obsidian read file="目标笔记" | | 5. 跨平台数据库级联录入 | 痛点：外部数据（如记账、习惯打卡）很难干净地录入到 Obsidian 的表格或 Dataview 中。方案：结合 Obsidian 1.12 最新的 Bases（数据库）功能。通过 n8n 接收外部 Webhook（比如银行消费短信），直接让 CLI 在指定的 Base 文件中创建一条新记录，并严格按数据类型（数字、日期）注入字段。 | obsidian base:create file="财务库" name="打车"obsidian property:set type="number" value="30" | | 6. 历史知识自动唤醒与破冰 | 痛点：记录了大量笔记但从不回顾，知识变成死水。方案：每天早晨执行一个自动化脚本，利用 CLI 提取一篇早于 1 年前的随机笔记，交给 AI 提炼核心观点，并与你最近一周关注的标签（如 #Agent）进行强行跨界联想，将联想结果作为“每日思考”追加到今天日记中。 | obsidian random:read folder="卡片盒"obsidian tags sort=count limit=5obsidian daily:prepend content="AI的跨界联想" | | 7. 批量元数据重构与清洗 | 痛点：笔记库用久了，属性极其混乱（比如状态标签混用了 doing、in-progress、进行中），导致 Dataview 列表报错。方案：让 AI 脚本遍历你的核心文件夹，读取现有的属性值，统一转换为标准格式，然后用 CLI 进行批量覆写。这种方式强制符合 YAML 语法，绝不会多一个空格或少一个引号。 | obsidian propertiesobsidian property:read name="status"obsidian property:set name="status" value="标准值" |

Obsidian CLI 核心原理

Sun, 05 Apr 2026 00:00:00 GMT

Obsidian CLI 是一个通过命令行操作 Obsidian 笔记库的官方工具（需要 Obsidian 1.12 以上版本）。它的核心功能是为 AI 智能体（如 Gemini CLI、Claude Code、OpenClaw）和自动化工作流（如 n8n）提供原生交互接口，解决 AI 扫描整个笔记库产生高额 Token 消耗的问题。

架构机制对比

开启与基础配置

确认系统环境，保证 Obsidian 客户端版本在 1.12 以上。
进入 Obsidian 界面，打开“设置 -> 常规 (General)”。
找到“命令行界面 (Command line interface)”开关并打开。
在弹出的窗口中确认注册到系统 Path。
保证 Obsidian 客户端处于运行状态（如果在未运行状态下执行命令，系统会自动启动客户端）。

验证配置成功的方法是打开操作系统的终端工具（Mac 使用 Terminal，Windows 使用 PowerShell），输入下面这个基础命令：

obsidian daily

如果配置正确，Obsidian 会直接自动应用日记模版并在界面中生成今天的日记文件。

AI 智能体集成方案

为了让智能体工具掌握使用命令行的能力，我们需要为它们配置专门的 Agent Skill。这里以 Obsidian CEO (Steph Ango) 开发的官方 Skill 仓库为例。

配置 Agent Skill 目录

工具链需要严格的目录层级支持。针对不同的智能体工具，配置路径有严格的区别，必须保证 SKILL.md 文件在规定的层级内：

完成目录配置后，智能体就具备了直接向 Obsidian 进程发送指令的能力。

场景案例与代码实现

案例一：让 Gemini CLI 抓取文献并生成笔记

在这个场景里，我们让智能体抓取外部数据，再用 Obsidian CLI 把数据写入笔记。

执行提示词：

任务：获取 arXiv 最新 AI 论文并写入 Obsidian 今日日记。

请按以下步骤执行：

1. 获取论文数据
   从以下 RSS feed 获取论文列表：
   https://export.arxiv.org/rss/cs.AI

解析 RSS 内容，并 **按发布时间排序，选取最新发布的 10 篇论文**。

2. 提取并处理字段
   对每篇论文保留以下字段：

* title
* abstract
* link
* published date

然后执行以下处理：

* 将 **title 翻译为中文**
* 将 **abstract 翻译为中文**
* 保留原始 link
* 保留 published date

3. 整理为 Markdown 表格

生成如下格式的 Markdown 表格：

| 标题（中文） | 摘要（中文） | 原文链接 | 发布日期 |
| ------ | ------ | ---- | ---- |
| ...    | ...    | ...  | ...  |

要求：

* 每篇论文一行
* 摘要不要截断

4. 写入 Obsidian 日记

使用 **obsidian-cli skill** 完成以下操作：

* 创建或打开 **今天的日记**
* 在日记末尾追加以下内容：

## 今日AI论文

（在这里插入生成的 Markdown 表格）

5. 写入规则
* 必须使用 `obsidian-cli` skill 完成 Obsidian 操作，不要直接操作文件系统。

案例二：通过 Python 脚本调用

使用代码调用 CLI 命令适合每日定时触发的确定性任务。让 AI 编写代码时，要把 Obsidian CLI 的官方文档发送给 AI 提供上下文。

生成代码的提示词：

**角色设定**：你是一位精通 Python 和自动化办公的专家，为我编写一个 Python 自动化脚本。
**任务目标**：我需要从 [输入源，例如：ArXiv API] 获取最新的 [内容类型，例如：AI 相关论文]，并将这些内容整理后通过Obsidian-CLI发送到我的Obsidian。
**详细需求**：
1. **数据获取**：从这个接口 [粘贴 URL] 获取前 10 条数据。我需要提取论文的“标题”、“发布日期”、“摘要（限制 200 字）”和“原文链接”。
2. **数据格式化**：将这些数据整理成 Markdown 表格形式，表头为：序号 | 论文名称 | 发布日期 | 简介 | 链接。
3. **与软件交互**：使用命令行方式调用Obsidian-CLI来创建并写入这些内容。

    - 使用模版 [模版名] 创建名为 [笔记名] 的笔记。

    - 然后将表格内容逐行追加到笔记中。

    - 最后自动在软件中打开这个笔记。

4. **稳定性要求**：

    - 考虑 Windows 系统的兼容性，确保代码在输出中文或特殊符号时不会报错（强制使用 UTF-8 编码）。

    - 因为是自动化脚本，如果操作失败（比如软件没响应或命令执行错误），务必在终端里清晰地打印出错误原因，不要静默崩溃。

    - 代码结构要清晰，方便我修改里面的配置参数（如笔记名称、搜索关键词等）。

案例三：在N8N工作流中调用

需要在本地部署N8N，以便于N8N能够直接访问本地文件系统。在Docker中部署的N8N无法做到这一点。
启动N8N的时候，设置参数来保证所有节点都可用：set NODES_EXCLUDE=[] && n8n start。（n8n 2.x 为了安全，默认禁用了涉及本地文件系统操作和 Shell 命令的节点。）
添加Execute Command节点，设置执行命令：python C:\Users\jason/obsidian-cli-diary-code.py。
点击Execute Step按钮测试。
注意事项：如果遇到utf-8编码问题，启动n8n的时候添加参数：set PYTHONIOENCODING=utf-8 && n8n start。

注意事项

Obsidian CLI 的所有命令执行都依赖 Obsidian 桌面端程序的运行状态。
在本地运行 OpenClaw 这类高频自主智能体时，需要严格监控 Token 消耗。确定的日常操作建议全部转交给 n8n 或 Python 脚本。
浏览器内容抓取可以配合 defuddle 这个 Skill 工具，把网页内容清洗成干净的 Markdown 格式后直接写入笔记库。

官方理念与隐私边界

Obsidian 联合创始人是 Erica Xu 和 Shida Li。现任 CEO 是 Steph Ango（网络 ID 是 kepano）。

官方坚守本地优先和数据隐私底线。官方决不在软件内部强制集成任何云端 AI 模块。CLI 工具充当了一个开放的外部操作手脚。用户全权决定把笔记库接入哪种 AI 框架。

有极高隐私要求的用户可以使用 NAS 进行多端数据同步。配合本地部署的大语言模型处理数据。根据2026年的前沿模型能力测试，70B 级别的本地开源模型在执行多步骤、重度依赖工具调用的智能体任务时，表现一般。长周期任务规划能力明显弱于前沿闭源模型。智能体操作具有不可控风险。必须通过 Git 定时提交做好知识库版本备份。

Obsidian 必装 Skills

Sun, 05 Apr 2026 00:00:00 GMT

Obsidian CEO 发布的 Skills

defuddle

Skill功能

Defuddle 主要用来抓取网页里的核心正文。它会自动删掉导航条、侧边栏和广告等干扰元素，只留下干净的 Markdown 内容。这个功能让 AI 在处理长文章、在线文档或博客时，不仅能读得更准，还能大幅减少不必要的字符开销。最近一次更新中已经支持YouTube视频链接，它获取YouTube视频字幕的方式是调用YouTube官方API，而不是我们之前熟知的yt-dlp组件。

所需依赖

Node.js 运行环境。
全局安装的 defuddle 包，安装命令是 npm install -g defuddle。

触发条件和使用方法

当你给 Agent 发送一个网页链接（URL），并要求它阅读、分析或总结里面的内容时，就会触发这个 Skill。

提示词样例：

提取这个网页的正文，转成干净的 Markdown 格式：[URL]。

注意事项

这个工具对标准 HTML 网页（如新闻、博客、官方文档）效果最好，但如果网页需要登录或者是纯动态渲染的单页应用，抓取效果可能受限。

obsidian-cli

功能开启与基础配置

确认系统环境，保证 Obsidian 客户端版本在 1.12 以上。
进入 Obsidian 界面，打开“设置 -> 常规 (General)”。
找到“命令行界面 (Command line interface)”开关并打开。
在弹出的窗口中确认注册到系统 Path。
保证 Obsidian 客户端处于运行状态（如果在未运行状态下执行命令，系统会自动启动客户端）。

验证配置成功的方法是打开操作系统的终端工具（Mac 使用 Terminal，Windows 使用 PowerShell），输入下面这个基础命令：

obsidian daily

如果配置正确，Obsidian 会直接自动应用日记模版并在界面中生成今天的日记文件。

obsidian-bases

Skill 功能

这个 Skill 允许 AI 通过编写 YAML 格式的 .base 文件来创建Obsidian bases数据库。它支持非常强大的公式系统，可以读取笔记的 Frontmatter 属性或文件元数据（如创建时间、字数等），并进行条件判断、日期运算和字符串处理。

所需依赖

Maps 插件：如果需要使用这个 Skill 里的 map（地图）视图，必须额外安装名为 Maps 的社区插件。

触发条件和使用方法

样例提示词：

写一个 .base 文件来管理我的项目笔记，要求筛选出所有带 #project 标签的文件，用表格显示项目名称、截止日期和剩余天数。

视图限制：目前只支持 table（表格）、cards（卡片）、list（列表）和 map（地图）这四种类型。

obsidian-markdown

使用方法

样例提示词：

根据这段会议记录生成一份 Obsidian 笔记。要求在顶部包含日期和参会人的属性，使用双向链接关联到“项目 A”笔记，并把关键决策点用important类型的提示框标注。

扩展：因为skill是对格式的语法和约束，所以可以将个人obsidian格式偏好加入到skill中，以保证Agent写出的知识笔记符合你的要求。

json-canvas

使用方法

样例提示词：

创建一个名为“AI 学习路径”的 json canvas文件。中心是一个文本节点，连向三个文件节点，分别是“模型基础”、“提示词工程”和“智能体实战”。

obsidian-canvas-creator

Skill 功能

内置了径向布局（MindMap）和自由排版（Freeform）算法，能够自动计算节点坐标、处理连接线路径、并根据文本长度动态调整节点尺寸，从而生成整齐、美观且逻辑清晰的视觉架构。

使用方法

样例提示词：

把这markdown知识笔记转换成一个mindmap格式的 Obsidian Canvas。

与 json-canvas skill 的对比

侧重点不同：json-canvas 主要关注底层的 JSON 语法正确性和属性定义；而 obsidian-canvas-creator 侧重于高层的排版策略和空间坐标计算。
自动化程度不同：使用 json-canvas 时，AI 可能只是机械地摆放节点；使用本 Skill 时，AI 会根据 layout-algorithms.md 计算每个节点的 X/Y 坐标，确保节点不重叠且间距符合视觉审美。
结构化逻辑：本 Skill 引入了特定的布局模式（如 MindMap 模式和 FreeForm模式），能自动处理父子层级关系，而不仅仅是单一的节点创建。

mermaid-visualizer

使用方法

样例提示词：

根据这段关于软件开发生命周期的描述生成一个横向的 Mermaid 流程图，要求包含不同的子图来区分开发环境和测试环境。

excalidraw-diagram

所需依赖

Excalidraw 插件：必须安装并启用 Excalidraw 插件。

触发条件和使用方法

样例提示词：

用 Excalidraw 画一个 AI 智能体的工作流动画图，按照感知、思考、行动的顺序设置动画步骤，并保存为 .excalidraw 文件。

tutor-skills

Skill 功能

tutor-setup 能将任何本地文档或源代码工程自动解析，并生成带有双链、MOC 和复习题的独立 Obsidian 学习金库 (StudyVault)；而 tutor 则读取知识库的进度数据，在终端内为你生成互动式测验，追踪并攻克你的知识薄弱点。

所需依赖

基础环境：智能体工具如 Claude Code, OpenCode。

使用方法

使用方法：在特定工作目录输入命令 /tutor-setup 触发构建，或在已有 StudyVault 的目录下输入 /tutor 触发复习。

Skill 的特殊机制

模式自动侦测：无需手动指定，Skill 会自动扫描当前工作目录，若发现 package.json 或 pom.xml 等工程文件会自动进入“代码库模式”；若只有 PDF/纯文本，则进入“文档模式 ”。

注意事项

Token 消耗风险：尽管禁止了 PDF 图像读取，但“代码库模式”会递归读取大量源文件并进行架构溯源（Phase C1-C9 循环），在短时间内消耗大量 Token 额度。

scholar-skill

Skill 功能

scholar-skill 是一个深度的个人知识管理与文献解构工作流。它通过分级标准（L1分发/L2标准阅读/L3深度解构），将原始论文（PDF/ArXiv）转化为 Obsidian 中的双链卡片、MOC（内容地图）以及系统性的反思报告。它还能记录你阅读过程中的误区并提取可复用的研究方法论。

所需依赖

要运行此系统，你需要配置一套相对重型的底层环境：

基础环境：本地 Python 环境与预先安装好的 Obsidian 客户端（及配置好的 Vault 文件夹）。
核心框架：安装配置好的 OpenClaw 智能体框架。
依赖 Skill (通过 ClawHub 安装)：
- obsidian-direct（必须）：用于绕过官方限制，直接通过 Python 强行读写本地 .md 文件。
- arxiv-watcher（必须）：用于通过 ArXiv API 抓取文献资源。
- durable-task-runner（核心必须）：用于支持 L3 级别长时间挂机任务的调度与断点续传。
- 增强依赖（可选）：tavily（联网抓取）、pdf（文本解析）、academic-research-hub。

触发条件与使用方法

触发条件：当意图匹配到“阅读论文”、“L1/L2/L3阅读”、“知识内化”或“文献笔记”时自动触发工作流。
使用方法（提示词样例）：

获取这篇文献 ArXiv:2407.19354 并进行处理。
先做 L1 快速评估，如果判定为 P0 优先级，则请在后台直接启动 L3 深度阅读。
完成后将知识树更新推送到我的 Obsidian 对应目录。

Skill 的特殊机制

超长周期任务编排：由于大模型无法一次性吃透几十页附带复杂公式的论文，L3级深度阅读被设计为长达 2.5 小时的异步挂机任务。底层深度依赖 OpenClaw 的 durable-task-runner 来处理多次 LLM 推演循环、API 限流等待以及崩溃恢复。
周期性反思机制：内置时间触发器逻辑，强制在周末或月末对“临时存储的知识”进行 L2/L3 反思，生成知识体系演进报告。
人类确认防呆机制：当 AI 发现新论文推翻了你旧笔记的结论时，不会直接覆写旧笔记，而是生成一份确认单放进 0-Inbox 文件夹，等待人类审核确认（Human in the loop）。

注意事项与风险预警

财务毁灭/算力黑洞风险：长达 2.5 小时的 L3 循环和高频的历史知识检索（RAG）会消耗极其恐怖的 Token。如果后端挂载的是商用前沿模型（如 Claude 3.5 Sonnet 或 GPT-4o），单篇深读可能带来高昂的 API 账单。
数据覆写与坏档风险：底层的 obsidian-direct 使用的是民间 Python 暴力文件 I/O 脚本，而非 Obsidian 官方 CLI 通信。在文件多端同步（如 iCloud/Obsidian Sync）期间，极易引发文件冲突、内容丢失或双链索引错误。强烈建议在独立测试库中运行，并开启 Git 快照。

核心插件

claudian: Obsidian 第三方插件（暂未上架官方市场），适配 Claude Code。GitHub Repo: YishenTu/claudian
obsidian-agent-client: 第三方插件（暂未上架官方市场），适配主流智能体：Claude Code, Codex, Gemini CLI, OpenCode, Qwen Code。GitHub Repo: RAIT-09/obsidian-agent-client

1. 安装方式

方案 A：通过 BRAT 安装 (推荐)

这是保持插件自动更新的最佳方式，适合尚未上架市场的 Beta 插件。

安装 BRAT: 在 Obsidian 插件市场搜索并安装 BRAT。
添加仓库: 打开设置 -> BRAT -> Add Beta plugin，输入仓库地址：YishenTu/claudian。
启用: 点击 Add Plugin 等待下载完成后，在“第三方插件”列表中开启 Claudian。

方案 B：手动加载

若网络环境无法直接连接 GitHub 仓库，可采用此法。

获取文件: 访问 GitHub 仓库 Releases 页面，下载 main.js、manifest.json、styles.css。
创建路径: 进入仓库目录 .obsidian/plugins/，新建文件夹 claudian。
放置文件: 将下载的三个文件放入该文件夹。
启用: 重启 Obsidian 或在插件设置页刷新，手动开启。

2. 插件设置

claudian设置

打开 claudian 设置页。
基础设置: 设置 User Name (如 Jason)。
自定义AI模型: 使用兼容Anthropic接口的模型（如智谱GLM或DeepSeek）来替换Claude模型。

ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_API_KEY=你的智谱api key
ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-5

连通性验证:

Ctrl/Cmd + P 调出命令面板 -> 输入 claudian -> 选择 Open chat view。
发送“你好”，若回复正常则配置成功。

obsidian-agent-client设置

以 OpenCode为例：

打开 agent-client 设置页。在 Custom Agent 中，点击 Add Custom Agent按钮。设置 Agent ID 和 Display Name 为 OpenCode。
在命令行中输入 where opencode 查看 OpenCode 安装路径，把路径填入Path。
Arguments 填如下信息，注意第三行是你的Obsidian Vault路径：

acp
--cwd
D:\Obsidian Vault\MyObVault

连通性验证:

在Agent Client的AI对话框中，发送“你好”，若回复正常则配置成功。

CC

Obsidian AI Agent 配置指南：Claudian + Obsidian Skills

1. 核心组件

2. 环境部署流程

2.1 安装 Claudian 插件 (手动旁加载)

2.2 配置模型参数

2.3 部署 Obsidian Skills

3. 实战应用与技巧

3.1 典型用例：生成知识图谱

3.2 优化

4. 理念解析：Why Local Agent?

Git 进阶操作：版本管理与分支管理

一、Git Log：如何查看单个文件的“成长日记”

核心操作

让输出信息更友好

Git 版本回退：文件级“后悔药”与提交级“时光机”

一、文件级后悔药：git restore (Obsidian 用户最常用)

功能1：丢弃工作区的修改 (橡皮擦)

功能2：从历史中恢复文件 (时光机捞取)

二、提交级后悔药：git revert 与 git reset

The Safe Choice: git revert (安全的会计师)

The Nuclear Option: git reset (危险的时光机)

三、Git Blame：甩锅！

核心操作

Git 分支管理核心命令笔记

一、查看与切换分支

二、合并与删除分支

三、解决合并冲突

打开冲突文件。 Git 会在文件中用特殊标记标出冲突区域： <<<<<<< HEAD (你当前分支的修改)

Obsidian 官方 CLI 命令全景速查表

Obsidian CLI 典型自动化应用场景与工作流

Obsidian CLI 核心原理

架构机制对比

开启与基础配置

AI 智能体集成方案

配置 Agent Skill 目录

场景案例与代码实现

案例一：让 Gemini CLI 抓取文献并生成笔记

案例二：通过 Python 脚本调用

案例三：在N8N工作流中调用

注意事项

官方理念与隐私边界

Obsidian 必装 Skills

Obsidian CEO 发布的 Skills

defuddle

Skill功能

所需依赖

触发条件和使用方法

注意事项

obsidian-cli

obsidian-bases

Skill 功能

所需依赖

触发条件和使用方法

obsidian-markdown

使用方法

json-canvas

使用方法

obsidian-canvas-creator

Skill 功能

使用方法

与 json-canvas skill 的对比

mermaid-visualizer

使用方法

excalidraw-diagram

所需依赖

触发条件和使用方法

tutor-skills

Skill 功能

所需依赖

使用方法

Skill 的特殊机制

注意事项

scholar-skill

Skill 功能

所需依赖

触发条件与使用方法

Skill 的特殊机制

注意事项与风险预警

核心插件