@bty/customer-service-cli 0.6.10 → 0.6.12

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.6.12 (2026-08-31)
+
+- `channel-metric query` 新增 `--format json|markdown|table`（默认 json）：markdown 输出适合贴文档/群消息，table 输出终端表格；json 保持原结构不变。
+
+## 0.6.11 (2026-08-27)
+
+- `workspace points-consumes` 改用 `customer-observability-api` 备库 Cursor 接口，支持 `--cursor`、`--start`、`--end`、`--limit`，可继续读取超过 10000 条的历史积分流水。
+
 ## 0.6.10 (2026-08-26)
 
 - `context-search`：`query_content` 增加最少 2 个字符的本地校验，避免过短关键词触发服务端全量扫描。

package/dist/bin.js

@@ -1159,11 +1159,42 @@ function renderGroupedTable(groups) {
 \u5171 ${total} \u6761\u8BB0\u5F55
 `);
 }
+function renderMarkdownTable(groups) {
+  let total = 0;
+  const escape = (value) => value.replace(/\|/g, "\\|");
+  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 headCells = ["account_id", ...headers].map(escape);
+    process.stdout.write(`| ${headCells.join(" | ")} |
+`);
+    process.stdout.write(`| ${headCells.map(() => "---").join(" | ")} |
+`);
+    for (const row of group.items) {
+      const cells = [
+        String(row.account_id),
+        ...row.metrics_json.map(
+          (field) => field.value === void 0 || field.value === null ? "-" : escape(String(field.value))
+        )
+      ];
+      process.stdout.write(`| ${cells.join(" | ")} |
+`);
+    }
+    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) => {
+  ).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").option("--format <format>", "\u8F93\u51FA\u683C\u5F0F\uFF1Ajson\uFF08\u9ED8\u8BA4\uFF09/ markdown / table", "json").action(async (opts) => {
     try {
       setRuntimeWorkspaceId(opts.workspaceId);
       const data = await queryChannelMetrics({
@@ -1174,11 +1205,24 @@ function registerChannelMetricCommand(program2) {
         channel: opts.platform
       });
       const groups = data?.groups ?? [];
-      if (groups.length === 0) {
-        process.stdout.write("(empty)\n");
-        return;
+      switch (opts.format) {
+        case "markdown":
+          if (groups.length === 0) {
+            process.stdout.write("(empty)\n");
+            return;
+          }
+          renderMarkdownTable(groups);
+          break;
+        case "table":
+          if (groups.length === 0) {
+            process.stdout.write("(empty)\n");
+            return;
+          }
+          renderGroupedTable(groups);
+          break;
+        default:
+          formatOutput({ success: true, data }, false);
       }
-      renderGroupedTable(groups);
     } catch (err) {
       reportCaughtError(err);
       process.exit(toExitCode(err));
@@ -1258,16 +1302,31 @@ async function getDailyDeduction(opts) {
     }
   );
 }
+var MAX_POINTS_CURSOR_PAGES = 500;
 async function getPointsConsumes(opts) {
   const request = createRequest();
-  return request(
-    getCustomerServiceUrl(),
-    "/v1/workspace/points_consumes",
-    {
-      method: "POST",
-      body: { page: opts.page, page_size: opts.pageSize, debug: true }
+  const items = [];
+  let cursor = opts.cursor;
+  let fetchedPages = 0;
+  while (fetchedPages < MAX_POINTS_CURSOR_PAGES) {
+    fetchedPages += 1;
+    const page = await request(getObservabilityUrl(), "/v1/points/consumes", {
+      method: "GET",
+      query: {
+        cursor,
+        start_time: opts.startTime,
+        end_time: opts.endTime,
+        limit: opts.limit
+      }
+    });
+    items.push(...page.items);
+    const nextCursor = page.has_more && page.next_cursor ? page.next_cursor : void 0;
+    if (!nextCursor) {
+      return { ...page, items, next_cursor: null, has_more: false, fetched_pages: fetchedPages };
     }
-  );
+    cursor = nextCursor;
+  }
+  throw new Error(`\u79EF\u5206\u6D41\u6C34\u5206\u9875\u8D85\u8FC7 ${MAX_POINTS_CURSOR_PAGES} \u9875\uFF0C\u8BF7\u7F29\u5C0F\u65F6\u95F4\u8303\u56F4`);
 }
 
 // src/commands/config.ts
@@ -7511,17 +7570,18 @@ function registerWorkspaceCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
-  workspace.command("points-consumes").description("\u5206\u9875\u67E5\u8BE2\u5F53\u524D\u5DE5\u4F5C\u7A7A\u95F4\u7684\u79EF\u5206\u8D26\u6237\u6D88\u8017\u6D41\u6C34\uFF0C\u56FA\u5B9A\u8FD4\u56DE extra \u8C03\u8BD5\u5B57\u6BB5").option("--page <number>", "\u9875\u7801\uFF0C\u9ED8\u8BA4 1", "1").option("--page-size <number>", "\u6BCF\u9875\u6570\u91CF\uFF0C\u9ED8\u8BA4 20", "20").action(async (opts) => {
+  workspace.command("points-consumes").description("\u4F7F\u7528\u6E38\u6807\u67E5\u8BE2\u5F53\u524D\u5DE5\u4F5C\u7A7A\u95F4\u7684\u79EF\u5206\u6D41\u6C34\uFF08\u8BFB\u53D6\u89C2\u6D4B\u670D\u52A1\u5907\u5E93\uFF09").option("--cursor <token>", "\u4E0B\u4E00\u9875\u6E38\u6807").option("--start <ISO>", "\u8D77\u59CB\u65F6\u95F4\uFF08\u542B\uFF09").option("--end <ISO>", "\u7ED3\u675F\u65F6\u95F4\uFF08\u4E0D\u542B\uFF09").option("--limit <number>", "\u6BCF\u6279\u6570\u91CF\uFF0C\u9ED8\u8BA4 100", "100").action(async (opts) => {
     try {
-      const page = Number(opts.page);
-      const pageSize = Number(opts.pageSize);
-      if (!Number.isInteger(page) || page <= 0) {
-        throw new Error("--page \u5FC5\u987B\u4E3A\u6B63\u6574\u6570");
-      }
-      if (!Number.isInteger(pageSize) || pageSize <= 0) {
-        throw new Error("--page-size \u5FC5\u987B\u4E3A\u6B63\u6574\u6570");
+      const limit = Number(opts.limit);
+      if (!Number.isInteger(limit) || limit <= 0 || limit > 500) {
+        throw new Error("--limit \u5FC5\u987B\u4E3A 1-500 \u7684\u6574\u6570");
       }
-      const data = await getPointsConsumes({ page, pageSize });
+      const data = await getPointsConsumes({
+        cursor: opts.cursor,
+        startTime: opts.start,
+        endTime: opts.end,
+        limit
+      });
       formatOutput({ success: true, data }, program2.opts().table);
     } catch (err) {
       reportCaughtError(err);

package/package.json

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