Agent Skills
返回列表
Obsidian 集成助手

Obsidian 集成助手

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3cdd1ed9/obsidian-integration。

技能介绍

问题背景

很多自动化场景需要读写 Obsidian 笔记，或在库外触发 Obsidian 里的插件命令（例如把笔记发成 X 线程）。单靠社区插件往往只覆盖一半：Local REST API 能安全地做文件读写、搜索、列表，但不能执行命令；Advanced URI 则通过 adv-uri 协议从外部触发任意 Obsidian 命令（含社区插件），却不负责 REST 式文件管理。两者组合才是完整答案。

技能如何工作

技能以教程 + 工具包形式说明一次性前置：在 Obsidian 内安装并启用上述两个插件，在 Local REST API 设置里生成 Bearer Token；Obsidian 必须保持运行，REST 与 URI 才会生效。

能力 A — 文件操作（Local REST API）

  • 用 GET/PUT/POST/DELETE /vault/ 读、写、追加、删除笔记（路径需 URL 编码）
  • GET /vault/ 列出库内文件；GET /search/?query= 做全文检索
  • 服务走 HTTPS + 自签证书，客户端需跳过证书校验；错用 HTTP 常见 HTTP 000
  • 实际监听端口常非默认 27123，需用 netstat 等确认 LISTENING 端口再作为 BASE

能力 B — 触发命令（Advanced URI）

  • URI 主机为 adv-uri，推荐用稳定的 commandid 而非 commandname
  • 可带 filepath 让命令作用在指定笔记；confirm=true 可自动点首个确认框
  • Windows/PowerShell 若 URI 含 % 编码的中文路径可能被拦截，需改用未编码的原始文件名再 Start-Process

常见流程：用 PUT 把书签/摘要写入库（可加 YAML frontmatter）；用 GET 读笔记再分析；发推前先按 notetweet 格式写好 THREAD START/END，再通过 URI 触发插件命令——对外发布前务必与用户确认。

边界与注意

  • 401 多为 Token 失效，需在插件设置重新生成
  • 命令无反应：检查 Obsidian 是否在运行、插件是否安装、commandid 是否正确
  • 可选 notetweet / x-post-saver 需自行配置 X API，密钥存在 Obsidian Secret Storage

仓库内 scripts/obsidian_helper.py 与 references/api_reference.md 提供可运行客户端与端点说明。

使用场景

  • 对话或脚本里收到「存进我的库」时，用 HTTPS PUT 把 Markdown 写到指定路径，并附上来源、时间等 frontmatter。
  • Obsidian 保持打开的前提下，从外部 GET 某篇笔记，对正文做摘要、抽取要点或生成与其他笔记的关联建议。
  • 长文已在库内按 notetweet 格式写好 THREAD 起止标记，通过 Advanced URI 触发插件，把该文件发成 X 推文或线程。
  • 自动化任务需要对 vault 做全文 search，拿到命中文件列表后再批量读取或交给下游分析。

适合人员

  • 以 Obsidian 为主知识库、希望 WorkBuddy 或 Agent 能直接读写库内笔记而不是手工复制粘贴的人
  • 在 Obsidian 里写推文草稿、希望从外部一条 URI 触发 notetweet/x-post-saver 发线程的内容创作者
  • 自建本地集成、既要 REST 读写/search 又要 adv-uri 触发社区插件命令的脚本或工具维护者
  • 把浏览器采集、RSS 摘要等结果定期 append 到固定 inbox 笔记、并需 URL 编码与端口探测踩坑指南的笔记维护者