# Obsidian Web Clipper AI 摘要教程：把网页保存成带出处的读书卡

## 本轮实际范围

原创网页与模板字段已运行离线验收；未安装 Obsidian 扩展、未调用摘要模型。官方视频静帧用于定位 Interpreter。

## 起步

```bash
python3 verify.py
```

## 1. 打开原创网页

在练习目录运行本地静态服务，浏览器打开 article.html。确认三段原文、6 只白鹭与 3 只喜鹊都可见；它是本站原创材料，没有发送到模型。

```bash
python3 -m http.server 3391 --bind 127.0.0.1
```

## 2. 导入读书卡模板

在官方 Web Clipper 扩展的 Settings → 模板页导入 clipper-template.json。模板分别保存标题、来源 URL、采集日期、原文摘录和 AI 摘要，不让摘要覆盖原文。

## 3. 限定 Interpreter 正文

打开 Interpreter 设置并启用，context 使用 {{selectorHtml:#main}}。模板的 prompt variable 要求只返回三条可由原文支持的摘要；不要把导航、评论和广告一并发送。

## 4. 填写完整模型端点

添加自定义 provider。此处 Base URL 按官方文档填写完整 Chat Completions 地址，例如 https://api.apizt.com/v1/chat/completions；模型 ID 用自己实际可用的名称，Key 只保存在本机。

## 5. 先解释再保存

在扩展里点击 Interpret，检查三个摘要是否保留 7 点、3 段、每段 10 分钟，并保留“待核对”的边界。模型调用尚未由本站执行；官方图只定位实际入口。

## 6. 核对生成笔记

保存到独立测试 vault 后导出为 my-card.md，检查 source、captured 和原文片段。用 verify.py --actual my-card.md 检查必需字段，再人工逐句回读模型摘要。

```bash
python3 verify.py --actual my-card.md
```

## 7. 运行缺出处负例

检查 negative.json 中 source 为空的卡片会被拒绝。保留原始网页、实际笔记和运行时间，区分模型摘要是否成功与模板能否导入。

```bash
python3 verify.py
```

## 官方来源

https://obsidian.md/help/web-clipper/interpreter

## 提醒

参考文档、卡片、JSON和图片都明确标注人工或离线范围；没有实际调用的模型不提供假成功结果。占位配置不是可用凭据。