用途
save-md 用于将一个指定的来源完整保存为 Markdown 文件。它的目标是把命名来源写入一个 .md 文件，说明文件位置，并保证正文来自抓取到的原始字节，而不是来自摘要。
明确的范围界定（资料原文）：
- IS：一个命名来源（URL、附件、粘贴内容、YouTube 视频、Google 文档、PDF）对应到用户文件树中的一个 .md 文件。
- IS NOT：从抓取结果作答、把内容摘要进聊天、爬取超出所命名 URL 的范围、或凭记忆重建一次演讲。
完成标准
资料给出的完成标准是：在用户可打开的位置存在一个 .md 文件，带有如下 frontmatter，并且回读该文件时能返回来源的最后一段：
---
title: "<title>"
source: "<URL or path>"
date: "<date -u +%Y-%m-%dT%H:%M:%SZ, run now>"
type: web | youtube | gdoc | sheet | slides | pdf | docx | tweet | conversation
---
主要能力与使用方式
- 使用
curl -sSL -o <file> <url>抓取并读取文件。 - 优先选择文本端点而非 HTML 页面外壳。
- 生成带 title、source、date、type 的 frontmatter 元数据。
- 当抓取失败时，给出带明确原因的缺失文件说明（例如付费墙、登录墙、机器人检查、私有文档），这被认为优于给出一个看似合理的替代文件。
参考文件
资料中提到 references/source-endpoints.md，应在处理 URL 主机时始终读取，其中包含：经过测试的端点、对应的 curl 命令行、每个端点会出现的失败情况，以及可选的备选读取器。
注意事项（Gotchas）
- WebFetch 会把页面交给一个小模型并返回其答案：一篇 1,200 词的文章可能被返回为 120 词。只有 Content-Type 为 text/markdown 且少于 100K 字符的内容才能原样通过。
- oEmbed、GitHub 的
?raw=true、以及 Drive 下载会跨主机重定向。不加-L会保存一个空的 301。 - YouTube 的 “Sign in to confirm you're not a bot” 是 IP 封锁：在笔记本上使用
--cookies-from-browser，在沙盒中停止。描述文字并不等于演讲内容。 - 大型 PDF 旁边出现一个空的 .md 意味着这是扫描件，而不是空白文档：应渲染页面并读取它们。
维护
资料仅说明：evals/evals.json 为任何修改此技能的人保存了场景和路由提示。
限制
资料未提供收费、价格、具体平台支持列表或具体使用步骤以外的信息。以上内容均以资料事实为准，未提供的部分明确为暂未提供。