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

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to `@geoly-ai/social-hub-cli` are documented in this file.
 
 Release workflow: `pnpm release:cli` → `pnpm publish:cli`.
 
+## [0.3.47] - 2026-10-22
+
+### Added
+
+- owned subreddit weekly visitors/contributions column, trend, refresh + skills
+
+## [0.3.46] - 2026-10-20
+
+### Added
+
+- add internal/external account type filter across list, stats, refresh, CLI, SDK
+- public-reddit read methods and intelligence commands (B5)
+- archive-observations 评论来源退役为 410 ARCHIVE_SOURCE_RETIRED,评论列表加范围说明
+
+### Fixed
+
+- 系统级 users/members 列表的 role 改为与登录同口径的有效角色
+
+### Documentation
+
+- public-reddit read commands usage (B6)
+
 ## [0.3.45] - 2026-09-22
 
 ### Added

package/dist/cmd-manifest.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-22T08:00:46.932Z",
-  "cliVersion": "0.3.45",
+  "generatedAt": "2026-10-22T03:31:57.523Z",
+  "cliVersion": "0.3.47",
   "commands": [
     "accounts",
     "accounts brand-bindings",
@@ -282,6 +282,10 @@
     "intelligence monitors-update",
     "intelligence opportunity-map",
     "intelligence posts-import",
+    "intelligence public-communities",
+    "intelligence public-post-count",
+    "intelligence public-posts",
+    "intelligence public-status",
     "intelligence runs-list",
     "intelligence sentiment-intent",
     "intelligence snapshot-latest",
@@ -507,9 +511,11 @@
     "subreddit-asset protection",
     "subreddit-asset protection get",
     "subreddit-asset protection set",
+    "subreddit-asset refresh-weekly-stats",
     "subreddit-asset register",
     "subreddit-asset register-subreddit",
     "subreddit-asset set-status",
+    "subreddit-asset weekly-stats",
     "users",
     "users create",
     "users list",

package/dist/index.d.ts

@@ -1,8 +1,47 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+import { type SocialHubClient } from "@geoly-ai/social-hub-sdk";
 declare const program: Command;
 /** 返回放错位置字段的指引(无则 null)。用于 accounts update / sync core 防呆。 */
 export declare function detectMisplacedAccountFields(body: Record<string, unknown>): string | null;
+/**
+ * `--subreddit a,b` -> ["a","b"]:逗号分隔、trim、去空项、去重(保序)。
+ * 空结果由调用方拒绝(不能把「没给板块」悄悄变成不带板块的请求)。
+ */
+export declare function parsePublicRedditSubreddits(raw: string): string[];
+/**
+ * 把「公开库错误」格式化成 stderr 文本;不是公开库错误返回 null(调用方原样重抛,
+ * 交给默认错误边界)。🔴 鸭子类型:跨包副本的 `instanceof SocialHubHttpError` 会假阴性
+ * (与 output.ts `restrictionBlockFromError` 同理),CLI 测试整包 mock SDK 时更是如此。
+ */
+export declare function formatPublicRedditError(e: unknown): string | null;
+export type PublicRedditCliClient = Pick<SocialHubClient, "listPublicRedditCommunities" | "searchPublicRedditPosts" | "countPublicRedditPosts" | "getPublicRedditStatus">;
+type PublicRedditWindowOpts = {
+    window?: string;
+    from?: string;
+    to?: string;
+};
+export declare function runPublicCommunities(client: PublicRedditCliClient, opts: {
+    industryKeys?: string;
+    tierKeys?: string;
+    poolKinds?: string;
+    hasProfile?: string;
+    limit?: string;
+    cursor?: string;
+}): Promise<void>;
+export declare function runPublicPosts(client: PublicRedditCliClient, opts: PublicRedditWindowOpts & {
+    subreddit: string;
+    query?: string;
+    limit?: string;
+    cursor?: string;
+    includeBody?: boolean;
+}): Promise<void>;
+export declare function runPublicPostCount(client: PublicRedditCliClient, opts: PublicRedditWindowOpts & {
+    subreddit: string;
+    query: string;
+    type?: string;
+}): Promise<void>;
+export declare function runPublicStatus(client: PublicRedditCliClient): Promise<void>;
 export type VocAcquireClient = {
     vocQuery(body: unknown): Promise<Record<string, unknown>>;
     getIntelRunProgress(runId: string): Promise<{

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAwnF9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AAg+BD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAQF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE;IACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAkJnE;AAwyCD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAyCpD;AAqzDD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAGL,KAAK,eAAe,EAqBrB,MAAM,0BAA0B,CAAC;AA6ClC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA6nF9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AA0sBD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjE;AAsDD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA6BjE;AAyCD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,eAAe,EACb,6BAA6B,GAC7B,yBAAyB,GACzB,wBAAwB,GACxB,uBAAuB,CAC1B,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAeF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,sBAAsB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,sBAAsB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAIf;AA8RD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAQF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE;IACN,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAkJnE;AAy2CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAyCpD;AA0zDD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -20,7 +20,7 @@ import { registerDoctorAndVersion } from "./register-shared.js";
 import { registerSkillsCommands } from "./register-skills.js";
 import { readJsonArgOrExit, resolveJsonArg } from "./lib/json-arg.js";
 import { applyContentReviewFlags, AUTHOR_RELATION_MISMATCH_HINT, ContentReviewArgError, } from "./lib/content-review-args.js";
-import { runCliProgram, withCliErrorBoundary } from "./output.js";
+import { runCliProgram, withCliErrorBoundary, writeStderrSync, } from "./output.js";
 import { maybeNotifyUpdate } from "./update-check.js";
 import { maybeNotifySkillUpdate } from "./skill-update-check.js";
 import { getCliVersion } from "./version-info.js";
@@ -370,6 +370,7 @@ reddit
     .option("--draft-status <st>", "draftStatus filter (pending|drafted|reviewed|published|unknown)")
     .option("--post-type <t>", "postType filter")
     .option("--repost-type <t>", "repostType filter (none|first|second)")
+    .option("--account-type <t>", "账号类型筛选:internal|external(可逗号分隔);proxy/海外兼职/未知/空值在选了任一项时不命中")
     .option("--contains-brand-keyword <v>", "true | false | unset")
     .option("--primary-product <text>", "primary product contains match")
     .option("--seq-no-min <n>", "序列号下界(含);与 --seq-no-max 组成闭区间,无编号(null)的帖会落选")
@@ -391,6 +392,7 @@ reddit
         draftStatus: opts.draftStatus,
         postType: opts.postType,
         repostType: opts.repostType,
+        accountType: opts.accountType,
         containsBrandKeyword: opts.containsBrandKeyword,
         primaryProduct: opts.primaryProduct,
         seqNoMin: opts.seqNoMin !== undefined ? Number(opts.seqNoMin) : undefined,
@@ -2460,6 +2462,191 @@ pools
     const res = await requireClient().deleteSubredditPoolTierRule(resolveTeamId(opts.team), opts.id);
     console.log(JSON.stringify(res, null, 2));
 });
+// ── 公开 Reddit 只读读路径(intelligence public-*;B5)────────────────────────────────
+/** 与 contracts `PUBLIC_REDDIT_SEARCH_MAX_COMMUNITIES` / `…COUNT_MAX_COMMUNITIES` 同值。 */
+const PUBLIC_REDDIT_SEARCH_MAX = 20;
+const PUBLIC_REDDIT_COUNT_MAX = 50;
+/**
+ * `--subreddit a,b` -> ["a","b"]:逗号分隔、trim、去空项、去重(保序)。
+ * 空结果由调用方拒绝(不能把「没给板块」悄悄变成不带板块的请求)。
+ */
+export function parsePublicRedditSubreddits(raw) {
+    const out = [];
+    for (const part of raw.split(",")) {
+        const v = part.trim();
+        if (v && !out.includes(v))
+            out.push(v);
+    }
+    return out;
+}
+/** 本地校验失败:写 stderr、退出码 1(服务端同样会 400,这里省一次上游预算与往返)。 */
+class PublicRedditUsageError extends Error {
+}
+function requirePublicRedditSubreddits(raw, max) {
+    const list = parsePublicRedditSubreddits(raw);
+    if (list.length === 0) {
+        throw new PublicRedditUsageError("--subreddit 至少需要一个板块(逗号分隔)");
+    }
+    if (list.length > max) {
+        throw new PublicRedditUsageError(`--subreddit 最多 ${max} 个板块(收到 ${list.length} 个),请拆分后分别查询`);
+    }
+    return list;
+}
+const PUBLIC_REDDIT_NOT_NO_DATA = "这不是「没有数据」:本次读取没有成功完成,结果未知,不能当作空结果。";
+/** 已知错误码的明确文案;未知的 PUBLIC_REDDIT_* 走兜底(同样不是空结果)。 */
+const PUBLIC_REDDIT_ERROR_TEXT = {
+    PUBLIC_REDDIT_DISABLED: "公开库检索当前对本次请求未启用(服务端开关为 off,或 shadow 模式下当前身份无权读取)。",
+    PUBLIC_REDDIT_POLICY_DENIED: "上游数据服务拒绝了本次读取(策略拒绝,通常是准入/范围问题,需要管理员处理)。",
+    PUBLIC_REDDIT_AUTH_FAILED: "上游数据服务的凭据校验失败(key 过期或已轮换),需要管理员处理。",
+    PUBLIC_REDDIT_BUDGET_EXHAUSTED: "Hub 对上游的调用预算已用完,请稍后再试。",
+    PUBLIC_REDDIT_RATE_LIMITED: "上游数据服务限流,请稍后再试,不要轮询。",
+    PUBLIC_REDDIT_DEGRADED: "上游数据服务暂时降级,请稍后再试。",
+    PUBLIC_REDDIT_UNAVAILABLE: "上游数据服务暂时不可用,请稍后再试。",
+    PUBLIC_REDDIT_COUNT_TIMEOUT: "计数超时:请缩小板块范围或按月切分窗口后重试(不要原样重试)。",
+    PUBLIC_REDDIT_BAD_UPSTREAM_RESPONSE: "上游返回了无法解析的响应(契约漂移),需要管理员处理。",
+    PUBLIC_REDDIT_COMMUNITY_NOT_AVAILABLE: "指定板块不在公开库可读范围内(板块未被上游准入),不代表该板块没有帖子。",
+    PUBLIC_REDDIT_SCOPE_TOO_LARGE: "查询范围过大(板块 × 窗口超出上游成本上限):请减少板块或按月切分窗口后分别查询。",
+    PUBLIC_REDDIT_INVALID_WINDOW: "窗口无效:检查 --window / --from / --to(互斥、from<to、跨度 ≤366 天)。",
+    PUBLIC_REDDIT_QUERY_REQUIRED: "该读取必须带 --query。",
+    PUBLIC_REDDIT_INVALID_COMMUNITY: "板块名无效(小写 3–21 位,不带 r/ 或 u_ 前缀)。",
+    PUBLIC_REDDIT_INVALID_REQUEST: "请求参数被服务端拒绝,详见下方 error.message。",
+    PUBLIC_REDDIT_CURSOR_RESET: "分页游标已失效,请去掉 --cursor 从第一页重新查询。",
+    PUBLIC_REDDIT_CURSOR_MISMATCH: "--cursor 与当前查询条件不匹配,请使用同一组条件翻页。",
+};
+/**
+ * 把「公开库错误」格式化成 stderr 文本;不是公开库错误返回 null(调用方原样重抛,
+ * 交给默认错误边界)。🔴 鸭子类型:跨包副本的 `instanceof SocialHubHttpError` 会假阴性
+ * (与 output.ts `restrictionBlockFromError` 同理),CLI 测试整包 mock SDK 时更是如此。
+ */
+export function formatPublicRedditError(e) {
+    if (!(e instanceof Error))
+        return null;
+    const { code, status, details, retryAfterSeconds } = e;
+    if (typeof code !== "string" || !code.startsWith("PUBLIC_REDDIT_")) {
+        return null;
+    }
+    const text = PUBLIC_REDDIT_ERROR_TEXT[code] ?? "公开库读取失败(服务端返回了错误码)。";
+    const lines = [`[${code}] ${text}`, PUBLIC_REDDIT_NOT_NO_DATA];
+    if (typeof retryAfterSeconds === "number") {
+        lines.push(`Retry-After: ${retryAfterSeconds}s`);
+    }
+    lines.push(JSON.stringify({
+        error: {
+            status: typeof status === "number" ? status : undefined,
+            code,
+            message: e.message,
+            details,
+            retryable: false,
+        },
+    }));
+    return lines.join("\n");
+}
+/**
+ * 公开库命令的统一外壳:本地用法错误与公开库错误 -> stderr + 退出码 1;
+ * 其余错误原样重抛(走默认边界)。绝不把错误转成空结果/退出码 0。
+ */
+async function runPublicRedditCommand(run) {
+    try {
+        await run();
+    }
+    catch (e) {
+        if (e instanceof PublicRedditUsageError) {
+            writeStderrSync(e.message);
+            process.exit(1);
+        }
+        const text = formatPublicRedditError(e);
+        if (text === null)
+            throw e;
+        writeStderrSync(text);
+        process.exit(1);
+    }
+}
+/** 成功输出:stdout 永远是完整 JSON;0 条时 stderr 另给事实性提示(退出码仍为 0)。 */
+function printPublicRedditResult(res) {
+    console.log(JSON.stringify(res, null, 2));
+    if (Array.isArray(res.items) && res.items.length === 0) {
+        const excluded = res.source?.excludedCommunities ?? [];
+        writeStderrSync(excluded.length > 0
+            ? `无结果(0 条)。注意:${excluded.length} 个板块被排除未查询(${excluded
+                .map((x) => x.communityId)
+                .join(",")}),空结果不代表这些板块没有数据,详见 source.excludedCommunities。`
+            : "无结果(0 条)。");
+    }
+}
+function windowParams(opts) {
+    // 枚举与互斥由服务端 zod 400(与本组 --sort 的透传惯例一致),这里只转发。
+    return {
+        window: opts.window,
+        from: opts.from,
+        to: opts.to,
+    };
+}
+export async function runPublicCommunities(client, opts) {
+    await runPublicRedditCommand(async () => {
+        let hasProfile;
+        if (opts.hasProfile !== undefined) {
+            // Boolean 强转类参数本地拦(见 monitors-list --enabled 先例),避免 "yes" 被悄悄当成 false。
+            if (opts.hasProfile !== "true" && opts.hasProfile !== "false") {
+                throw new PublicRedditUsageError("--has-profile 只接受 true|false");
+            }
+            hasProfile = opts.hasProfile === "true";
+        }
+        const res = await client.listPublicRedditCommunities({
+            industryKey: opts.industryKeys,
+            tierKey: opts.tierKeys,
+            poolKind: opts.poolKinds,
+            hasProfile,
+            limit: opts.limit === undefined ? undefined : Number(opts.limit),
+            cursor: opts.cursor,
+        });
+        printPublicRedditResult(res);
+    });
+}
+export async function runPublicPosts(client, opts) {
+    await runPublicRedditCommand(async () => {
+        const subreddit = requirePublicRedditSubreddits(opts.subreddit, PUBLIC_REDDIT_SEARCH_MAX);
+        const res = await client.searchPublicRedditPosts({
+            subreddit,
+            query: opts.query,
+            ...windowParams(opts),
+            limit: opts.limit === undefined ? undefined : Number(opts.limit),
+            cursor: opts.cursor,
+            includeBody: opts.includeBody ? true : undefined,
+        });
+        printPublicRedditResult(res);
+    });
+}
+export async function runPublicPostCount(client, opts) {
+    await runPublicRedditCommand(async () => {
+        // 本地先拦:count 是昂贵读,服务端同样会 400,但不该为此白花一次往返与上游预算。
+        const subreddits = requirePublicRedditSubreddits(opts.subreddit, PUBLIC_REDDIT_COUNT_MAX);
+        const query = opts.query?.trim();
+        if (!query) {
+            throw new PublicRedditUsageError("--query 必填且不能为空(对方生产不接受无 query 的计数)");
+        }
+        if (!opts.window && !opts.from && !opts.to) {
+            throw new PublicRedditUsageError("计数必须给窗口:--window <day|week|month|last_90d|last_360d|last_full_week> 或 --from + --to");
+        }
+        if (opts.type !== undefined &&
+            opts.type !== "post" &&
+            opts.type !== "comment") {
+            throw new PublicRedditUsageError("--type 只接受 post|comment");
+        }
+        const res = await client.countPublicRedditPosts({
+            subreddits,
+            query,
+            artifactType: opts.type,
+            ...windowParams(opts),
+        });
+        // 计数响应没有 items:不走空页提示。exact=false 时 total 为 null,原样输出。
+        console.log(JSON.stringify(res, null, 2));
+    });
+}
+export async function runPublicStatus(client) {
+    await runPublicRedditCommand(async () => {
+        console.log(JSON.stringify(await client.getPublicRedditStatus(), null, 2));
+    });
+}
 const intel = program
     .command("intelligence")
     .description("板块情报与 KOL 挖掘");
@@ -2508,7 +2695,7 @@ intel
 });
 intel
     .command("comments")
