Obsidian Save Article

将网页文章保存到本地 Obsidian Vault，支持图片抓取。

触发方式

当用户发送：

• - 一个网页链接
• 可选的 notes 或 comments
• 明确要求保存到 Obsidian或收藏文章

例如：

• - https://example.com/article 这篇文章不错
• 帮我保存这个：https://xxx.com 内容：我的笔记

首次使用：路径配置

第一次运行时的引导流程

首次使用该技能时，系统会自动检测是否已配置保存路径。如果没有配置，会引导用户完成设置：

🔷 欢迎使用 Obsidian 文章保存功能！

请选择您要保存到的 Obsidian Vault 类型：

1️⃣ 本地 Obsidian（本地磁盘）
2️⃣ iCloud Obsidian（云端同步）

请回复数字或选项名称。

选项 1：本地 Obsidian

如果用户选择本地 Vault：

📂 请告诉我您的 Obsidian Vault 路径。

例如：~/Documents/Obsidian Vault

或者直接拖拽文件夹到聊天窗口，我会自动识别路径。

用户输入路径后，验证路径有效性：

✅ 找到 Vault：My Notes
路径：/Users/liz/Documents/Obsidian Vault/My Notes

📁 请输入要保存文章的子文件夹名称（可选）。

例如：Articles、ReadLater、收藏夹
直接回车将保存到根目录。

选项 2：iCloud Obsidian

如果用户选择 iCloud Vault：

☁️ iCloud Obsidian 路径查找指南：

1. 1. 打开 Finder
2. 在左侧边栏找到 iCloud
3. 点击 iCloud Drive
4. 找到您的 Obsidian Vault 文件夹
5. 右键点击 → 复制路径

请将路径粘贴到聊天中。

用户输入 iCloud 路径后，类似本地流程询问子文件夹。

路径配置存储

配置完成后，路径信息会保存在：

~/.obsidian-save-article-config.json

内容示例：
json
{
type: local,
vault_path: /Users/liz/Documents/Obsidian Vault/My Notes,
subfolder: Articles,
full_path: /Users/liz/Documents/Obsidian Vault/My Notes/Articles,
configured: true,
configured_at: 2026-03-18T01:00:00Z
}

重新配置路径

用户可以随时重新配置路径：

• - 说更改 Obsidian 保存路径或重新配置
• 说查看当前保存路径查看配置

保存格式

YAML Frontmatter

yaml

全文内容

重要：图片必须放在 Full Article callout 内部，位于内容之前！

text

[!note]- 📄 Full Article





文章第一段内容...

文章第二段内容...

错误格式（图片在 callout 外部）：
text

← 错误！在 callout 外面

[!note]- 📄 Full Article

文章内容...

正确格式（图片在 callout 内部）：
text

[!note]- 📄 Full Article ← callout 头部先

← 图片在 callout 内部

文章第一段内容...

文章第二段内容...

用户 Notes

text

用户笔记内容

内容抓取方法

该技能支持两种内容抓取方法，系统会自动选择最合适的方式。

方法 1：Jina.ai Reader（首选）

• - 原理：使用 https://r.jina.ai/ 抓取网页内容
• 优点：快速、返回干净的 Markdown 格式
• 适用：大多数网站、博客、新闻文章

方法 2：Browser 工具（Fallback）

当 Jina.ai 失败时，自动使用浏览器工具抓取内容。

触发条件：

• - Jina.ai 返回错误
• Jina.ai 返回空内容或无效内容
• 连接超时
• 网站阻止 Jina.ai 访问（如微信公众号文章、付费内容）

操作步骤：

1. 1. 使用 browser 工具打开目标 URL
2. 获取页面快照（snapshot）
3. 提取页面文本内容
4. 清理和格式化内容

Browser 工具调用示例

python

Step 1: 打开页面

Step 2: 获取快照（使用 aria 模式获取结构化内容）

Step 3: 提取文本内容并清理

内容清理规则

从浏览器获取内容后，需要进行清理：

• - 移除导航栏、页脚、广告等无关内容
• 保留文章标题和正文
• 转换 HTML 标签为 Markdown 格式
• 处理特殊字符和编码问题

工作流程

带路径配置的工作流程

1. 1. 检查配置：读取 ~/.obsidian-save-article-config.json

1. 2. 解析输入：提取 URL 和用户 notes

1. 3. 抓取内容：