Reddit 只读模式

为 Clawdbot 提供的只读 Reddit 浏览功能。

此技能的用途

• 在一个或多个子版块中查找帖子（热门/最新/热门/争议/上升）
• 按查询搜索帖子（在子版块内或跨所有版块）
• 拉取评论线程以获取上下文
• 生成一个永久链接的简短列表以便用户可以手动打开 Reddit 并回复

硬性规则

• 仅限于只读操作。此技能从不发帖、回复、投票或进行版务管理。
• 请求时请保持礼貌：
  • 优先使用较小的限制（5-10）。
  • 仅在需要时扩展。
• 向用户返回结果时，始终包含永久链接。

输出格式

所有命令均将 JSON 打印到标准输出。

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

命令

1) 列出子版块中的帖子

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

2) 搜索帖子

# Search within a subreddit
node {baseDir}/scripts/reddit-readonly.mjs search <subreddit> "<query>" --limit 10

# Search all of Reddit
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10

3) 获取帖子的评论

# By post id or URL
node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6

4) 获取子版块中的近期评论

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

5) 帖子及评论合集

node {baseDir}/scripts/reddit-readonly.mjs thread <post_id|url> --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. 从查找（或帖子/搜索）开始，使用较小的限制。
3. 对于 1–3 个有潜力的项目，通过帖子.
4. 向用户呈现一个候选列表：
   • 标题，子版块，评分，创建时间
   • 永久链接
   • 简要说明匹配原因
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)'