giteahh/llm_wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cf1887990123f4514d8b5bda66aed7b9336ef4ac
llm_wiki/wiki/README_Douban_Clipper.md
T

12 KiB
Raw Blame History

categories, tags, created, source, type
categories tags created source type
LLM Wiki
wiki
reference
tool
obsidian
2026-04-10 README_Douban_Clipper reference

豆瓣图书 Web Clipper 模板 - 使用指南

自动化收集豆瓣图书信息到你的 Obsidian 知识库

📚 简介

这是一个为 Obsidian Web Clipper 设计的豆瓣图书采集模板，可以自动从豆瓣图书页面提取书籍信息，并以符合 AGENTS.md 规范的格式保存到你的 Obsidian vault 中。

主要功能

✅ 自动识别豆瓣图书页面 - URL 触发器自动匹配

✅ 智能字段提取 - 提取书名、作者、ISBN、评分等 13 个字段

✅ 标准 YAML 格式 - 完全符合 Obsidian 和 AGENTS.md 规范

✅ Markdown 转换 - 内容简介自动转换为 Markdown 格式

✅ 零配置使用 - 导入模板后即可使用

提取的字段

| 字段 | 说明 | 类型 |
------
categories
author
cover
isbn
scoreGr
rating_people
pages
year
publisher
rating
translator
genre
created
tags
content

🚀 快速开始

前置要求

  • ✅ Obsidian 应用（版本 ≥ 1.7.2）
  • ✅ Microsoft Edge 浏览器（最新版本）
  • ✅ Obsidian Web Clipper 扩展

安装步骤（5 分钟）

1. 安装 Obsidian Web Clipper

Windows 11 + Edge 浏览器：

  1. 打开 Microsoft Edge 浏览器
  2. 访问：https://microsoftedge.microsoft.com/addons
  3. 搜索"Obsidian Web Clipper"
  4. 点击"获取"按钮安装
  5. 安装完成后，工具栏会出现 Web Clipper 图标

2. 连接 Obsidian Vault

  1. 打开 Obsidian 应用
  2. 点击 Edge 工具栏的 Web Clipper 图标
  3. 按照连接向导选择你的 Vault
  4. 确认连接成功

3. 导入豆瓣模板

  1. 打开 Edge 浏览器
  2. 点击 Web Clipper 图标
  3. 点击右上角的齿轮图标 ⚙️ 进入设置
  4. 点击"Import"按钮
  5. 选择文件：douban-book-clipper.json
  6. 确认导入成功

4. 开始使用

  1. 访问任意豆瓣图书页面：https://book.douban.com/subject/37900003/
  2. 点击 Web Clipper 图标
  3. 模板会自动选中（通过 URL 匹配）
  4. 预览提取的字段
  5. 点击"Save"保存到 Obsidian
  6. 完成！✨

📖 详细使用指南

第一次使用

步骤 1：访问豆瓣图书

在 Edge 浏览器中访问任意豆瓣图书页面，例如：

步骤 2：打开 Web Clipper

点击 Edge 工具栏中的 Web Clipper 图标（紫色的 Obsidian logo）

步骤 3：自动匹配模板

由于模板中配置了触发器 https://book.douban.com/subject/，Web Clipper 会：

  1. 检测到当前 URL 匹配
  2. 自动选中"Douban Books"模板
  3. 显示提取的字段预览

如果没有自动选中：

  • 手动从模板列表选择"Douban Books"

步骤 4：预览和编辑

在预览面板中，你可以：

✅ 查看提取的字段 - 所有字段都会显示在预览中

✅ 编辑字段值 - 点击任意字段可以修改

✅ 添加个人标签 - 在 tags 字段中添加你的标签

✅ 修改保存路径 - 默认为 References 文件夹

✅ 修改文件名 - 默认为 {{title}}（书名）

步骤 5：保存到 Obsidian

确认无误后，点击"Save"按钮

Web Clipper 会：

  1. 创建新的 Markdown 文件
  2. 保存到 References 文件夹
  3. 文件名为书名（如：年轻医生手记.md）
  4. 自动应用 Linter 格式化（如果已启用）

