展开本页目录
开始前准备什么
- 将练习包解压到独立目录，不覆盖已有项目或真实业务资料。
- 先运行本包校验并查看实测范围，再按官方文档使用自己的软件、账号与准确版本。
- 需要真实模型的步骤只使用自己的 Key，截图与下载包不包含凭据。
- 打开原创网页
- 导入读书卡模板
- 限定 Interpreter 正文
- 填写完整模型端点
- 先解释再保存
- 核对生成笔记
- 运行缺出处负例
原创输入、运行脚本、字段校验、负例和执行范围；不含可用密钥。
原创网页与模板字段已运行离线验收；未安装 Obsidian 扩展、未调用摘要模型。官方视频静帧用于定位 Interpreter。
对应正文的具体资料，保持输入可追溯。
验证字段与负例；不能代替未执行的软件或模型。
明确区分材料验证、框架执行和模型调用。
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.md7. 运行缺出处负例
检查 negative.json 中 source 为空的卡片会被拒绝。保留原始网页、实际笔记和运行时间，区分模型摘要是否成功与模板能否导入。
bash
python3 verify.py
怎样确认已经完成
- 保存到独立测试 vault 后导出为 my-card.md，检查 source、captured 和原文片段。用 verify.py --actual my-card.md 检查必需字段，再人工逐句回读模型摘要。
- 检查 negative.json 中 source 为空的卡片会被拒绝。保留原始网页、实际笔记和运行时间，区分模型摘要是否成功与模板能否导入。
- 原创网页与模板字段已运行离线验收；未安装 Obsidian 扩展、未调用摘要模型。官方视频静帧用于定位 Interpreter。
常见问题
Web Clipper 的 Base URL 只填 /v1 吗？
该扩展的自定义 provider 当前官方说明通常填写完整 /chat/completions 端点；不要照搬 SDK 的 /v1 根地址。
这算免费的 AI 第二大脑吗？
剪藏与模板可本地使用；Interpreter 调用你选择的服务，是否收费取决于模型与账户。本文没有提供可用 Key。