@geoly-ai/social-hub-cli 0.1.9 → 0.1.11

package/skills/social-hub-intelligence/SKILL.md

@@ -50,25 +50,56 @@ social-hub intelligence tier-rules-delete -t <team-id> --id <uuid>
 
 ## 抓取任务（异步 run）
 
+品牌洞察默认使用 **Reddit 搜索 VOC 采样**（`sourceMode=search`），不是 watchlist 热帖过滤。
+`sourceMode=watchlists` 保留给运营热帖扫描；`hybrid` 先搜索再补充 watchlist 结果。
+
 ```bash
 social-hub intelligence fetch-by-industry -t <team-id> -j '{"mode":"all","industryKeys":["tech"],"sort":"hot","limitPerSubreddit":25}'
 social-hub intelligence fetch-by-tier -t <team-id> -j '{"mode":"all","tier":"T1","sort":"hot"}'
-social-hub intelligence fetch-by-keywords -t <team-id> -j '{"mode":"all","brandKeywords":["brand"],"competitorKeywords":["rival"]}'
-social-hub intelligence runs-list -t <team-id> [--dimension industry] [--status queued]
+social-hub intelligence fetch-by-keywords -t <team-id> -j '{
+  "mode":"all",
+  "brandKeywords":["brand"],
+  "competitorKeywords":["rival"],
+  "sourceMode":"search",
+  "redditSort":"relevance",
+  "redditTime":"month",
+  "limitPerQuery":10,
+  "maxPages":1
+}'
+social-hub intelligence fetch-by-keywords -t <team-id> -j '{
+  "mode":"all",
+  "brandKeywords":["brand"],
+  "sourceMode":"watchlists",
+  "sort":"hot",
+  "limitPerSubreddit":30
+}'
+social-hub intelligence runs-list -t <team-id> [--dimension keywords] [--status queued]
 ```
 
+Run 的 `resultPayload` 会保存 VOC 结构化结果（items/summary/rateLimit/requestIdentity/notes/errors），
+便于 UI 诊断。输出口径与 `reddit-voc-volume` skill 一致：低频采样、结构化 JSON、
+score/upvote_ratio 为 Reddit 公开字段而非全站真实总量。
+
 ## Insights
 
 ```bash
 social-hub intelligence brand-mention-radar -t <team-id> -j '{"keywords":["brand"]}'
 social-hub intelligence opportunity-map -t <team-id> -j '{"keywords":["topic"]}'
 social-hub intelligence sov -t <team-id> -j '{"brandKeywords":["brand"],"competitorKeywords":["rival"]}'
-social-hub intelligence sentiment-intent -t <team-id>
+social-hub intelligence sentiment-intent -t <team-id> --keywords brand,rival
 social-hub intelligence campaign-lift -t <team-id> -j '{"keywords":["brand"],"campaignStartAt":"2026-01-01T00:00:00Z","campaignEndAt":"2026-02-01T00:00:00Z"}'
 social-hub intelligence snapshot-latest -t <team-id>
 social-hub intelligence snapshot-save -t <team-id> -j '{"payload":{"note":"manual snapshot"}}'
 ```
 
+## Reddit 帖子表现刷新（worker）
+
+Worker 侧帖子刷新与 VOC 采样共用 `PublicRedditClient`：
+
+- 主路径：匿名 `.json` + `curl_cffi` / native fetch（`REDDIT_REFRESH_AUTH_MODE=none`）
+- 兜底：headless Chromium（`REDDIT_BROWSER_FALLBACK_ENABLED=true` 时启用）
+- 容器默认关闭 browser fallback；需要灰度时在 worker 环境打开并确保 Chromium 可用
+
 ## 派发到调度任务
 
 ```bash

package/skills/social-hub-openclaw-context/SKILL.md

@@ -81,7 +81,7 @@ social-hub query subreddit-candidates -t <team-id> --account A1 --action browse
 | `personaPools.expandedByKind`             | 按来源汇总：`direct` / `common` / `industry` / `pet` / `brand` 的 `r/...` 列表           |
 | `personaPools.expandedPools[].subreddits` | 每个 pool ref 展开后的具体板块（可多条）                                                 |
 | `personaPools.brandPools`                 | 账号品牌绑定及对应 `brand_pools.*` ref 展开结果                                          |
-| `personaPools.unresolvedRefs`             | alias 表无法解析的 ref；正常 seed 后 P01-P57 的 `starter/advanced/pet_pool` 不应出现    |
+| `personaPools.unresolvedRefs`             | alias 表无法解析的 ref；正常 seed 后 P01-P57 的 `starter/advanced/pet_pool` 不应出现     |
 | `fallback.reason`                         | 如 `candidate_pool_exhausted` 须在 Agent 回执说明                                        |
 
 **Agent 门禁**：

package/skills/social-hub-posts/SKILL.md

@@ -34,11 +34,13 @@ metadata:
 
 ```bash
 social-hub reddit list -t <team-id> -n 20
