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) 搜索帖子

# 在子版块内搜索
node {baseDir}/scripts/reddit-readonly.mjs search <subreddit> "<query>" --limit 10

# 搜索整个 Reddit
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10

3) 获取帖子的评论

# 通过帖子 ID 或 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) 发现机会（多版块辅助工具）

当用户描述如下标准时使用此工具： "查找过去48小时内在 r/a、r/b 和 r/c 中发布的关于 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 个有前景的项目，通过thread获取上下文。
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)'