-    .description("GET /v1/system/subreddit-intelligence/comments(评论样本查询:postId/subreddit/keyword/intent/sentiment)")
+    .description("GET /v1/system/subreddit-intelligence/comments(评论样本查询:postId/subreddit/keyword/intent/sentiment;只含 Hub 内现有评论样本(非归档,约 5.7 万条),历史/归档评论已迁至 CyberRedd)")
     .option("--post-id <id>", "t3_xxx")
     .option("--subreddit <name>", "板块名")
     .option("--keyword <kw>", "正文关键词")
@@ -2532,7 +2719,7 @@ intel
 });
 intel
     .command("comments-count")
-    .description("GET /v1/system/subreddit-intelligence/comments/count(评论样本精确总数:不封顶、无分页;不接受 keyword;昂贵读,禁止轮询)")
+    .description("GET /v1/system/subreddit-intelligence/comments/count(评论样本精确总数:不封顶、无分页;不接受 keyword;昂贵读,禁止轮询;只含 Hub 内现有评论样本(非归档,约 5.7 万条),历史/归档评论已迁至 CyberRedd)")
     .option("--post-id <id>", "t3_xxx")
     .option("--subreddit <name>", "板块名")
     .option("--intent <intent>", "意图标签")
@@ -3556,6 +3743,50 @@ intel
     });
     console.log(JSON.stringify(res, null, 2));
 });