+social-hub reddit list -t <team-id> --ops-status normal --post-type post
 social-hub reddit list-full -t <team-id> --brand <brand-uuid> -n 50
 social-hub reddit list -t <team-id> --aggregate --all
 social-hub reddit stats -t <team-id> --aggregate --range 30
 social-hub reddit stats -t <team-id> --aggregate --range all
 social-hub reddit stats -t <team-id> --brand <uuid> --aggregate --range 90
+social-hub reddit stats -t <team-id> --ops-status risk --contains-brand-keyword true --primary-product "PLAUD Note"
 social-hub reddit refresh-status -t <team-id>
 social-hub reddit refresh -t <team-id> --snapshot <snapshotId>
 social-hub reddit refresh-progress -t <team-id> --batch <batchId>
@@ -48,6 +50,8 @@ social-hub reddit refresh-logs -t <team-id> -n 20
 
 筛选帖表现时优先 **`--brand`**，勿把 `--campaign` 当作品牌 ID。
 
+**`opsStatus` 约定（canonical，勿传中文或 `banned`）：** `normal` | `risk` | `deleted` | `abnormal` | `unknown`。列表与 stats 均支持 `--ops-status`；stats 同样支持 `--contains-brand-keyword` 与 `--primary-product`，筛选口径与 Web 帖子表现页一致。
+
 ## 单条写入与更新
 
 ```bash
@@ -103,6 +107,7 @@ social-hub reddit batch-upsert -t <team-id> -j '{
 
 - **必填（推荐）**：`subreddit`；有真实 Reddit 链接时带 `permalink`
 - **可选**：`title`、`score`、`commentsCount`、`viewCount`、`upvoteRatio`、`postedAt`、`source`、`publishDoc`、`rawPayload`
+- **`opsStatus`**：只写 canonical 值（`normal|risk|deleted|abnormal|unknown`），导入/更新时勿写中文标签。
 - **`socialAccountId`**：OpenClaw profile 扫描时建议带上（来自 `context account` 的 `account.id`），用于把快照归因到运营账号。
 - **`viewCount`**：浏览/曝光。平台页面不可见时传 `null`，不要臆造。
 - **`upvoteRatio`**：页面可读时传 0–1 小数；不可得时省略。

package/skills/social-hub-shared/SKILL.md

@@ -15,11 +15,11 @@ metadata:
 
 ## 凭证与配置真源
 
-| 项 | 推荐来源 | 说明 |
-|---|---|---|
-| API 地址 | `~/.config/social-hub/config.json` → `apiUrl` | 生产默认 `https://reddit.eclick-geo.com/api` |
-| 凭证 | 同上 → `authToken`（Device Code 登录后写入） | CLI 内部以 Bearer 发送；**不要用环境变量传 key** |
-| 默认 team | `context.json` 的 `currentTeamId` 或 config 的 `teamId` | 用 `social-hub context use` 持久化 |
+| 项        | 推荐来源                                                | 说明                                             |
+| --------- | ------------------------------------------------------- | ------------------------------------------------ |
+| API 地址  | `~/.config/social-hub/config.json` → `apiUrl`           | 生产默认 `https://reddit.eclick-geo.com/api`     |
+| 凭证      | 同上 → `authToken`（Device Code 登录后写入）            | CLI 内部以 Bearer 发送；**不要用环境变量传 key** |
+| 默认 team | `context.json` 的 `currentTeamId` 或 config 的 `teamId` | 用 `social-hub context use` 持久化               |
 
 配置文件路径：`~/.config/social-hub/config.json`（权限 `600`）。
 
