@geoly-ai/social-hub-cli 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,9 @@ All notable changes to `@geoly-ai/social-hub-cli` are documented in this file.
4
4
 
5
5
  Release workflow: `pnpm release:cli` → `pnpm publish:cli`.
6
6
 
7
+ ## [0.1.8] - 2026-06-05
8
+
9
+ Bundle updated Social Hub subreddit pool skills and persona pool alias guidance.
7
10
  ## [0.1.7] - 2026-06-04
8
11
 
9
12
  ### Added
@@ -1,6 +1,6 @@
1
1
  {
2
- "generatedAt": "2026-06-04T08:41:41.416Z",
3
- "cliVersion": "0.1.7",
2
+ "generatedAt": "2026-06-05T01:51:36.942Z",
3
+ "cliVersion": "0.1.8",
4
4
  "commands": [
5
5
  "accounts",
6
6
  "accounts brand-bindings",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@geoly-ai/social-hub-cli",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "type": "module",
5
5
  "description": "social-hub CLI for Social Ops Hub",
6
6
  "repository": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 1,
3
3
  "package": "social-ops-hub",
4
- "cliVersion": "0.1.7",
4
+ "cliVersion": "0.1.8",
5
5
  "repository": "social-ops-hub",
6
6
  "publish": {
7
7
  "registry": "https://skill.sh",
@@ -81,7 +81,7 @@ social-hub query subreddit-candidates -t <team-id> --account A1 --action browse
81
81
  | `personaPools.expandedByKind` | 按来源汇总:`direct` / `common` / `industry` / `pet` / `brand` 的 `r/...` 列表 |
82
82
  | `personaPools.expandedPools[].subreddits` | 每个 pool ref 展开后的具体板块(可多条) |
83
83
  | `personaPools.brandPools` | 账号品牌绑定及对应 `brand_pools.*` ref 展开结果 |
84
- | `personaPools.unresolvedRefs` | alias 表无法解析的 ref(含部分 `persona_pools.Pxx.*`) |
84
+ | `personaPools.unresolvedRefs` | alias 表无法解析的 ref;正常 seed 后 P01-P57 的 `starter/advanced/pet_pool` 不应出现 |
85
85
  | `fallback.reason` | 如 `candidate_pool_exhausted` 须在 Agent 回执说明 |
86
86
 
87
87
  **Agent 门禁**:
@@ -92,6 +92,12 @@ social-hub query subreddit-candidates -t <team-id> --account A1 --action browse
92
92
  4. 养号阶段 `poolKind=pet` 且可用宠物 sub **≥3** 时须轮换;**不得**用 `brand` 池替代宠物主池。
93
93
  5. 运营期品牌池(`poolKind=brand` / `source=brand.binding`)仅低占比补充(建议 10%–20%)。
94
94
 
95
+ **Persona pool 排障**:
96
+
97
+ - `persona_pools.Pxx.starter/advanced` 应通过 `subreddit_pool_aliases` 解析到 `persona_pools__Pxx_starter/advanced`。
98
+ - 若 `unresolvedRefs` 出现 P01-P57 的 starter/advanced,先检查 Pool Aliases 是否存在,再检查对应 `subreddit_industry_pools` catalog rows 是否存在。
99
+ - 若 Hub 不可用,OpenClaw 本地 fallback 只读 `openclaw-template/shared/subreddit-pools.json` 的 `persona_pools`;不要临时解析团队 workspace copy。
100
+
95
101
  配合 `social-hub-events-observability` 的 `events list-full` 可核对近期 sub;`social-hub-graph-compliance` 的 blocklist 已由候选接口过滤。
96
102
 
97
103
  ## 导出(审计 / 离线查看)
@@ -20,7 +20,7 @@ social-hub pools catalog-update -t <team-id> --id <pool-id> -j '{...}'
20
20
  social-hub pools catalog-delete -t <team-id> --id <pool-id>
21
21
 
22
22
  social-hub pools aliases-list -t <team-id> [--alias-ref persona_pools.P23.starter]
23
- social-hub pools aliases-create -t <team-id> -j '{"aliasRef":"persona_pools.P23.starter","industryKey":"common_pools__starter_casual"}'
23
+ social-hub pools aliases-create -t <team-id> -j '{"aliasRef":"persona_pools.P23.starter","industryKey":"persona_pools__P23_starter","poolKind":"industry","tier":"starter"}'
24
24
  social-hub pools aliases-update -t <team-id> --id <alias-id> -j '{...}'
25
25
  social-hub pools aliases-delete -t <team-id> --id <alias-id>
26
26
 
@@ -39,3 +39,21 @@ social-hub pools tier-rules-delete -t <team-id> --id <rule-id>
39
39
  权限资源:`subredditPool`(与 `subredditIntelligence` 分析只读分离)。
40
40
 
41
41
  兼容:旧 `subreddit-intelligence/industry-pools` 仍可读;新写操作优先走 `subreddit-pools/*`。
42
+
43
+ ## Persona Pool Aliases 约定
44
+
45
+ - Hub persona key 以本地 `persona_pools.Pxx.*` 为准,不用飞书编号做主键。
46
+ - `persona_pools.Pxx.starter` / `persona_pools.Pxx.advanced` 的标准 `industryKey`:
47
+ - `persona_pools__Pxx_starter`
48
+ - `persona_pools__Pxx_advanced`
49
+ - alias 不能单独建:必须先有对应 `subreddit_industry_pools` catalog rows,否则页面能看到 alias,但运行时展开不到具体 subreddit。
50
+ - P32-P57 的本地 fallback 来源是 `openclaw-template/shared/subreddit-pools.json`;团队 workspace copy 不作为同步目标。
51
+ - `redditRefs` 是 persona 直接候选社区,不等同于 starter/advanced pool;不要直接用 `redditRefs` 覆盖 alias。
52
+ - `pet_pool` 继续映射到 `common_pools__starter_pet`,不随 starter/advanced backfill 改动。
53
+
54
+ ## 常见排障
55
+
56
+ - Pool Aliases 页面为空:先确认是否跑过 `db:seed` 或 persona pool bootstrap;再用 `aliases-list` 查当前 team,而不是只看 catalog。
57
+ - `personaPools.unresolvedRefs` 仍有 `persona_pools.Pxx.starter/advanced`:说明 alias 缺失,或 alias 指向的 `industryKey` catalog rows 未创建。
58
+ - catalog 有数据但候选为空:检查 subreddit 是否被 `bot_bouncer_blocklist`、`previously_banned`、team blocklist 或 tier policy 过滤。
59
+ - 本地 fallback 与 Hub 漂移:对比 `openclaw-template/shared/subreddit-pools.json` 里的 `persona_pools.Pxx.starter/advanced` 和 Hub catalog 的 `persona_pools__Pxx_*` rows。