前言¶
很多人用 Obsidian 做长期知识沉淀，笔记库本质上就是本机上的一个文件夹。但在 Cursor、Claude Code 等环境里，Agent 往往不知道「库路径在哪、Markdown 与附件怎么组织、哪些操作算在改笔记库」。结果是：要么只能零散读单个文件，要么靠口头描述路径，容易漏掉链接、附件或库级约定。
下面介绍 SkillHub 上的 @zcwl/obsidian（obsidian）。它的定位很直接：Obsidian 笔记库即磁盘文件夹，直接管理——让 Agent 按文件夹语义理解并操作你的库，而不是把它当成无关的普通目录。
这是什么¶
- 名称与坐标：obsidian，
@zcwl/obsidian - 出品：智创未来（SkillHub 来源标注为 enterprise）
- 版本：1.0.0
- 分类：knowledge-management（知识管理）
- 官方入口：SkillHub 技能页；技能包地址 https://api.skillhub.cn/zcwl/obsidian
- 依赖：标签标明
requires_api_key=false，安装使用不依赖额外 API Key
Skill 采用通用的 SKILL.md 格式，安装后由 Agent 读取其中的说明，在对话中按技能约定处理 Obsidian 库路径下的 Markdown 与相关文件。
核心功能¶
根据 SkillHub 公示的简介，当前可核实的能力边界如下：
- 库即文件夹：将 Obsidian 笔记库视为磁盘上的普通目录结构，在 Agent 侧按路径读写、整理，而不是抽象成不可见的「应用内对象」。
- 直接管理：在 Agent 工作流中，对库内笔记与资源做创建、修改、检索、组织等文件级操作（具体步骤与约束以安装后的
SKILL.md为准）。 - 知识管理场景：归类在 knowledge-management，适合与长期笔记、资料归档、库内结构维护等任务配合。
SkillHub 页面未单独列出子命令或插件清单；未在官方资料中出现的功能（例如同步 Obsidian 专有插件配置、Graph 视图操作等）本文不展开。
安装与启用¶
安装流程遵循 SkillHub 安装与优先源配置。先做环境检查，再把技能装到当前 Agent 实际使用的 skills 目录。
1. 检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装 CLI，可按官方文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 obsidian 技能¶
官方页面给出的安装方式为：依据上述安装文档，安装 @zcwl/obsidian。命令形态如下（--dir 必须指向本机 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别）：
skillhub install @zcwl/obsidian --dir <你的 Agent skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，按你实际使用的客户端择一）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下 .windsurf/skills/ |
安装完成后，按你所用 Agent 的说明重启或刷新技能列表，使 SKILL.md 被加载。
也可将下面提示词发给支持 Skill 安装的 AI，由其按官方文档完成安装（与 SkillHub 页面文案一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@zcwl/obsidian`。
典型用法¶
公开资料未附带逐步复制的对话脚本。可复现的通用流程是：
- 在本机确认 Obsidian 笔记库的绝对路径（即你在 Obsidian 中打开的 vault 文件夹）。
- 在已启用
@zcwl/obsidian的 Agent 会话中，说明要对该路径下的笔记做何种文件级操作（例如整理某目录、批量重命名、根据标题新建 Markdown 等）。 - 让 Agent 依据技能包内的
SKILL.md约定执行；涉及删除或大规模移动前，建议先备份库或依赖版本管理。
具体指令模板、命名规范、是否避开 .obsidian 配置目录等细节，以你安装后本地的 SKILL.md 为准，本文不臆造字段或示例路径。
适用场景与注意¶
更适合谁
- 已有固定 Obsidian 库路径，希望 Agent 像操作普通项目目录一样读写笔记。
- 知识管理类任务多，需要与 Cursor / Claude Code 等编码环境共用同一套 skills 机制。
使用上需注意
- 路径与备份：库即文件夹意味着误删、覆盖会直接影响真实笔记；重要库请先备份或使用 Git 等版本管理。
- 与 Obsidian 客户端并行：Agent 改的是磁盘文件；Obsidian 打开时一般会感知文件变化，但并发编辑同一文件仍可能冲突，宜错开或关闭自动重载后再批量改动。
- 统计口径：SkillHub 抓取资料显示评分为 100000、下载约 96391 次（页面展示会变动）；安装数等以 SkillHub 实时页面为准。
- 资料边界：
https://api.skillhub.cn/zcwl/obsidian在浏览器直接 GET 可能返回 405；安装与元信息以 SkillHub 技能页与skillhubCLI 为准。
结尾¶
@zcwl/obsidian 把「Obsidian 笔记库 = 磁盘文件夹」这一事实写进 Agent 技能，减少路径与库结构上的反复解释，适合把笔记库纳入自动化整理与辅助写作流程。需要安装或查看版本时，请打开官方技能页：https://www.skillhub.cn/skills/zcwl/obsidian，技能包地址：https://api.skillhub.cn/zcwl/obsidian。
