@geoly-ai/social-hub-cli 0.3.43 → 0.3.45

package/skills/reddit-voc-volume/SKILL.md

@@ -10,8 +10,8 @@ description: |
 
 ## Arctic Shift 归档后端(v2.12.27)
 
-`history` / `comments` 模式与缺省的 `--backend arctic-shift` 走 Arctic Shift 归档 API，不经
-reddit.com。**使用前读 [references/arctic-shift.md](references/arctic-shift.md)**，
+`history` / `comments` 模式与 `keyword` / `subreddit` 的 Emergency Acquisition 都走 Arctic Shift
+归档 API，不经 reddit.com（v2.12.28 起后端固定，**没有** `--backend` 参数）。**使用前读 [references/arctic-shift.md](references/arctic-shift.md)**，
 尤其是「能力边界」表：正文 / `num_comments` / `upvote_ratio` / 版规 / wiki 可用；
 **`score` 不可信**（实测约 1/3 归档行是发帖瞬间的陈旧值，逐条标 `score_status`，
 只有 `Backfilled` 允许用于声量）；此刻置顶、当前 hot、About 页周指标是 live 语义，
@@ -46,7 +46,8 @@ reddit.com。**使用前读 [references/arctic-shift.md](references/arctic-shift
 
 
 
-Python 3.10+；可选 curl、curl_cffi、browser_cookie3；网络可访问 reddit.com；建议配置 HTTPS_PROXY。
+Python 3.10+；网络可访问 **arctic-shift.photon-reddit.com**（历史/评论/版规/wiki/about）与 Social Hub / 本机 Firecrawl（渲染页证据）；建议配置 HTTPS_PROXY。
+**本机不直连 reddit.com**：渲染页由 Hub / Firecrawl 代为访问。`curl`、`curl_cffi`、`browser_cookie3` 与 `--via-curl` 均为 v2.12.28 前的遗留物，当前代码路径用不到（见下节「请求身份」）。
 
 ## 何时用 / 不用
 
@@ -55,9 +56,9 @@ Python 3.10+；可选 curl、curl_cffi、browser_cookie3；网络可访问 reddi
 | 品牌词/关键词 Reddit 声量 | 单条链接只要 score → `reddit-link-engagement` |
 | 指定 r/xxx 内关键词扫描 | 大规模全站监控、分钟级轮询 |
 | 批量 Reddit URL 汇总：帖子 permalink、`/about`、`/about/rules`、`/wiki/*` | 绕过私密版/验证码/登录墙 |
-| subreddit hot listing 里的置顶帖 / pinned / stickied / megathread 公开采样 | 读取 AutoModerator 配置或 mod apps 后台 |
+| 通过 Social Hub 取得当前置顶帖 / pinned / stickied / megathread 公开证据；Hub 不可用时标 NotVisible | 读取 AutoModerator 配置或 mod apps 后台 |
 | 公开渲染 About 页里的周访客/周贡献/每周活跃用户兼容字段、可见 Installed Apps、公开 flair filter / page signals | 保证完整后台 Installed Apps 或 flair template 列表 |
-| JSON 失败后的 Social Hub / Firecrawl / 浏览器低频兜底采样 | 并发刷搜索页 |
+| Hub / Arctic 取不到时的 Social Hub / Firecrawl / 浏览器低频兜底采样 | 并发刷搜索页 |
 
 ## 一步执行(Emergency Acquisition——仅四级链路 L3 时使用,默认先走 Hub,见上节)
 
@@ -123,9 +124,9 @@ python3 "$VOC" comments t3_abc123 --source search --body "battery life" \
 # 按评论 ID 批查（最多 500；空格或逗号分隔）
 python3 "$VOC" comments --ids t1_def456 ghi789 --pretty
 
-# Emergency Acquisition 后端切换（缺省已是 arctic-shift）
-python3 "$VOC" keyword "PLAUD recorder" --backend arctic-shift --pretty
-python3 "$VOC" keyword "PLAUD recorder" --backend reddit-json --pretty
+# ⛔ 没有 --backend 这个参数(v2.12.28 起后端固定 Arctic Shift)。
+# 传它会被 argparse 直接拒掉:error: unrecognized arguments: --backend
+# 旧文档里的 `--backend arctic-shift` / `--backend reddit-json` 两条都跑不了,别照抄。
 
 # 检查 Social Hub scrape fallback
 python3 "$VOC" social-hub-check --pretty
@@ -136,7 +137,7 @@ python3 "$VOC" firecrawl-check --pretty
 # 检查 skill 内置的 Firecrawl 自托管源码快照
 python3 "$HOME/.cursor/skills/reddit-voc-volume/scripts/setup_firecrawl_service.py" --check --pretty
 
-# 仅在 Reddit JSON 失败时启用 Social Hub 页面 fallback
+# 渲染页证据:显式启用 Social Hub 页面 fallback(Arctic 不提供渲染页信号时)
 python3 "$VOC" links \
   "https://www.reddit.com/r/espresso/wiki/rules" \
   --fallback social-hub \
@@ -162,7 +163,7 @@ python3 "$VOC" links \
 | `subreddit` | Hub-First 子版内关键词 VOC | `-r/--subreddit` 可重复；同上 acquisition-policy/sort/time |
 | `links` | 批量 Reddit URL；支持帖子 permalink、subreddit about、about/rules、wiki 页面；可显式启用 Social Hub / Firecrawl 页面 fallback | URL 列表或 `--file`；`--fallback social-hub/firecrawl/auto` |
 | `comments` | **v2.12.31 新增。** 从 Arctic Shift 读取帖子历史评论正文；默认树模式，另有筛选搜索和评论 ID 批查 | positional 帖子 URL/ID；`--source tree/search`；`--body` / `--author` / `--after` / `--before` / `--parent-id`；`--ids` |
-| `stickies` | 从 subreddit hot listing 低频读取 `stickied=true` 置顶帖 | `-r/--subreddit` 可重复；`--limit` 控制 hot listing 读取数量 |
+| `stickies` | Hub-First 读取当前置顶证据；本地无有效兜底，取不到标 NotVisible | `-r/--subreddit` 可重复；`--limit` 为历史兼容参数 |
 | `about-page` | 用 Social Hub 或自托管 Firecrawl 渲染公开 subreddit About 页，提取 weekly visitors、weekly contributions、weekly active users 兼容字段、公开 Installed Apps | `-r/--subreddit` 可重复；`--provider social-hub/firecrawl/auto`；`--firecrawl-base-url` |
 | `page-signals` | 用 Social Hub 或自托管 Firecrawl 渲染任意公开 Reddit 页，统一解析页面 links/Markdown 里的公开信号 | URL 列表或 `--file`；`--provider social-hub/firecrawl/auto` |
 | `flair-filters` | 渲染 subreddit home/hot/new/top，合并公开可见 flair filter 链接 | `-r/--subreddit` 可重复；`--provider social-hub/firecrawl/auto` |
@@ -272,7 +273,7 @@ python3 "$VOC" page-signals "https://www.reddit.com/r/espresso/" \
 
 ### Social Hub / Firecrawl 页面 fallback（可选）
 
-页面 fallback 只在 `links` 模式显式开启；当 Reddit JSON 抓取失败，或 JSON 成功但结构化解析不到目标内容（如非帖子页面被帖子解析器返回 `no_post_in_listing`）时触发。`social-hub` 需要 Social Hub CLI 已登录且 `social-hub scrape status` 可用；`firecrawl` 需要本机自托管 Firecrawl 服务。
+页面 fallback 只在 `links` 模式按 `--fallback` 开启；当 Arctic 归档查询失败或未返回可解析的目标内容时触发。`social-hub` 需要 Social Hub CLI 已登录且 `social-hub scrape status` 可用；`firecrawl` 需要本机自托管 Firecrawl 服务。当前已验证出口上，Social Hub scrape 的 Reddit 渲染页也可能返回 captcha；`auto` 会接着尝试本机 Firecrawl，两者都失败时标 NeedsAcquisition，不把页面缺口判作内容不存在。
 
 ```bash
 python3 "$VOC" links "https://www.reddit.com/r/espresso/wiki/rules" \
@@ -374,7 +375,7 @@ Installed Apps 只代表公开渲染 About 页可见的 app 链接，例如页
 
 若页面 provider 可达但 Reddit 返回空壳页或 anti-bot 内容，`about-page` 会输出 `ok=false`、`about_page_failed: ... about_page_empty_rendered_content`。这时不要写 `NotVisible` 或“没有数据”，而是在 Phase 0.5 报告里标 `AboutPageEvidenceStatus: NeedsAcquisition`，可低频稍后重试，或要求用户提供 About 页截图/文本。
 
-Social Hub / Firecrawl 只能提供公开 HTML/Markdown 页面证据；不要把它们当成 Reddit JSON 替代品。帖子 `score`、`num_comments`、`upvote_ratio`、`stickied=true`、flair 结构化字段仍以 JSON 成功输出为准。
+Social Hub / Firecrawl 只能提供公开 HTML/Markdown 页面证据；不要把渲染页信号当成完整结构化数据。帖子 `num_comments`、`upvote_ratio` 与 flair 字段可来自 Hub 或 Arctic 归档；Arctic `score` 仅在 `score_status=Backfilled` 时可用于声量，`VerifiedLive` 则以实时核验值为准。归档 `stickied` 不证明当前置顶；当前置顶只用 Hub 的 live 证据。
 
 ## 风控（默认严格，勿随意放宽）
 
@@ -385,24 +386,30 @@ Social Hub / Firecrawl 只能提供公开 HTML/Markdown 页面证据；不要把
 - 默认 `--sleep-sec 6`，每次请求后 **+1.5–4.5s** 随机抖动
 - 默认 `--max-pages 1`，单次运行最多 **20** 个 HTTP 请求
 - 遇 **429** → 立即熔断，输出 `rate_limited: true`
-- 遇 **403/HTML challenge** → 停止扩量，见 [`references/browser-fallback.md`](references/browser-fallback.md)
+- 渲染页（Social Hub / Firecrawl）遇 **403/captcha/HTML challenge** → 停止扩量，见 [`references/browser-fallback.md`](references/browser-fallback.md)；reddit.com `.json` 已不在采集路径内（见下节）
 
 长期监控：按**小时/天**排程、缓存结果、只增量查询；勿同一 IP 高频轮询。
 
 v2.12.23 沿用 v2.12.12 引入的安全默认采样：`limit=10 / sleep=6`，目的是降低单次误触发风控的概率。Phase 0.5 / Phase 1 如需更大样本，应在命令中显式传 `--limit` 和 `--sleep-sec`，不要依赖默认值。
 
-## JSON 请求身份
+## 请求身份（v2.12.28 起不再打 reddit.com `.json`）
 
-Reddit `.json` 常对非浏览器请求 403。脚本默认：
+🔴 **本脚本已不向 reddit.com 发 `.json` 请求。** v2.12.28 把 `search.json` / `<permalink>.json` /
+`about.json` / `rules.json` / `wiki/*.json` 全部换成 Arctic Shift 端点（对照表见
+[`references/arctic-shift.md`](references/arctic-shift.md) §「v2.12.28：reddit `.json` 直采已全部移除」），
+渲染页证据走 Social Hub / Firecrawl。**2026-09-18 实测：`.json` 对住宅代理同样 403**，
+Reddit 侧封控已不是「换个指纹/加 cookie 就能过」的问题，别再把它当可选通道。
 
-1. Chrome UA + 完整浏览器请求头
-2. `curl_cffi` Chrome TLS 指纹（`impersonate=chrome131`）
-3. 可选 cookie：`REDDIT_COOKIES_JSON` 或 `REDDIT_USE_BROWSER_COOKIES=1`（`browser_cookie3` 读本机浏览器）
-4. 降级：`curl` → `urllib`；代理：`HTTPS_PROXY` / `REDDIT_SYNC_HTTP_PROXY`
+遗留物盘点：`RedditHttpClient` / `CookieStore` 仍有定义，但主流程不再实例化客户端，也不会读取浏览器 cookie；
+`--via-curl` 是保留的空开关；`fetch_via_curl_cffi` / `http_get_json_via_curl` 只有定义没有调用。
+`requirements.txt` 的 `curl_cffi`、`browser_cookie3` 当前路径用不到。输出信封里的
+`request_identity.*` 是兼容字段，**不表示真的打过 reddit.com**。
 
-**Cookie 单次加载**：进程启动时读一次 cookie（或 `REDDIT_COOKIES_JSON`），整次运行复用；`curl_cffi` Session 也复用，避免重复弹钥匙串。输出 `request_identity.cookie_cache_reused` 表示多请求复用。
+`links` 模式四种目标现在全部走 Arctic：帖子 permalink → `arctic_post_by_permalink`，
+about / rules / wiki → 对应的 `arctic_*_as_reddit_payload`；取不到才按 `--fallback` 走 Hub / Firecrawl 渲染页。
 
-Cookie **仅**用于减少公开页误判，不用于私密版/验证码。输出 `request_identity` 不含 cookie 值。
+出站身份现在只剩两类：Arctic Shift 归档 API（普通 HTTPS，可用 `HTTPS_PROXY`）与
+Social Hub / Firecrawl 渲染页。
 
 ## 输出 JSON 结构
 
@@ -485,8 +492,8 @@ Cookie **仅**用于减少公开页误判，不用于私密版/验证码。输
 > | `selftext_chars` / `selftext_words` | 正文真实长度（截断前） |
 > | `selftext_truncated` | `false`=全文可信；`true`=被截断；**`null`=来源未声明（Hub 的 `selftextExcerpt` 即为此类），下游须按已截断处理** |
 >
-> **v2.12.27：`selftext_truncated=false` 的三个合法来源** —— Hub 记录声明
-> `selftextCompleteness: full`；Arctic Shift 归档；reddit `.json` 直采。
+> **`selftext_truncated=false` 的合法来源** —— Hub 记录声明 `selftextCompleteness: full`；
+> Arctic Shift 归档。（v2.12.27 原列的第三项「reddit `.json` 直采」自 v2.12.28 起已不存在。）
 > Hub 的 `unknown` / 无声明仍是 `null`。Hub dispatch run 的 `resultPayload`
 > **不带正文字段**，脚本会从 `intelligence hot-posts` 回填，回填不到保持 `null`。
 >
@@ -507,13 +514,13 @@ Cookie **仅**用于减少公开页误判，不用于私密版/验证码。输
 
 
 - `score` 是 Reddit 展示分，≠ 纯点赞数；`upvote_ratio` 更有参考价值。
-- `flair_*` 来自 Reddit post JSON 的 `link_flair_*` 字段；无 flair 时字段保持 `null` 或空数组。帖子 item 还包含公开 JSON 中可见的 `flair_template_id`、`flair_filter_query`、`author_flair_text`、`author_flair_type`、NSFW/spoiler/gallery/video 等辅助字段。
+- `flair_*` 从 Hub 或 Arctic 帖子记录的 `link_flair_*` 字段映射；无 flair 时字段保持 `null` 或空数组。帖子 item 还包含来源记录中可见的 `flair_template_id`、`flair_filter_query`、`author_flair_text`、`author_flair_type`、NSFW/spoiler/gallery/video 等辅助字段。
 - `item_type=post` 是帖子；`item_type=subreddit_about` / `subreddit_rules` / `wiki_page` 是非帖子公开页面证据，`score` / `num_comments` 置 0 仅为 schema 兼容。
 - `item_type=comment` 来自 `comments`，`body` 为不截断的归档评论正文；`parent_id` 加树坐标可还原层级。其 `score_status=ArchivedSnapshot`、`score_realtime=false`，不得当实时热度。
-- `item_type=pinned_post` 来自 `stickies` 模式，只代表 hot listing 中公开可见的 `stickied=true` 帖子；可作为 Pinned/Sticky/Megathread 证据输入 `reddit-subreddit-compliance`。
-- `item_type=firecrawl_page` 是 Social Hub / Firecrawl 页面 fallback 结果，含 `markdown_excerpt`、`html_excerpt`、`metadata`、`page_provider` 和 `page_signals`；只在 `--fallback social-hub|firecrawl|auto` 且 JSON 抓取失败或解析不到目标内容时出现。
+- `item_type=pinned_post` 只能来自 Hub 的当前置顶证据；`stickies` 的本地 Emergency Acquisition 不再产出它。Hub 取不到时标 NotVisible / NeedsAcquisition，不用归档 `stickied` 冒充。
+- `item_type=firecrawl_page` 是 Social Hub / Firecrawl 页面 fallback 结果，含 `markdown_excerpt`、`html_excerpt`、`metadata`、`page_provider` 和 `page_signals`；只在 `--fallback social-hub|firecrawl|auto` 且 Arctic 查询失败或未返回可解析目标时出现。
 - `item_type=subreddit_about_page` 是 `about-page` 的 Social Hub / Firecrawl 渲染结果，含 `weekly_visitors`、`weekly_contributions`、`weekly_active_users`、`weekly_active_users_source`、`installed_apps`、`installed_apps_status`、`flair_filters`、`page_signals`、`page_provider`，只能作为公开渲染 About 页证据。
-- `item_type=reddit_page_signals` / `subreddit_flair_filters` 来自 `page-signals` / `flair-filters`，只表示公开渲染页可见链接和正文信号；不能替代 `.json` 的 score/comment/stickied，也不能证明后台 flair template 或 Installed Apps 完整列表。
+- `item_type=reddit_page_signals` / `subreddit_flair_filters` 来自 `page-signals` / `flair-filters`，只表示公开渲染页可见链接和正文信号；不能单凭它们证明实时 score/comment/current-pinned，也不能证明后台 flair template 或 Installed Apps 完整列表。
 - `subreddit_rules` items 含 `rules[]`、`rule_count`、`rules_text_excerpt`；`wiki_page` items 含 `wiki_page`、`content_md_excerpt`；`subreddit_about` items 含 `public_description`、`description_excerpt`、`submit_text_excerpt`、`allow_images/videos/polls/galleries`、`link_flair_enabled`、`user_flair_enabled_in_sr`、`wiki_enabled`、banner/sidebar 元数据。
 - `subreddit_metrics` 是 best-effort 板块公开指标。v2.12.28 起 `subscribers` 等来自 **Arctic Shift 的 subreddit 元数据**，`metrics_status=ArchivedSnapshot` —— Arctic 的 subreddit 列表更新不频繁，这是**快照值，不是实时订阅数**。另附 `num_posts` / `num_comments` / `metrics_updated_at`（来自 `_meta`，刷新更勤）。取不到时字段为 `null` 且 `metrics_status=Unavailable`。要实时规模指标走 `about-page` 渲染页或 Hub。
 - `subreddit_metrics.weekly_visitors` / `subreddit_metrics.weekly_active_users` 不是稳定公开 JSON 字段，默认输出 `null`；需要周访客/周贡献时运行 `about-page`，并在报告中标注来源为 `public_rendered_about_page`。
@@ -522,7 +529,7 @@ Cookie **仅**用于减少公开页误判，不用于私密版/验证码。输
 
 ## 浏览器兜底
 
-JSON 连续失败时，优先考虑显式 `--fallback social-hub` 或 `--fallback auto`；若 Social Hub 和本地 Firecrawl 都不可用，再读 [`references/browser-fallback.md`](references/browser-fallback.md)：低频打开搜索页/子版页，只读首屏，回填同一 schema（`fetch_mode: browser_fallback`，`confidence: sampled`）。
+Arctic 查询缺口或渲染页取不到时，先按 Hub-First 决策表处理；`links` 可显式启用 `--fallback auto`。若 Social Hub 和本地 Firecrawl 都不可用，再读 [`references/browser-fallback.md`](references/browser-fallback.md)：低频打开搜索页/子版页，只读首屏，回填同一 schema（`fetch_mode: browser_fallback`，`confidence: sampled`）。
 
 ## 安装与依赖
 

package/skills/reddit-voc-volume/matrix-contract.md

@@ -19,7 +19,7 @@
 - archived comment bodies and reconstructable thread hierarchy from Arctic Shift
   (`comments`; `parent_id` plus tree coordinates; archive score is not live)
 - public subreddit rules/wiki/about/submit-text evidence
-- public pinned/stickied/megathread evidence from subreddit hot listings
+- current pinned/stickied/megathread evidence from Social Hub (no local archive substitute)
 
 ## Evidence Role
 

package/skills/reddit-voc-volume/references/arctic-shift.md

@@ -1,8 +1,8 @@
 # Arctic Shift 归档后端（v2.12.27；v2.12.31 增加评论正文）
 
-> **何时读本文件：** 使用 `history` / `comments` 模式，或 Emergency Acquisition 落到
-> `--backend arctic-shift`（缺省）时。判断某个字段能不能用，以本文件的
-> 「能力边界」表为准。
+> **何时读本文件：** 使用 `history` / `comments` 模式，或 Emergency Acquisition 取数时
+> （v2.12.28 起后端固定 Arctic Shift，**没有** `--backend` 参数可选）。判断某个字段能不能用，
+> 以本文件的「能力边界」表为准。
 
 上游项目：<https://github.com/ArthurHeitmann/arctic_shift>
 Base URL：`https://arctic-shift.photon-reddit.com`
@@ -130,12 +130,13 @@ python3 "$VOC" comments "https://www.reddit.com/r/example/comments/abc123/slug/"
 python3 "$VOC" comments abc123 --source search --body "battery life" --parent-id top --pretty
 python3 "$VOC" comments --ids t1_def456 ghi789 --pretty
 
-# Emergency Acquisition 显式指定后端（缺省已是 arctic-shift）
-python3 "$VOC" keyword "PLAUD recorder" --backend arctic-shift --pretty
-python3 "$VOC" keyword "PLAUD recorder" --backend reddit-json --pretty   # 旧的 .json + curl
+# Emergency Acquisition:后端固定 Arctic Shift,直接跑即可
+python3 "$VOC" keyword "PLAUD recorder" --pretty
+# ⛔ 没有 --backend 参数。旧文档里的 `--backend arctic-shift` / `--backend reddit-json`
+#    都会被 argparse 拒掉:error: unrecognized arguments: --backend
 ```
 
-环境变量 `REDDIT_VOC_BACKEND` 可改缺省后端。
+后端不可切换:v2.12.28 起固定 Arctic Shift。(旧文档提到的 `REDDIT_VOC_BACKEND` 环境变量脚本里并不存在,设了也没有任何效果。)
 
 ## 输出信封新增字段
 

package/skills/reddit-voc-volume/references/browser-fallback.md

@@ -1,6 +1,11 @@
-# 浏览器低频兜底（JSON 不可用时）
+# 浏览器低频兜底（渲染页也取不到时）
 
-当 `reddit_voc_volume.py` 返回 `403`、`reddit_returned_html_not_json`、连续 `429` 熔断后，才考虑浏览器兜底。**不是**默认路径。
+> **v2.12.28 起的前提变化**：主路径已不打 reddit.com `.json`（历史走 Arctic Shift，证据走
+> Social Hub / Firecrawl 渲染页）。**2026-09-18 实测 `.json` 对住宅代理同样 403**，所以这里的
+> 触发条件应读作「Hub 与 Firecrawl 渲染页都取不到」，而不是「JSON 挂了」。
+
+当 Arctic / Hub 无法提供所需证据，且 Social Hub / Firecrawl 渲染页返回 `403` / captcha
+或连续 `429` 熔断后，才考虑浏览器兜底。**不是**默认路径；验证码或登录墙必须停止，不得绕过。
 
 ## 原则
 
@@ -8,7 +13,7 @@
 - 只读 **首屏/少量可见** 帖子，不自动滚动扫全量
 - 页面间等待 **≥10–20s**，加随机停顿；不连续刷新同一 URL
 - 不用登录态绕过私密/受限内容；不处理验证码；不自动换 IP
-- 输出必须复用与 JSON 模式相同的 schema，并标记：
+- 输出必须复用 VOC 的结构化 schema，并标记：
   - `fetch_mode: "browser_fallback"`
   - `confidence: "sampled"`
   - `notes`: 说明为浏览器首屏采样，非完整结果
@@ -25,7 +30,7 @@ https://www.reddit.com/r/SUBREDDIT/search/?q=QUERY&restrict_sr=1&sort=relevance&
 1. 先读 `browser-element-finder` skill 的连接规范（profile + targetId）
 2. `browser(action="open", url=<search_url>, profile=...)`
 3. `browser(action="snapshot", ...)` 读取可见帖子标题、链接、score、评论数（若 snapshot 含）
-4. 手动解析为 `items[]`，字段对齐 JSON 模式
+4. 手动解析为 `items[]`，字段对齐 VOC 输出 schema
 5. 等待 ≥10s 再开下一页（通常本次任务只开一页）
 
 ## 回填 JSON 示例片段

package/skills/reddit-voc-volume/requirements.txt

@@ -1,3 +1,5 @@
-# Reddit VOC volume — Python dependencies (optional but recommended)
+# Reddit VOC volume — Python dependencies
+# 以下两项仅供未调用的旧 Reddit HTTP 函数使用。主流程不实例化旧客户端，
+# 不读取浏览器 cookie；不安装也不影响当前模式。
 curl_cffi>=0.7.0
 browser_cookie3>=0.19.0

package/skills/reddit-voc-volume/scripts/reddit_voc_volume.py

@@ -3078,9 +3078,7 @@ def collect_subreddit_metrics(
     subreddit_names: list[str],
     *,
     user_agent: str,
-    force_curl: bool,
     tracker: RequestTracker,
-    http: RedditHttpClient,
     notes: list[str],
     errors: list[str],
 ) -> list[dict[str, Any]]:
@@ -4008,9 +4006,7 @@ def run_stickies_mode(
     limit: int,
     sleep_sec: float,
     user_agent: str,
-    force_curl: bool,
     tracker: RequestTracker,
-    http: RedditHttpClient,
 ) -> tuple[list[dict[str, Any]], list[str], list[str]]:
     notes: list[str] = []
     errors: list[str] = []
@@ -4071,9 +4067,7 @@ def run_links_mode(
     *,
     sleep_sec: float,
     user_agent: str,
-    force_curl: bool,
     tracker: RequestTracker,
-    http: RedditHttpClient,
     fallback: str = "none",
     firecrawl_base_url: str | None = None,
     verify_rules: bool = False,
@@ -4243,7 +4237,7 @@ def run_links_mode(
             else:
                 errors.append(f"{url}: {msg}")
                 notes.append(
-                    "JSON fetch failed. To try page fallback, rerun links with "
+                    "Arctic lookup failed. To try page fallback, rerun links with "
                     "--fallback social-hub, --fallback firecrawl, or --fallback auto."
                 )
         except Exception as e:
@@ -4253,7 +4247,7 @@ def run_links_mode(
             else:
                 errors.append(f"{url}: {e}")
                 notes.append(
-                    "JSON fetch failed. To try page fallback, rerun links with "
+                    "Arctic lookup failed. To try page fallback, rerun links with "
                     "--fallback social-hub, --fallback firecrawl, or --fallback auto."
                 )
         jitter = sleep_with_jitter(sleep_sec)
@@ -4941,7 +4935,7 @@ def main() -> int:
             if _env_truthy("REDDIT_SOCIAL_HUB_ENABLED")
             else "none"
         ),
-        help="Optional page fallback when Reddit JSON fetch fails. auto tries social-hub first, then local Firecrawl.",
+        help="Optional page fallback when the Arctic archive lookup fails or returns nothing. auto tries social-hub first, then local Firecrawl.",
     )
     pl.add_argument(
         "--firecrawl-base-url",
@@ -5346,7 +5340,6 @@ def main() -> int:
 
     tracker = RequestTracker()
     mode_acquisition: dict[str, Any] | None = None
-    http = RedditHttpClient(args.user_agent if hasattr(args, "user_agent") else DEFAULT_UA, force_curl=getattr(args, "via_curl", False))
 
     if args.mode in ("keyword", "subreddit"):
         effective_limit, limit_truncated = clamp_limit(args.limit)
@@ -5413,9 +5406,7 @@ def main() -> int:
             subreddit_metrics = collect_subreddit_metrics(
                 metric_subreddits,
                 user_agent=args.user_agent,
-                force_curl=args.via_curl,
                 tracker=tracker,
-                http=http,
                 notes=notes,
                 errors=errors,
             )
@@ -5474,9 +5465,7 @@ def main() -> int:
                 limit=effective_limit,
                 sleep_sec=args.sleep_sec,
                 user_agent=args.user_agent,
-                force_curl=args.via_curl,
                 tracker=tracker,
-                http=http,
             )
             notes.extend(local_notes)
             errors.extend(local_errors)
@@ -5488,9 +5477,7 @@ def main() -> int:
             subreddit_metrics = collect_subreddit_metrics(
                 subreddits,
                 user_agent=args.user_agent,
-                force_curl=args.via_curl,
                 tracker=tracker,
-                http=http,
                 notes=notes,
                 errors=errors,
             )
@@ -5688,9 +5675,7 @@ def main() -> int:
             urls,
             sleep_sec=args.sleep_sec,
             user_agent=args.user_agent,
-            force_curl=args.via_curl,
             tracker=tracker,
-            http=http,
             fallback=args.fallback,
             firecrawl_base_url=args.firecrawl_base_url,
             verify_rules=getattr(args, "verify_rules", False),
@@ -5702,9 +5687,7 @@ def main() -> int:
         subreddit_metrics = collect_subreddit_metrics(
             [str(item.get("subreddit") or "") for item in items],
             user_agent=args.user_agent,
-            force_curl=args.via_curl,
             tracker=tracker,
-            http=http,
             notes=notes,
             errors=errors,
         )