@geoly-ai/social-hub-cli 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@geoly-ai/social-hub-cli` are documented in this file.
 
 Release workflow: `pnpm release:cli` → `pnpm publish:cli`.
 
+## [0.3.1] - 2026-07-31
+
+### Added
+
+- 首次 install 接管 unknown-source skill 目录(同步我方文件+保留用户文件)
+
+### Fixed
+
+- -j/--json 在 Windows 报错 —— 加 --json-file/@file/stdin 输入绕开 shell 引号
+- VOC 历史数据查询直接走 Arctic,不再默认 hub-first 先撞 Hub
+
 ## [0.3.0] - 2026-07-31
 
 ### Added

package/dist/cmd-manifest.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-07-31T03:56:37.911Z",
-  "cliVersion": "0.3.0",
+  "generatedAt": "2026-07-31T04:40:00.481Z",
+  "cliVersion": "0.3.1",
   "commands": [
     "accounts",
     "accounts brand-bindings",

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;AAmCpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA27D9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AA2/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;AA+1ED,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;AAoCpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AA+8D9B,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAOf;AA2/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;AA+1ED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -12,6 +12,7 @@ import { registerBatchAndExport } from "./register-batch.js";
 import { registerAgentContext, registerOpsRuntime } from "./register-ops.js";
 import { registerDoctorAndVersion } from "./register-shared.js";
 import { registerSkillsCommands } from "./register-skills.js";
+import { readJsonArgOrExit } from "./lib/json-arg.js";
 import { maybeNotifyUpdate } from "./update-check.js";
 import { maybeNotifySkillUpdate } from "./skill-update-check.js";
 import { getCliVersion } from "./version-info.js";
@@ -117,16 +118,13 @@ events
     .command("batch")
     .description("POST /events/batch")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", '{ "events": [ ... ] }')
+    .option("-j, --json <json>", '{ "events": [ ... ] }。也可 -j @<path> 读文件 / -j - 读 stdin')
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().appendEventsBatch(resolveTeamId(opts.team), body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -217,16 +215,13 @@ styleMarks
     .description("PUT /events/external/:eventExternalRef/style-mark (idempotent upsert)")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
     .requiredOption("--event-ref <ref>", "event externalRef")
-    .requiredOption("-j, --json <json>", "body JSON")
+    .option("-j, --json <json>", "body JSON。也可 -j @<path> 读文件 / -j - 读 stdin")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().upsertEventStyleMarkByExternalRef(resolveTeamId(opts.team), opts.eventRef, body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -234,16 +229,13 @@ styleMarks
     .command("create")
     .description("POST /style-marks（直接创建；事件可不存在，eventExternalRef 必填）")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", "{ eventExternalRef, markExternalRef?, socialAccountId?, approved?, reasonTags?, styleTags?, note? }")
+    .option("-j, --json <json>", "{ eventExternalRef, markExternalRef?, socialAccountId?, approved?, reasonTags?, styleTags?, note? }。也可 -j @<path> 读文件 / -j - 读 stdin")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().createStyleMark(resolveTeamId(opts.team), body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -369,16 +361,13 @@ reddit
     .command("create-snapshot")
     .description("POST /reddit-post-snapshots（手工补录）")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", '{"permalink":"...","subreddit":"...","score":0,"commentsCount":0,"brandNote":null,"negativeFeedback":null,"repostType":"none","firstRepostLink":null,"secondRepostLink":null}')
+    .option("-j, --json <json>", '{"permalink":"...","subreddit":"...","score":0,"commentsCount":0,"brandNote":null,"negativeFeedback":null,"repostType":"none","firstRepostLink":null,"secondRepostLink":null}。也可 -j @<path> 读文件 / -j - 读 stdin')
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().createRedditPostSnapshot(resolveTeamId(opts.team), body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -410,16 +399,13 @@ jobs
     .command("create")
     .description("POST /scheduled-jobs（--json 为完整 body）")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", "createScheduledJobBody JSON")
+    .option("-j, --json <json>", "createScheduledJobBody JSON。也可 -j @<path> 读文件 / -j - 读 stdin")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().createScheduledJob(resolveTeamId(opts.team), body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -427,16 +413,13 @@ jobs
     .command("batch")
     .description("POST /scheduled-jobs/batch")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", '{ "jobs": [ ... ] }')
+    .option("-j, --json <json>", '{ "jobs": [ ... ] }。也可 -j @<path> 读文件 / -j - 读 stdin')
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     const res = await requireClient().createScheduledJobsBatch(resolveTeamId(opts.team), body);
     console.log(JSON.stringify(res, null, 2));
 });
@@ -466,17 +449,14 @@ content
     .command("review")
     .description("POST /content-review — 评论发布前独立 LLM 复审+优化(层③);degraded 时降级本地自审")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", "{ accountId?, draft, commentType, thread:{subreddit,postTitle,...}, brandContext?:{brandKey|campaignId}, rewrite?, stage?, attempt? } (omit accountId for persona-less ContentOnly review)")
+    .option("-j, --json <json>", "{ accountId?, draft, commentType, thread:{subreddit,postTitle,...}, brandContext?:{brandKey|campaignId}, rewrite?, stage?, attempt? } (omit accountId for persona-less ContentOnly review)。也可 -j @<path> 读文件 / -j - 读 stdin")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .option("--brand-context <json>", '品牌上下文 { "brandKey":"..." } 或 { "campaignId":"..." }(§0.3;便捷参数,覆盖 -j 里的 brandContext)')
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     if (opts.brandContext) {
         try {
             body.brandContext = JSON.parse(opts.brandContext);
@@ -493,17 +473,14 @@ content
     .command("post-review")
     .description("POST /post-review — 帖子(title+body)发布前独立 LLM 审核(七维,独立模型 key);仅审帖子正文,评论审核用 content review")
     .option("-t, --team <teamId>", "Team UUID(缺省用当前 context)")
-    .requiredOption("-j, --json <json>", "{ accountId?, title, body, subreddit, subredditRules?, brandContext?:{brandKey|campaignId}, rewrite?, stage?, attempt? } (omit accountId for persona-less ContentOnly review)")
+    .option("-j, --json <json>", "{ accountId?, title, body, subreddit, subredditRules?, brandContext?:{brandKey|campaignId}, rewrite?, stage?, attempt? } (omit accountId for persona-less ContentOnly review)。也可 -j @<path> 读文件 / -j - 读 stdin")
+    .option("--json-file <path>", "从文件读 body JSON(路径,或 - 表示 stdin);与 -j 二选一。Windows 建议用此绕开 shell 引号问题")
     .option("--brand-context <json>", '品牌上下文 { "brandKey":"..." } 或 { "campaignId":"..." }(便捷参数,覆盖 -j 里的 brandContext)')
     .action(async (opts) => {
-    let body;
-    try {
-        body = JSON.parse(opts.json);
-    }
-    catch {
-        console.error("Invalid -j / --json");
-        process.exit(1);
-    }
+    const body = readJsonArgOrExit({
+        inline: opts.json,
+        file: opts.jsonFile,
+    });
     if (opts.brandContext) {
         try {
             body.brandContext = JSON.parse(opts.brandContext);