@bty/customer-service-cli 0.6.8 → 0.6.10

package/CHANGELOG.md

@@ -1,7 +1,15 @@
 # Changelog
 
-## Unreleased
+## 0.6.10 (2026-08-26)
 
+- `context-search`：`query_content` 增加最少 2 个字符的本地校验，避免过短关键词触发服务端全量扫描。
+- `channel-metric backfill`：对齐服务端权限收紧——`--workspace-id` 逐个鉴权，缺省不再采集所有 workspace，改为只采集当前登录 workspace；同时修复不传 `--workspace-id` 时 commander 解析崩溃的问题。
+
+## 0.6.9 (2026-08-24)
+
+- 新增 `channel-metric` 命令组，查询千牛等渠道店铺客服的每日排行指标（`channel_metric_snapshot`）：
+  - `channel-metric query --workspace-id <ws> --start <date> --end <date> [--agent <id>] [--platform <channel>]`：按 workspace + 日期区间（+ 可选 agent / 渠道）查询指标，按日期×渠道分组输出。
+  - `channel-metric backfill --channel <channel> --start <date> --end <date> [--workspace-id <ws>...]`：手动补数据，采集指定日期区间的渠道指标；`--workspace-id` 可重复传，缺省采集所有已开启配置的 workspace。
 - 新增 `media upload` 命令与 `product supplement` 子命令组，支持商品「补充知识」图片/视频维护，与前端上传行为一致：
   - `media upload --file <path> --type image|video [--path-prefix /ai/knowledge/supplement] [--dry-run]`：本地图片/视频先经 `/v1/upload_sts` 取 STS 凭证上传到公开 OSS（`resource_bucket`），返回公网 URL；已是 http(s) URL 直接拒绝（无需上传）。上传 key 与前端一致：`${prefix}/${timestamp}_${filename}`。图片上限 10MB、视频上限 200MB，超限/类型不符在发起上传请求前直接失败。
   - `product supplement list --agent <id> --product-id <id>`：读取并解析商品「补充知识」条目（容错解析数组 / JSON 字符串 / 多层编码）。

package/dist/bin.js

@@ -1095,6 +1095,121 @@ function registerChangeConsumerCommand(program2) {
   });
 }
 
