---

name: obsidian-clipper-template-creator description: Obsidian Web Clipper 模板创建指南。当你需要创建新的剪藏模板、了解可用变量或格式化剪藏内容时使用。 risk: safe source: community date_added: "2026-02-27"

Obsidian Web Clipper 模板创建器

此技能帮助你创建可导入的 Obsidian Web Clipper JSON 模板。

使用场景

• 你需要创建或优化可导入的 Obsidian Web Clipper 模板。
• 你想将网站的真实 DOM、schema 数据和选择器映射到有效的剪藏模板中。
• 你需要选择器验证和模板逻辑指导，然后再将 JSON 交给用户。

工作流程

1. 识别用户意图： 特定网站（YouTube）、特定类型（食谱）还是通用剪藏？
2. 检查现有基础模板： 用户可能在 Bases/ 中定义了"Base"模式。
   • 操作： 读取 Bases/*.base 以找到匹配的类别（例如 Recipes.base）。
   • 操作： 使用 Base 中定义的属性来构建 Clipper 模板属性。
   • 详见 references/bases-workflow.md。
3. 获取并分析参考 URL： 根据真实页面验证变量。
   • 操作： 向用户索取要剪藏内容的示例 URL（如未提供）。
   • 操作（必需）： 使用 WebFetch 获取页面内容；如果 WebFetch 不可用，使用浏览器 DOM 快照。详见 references/analysis-workflow.md。
   • 操作： 分析 HTML 中的 Schema.org JSON、Meta 标签和 CSS 选择器。
   • 操作（必需）： 根据获取的内容验证每个选择器。不要猜测选择器。
   • 详见 references/analysis-workflow.md。
4. 起草 JSON： 按照模式创建有效的 JSON 对象。
   • 详见 references/json-schema.md。
5. 考虑模板逻辑： 对可选块使用条件判断（例如仅在存在营养信息时显示）、对列表数据使用循环、使用变量赋值避免重复表达式、对缺失变量使用回退值。仅在能改善模板时使用逻辑；保持简单模板的简洁。详见 references/logic.md。
6. 验证变量： 确保所选变量（预设、Schema、选择器）存在于你的分析中。
   • 操作（必需）： 如果无法从获取的内容中验证选择器，请明确说明并要求提供另一个 URL。
   • 详见 references/variables.md。

选择器验证规则

• 始终验证选择器 — 在回复前根据实际页面内容进行验证。
• 永远不要猜测选择器。 如果无法访问 DOM 或元素缺失，请要求提供另一个 URL 或截图。
• 优先使用稳定选择器（data 属性、语义角色、唯一 ID）而非脆弱的 class 链。
• 记录目标元素 — 在推理中说明（例如"关于侧边栏段落"）以减少不匹配。

输出格式

始终将最终结果输出为用户可以复制和导入的 JSON 代码块。

Clipper 模板编辑器会验证模板语法。 如果你使用了模板逻辑（条件、循环、变量赋值），请确保遵循 references/logic.md 和官方 Logic 文档中的语法，以便模板通过验证。

{
  "schemaVersion": "0.1.0",
  "name": "My Template",
  ...
}

资源

• references/variables.md - 可用数据变量。
• references/filters.md - 格式化过滤器。
• references/json-schema.md - JSON 结构文档。
• references/logic.md - 模板逻辑。
• references/bases-workflow.md - 如何将 Bases 映射到模板。
• references/analysis-workflow.md - 如何验证页面数据。

官方文档

• Variables
• Filters
• Logic
• Templates

示例

参见 assets/ 中的 JSON 示例。

限制

• 仅在任务明确符合上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停下来要求澄清。