Reddit 只读模式

Clawdbot 的只读 Reddit 浏览功能。

该技能的用途

• 在单个或多个子版块（subreddit）中查找帖子（hot/new/top/controversial/rising 排序）
• 按关键词查询帖子（限定于某子版块，或全站搜索）
• 拉取某条帖子的评论树（comment thread），以提供上下文
• 生成一份 永久链接（permalink）短列表，供用户手动打开 Reddit 并回复

硬性规则

• 严格只读。 本技能绝不会发帖、回复、投票或执行任何版务操作。
• 请求需保持礼貌与节制：
  • 优先使用较小的限制值（5–10）。
  • 仅在必要时扩大限制。
• 向用户返回结果时，必须始终包含 永久链接（permalinks）。

输出格式

所有命令均将 JSON 输出至 stdout。

• 成功： { "ok": true, "data": ... }
• 失败： { "ok": false, "error": { "message": "...", "details": "..." } }

命令

1) 列出某子版块中的帖子

node {baseDir}/scripts/reddit-readonly.mjs posts  
  --sort hot|new|top|controversial|rising 
  --time day|week|month|year|all 
  --limit 10 
  --after 

2) 搜索帖子

# 在指定子版块内搜索
node {baseDir}/scripts/reddit-readonly.mjs search  "" --limit 10

# 全站搜索
node {baseDir}/scripts/reddit-readonly.mjs search all "" --limit 10

3) 获取某帖子的评论

# 支持通过 post_id 或 URL 指定
node {baseDir}/scripts/reddit-readonly.mjs comments  --limit 50 --depth 6

4) 获取某子版块中最新评论

node {baseDir}/scripts/reddit-readonly.mjs recent-comments  --limit 25

5) 帖子线程包（帖子 + 评论）

node {baseDir}/scripts/reddit-readonly.mjs thread  --commentLimit 50 --depth 6

6) 寻找机会（多子版块辅助命令）

当用户描述如下条件时使用该命令：
“在 r/a、r/b 和 r/c 中查找过去 48 小时内发布的关于 X 的帖子，并排除含 Y 的内容”。

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

推荐的智能体工作流

1. 必要时先明确范围：包括目标子版块、主题关键词、时间范围等。
2. 优先使用小限制值，调用 find（或 posts/search）启动。
3. 对其中 1–3 个有潜力的结果，使用 thread 获取完整上下文。
4. 向用户提供一份简明短列表，每项应包含：
   • 标题、所属子版块、分数（score）、发布时间
   • 永久链接（permalink）
   • 匹配原因简述
5. 若用户要求，可用自然语言提供 回复草稿建议，但须提醒用户仍需手动发布。

故障排查

• 若 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)'