+// src/commands/channel-metric.ts
+import Table2 from "cli-table3";
+
+// src/client/channel-metric-api.ts
+var CHANNEL_METRIC_PREFIX = "/v1/channel-metric";
+async function backfillChannelMetrics(opts) {
+  const request = createRequest();
+  const body = {
+    channel: opts.channel,
+    start_date: opts.startDate,
+    end_date: opts.endDate
+  };
+  if (opts.workspaceIds && opts.workspaceIds.length > 0) {
+    body.workspace_ids = opts.workspaceIds;
+  }
+  return request(getObservabilityUrl(), `${CHANNEL_METRIC_PREFIX}/backfill`, {
+    method: "POST",
+    body
+  });
+}
+async function queryChannelMetrics(opts) {
+  const request = createRequest();
+  const query = {
+    workspace_id: opts.workspaceId,
+    start_date: opts.startDate,
+    end_date: opts.endDate
+  };
+  if (opts.configId) query.config_id = opts.configId;
+  if (opts.channel) query.channel = opts.channel;
+  return request(getObservabilityUrl(), `${CHANNEL_METRIC_PREFIX}/metrics`, {
+    method: "GET",
+    query
+  });
+}
+
+// src/commands/channel-metric.ts
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+function renderGroupedTable(groups) {
+  let total = 0;
+  for (const group of groups) {
+    process.stdout.write(`
+=== ${group.stat_date} \xB7 ${group.channel}\uFF08${group.items.length} \u4E2A\u8D26\u53F7\uFF09===
+`);
+    const first = group.items[0];
+    const headers = (first?.metrics_json ?? []).map((field) => field.label);
+    const table = new Table2({ head: ["account_id", ...headers] });
+    for (const row of group.items) {
+      table.push([
+        String(row.account_id),
+        ...row.metrics_json.map(
+          (field) => field.value === void 0 || field.value === null ? "-" : String(field.value)
+        )
+      ]);
+    }
+    process.stdout.write(`${table.toString()}
+`);
+    total += group.items.length;
+  }
+  process.stdout.write(`
+\u5171 ${total} \u6761\u8BB0\u5F55
+`);
+}
+function registerChannelMetricCommand(program2) {
+  const channelMetric = program2.command("channel-metric").description("\u6E20\u9053\u76D1\u63A7\u6307\u6807\u67E5\u8BE2 \u2014\u2014 \u67E5\u8BE2\u5343\u725B\u7B49\u6E20\u9053\u5E97\u94FA\u5BA2\u670D\u7684\u6BCF\u65E5\u6392\u884C\u6307\u6807\uFF08channel_metric_snapshot\uFF09");
+  channelMetric.command("query").description(
+    "\u6309 workspace + \u65E5\u671F\u533A\u95F4\uFF08+ \u53EF\u9009 agent / \u6E20\u9053\uFF09\u67E5\u8BE2\u6307\u6807\uFF0C\u6309\u65E5\u671F\xD7\u6E20\u9053\u5206\u7EC4\u8F93\u51FA\u3002\u4E0D\u4F20 --agent \u8F93\u51FA\u8BE5 workspace \u4E0B\u5168\u90E8 agent\uFF0C\u4E0D\u4F20 --platform \u8F93\u51FA\u5168\u90E8\u6E20\u9053"
+  ).requiredOption("--workspace-id <workspace_id>", "\u5DE5\u4F5C\u7A7A\u95F4 ID\uFF08\u5FC5\u4F20\uFF0C\u4E0E\u670D\u52A1\u7AEF\u5F52\u5C5E\u6821\u9A8C\u4E00\u81F4\uFF09").option("--agent <agent_id>", "Agent \u914D\u7F6E ID\uFF1B\u7F3A\u7701\u67E5\u8BE2\u8BE5 workspace \u4E0B\u5168\u90E8 agent").requiredOption("--start <date>", "\u8D77\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").option("--platform <channel>", "\u6E20\u9053\uFF08platform\uFF09\uFF0C\u5982 qianniu\uFF1B\u7F3A\u7701\u67E5\u8BE2\u5168\u90E8\u6E20\u9053").action(async (opts) => {
+    try {
+      setRuntimeWorkspaceId(opts.workspaceId);
+      const data = await queryChannelMetrics({
+        workspaceId: opts.workspaceId,
+        configId: opts.agent,
+        startDate: opts.start,
+        endDate: opts.end,
+        channel: opts.platform
+      });
+      const groups = data?.groups ?? [];
+      if (groups.length === 0) {
+        process.stdout.write("(empty)\n");
+        return;
+      }
+      renderGroupedTable(groups);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  channelMetric.command("backfill").description(
+    "\u624B\u52A8\u8865\u6570\u636E\uFF1A\u91C7\u96C6\u6307\u5B9A\u65E5\u671F\u533A\u95F4\u7684\u6E20\u9053\u6307\u6807\u3002\u53EF\u6307\u5B9A workspace\uFF08\u53EF\u91CD\u590D\u4F20\uFF0C\u9010\u4E2A\u9274\u6743\uFF09\uFF1B\u4E0D\u4F20 --workspace-id = \u53EA\u91C7\u96C6\u5F53\u524D workspace\uFF08\u767B\u5F55\u6001\u4E0B\uFF0C\u670D\u52A1\u7AEF\u9650\u5236\uFF09"
+  ).requiredOption("--channel <channel>", "\u6E20\u9053\uFF08platform\uFF09\uFF0C\u5982 qianniu").requiredOption("--start <date>", "\u8D77\u59CB\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65E5\u671F\uFF08YYYY-MM-DD\uFF09").option(
+    "--workspace-id <workspace_id>",
+    "\u5DE5\u4F5C\u7A7A\u95F4 ID\uFF08\u53EF\u91CD\u590D\u4F20\uFF1B\u7F3A\u7701 = \u53EA\u91C7\u96C6\u5F53\u524D workspace\uFF09",
+    collect,
+    []
+    // 默认空数组：commander 首次解析时 previous 为 undefined，无默认值会崩
+  ).action(async (opts) => {
+    try {
+      const workspaceIds = opts.workspaceId?.length ? opts.workspaceId : void 0;
+      setRuntimeWorkspaceId(workspaceIds?.[0]);
+      const data = await backfillChannelMetrics({
+        channel: opts.channel,
+        startDate: opts.start,
+        endDate: opts.end,
+        workspaceIds
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
 // src/client/chat-history-api.ts
 async function listChatHistory(opts) {
   const request = createRequest();
@@ -1250,6 +1365,11 @@ function parseSearchTime(value, fieldName) {
   }
   return parsed;
 }
+function validateContextSearchQuery(queryContent) {
+  if (queryContent.trim().length < 2) {
+    throw new Error("query_content \u81F3\u5C11\u9700\u8981 2 \u4E2A\u5B57\u7B26");
+  }
+}
 function validateContextSearchRange(startTime, endTime) {
   if (!startTime || !endTime) return;
   const start = parseSearchTime(startTime, "\u5F00\u59CB\u65F6\u95F4");
@@ -1288,6 +1408,7 @@ function shouldKeepTransferHumanConversation(item, onlyAbnormal) {
   });
 }
 async function contextSearchRecords(opts) {
+  validateContextSearchQuery(opts.queryContent);
   validateContextSearchRange(opts.startTime, opts.endTime);
   const wsId = getWorkspaceId(opts.workspaceId);
   const request = createRequest();
@@ -1608,7 +1729,7 @@ async function writeBinaryToFile(filePath, buffer) {
 }
 
 // src/commands/dashboard.ts
-function collect(value, previous) {
+function collect2(value, previous) {
   return previous.concat([value]);
 }
 function registerDashboardCommand(program2) {
@@ -1663,7 +1784,7 @@ function registerDashboardCommand(program2) {
   });
   dashboard.command("export").description(
     "\u5BFC\u51FA\u5E97\u94FA\u7EF4\u5EA6\u6BCF\u65E5\u660E\u7EC6\uFF08\u63A5\u5F85\u5BA2\u6237\u6570/AI\u72EC\u7ACB\u627F\u63A5/\u8F6C\u4EBA\u5DE5/AI\u56DE\u590D\u6D88\u606F\u6570\uFF09\u3002\u9ED8\u8BA4\u89E3\u6790\u4E3A JSON \u884C\uFF1B--out \u843D\u76D8\u539F\u59CB CSV\u3002\u53EF\u91CD\u590D --config-id \u9650\u5B9A\u5E97\u94FA"
-  ).requiredOption("--start <date>", "\u5F00\u59CB\u65E5\u671F (YYYY-MM-DD)\uFF0C\u5FC5\u586B").requiredOption("--end <date>", "\u7ED3\u675F\u65E5\u671F (YYYY-MM-DD)\uFF0C\u5FC5\u586B\uFF0C\u4E0D\u80FD\u665A\u4E8E\u6628\u5929").option("--config-id <id>", "\u5E97\u94FA\u914D\u7F6E ID\uFF08\u53EF\u91CD\u590D\u4F20\uFF1B\u4E0D\u4F20=\u5168\u90E8\u5E97\u94FA\uFF09", collect, []).option("--channel <channel>", "\u6E20\u9053\u7B5B\u9009: qianniu | jingdong | pinduoduo | douyin").option("--out <path>", "\u843D\u76D8\u539F\u59CB CSV \u8DEF\u5F84\uFF08\u7236\u76EE\u5F55\u81EA\u52A8 mkdir -p\uFF09").action(async (opts) => {
+  ).requiredOption("--start <date>", "\u5F00\u59CB\u65E5\u671F (YYYY-MM-DD)\uFF0C\u5FC5\u586B").requiredOption("--end <date>", "\u7ED3\u675F\u65E5\u671F (YYYY-MM-DD)\uFF0C\u5FC5\u586B\uFF0C\u4E0D\u80FD\u665A\u4E8E\u6628\u5929").option("--config-id <id>", "\u5E97\u94FA\u914D\u7F6E ID\uFF08\u53EF\u91CD\u590D\u4F20\uFF1B\u4E0D\u4F20=\u5168\u90E8\u5E97\u94FA\uFF09", collect2, []).option("--channel <channel>", "\u6E20\u9053\u7B5B\u9009: qianniu | jingdong | pinduoduo | douyin").option("--out <path>", "\u843D\u76D8\u539F\u59CB CSV \u8DEF\u5F84\uFF08\u7236\u76EE\u5F55\u81EA\u52A8 mkdir -p\uFF09").action(async (opts) => {
     try {
       const result = await exportShopData({
         startDate: opts.start,
@@ -7470,6 +7591,7 @@ registerMediaCommand(program);
 registerKnowledgeCommand(program);
 registerActivityCommand(program);
 registerIssueCommand(program);
+registerChannelMetricCommand(program);
 registerChatHistoryCommand(program);
 registerFaqCommand(program);
 registerConversationCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bty/customer-service-cli",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "description": "AI Customer Service CLI - Agent friendly",
   "type": "module",
   "main": "./dist/bin.js",