用途:当用户想深度阅读某条 BestBlogs 资源(文章、播客、视频、推文)时,本技能负责获取该资源的元信息与全文 Markdown,供本地 LLM 或阅读界面使用,同时可回传 read 行为以维持 BestBlogs 的个性化推荐。
主要能力与对应原语:bestblogs.resource.meta.get 内部调用 /resources/{id}/meta 获取元信息;bestblogs.resource.markdown.get 内部调用 /resources/{id}/markdown 获取正文 Markdown;bestblogs.resource.read.mark 内部调用 POST /resources/{id}/read 回传已读;bestblogs.resource.deep_read.prepare 通过 CLI bestblogs read deep <id> 完成 meta + markdown + mark read 的组合动作。对外主要暴露 deep_read.prepare,它会并行拉取 meta 与 markdown,再串行标记已读。
使用方式:完整深读(默认包含 mark read)执行 bestblogs read deep RAW_xxx --json。只取正文 Markdown 可加 --markdown-only,输出纯 Markdown,适合管道给本地 LLM。仅预览、不回传已读可加 --no-mark-read --json。
适用场景:把某条资源的正文喂给本地 LLM 做总结或问答;查看某条资源的元信息与全文;在阅读的同时回传已读行为。常见链路为先 discover today、从候选中选一条,再 read deep、把 markdown 交给本地 LLM,最后用 capture 保存笔记。
限制与错误处理:资源不存在或已下架会返回 404 / NOT_FOUND;资源为私有源且当前用户未订阅时 meta 可能返回 null,需提示用户订阅对应源;mark read 失败时返回 readMarked=false 与 markError,内容仍会保留,应告知用户已读回传失败但不影响阅读。默认会回传已读,除非用户明确只是预览,否则不要重复回传。