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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoly-ai/social-hub-cli",
-  "version": "0.3.42",
+  "version": "0.3.43",
   "type": "module",
   "description": "social-hub CLI for Social Ops Hub",
   "repository": {
@@ -23,7 +23,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "@geoly-ai/social-hub-authz": "0.0.20",
-    "@geoly-ai/social-hub-sdk": "0.1.15"
+    "@geoly-ai/social-hub-sdk": "0.1.16"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/skills/integrity.json

@@ -4,7 +4,7 @@
   "fileCount": 1656,
   "files": {
     "README.md": "5246d4ae2712e3e656b101041929183d7ae7f8ea487dacf5854187826ab7c335",
-    "manifest.json": "511a9d10759fb3093bd091a04cf613743967548b9b12d623cae22235571fd7e9",
+    "manifest.json": "aa878b3b0abb3e120e88d54f293f7ca30157e9fd4467ce26e148976d26e31952",
     "reddit-answers-research/SKILL.md": "ab6fd12eeb2fef4dc31a6f3c21a84810d6b5bdb309f130bcdc9eb902f075294a",
     "reddit-answers-research/references/browser-playbook.md": "a8f61d3d43ca93d46dadc8a092a515ddcd32df12fb1d08d334cce2e02709d915",
     "reddit-answers-research/references/report-template.md": "9aa9acf555ba8b2ca503bdbdf5750a5f53c66e19989bf6807fa6200c7317e306",
@@ -1643,7 +1643,7 @@
     "social-hub-content-review/SKILL.md": "6d10a84ab56552fd953863b97978bddc0e925e3a2667d64a7a4c51e33a3ddb58",
     "social-hub-events-observability/SKILL.md": "f4c17487c64bb1f48381d8d60e97cfa160a94a0f120153b1c0e798a0c7ee7ebe",
     "social-hub-graph-compliance/SKILL.md": "2270aeb321733f0318f75da4838ca1ca03996c6cac59e5a12f7152bd1ecdfa26",
-    "social-hub-intelligence/SKILL.md": "632e6ad7fe92cf82c0b5e9e01c2ea5d6aff94871384c5e39d8617fcd0663e877",
+    "social-hub-intelligence/SKILL.md": "69f4a3d97b36e13f8ee594708f84e268996559ace86982194dbc23d353cc2923",
     "social-hub-migration/SKILL.md": "1c13f231bb81ae8d242c834eec93a499830481804c66f6dba95922972f56f9ce",
     "social-hub-notifications/SKILL.md": "f80f4cf2f9ef0dbf60bd6e8bb4ad7e27dc0ff1fe59f4c7e79e49cc691ed4be6a",
     "social-hub-openclaw-context/SKILL.md": "97c48f38f1f1a206c3af2af49fcd445a1cd5b78d4a9c805c2456de4ce98fec09",

package/skills/manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "package": "social-ops-hub",
-  "cliVersion": "0.3.42",
+  "cliVersion": "0.3.43",
   "repository": "social-ops-hub",
   "publish": {
     "registry": "https://skill.sh",

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

@@ -278,7 +278,8 @@ social-hub intelligence monitor-runs-list [--status degraded] [-n 20]
 social-hub intelligence monitor-ruleset-create --monitor <uuid> --lookback 1440 \
   --note "第一版:品牌词 + 竞品词" \
   -j '[{"term":"aporro","scope":"both","matchMode":"word","weight":3},
-       {"term":"cold brew","scope":"body","matchMode":"phrase"}]'
+       {"term":"cold brew","scope":"body","matchMode":"phrase"},
+       {"term":"espresso martini","polarity":"exclude","matchMode":"phrase"}]'
 
 # 2) 🔴 试跑:拿过去 24h 的历史帖子跑一遍,看会命中什么(只读,不发任何通知)
 social-hub intelligence monitor-ruleset-dry-run --monitor <uuid> --rule-set <uuid> --lookback 1440
@@ -301,7 +302,8 @@ social-hub intelligence monitor-brand-keyword-candidates --monitor <uuid> [--bra
 1. **active 之后不可原地修改,只能新建版本**(DB 触发器焊死)。改词的正确流程是
    create draft → dry-run → activate,不是去改已激活的那一版。
 2. **激活/停用不会重发历史命中**。观察的水位在被评估的那一轮就推进了,**无论命中与否** ——
-   否则调宽一次关键词,负责人就被历史帖子刷一次屏。要追溯旧帖需要显式 replay(尚未实现)。
+   否则调宽一次关键词,负责人就被历史帖子刷一次屏。要看「新规则放回历史窗口会怎样」,
+   用 `monitor-replay-run`(见下面「回放」)—— 它**同样不发通知**。
 3. **停用 ≠ 静音**。retire 之后该监听回到「不设关键词门」,报告**恢复全量新帖**。
    要减少推送就改规则,不要指望 retire。
 4. **词边界**:`matchMode=word` 时 `art` **不会**命中 `earth`,但会命中 `art-house`。
@@ -321,9 +323,82 @@ social-hub intelligence monitor-brand-keyword-candidates --monitor <uuid> [--bra
 watchlist 与品牌是多对多,若监听直接读品牌词并集,「给某品牌加一个词」或「把品牌绑到
 这个 watchlist」都会让**监听范围悄然扩大**,而运营没做过任何监听侧的动作。
 
-**卡片上「未发现新帖」要分三种读法**(0168 起卡片会自己区分,别再一律当成「没动静」):
+**卡片上「未发现新帖」要分五种读法**(卡片会自己区分,别再一律当成「没动静」):
 覆盖完整且没被过滤 ⇒ 真的没新帖;板块疑似截断 / 拿不到分页游标 ⇒ **采集没抓全**,
-按采集问题排查;全被关键词门筛掉 ⇒ 去看规则集。
+按采集问题排查;全被**排除词**否掉 ⇒ 去看排除词是不是配宽了;
+全都没命中 include 词 ⇒ 去看 include 词是不是配窄了;
+正文补抓全部失败 ⇒ **采集问题**,关键词只在正文里的帖子这轮判不了。
+🔴 后两组的处置方向**相反**(放宽 vs 收窄),所以卡片刻意分开表述,别当成同一句话。
+
+### 排除词 / 布尔规则(0171)
+
+规则对象加 `"polarity":"exclude"` 就是排除词(缺省 `include`)。
+
+```bash
+# espresso 收进来,但 espresso martini 排出去 —— 两条可以共存(唯一键含 polarity)
+-j '[{"term":"espresso","scope":"both","matchMode":"word"},
+     {"term":"espresso martini","polarity":"exclude","matchMode":"phrase"}]'
+```
+
+**四条口径**:
+
+1. **exclude 只撤销,自己不产生命中**。所以**一条 include 都没有的规则集不许激活**
+   (409 `monitor_rule_set_exclude_only`)—— 那等于把整个板块静音,而卡片上看起来
+   只是「今天没有相关新帖」。
+2. **撤销按来源优先级由低到高**:`manual`(30) > `brand_keyword`(20) > `expansion`(10)。
+   一条 exclude 只能撤销**优先级不高于它自己**的 include 命中 —— 近义词扩展出来的
+   否定词压不住运营亲手填的 include 词。同源的一对(都是 manual)**可以**互相作用。
+3. **被排除掉 ≠ 没命中**。dry-run 与回放都把它们分成 `excluded` / `no_match` 两个数,
+   卡片上也是两句话。⛔ 别合并看:前者去看排除词是不是配宽了,后者去看 include 词
+   是不是配窄了 —— 方向相反。
+4. **正文拿不到时排除判定也可能不完整**:有 `scope=body` 的排除词而正文没采到时,
+   帖子**照发**,但卡片标注「正文缺失,排除词未能完整判定(可能本应被排除)」。
+   取向与 include 侧一致:拿不准时不敢当成已排除,那会漏报。
+
+⚠️ **加了排除词一定先 dry-run**。一条配宽的排除词能把整个板块吃掉,
+而通知上看起来只是「今天没有相关新帖」。
+
+### 回放:改完规则想看效果,别等下一轮 cron(0171)
+
+```bash
+# 把某版规则(缺省 active;可传 draft)放回指定历史窗口重判
+social-hub intelligence monitor-replay-run --monitor <uuid> \
+  --from 2026-09-01T00:00:00Z --to 2026-09-08T00:00:00Z \
+  [--rule-set <draft-uuid>] [-n 500] [--note "第 3 版排除词效果"]
+
+social-hub intelligence monitor-replays-list --monitor <uuid>
+social-hub intelligence monitor-replay-get --monitor <uuid> --replay <uuid> \
+  [--decision matched|indeterminate|excluded|no_match]
+```
+
+🔴 **回放不写命中账本、不推进投递水位、不发任何通知**。它算的是「如果当时用这套规则
+会怎样」这个**假设**,结果落在独立的回放表上 —— 原始命中账本(「当初按哪版规则、
+因为什么命中」这个审计事实)一个字都不会被改。响应里的 `sideEffects` 显式声明了这三条。
+
+**差分怎么读**(`diff`,回放的产品价值就在这里):
+
+| 字段                 | 含义                           | 怎么用                        |
+| -------------------- | ------------------------------ | ----------------------------- |
+| `wouldStopReporting` | 当初报过、新规则下不再报       | 排除词的收益;顺便看有没有误杀 |
+| `wouldNewlyReport`   | 当初**被筛掉**、新规则下会报   | 新加的 include 词的收益       |
+| `neverObserved`      | 当时**根本没被这个监听观察到** | ⛔ **不是**「规则漏了」       |
+
+🔴 `neverObserved` 单列的理由:命中账本对「不命中」**一条都不写**,所以「当初没有账本行」
+既可能是被规则筛掉、也可能是监听那时还没开(或这条帖子是 VOC / 回灌进库的)。
+把两者合并成一句「原来没报」,会让「监听还没开」被读成「规则漏了」。
+
+**与 dry-run 的分工**:dry-run 是**不落库**的即时预览、窗口只能取 720/1440;
+回放**落库**、窗口任意(最长 30 天)、并给出上面那份差分。要拿去做上线决策的用回放。
+
+### 正文补抓(0171)
+
+listing 走渲染兜底时经常拿不到正文,采集端如实标 `unknown`,匹配侧据此判 `missing`。
+0171 起,当该板块**确实有 `scope=body`/`both` 的规则**时,系统会对这些帖子回头补抓一次
+(走既有的 Firecrawl 兜底链,每轮硬顶 12 条、看 deadline、失败不影响报告)。
+
+卡片覆盖行会给出「候选 N 条 · 补到 M 条 · 仍拿不到 K 条」。
+🔴 **只报成功数是不够的**:「12 条候选补了 0 条」与「根本没有候选」在通知上必须能分辨 ——
+前者意味着关键词只出现在正文里的帖子这一轮判不了,是**采集问题**。
 
 ### 近义词扩展(0169)