前言¶
很多人用 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。
