Reddit Readonly 是一个只读的 Reddit 浏览技能，面向 Clawdbot 使用，通过 Reddit 公开 JSON 端点获取数据。它的核心定位是帮助用户在不登录、不互动的前提下检索 Reddit 内容，并把结果整理成可手动操作的链接清单。
用途 该技能主要用于：在一个或多个 subreddit 中查找帖子（支持 hot、new、top、controversial、rising 排序）；按查询词在某个 subreddit 内或全站搜索帖子；拉取某个帖子的评论线索以获取上下文；以及生成永久链接的候选清单，让用户自行打开 Reddit 手动回复。
主要能力 技能提供一组命令行操作，所有命令将 JSON 打印到标准输出。成功时输出 { "ok": true, "data": ... }，失败时输出 { "ok": false, "error": { "message": "...", "details": "..." } }。具体命令包括：
- posts：列出某个 subreddit 的帖子，可指定排序（hot|new|top|controversial|rising）、时间范围（day|week|month|year|all）、数量限制和分页 token。
- search：在指定 subreddit 内搜索帖子，或使用 all 在全站搜索。
- comments：按帖子 id 或 URL 获取评论，可设置数量与深度。
- recent-comments：获取某个 subreddit 的近期评论。
- thread：获取帖子与评论的组合（线程包），可设置评论数量与深度。
- find：多 subreddit 辅助命令，适合根据用户描述的条件（如“查找 r/a、r/b、r/c 中最近 48 小时内关于 X 的帖子，排除 Y”）来筛选，支持 --subreddits、--query、--include、--exclude、--minScore、--maxAgeHours、--perSubredditLimit、--maxResults、--rank 等参数。
硬性规则 该技能严格只读，永远不会发帖、回复、投票或执行版务操作。请求时需要保持礼貌，优先使用较小的数量限制（如 5–10），仅在必要时再扩大。向用户返回结果时，必须始终包含永久链接。
使用方式 命令通过 node 执行脚本，例如： node {baseDir}/scripts/reddit-readonly.mjs posts <subreddit> --sort hot --limit 10 node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10 node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6 node {baseDir}/scripts/reddit-readonly.mjs find --subreddits "python,learnpython" --query "fastapi deployment" --include "docker,uvicorn,nginx" --exclude "homework,beginner" --minScore 2 --maxAgeHours 48 --perSubredditLimit 25 --maxResults 10 --rank new 建议的工作流程是：先澄清范围（subreddit、主题关键词、时间范围），用较小的限制启动 find 或 posts/search，对 1–3 个有潜力的条目用 thread 获取上下文，然后向用户呈现一个简短清单，包含标题、subreddit、分数、创建时间、永久链接以及简要的匹配原因。如用户要求，可以用自然语言提出回复草稿思路，但需提醒用户手动发布。
适用场景 适合需要在不互动的情况下调研 Reddit 社区讨论、按主题和条件筛选帖子、获取评论上下文、以及为人工回复准备候选链接的场景。
限制与排错 该技能只读，不涉及任何写操作。若 Reddit 返回 HTML，脚本会检测到并返回错误，此时可重新运行命令；如果请求反复失败，可降低 --limit 和/或通过环境变量设置更慢的请求节奏，例如： export REDDIT_RO_MIN_DELAY_MS=800 export REDDIT_RO_MAX_DELAY_MS=1800 export REDDIT_RO_TIMEOUT_MS=25000 export REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)' 关于是否需要认证、具体速率限制数值、安装方式、支持的平台版本等更多信息，资料中暂未提供。