+intel
+    .command("public-communities")
+    .description("GET /v1/system/public-reddit/communities(公开库社区目录,只读;DISABLED/POLICY_DENIED 等错误码 = 读取失败,不是没有数据)")
+    .option("--industry-keys <csv>", "行业 key,逗号分隔")
+    .option("--tier-keys <csv>", "tier key,逗号分隔")
+    .option("--pool-kinds <csv>", "primary|secondary|experimental|excluded,逗号分隔")
+    .option("--has-profile <bool>", "true|false")
+    .option("-n, --limit <n>", "每页条数(缺省用服务端默认)")
+    .option("--cursor <token>", "原样回传上一页的 nextCursor")
+    .action(async (opts) => {
+    await runPublicCommunities(requireClient(), opts);
+});
+intel
+    .command("public-posts")
+    .description("GET /v1/system/public-reddit/posts(公开库帖子检索,只读;必须带 --subreddit,单次 ≤20 个;--query 会发往外部数据服务;DISABLED/POLICY_DENIED 等错误码 = 读取失败,不是没有数据)")
+    .requiredOption("--subreddit <a,b>", "板块,逗号分隔(小写,不带 r/)")
+    .option("--query <text>", "全文关键词(⚠️ 会发往外部数据服务)")
+    .option("--window <name>", "day|week|month|last_90d|last_360d|last_full_week(与 --from/--to 互斥)")
+    .option("--from <iso>", "窗口起(含),ISO 8601 带时区")
+    .option("--to <iso>", "窗口止(不含),ISO 8601 带时区")
+    .option("-n, --limit <n>", "每页条数(缺省用服务端默认)")
+    .option("--cursor <token>", "原样回传上一页的 nextCursor")
+    .option("--include-body", "返回正文(缺省只回摘录)")
+    .action(async (opts) => {
+    await runPublicPosts(requireClient(), opts);
+});
+intel
+    .command("public-post-count")
+    .description("POST /v1/system/public-reddit/post-counts(公开库计数;昂贵读,禁止轮询;必须带 query;query 会发往外部数据服务;必须给窗口;DISABLED/POLICY_DENIED 等错误码 = 读取失败,不是没有数据)")
+    .requiredOption("--subreddit <a,b>", "板块,逗号分隔,单次 ≤50 个")
+    .requiredOption("--query <text>", "必填(⚠️ 会发往外部数据服务)")
+    .option("--window <name>", "day|week|month|last_90d|last_360d|last_full_week(与 --from/--to 互斥;二选一必给)")
+    .option("--from <iso>", "窗口起(含),ISO 8601 带时区")
+    .option("--to <iso>", "窗口止(不含),ISO 8601 带时区")
+    .option("--type <t>", "post|comment(缺省 post;comment 覆盖不完整)")
+    .action(async (opts) => {
+    await runPublicPostCount(requireClient(), opts);
+});
+intel
+    .command("public-status")
+    .description("GET /v1/system/public-reddit/status(开关/熔断/预算;仅 unrestricted admin)")
+    .action(async () => {
+    await runPublicStatus(requireClient());
+});
 intel
     .command("hot-posts-create")
     .description("POST .../subreddit-intelligence/hot-posts")
@@ -4556,6 +4787,7 @@ reddit
     .option("--draft-status <st>", "draftStatus filter (pending|drafted|reviewed|published|unknown)")
     .option("--post-type <t>", "postType filter")
     .option("--repost-type <t>", "repostType filter (none|first|second)")
+    .option("--account-type <t>", "账号类型筛选:internal|external(可逗号分隔);proxy/海外兼职/未知/空值在选了任一项时不命中")
     .option("--contains-brand-keyword <v>", "true | false | unset")
     .option("--primary-product <text>", "primary product contains match")
     .option("--seq-no-min <n>", "序列号下界(含);与 --seq-no-max 组成闭区间,无编号(null)的帖会落选")
@@ -4576,6 +4808,7 @@ reddit
         draftStatus: opts.draftStatus,
         postType: opts.postType,
         repostType: opts.repostType,
+        accountType: opts.accountType,
         containsBrandKeyword: opts.containsBrandKeyword,
         primaryProduct: opts.primaryProduct,
         seqNoMin: opts.seqNoMin !== undefined ? Number(opts.seqNoMin) : undefined,