步骤 6：验证结果

打开 Obsidian，检查生成的笔记：

  • 文件是否在 References 文件夹
  • YAML frontmatter 是否正确
  • 内容是否完整

日常使用流程

一旦设置完成，日常使用非常简单：

访问豆瓣图书 → 点击 Web Clipper → 确认字段 → 保存 ✅

仅需 10 秒！

🎯 高级功能

自定义保存路径

默认保存路径为 References，你可以修改：

  1. 在 Web Clipper 中打开模板设置
  2. 找到"Path"字段
  3. 修改为你想要的路径（如：Books/Collecting）

自定义文件名

默认文件名格式为 {{title}}（书名），你可以修改：

  1. 在 Web Clipper 中打开模板设置
  2. 找到"Note name format"字段
  3. 使用模板变量自定义，例如：
{{title}} - {{year}}
{{isbn}}
{{selector:#info|split:"作者:"|slice:1}}

可用变量：

  • {{title}} - 页面标题
  • {{date}} - 当前日期
  • {{url}} - 页面 URL
  • {{selector:…}} - 任意选择器

添加个人评分

rating 字段预留给你填写自己的评分：

  1. 在 Web Clipper 预览中
  2. 找到 rating 字段
  3. 输入你的评分（1-7）
  4. 保存

评分参考（AGENTS.md）：

  • 1 = Evil
  • 2 = Very Poor
  • 3 = Poor
  • 4 = Below Average
  • 5 = Average
  • 6 = Good
  • 7 = Perfect

添加个人标签

在 tags 字段中添加你的标签：

tags:
  - books
  - references
  - to-read
  - fiction
  - 2026

🛠️ 模板配置详解

文件结构

douban-book-clipper.json
├── schemaVersion    # 模板版本
├── name             # 模板名称
├── behavior         # 行为模式（create）
├── noteNameFormat   # 文件名格式
├── path             # 保存路径
├── noteContentFormat # 内容格式
├── properties       # 字段列表
└── triggers         # URL 触发器

字段配置详解

1. 基本字段

{
  "name": "categories",
  "value": "[[Books]]",
  "type": "multitext"
}
  • name: 字段名（YAML 键）
  • value: 字段值（可以使用模板变量）
  • type: 字段类型
    • text - 文本
    • number - 数字
    • multitext - 多值列表
    • date - 日期

2. 使用选择器

{
  "name": "scoreGr",
  "value": "{{selector:.rating_num[property=\"v:average\"]|trim|number}}",
  "type": "number"
}
  • selector: CSS 选择器语法
  • 过滤器链: |trim|number
    • trim - 去除首尾空格
    • number - 转换为数字类型

3. 使用 Meta 数据

{
  "name": "isbn",
  "value": "{{meta:book:isbn}}",
  "type": "text"
}
  • meta: 提取 HTML meta 标签
    • {{meta:og:image}} - Open Graph 图片
    • {{meta:book:isbn}} - Schema.org ISBN
    • {{meta:book:author}} - Schema.org 作者

4. 复杂过滤器链

{
  "name": "year",
  "value": "{{selector:#info|split:\"出版年:\"|slice:1|split:\"<\"|slice:0|split:\"-\"|slice:0|trim}}",
  "type": "number"
}

解析流程：

  1. selector:#info - 获取整个 info 区域的文本
  2. |split:"出版年:" - 分割，获取"出版年:"之后的部分
  3. |slice:1 - 取第二部分（索引从 0 开始）
  4. |split:"<" - 按 HTML 标签分割
  5. |slice:0 - 取第一部分（纯文本）
  6. |split:"-" - 按"-"分割（如：2026-1）
  7. |slice:0 - 取"2026"部分
  8. |trim - 去除空格

触发器配置

"triggers": [
  "https://book.douban.com/subject/"
]
  • 当访问匹配该 URL 模式的页面时，自动选中此模板
  • 支持通配符和正则表达式

🔧 故障排除

问题 1：模板导入失败

症状：导入 JSON 文件时报错

解决方案：

  1. 检查 JSON 文件格式是否正确
  2. 确认文件编码为 UTF-8
  3. 尝试重新下载模板文件
  4. 更新 Web Clipper 到最新版本

问题 2：某些字段为空

症状：预览中某些字段没有值

可能原因：

  • 豆瓣页面结构变化
  • CSS 选择器不匹配
  • 字段在特定页面不存在

解决方案：

  1. 检查豆瓣页面是否有该字段
  2. 使用浏览器开发者工具（F12）查看 HTML 结构
  3. 更新 CSS 选择器
  4. 为该字段添加默认值

问题 3：笔记保存失败

症状：点击保存后没有反应

解决方案：

  1. 确认 Obsidian 正在运行
  2. 重新连接 Vault
  3. 检查 References 文件夹是否存在
  4. 查看 Edge 浏览器控制台（F12）是否有错误

问题 4：YAML 格式错误

症状：Obsidian 显示 YAML 解析错误

解决方案：

  1. 检查 YAML 语法（冒号后面要有空格）
  2. 确保缩进使用空格（不是 Tab）
  3. 特殊字符需要用引号包裹
  4. 使用 YAML 验证工具检查语法

问题 5：内容简介包含 HTML 标签

症状：Markdown 中残留 <p>, <div> 等标签

解决方案：

  1. 检查 selectorHtml 选择器是否正确
  2. 确认 markdown 过滤器在过滤器链中
  3. 使用 replace 过滤器移除残留标签： 
    "value": "{{selectorHtml:#link-report .intro|replace:\"</p>\":\"\\n\\n\"|markdown}}"

问题 6：多作者显示不正确

症状：多作者显示为单行，没有分隔符

解决方案：

使用 join 过滤器：

{
  "name": "author",
  "value": "{{meta:book:author|replace:\" / \":\", \"}}",
  "type": "multitext"
}

或：

{
  "name": "author",
  "value": "{{selector:#info a:first-of-type|join:\", \"}}",
  "type": "multitext"
}

📝 生成的笔记示例

完整示例

---
categories:
  - "[[Books]]"
author:
  - "［俄］米哈伊尔·布尔加科夫"
cover: "https://img1.doubanio.com/view/subject/s/public/s35336248.jpg"
isbn: "9787549646609"
scoreGr: 9
rating_people: 39
pages: 264
year: 2026
publisher: "文汇出版社"
rating:
translator:
genre:
created: 2026-01-22
tags:
  - books
  - references
---

💉"我们的整个生活就是由这类笑话组成的。"

术业未精、孤立无援、焦头烂额、生死一线……

🌨️在毫无准备之时被抛向命运的暴风雪

一个菜鸟医生的乡村奇遇

🎖️《大师和玛格丽特》作者 布尔加科夫

半自传体短篇小说集 全新中文译本

同名剧集由"哈利·波特"丹尼尔·雷德克里夫主演

冷峻写实×黑色幽默

魔幻之外的布尔加科夫

+++

四十八天前,我以优等成绩从医学院毕业,被派来主管一家乡村医院。可优等成绩是一回事,治病又是另一回事。

截肢、难产、白喉、梅毒,愚昧的巫医术,无知的村民,还有暴风雪里的狼群!命运将我引向黑暗之中,直面危险、恐惧与孤独。寒冬长夜,我思考着自己的职责,写下这些笔记……

+++

【编辑推荐】

"有时候,我真遗憾自己不是个作家。"

❄️《大师和玛格丽特》作者、俄语文学巨匠布尔加科夫半自传性短篇小说集,看见魔幻现实主义之外的布尔加科夫。

毕业于医...

📚 相关文档

🤝 贡献

如果你发现了问题或有改进建议：

  1. 查看 TESTING.md 进行测试
  2. 使用 TEST_REPORT.md 记录问题
  3. 在 GitHub 提交 Issue 或 Pull Request

📄 许可证

本模板基于 MIT 许可证开源

🔗 链接

开始构建你的个人图书知识库吧！ 🚀📚

来源

溯源规则：所有数字/百分比/具体结论必须标注 [raw:{文件名}:{行号}] 格式。

Reference in New Issue View Git Blame Copy Permalink