@@ -128,11 +128,11 @@ CLI 仍兼容 `social-hub auth login --api-key sk_live_…` 与 `SOCIAL_HUB_API_
 
 Device Code 授权后，**`internal` 不足以**完成互动 CRON / ip-check / onboard 的常见 Hub 主写（例如 `events append`、`accounts update`、`accounts browser-envs update`）。部署 OpenClaw 执行 Agent 时，请为对应 Web 用户分配：
 
-| 最低 role | 典型 runtime 能力 |
-|-----------|-------------------|
+| 最低 role      | 典型 runtime 能力                                                                                              |
+| -------------- | -------------------------------------------------------------------------------------------------------------- |
 | **supervisor** | 推荐默认：`events append`、`accounts update`、`status-snapshots create`、`browser-envs create/update`、`ops *` |
-| **senior** | 只读 + `events append` / `ops *`（**不能** `accounts update` 或 browser-env telemetry） |
-| **internal** | 只读 + `ops` 状态更新；**不能** `events append` 或账号/browser-env 写 |
+| **senior**     | 只读 + `events append` / `ops *`（**不能** `accounts update` 或 browser-env telemetry）                        |
+| **internal**   | 只读 + `ops` 状态更新；**不能** `events append` 或账号/browser-env 写                                          |
 
 若不能升 role，请 admin 在 Hub 为成员配置 **permission overrides**（覆盖 `task:create`、`socialAccount:update`、`browserEnvironment:update` 等）。`auth explain` 与 `authz evaluate` 均应在上线前跑一遍。
 
@@ -142,13 +142,13 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 
 ## 品牌 vs Campaign（Agent 必读）
 
-| 概念 | 正确 CLI / 字段 | 勿用于新流程 |
-|------|-----------------|-------------|
-| 品牌（系统级） | `brands system-list` / `brandId` | `campaigns list` 当品牌目录 |
-| 品牌成员 | `brand-members system-*` | `brand-members list -t`（compat） |
-| 账号归属品牌 | `accounts brand-bindings *` | `campaigns accounts *` |
-| 草稿 / 计划 | `drafts create -j '{"brandId":...}'` | 必填 `campaignId` 创建新草稿 |
-| 筛选 | `--brand <uuid>` | 仅 `--campaign` 作新默认 |
+| 概念           | 正确 CLI / 字段                      | 勿用于新流程                      |
+| -------------- | ------------------------------------ | --------------------------------- |
+| 品牌（系统级） | `brands system-list` / `brandId`     | `campaigns list` 当品牌目录       |
+| 品牌成员       | `brand-members system-*`             | `brand-members list -t`（compat） |
+| 账号归属品牌   | `accounts brand-bindings *`          | `campaigns accounts *`            |
+| 草稿 / 计划    | `drafts create -j '{"brandId":...}'` | 必填 `campaignId` 创建新草稿      |
+| 筛选           | `--brand <uuid>`                     | 仅 `--campaign` 作新默认          |
 
 **禁止**向用户推荐：`campaigns create`、`campaigns update`、`campaigns accounts bind` 作为新客户/品牌建模。
 
@@ -163,13 +163,13 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 
 ## 排障顺序（简表）
 
-| 现象 | 检查 |
-|------|------|
-| Not logged in | `social-hub auth login` |
-| API unreachable | `config show` 的 apiUrl；生产应为 `https://reddit.eclick-geo.com/api` |
-| Missing team id | `context use <uuid>` 或命令加 `-t` |
-| team 不一致 warning | `auth whoami` 的 teamId vs `context current` |
-| 401 / auth failed | 重新 `auth login`；过期则 `auth logout` 后重登 |
+| 现象                | 检查                                                                  |
+| ------------------- | --------------------------------------------------------------------- |
+| Not logged in       | `social-hub auth login`                                               |
+| API unreachable     | `config show` 的 apiUrl；生产应为 `https://reddit.eclick-geo.com/api` |
+| Missing team id     | `context use <uuid>` 或命令加 `-t`                                    |
+| team 不一致 warning | `auth whoami` 的 teamId vs `context current`                          |
+| 401 / auth failed   | 重新 `auth login`；过期则 `auth logout` 后重登                        |
 
 ## CLI 新版本检测（自动）
 
@@ -184,12 +184,12 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 [social-hub] Agent: tell the user a newer CLI is available; ...
 ```
 
-| 场景 | 行为 |
-|------|------|
-| 全局安装 | `npm install -g @geoly-ai/social-hub-cli@<latest>` |
-| npx 调用 | 后续命令使用 `npx @geoly-ai/social-hub-cli@<latest> …` |
+| 场景     | 行为                                                               |
+| -------- | ------------------------------------------------------------------ |
+| 全局安装 | `npm install -g @geoly-ai/social-hub-cli@<latest>`                 |
+| npx 调用 | 后续命令使用 `npx @geoly-ai/social-hub-cli@<latest> …`             |
 | 跳过检查 | `SOCIAL_HUB_NO_UPDATE_CHECK=1` 或 `social-hub --no-update-check …` |
-| CI | 设置 `CI=true` 时自动跳过 |
+| CI       | 设置 `CI=true` 时自动跳过                                          |
 
 Agent 看到上述 stderr 时：**先向用户说明有新版本**，再执行升级命令，最后 `social-hub skills update --yes`（避免 CLI 与 skill 文档/命令漂移）。