by 运行时依赖
安装命令
点击复制技能文档
URL 到 Markdown 通过 baoyu-fetch CLI（Chrome CDP + 站点特定适配器）获取任何 URL 并将其转换为干净的 Markdown。
用户输入工具 当此技能提示用户时，按照以下工具选择规则（优先顺序）： 首选当前代理运行时暴露的内置用户输入工具 - 例如，AskUserQuestion、request_user_input、clarify、ask_user 或任何等效的。 回退：如果没有这样的工具，则发出编号的纯文本消息并要求用户用所选的编号/答案回复每个问题。 批处理：如果工具支持每次调用多个问题，则将所有适用的问题合并为单个调用；如果只支持单个问题，则按照优先顺序一次问一个问题。 具体的 AskUserQuestion 引用如下 - 示例 - 用其他运行时的本地等效项替换。
CLI 设置 重要：CLI 源代码存储在 {baseDir}/scripts/lib 中。 scripts/package.json 只安装第三方运行时依赖项。
代理执行说明 确定此 SKILL.md 文件的目录路径为 {baseDir} 解析 ${BUN} 运行时：如果安装了 bun，则使用 bun；否则建议安装 Bun 如果 {baseDir}/scripts/node_modules 不存在，则运行 ${BUN} install --cwd {baseDir}/scripts ${READER} = {baseDir}/scripts/baoyu-fetch 用解析的值替换此文档中的所有 ${READER}
首选项（EXTEND.md） 按优先顺序检查 EXTEND.md - 第一个找到的是赢家： 优先顺序 路径 范围 1 .baoyu-skills/baoyu-url-to-markdown/EXTEND.md 项目 2 ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md XDG 3 $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md 用户主目录
结果 操作 找到 读取、解析、应用设置 未找到 必须运行首次设置（见下文）- 不要默默创建默认值 EXTEND.md 支持：默认下载媒体、默认输出目录。
首次设置 当 EXTEND.md 未找到时，您必须使用 AskUserQuestion 收集首选项，然后创建 EXTEND.md。绝不能默默创建 EXTEND.md。生成被阻塞，直到设置完成。 将三个问题批量为单个调用： Q1 - 媒体（标题“媒体”）：“如何处理页面中的图像和视频？” “每次询问（推荐）”- 保存后提示 “始终下载”- 下载到本地 imgs/ 和 videos/ “从不下载”- 保持远程 URL Q2 - 输出（标题“输出”）：“默认输出目录？” “url-to-markdown（推荐）”- 保存到 ./url-to-markdown/{domain}/{slug}.md 用户可以选择“其他”并输入自定义路径 Q3 - 保存（标题“保存”）：“将首选项保存在哪里？” “用户（推荐）”- ~/.baoyu-skills/（所有项目） “项目”- .baoyu-skills/（仅此项目） 答案后，写入 EXTEND.md，确认“首选项已保存到 [path]”，然后继续。 完整模板：references/config/first-time-setup.md。
支持的键 默认值 描述 download_media 询问 询问 / 1 / 0 询问 = 每次提示，1 = 始终，0 = 从不 default_output_dir 空路径或空 默认输出目录（空 = ./url-to-markdown/） EXTEND.md → CLI 映射： EXTEND.md 键 CLI 参数 备注 download_media：1 --download-media 需要设置 --output default_output_dir：./posts/ 代理构造 --output ./posts/{domain}/{slug}.md 代理生成路径，而不是直接标志 值优先顺序：CLI 参数 → EXTEND.md → 技能默认值。
用法 # 默认：headless 捕获，markdown 到 stdout ${READER} # 保存到文件 ${READER} --output article.md # 保存并下载媒体 ${READER} --output article.md --download-media # 等待交互（登录/验证码）- 自动检测并继续 ${READER} --wait-for interaction --output article.md # 等待交互 - 手动控制（按 Enter 继续） ${READER} --wait-for force --output article.md # JSON 输出 ${READER} --format json --output article.json # 强制特定适配器 ${READER} --adapter youtube --output transcript.md
选项 选项 描述 要获取的 URL --output 输出文件路径（默认：stdout） --format 输出格式：markdown（默认）或 json --json 简写 --format json --adapter 强制适配器：x、youtube、hn 或 generic（默认：自动检测） --headless 强制 headless Chrome（无可见窗口） --wait-for 交互等待模式：none（默认）、interaction 或 force --wait-for-interaction 别名 --wait-for interaction --wait-for-login 别名 --wait-for interaction --timeout
下载媒体的基本目录（默认：与 --output 目录相同） --cdp-url 重用现有的 Chrome DevTools Protocol 端点 --browser-path 自定义 Chrome/Chromium 二进制路径 --chrome-pr