@bty/customer-service-cli 0.6.0 → 0.6.4

package/dist/bin.js

@@ -31,7 +31,24 @@ function formatOutput(response, table) {
   if (Array.isArray(data)) {
     renderArrayTable(data);
   } else if (data !== null && typeof data === "object") {
-    renderObjectTable(data);
+    const obj = data;
+    const innerArray = findInnerArray(obj);
+    if (innerArray) {
+      renderArrayTable(innerArray);
+      const total = obj.total ?? obj.count;
+      const pageNo = obj.page_no ?? obj.page;
+      const pageSize = obj.page_size;
+      if (total !== void 0) {
+        const paginationParts = [`total: ${total}`];
+        if (pageNo !== void 0) paginationParts.push(`page: ${pageNo}`);
+        if (pageSize !== void 0) paginationParts.push(`page_size: ${pageSize}`);
+        process.stdout.write(`
+${paginationParts.join(" | ")}
+`);
+      }
+    } else {
+      renderObjectTable(obj);
+    }
   } else {
     process.stdout.write(JSON.stringify(response, null, 2));
     return;
@@ -43,6 +60,16 @@ Page ${page} | ${pageSize} per page | ${total} total
 `);
   }
 }
+function findInnerArray(obj) {
+  const paginationKeys = /* @__PURE__ */ new Set(["total", "count", "page_no", "page", "page_size"]);
+  const arrayKey = Object.keys(obj).find(
+    (k) => Array.isArray(obj[k]) && !paginationKeys.has(k)
+  );
+  if (!arrayKey) return null;
+  const arr = obj[arrayKey];
+  if (arr.length === 0 || typeof arr[0] !== "object" || arr[0] === null) return null;
+  return arr;
+}
 function renderArrayTable(data) {
   const first = data[0];
   if (first == null) {
@@ -52,7 +79,14 @@ function renderArrayTable(data) {
   const headers = Object.keys(first);
   const table = new Table({ head: headers });
   for (const row of data) {
-    table.push(headers.map((h) => String(row[h] ?? "")));
+    table.push(
+      headers.map((h) => {
+        const val = row[h];
+        if (Array.isArray(val)) return val.length === 0 ? "[]" : `[${val.length} items]`;
+        if (val !== null && typeof val === "object") return JSON.stringify(val);
+        return String(val ?? "");
+      })
+    );
   }
   process.stdout.write(`${table.toString()}
 `);
@@ -60,7 +94,15 @@ function renderArrayTable(data) {
 function renderObjectTable(data) {
   const table = new Table();
   for (const [key, value] of Object.entries(data)) {
-    table.push({ [key]: String(value ?? "") });
+    let display;
+    if (Array.isArray(value)) {
+      display = value.length === 0 ? "[]" : `[${value.length} items]`;
+    } else if (value !== null && typeof value === "object") {
+      display = JSON.stringify(value);
+    } else {
+      display = String(value ?? "");
+    }
+    table.push({ [key]: display });
   }
   process.stdout.write(`${table.toString()}
 `);
@@ -436,7 +478,6 @@ function isTokenExpired(expiresAt) {
 // src/client/helpers.ts
 var DEFAULT_CS_API_URL = "https://customer-servhub-api.betteryeah.com";
 var DEFAULT_AI_API_URL = "https://ai-api.betteryeah.com";
-var DEFAULT_CUSTOMER_AGENT_API_URL = "https://customer-agent.bantouyan.com";
 var DEFAULT_CS_ADMIN_URL = "https://customer-service-admin.betteryeah.com";
 function getCustomerServiceUrl() {
   const envUrl = process.env.CS_CS_API_URL;
@@ -450,12 +491,6 @@ function getAiApiUrl() {
   const config = readConfig();
   return config?.aiApiUrl ?? DEFAULT_AI_API_URL;
 }
-function getCustomerAgentUrl() {
-  const envUrl = process.env.CS_CUSTOMER_AGENT_URL;
-  if (envUrl) return envUrl;
-  const config = readConfig();
-  return config?.customerAgentApiUrl ?? DEFAULT_CUSTOMER_AGENT_API_URL;
-}
 function getCsAdminUrl() {
   const envUrl = process.env.CS_CS_ADMIN_URL;
   if (envUrl) return envUrl;
@@ -477,15 +512,6 @@ function getWorkspaceId(overrideWorkspaceId) {
   if (globalConfig?.defaultWorkspaceId) return globalConfig.defaultWorkspaceId;
   throw new APIError(1, "\u672A\u8BBE\u7F6E\u5DE5\u4F5C\u7A7A\u95F4\uFF0C\u8BF7\u8FD0\u884C: cs-cli config set-workspace <id>");
 }
-function buildCookieHeaders() {
-  const creds = readCredentials();
-  if (!creds) throw new APIError(2, "\u672A\u767B\u5F55\uFF0C\u8BF7\u8FD0\u884C: cs-cli auth login");
-  if (isTokenExpired(creds.expiresAt)) {
-    clearCredentials();
-    throw new APIError(2, "Token \u5DF2\u8FC7\u671F\uFF0C\u8BF7\u8FD0\u884C: cs-cli auth login");
-  }
-  return { Cookie: `auth_token=${creds.accessToken}` };
-}
 
 // src/client/activity-api.ts
 var PATH_PREFIX = "/v1/activity";
@@ -1104,6 +1130,17 @@ async function getDailyDeduction(opts) {
     }
   );
 }
+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 }
+    }
+  );
+}
 
 // src/commands/config.ts
 function registerConfigCommand(program2) {
@@ -1187,6 +1224,7 @@ function registerConfigCommand(program2) {
 // src/client/conversation-api.ts
 var MAX_CONTEXT_SEARCH_RANGE_MS = 3 * 24 * 60 * 60 * 1e3;
 var MAX_TRANSFER_HUMAN_RANGE_MS = 7 * 24 * 60 * 60 * 1e3;
+var MAX_TRANSFER_HUMAN_CURSOR_PAGES = 500;
 function parseSearchTime(value, fieldName) {
   const parsed = new Date(value);
   if (Number.isNaN(parsed.getTime())) {
@@ -1259,15 +1297,36 @@ async function listConversations(opts) {
 async function listTransferHumanConversations(opts) {
   validateTransferHumanRange(opts.startDate, opts.endDate);
   const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/chat/conversations/transfer-human", {
-    method: "GET",
-    query: {
-      customer_agent_config_id: opts.customerAgentConfigId,
-      start_date: opts.startDate,
-      end_date: opts.endDate,
-      page: opts.page ?? 1
-    }
-  });
+  const items = [];
+  let cursor;
+  let fetchedPages = 0;
+  let pagination = {};
+  while (fetchedPages < MAX_TRANSFER_HUMAN_CURSOR_PAGES) {
+    fetchedPages += 1;
+    const page = await request(
+      getCustomerServiceUrl(),
+      "/v1/chat/conversations/transfer-human",
+      {
+        method: "GET",
+        query: {
+          customer_agent_config_id: opts.customerAgentConfigId,
+          start_date: opts.startDate,
+          end_date: opts.endDate,
+          page: 1,
+          cursor
+        }
+      }
+    );
+    items.push(...page.items ?? []);
+    pagination = page.pagination ?? {};
+    const hasMore = pagination.has_more === true;
+    const nextCursor = typeof pagination.next_cursor === "string" && pagination.next_cursor ? pagination.next_cursor : void 0;
+    if (!hasMore || !nextCursor) {
+      return { ...page, items, pagination: { ...pagination, fetched_pages: fetchedPages } };
+    }
+    cursor = nextCursor;
+  }
+  throw new Error(`\u8F6C\u4EBA\u5DE5\u4F1A\u8BDD\u5206\u9875\u8D85\u8FC7 ${MAX_TRANSFER_HUMAN_CURSOR_PAGES} \u9875\uFF0C\u8BF7\u7F29\u5C0F\u67E5\u8BE2\u65F6\u95F4\u8303\u56F4`);
 }
 
 // src/commands/conversation.ts
@@ -1323,13 +1382,12 @@ function registerConversationCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
-  conversation.command("transfer-human").description("\u67E5\u8BE2\u8F6C\u4EBA\u5DE5\u4F1A\u8BDD\u53CA\u5BF9\u5E94\u8F6C\u4EBA\u5DE5\u6D88\u606F\u8BB0\u5F55").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08customer_agent_config_id\uFF09").requiredOption("--start <date>", "\u5F00\u59CB\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T00:00:00\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T23:59:59\uFF09").option("--page <number>", "\u9875\u7801", "1").action(async (opts) => {
+  conversation.command("transfer-human").description("\u67E5\u8BE2\u8F6C\u4EBA\u5DE5\u4F1A\u8BDD\u53CA\u5BF9\u5E94\u8F6C\u4EBA\u5DE5\u6D88\u606F\u8BB0\u5F55").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08customer_agent_config_id\uFF09").requiredOption("--start <date>", "\u5F00\u59CB\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T00:00:00\uFF09").requiredOption("--end <date>", "\u7ED3\u675F\u65F6\u95F4\uFF08ISO \u683C\u5F0F\uFF0C\u5982 2026-05-20T23:59:59\uFF09").action(async (opts) => {
     try {
       const data = await listTransferHumanConversations({
         customerAgentConfigId: opts.agent,
         startDate: opts.start,
-        endDate: opts.end,
-        page: Number(opts.page)
+        endDate: opts.end
       });
       formatOutput({ success: true, data }, program2.opts().table);
     } catch (err) {
@@ -1685,16 +1743,23 @@ async function sendAgentMessage(opts) {
     ];
   }
   const request = createRequest();
+  const body = {
+    msg_list: msgList,
+    is_stream: false,
+    conversation_id: opts.conversationId
+  };
+  if (opts.mock !== void 0) {
+    body.mock = opts.mock;
+  }
+  if (opts.debugDataOverlay !== void 0) {
+    body.debug_data_overlay = opts.debugDataOverlay;
+  }
   return request(
     getCustomerServiceUrl(),
     "/v1/debug/chat/agent_message",
     {
       method: "POST",
-      body: {
-        msg_list: msgList,
-        is_stream: false,
-        conversation_id: opts.conversationId
-      }
+      body
     }
   );
 }
@@ -1814,218 +1879,677 @@ async function getLangfuseTrace(traceId, env) {
   );
 }
 
-// src/commands/debug.ts
-function registerDebugCommand(program2) {
-  const debug = program2.command("debug").description(
-    "Agent \u8C03\u8BD5\u6D4B\u8BD5 \u2014\u2014 \u5411 Agent \u53D1\u9001\u6D4B\u8BD5\u6D88\u606F\u5E76\u83B7\u53D6\u56DE\u590D\uFF0C\u662F\u9A8C\u8BC1 Agent \u56DE\u590D\u8D28\u91CF\u7684\u4E3B\u8981\u624B\u6BB5\u3002\u652F\u6301\u5355\u6761\u6D88\u606F\u548C\u591A\u8F6E\u5BF9\u8BDD\u91CD\u653E"
-  );
-  debug.command("ask").description(
-    "\u5411 Agent \u53D1\u9001\u6D88\u606F\u5E76\u7B49\u5F85\u56DE\u590D\u3002\u8FD4\u56DE { conversation_id, reply: [{ record_id, content, ... }] }\u3002record_id \u53EF\u4F20\u7ED9 debug record \u67E5\u770B\u5185\u90E8\u63A8\u7406\u94FE\u8DEF"
-  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").option("--text <message>", "\u53D1\u9001\u7684\u6D88\u606F\u5185\u5BB9\uFF08\u4E0E --messages \u4E92\u65A5\uFF0C\u4E8C\u9009\u4E00\uFF09").option(
-    "--messages <json>",
-    '\u5B8C\u6574\u6D88\u606F\u5217\u8868 JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u91CD\u653E\u591A\u8F6E\u5BF9\u8BDD\uFF08\u4E0E --text \u4E92\u65A5\uFF09\u3002\u63A5\u53D7\u4E24\u79CD\u683C\u5F0F\uFF1A(1) JSON \u6570\u7EC4 [{ match_id, content: { text, image_url? }, timestamp, type: "TEXT", role: "user"|"assistant" }, ...] (2) \u542B msg_list \u5B57\u6BB5\u7684\u5BF9\u8C61 { msg_list: [...] }\uFF08conversation records \u7684\u539F\u59CB\u683C\u5F0F\u53EF\u76F4\u63A5\u4F7F\u7528\uFF09'
-  ).option("--user <name>", "\u6A21\u62DF\u7684\u7528\u6237\u540D\uFF08\u9ED8\u8BA4\u4F7F\u7528\u767B\u5F55\u7528\u6237\u540D\uFF09").option("--url <image_url>", "\u9644\u5E26\u7684\u56FE\u7247 URL\uFF08\u4EC5 --text \u6A21\u5F0F\u6709\u6548\uFF09").option("--conversation <id>", "\u590D\u7528\u5DF2\u6709\u4F1A\u8BDD ID\uFF0C\u7528\u4E8E\u5728\u540C\u4E00\u4E0A\u4E0B\u6587\u4E2D\u7EE7\u7EED\u5BF9\u8BDD").option("--timeout <seconds>", "\u6700\u5927\u7B49\u5F85\u56DE\u590D\u65F6\u95F4\uFF08\u79D2\uFF09\uFF0C\u590D\u6742 Agent \u5EFA\u8BAE\u8C03\u9AD8", "30").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09", "2000").action(async (opts) => {
-    try {
-      if (!opts.text && !opts.messages) {
-        outputError(1, "\u5FC5\u987B\u6307\u5B9A --text \u6216 --messages \u5176\u4E2D\u4E4B\u4E00");
-        process.exit(1);
-      }
-      const userName = opts.user ?? readCredentials()?.username ?? "cli-user";
-      let conversationId;
-      if (opts.conversation) {
-        conversationId = opts.conversation;
-      } else {
-        const conv = await createDebugConversation({
-          agentConfigId: opts.agent,
-          userName
-        });
-        conversationId = conv.conversation_id;
-      }
-      let msgList;
-      if (opts.messages) {
-        const parsed = parseDataOption(opts.messages);
-        msgList = Array.isArray(parsed) ? parsed : parsed.msg_list;
-        if (!Array.isArray(msgList)) {
-          outputError(1, "--messages \u5FC5\u987B\u662F JSON \u6570\u7EC4\u6216\u5305\u542B msg_list \u5B57\u6BB5\u7684\u5BF9\u8C61");
-          process.exit(1);
-        }
-      }
-      await sendAgentMessage({
-        conversationId,
-        text: opts.text,
-        imageUrl: opts.url,
-        msgList
-      });
-      const agentRecords = await pollAgentReply(conversationId, {
-        timeout: Number(opts.timeout) * 1e3,
-        pollInterval: Number(opts.pollInterval)
-      });
-      formatOutput(
-        {
-          success: true,
-          data: {
-            conversation_id: conversationId,
-            reply: agentRecords
-          }
-        },
-        program2.opts().table
-      );
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
-    }
-  });
-  debug.command("record").description("\u83B7\u53D6\u67D0\u6761\u56DE\u590D\u7684\u5185\u90E8\u63A8\u7406\u94FE\u8DEF\uFF08flow_info\uFF09\uFF0C\u7528\u4E8E\u8BCA\u65AD Agent \u4E3A\u4F55\u7ED9\u51FA\u7279\u5B9A\u56DE\u590D").argument("<record_id>", "\u56DE\u590D\u8BB0\u5F55 ID\uFF08\u4ECE debug ask \u8FD4\u56DE\u7684 reply[].record_id \u83B7\u53D6\uFF09").option(
-    "--deep",
-    "\u6DF1\u5EA6\u89E3\u6790\uFF1A\u989D\u5916\u8C03\u7528 ai-api \u7684 flow execute_log \u63A5\u53E3\uFF0C\u62C9\u53D6 flow_info.flow_id + task_id \u5BF9\u5E94\u7684\u5B8C\u6574\u6267\u884C\u65E5\u5FD7\uFF08log_url \u5185\u5BB9\uFF09\uFF0C\u7528\u4E8E\u6392\u67E5\u8282\u70B9\u7EA7\u8F93\u5165\u8F93\u51FA",
-    false
-  ).option("--flow-workspace <id>", "flow \u6240\u5728 workspace ID\uFF08--deep \u65F6\u4F7F\u7528\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u5185\u7F6E\u56FA\u5B9A\u503C\uFF09").action(async (recordId, opts) => {
-    try {
-      const data = await getRecordDebugInfo(recordId);
-      let deep;
-      if (opts.deep) {
-        const flowInfo = data.flow_info;
-        const flowId = flowInfo?.flow_id;
-        const taskId = flowInfo?.task_id;
-        if (!flowId || !taskId) {
-          deep = { error: "flow_info \u4E2D\u7F3A\u5C11 flow_id \u6216 task_id\uFF0C\u65E0\u6CD5\u6DF1\u5EA6\u89E3\u6790" };
-        } else {
-          try {
-            deep = await getFlowExecuteLog({
-              flowId,
-              taskId,
-              workspaceId: opts.flowWorkspace
-            });
-          } catch (err) {
-            deep = { error: err.message };
-          }
-        }
-      }
-      formatOutput(
-        { success: true, data: opts.deep ? { ...data, deep } : data },
-        program2.opts().table
-      );
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
-    }
-  });
-  debug.command("reproduce").description(
-    "\u6839\u636E record_id \u590D\u73B0\u4E00\u6B21 Agent \u56DE\u590D\u3002\u81EA\u52A8\u83B7\u53D6\u5173\u8054\u4F1A\u8BDD\u3001\u622A\u53D6\u4E0A\u4E0B\u6587\u3001\u7528\u539F\u59CB user_name \u521B\u5EFA debug \u4F1A\u8BDD\u5E76\u91CD\u65B0\u53D1\u9001"
-  ).argument("<record_id>", "\u8981\u590D\u73B0\u7684\u56DE\u590D\u8BB0\u5F55 ID").option("--agent <config_id>", "\u4F7F\u7528\u6307\u5B9A Agent \u590D\u73B0\uFF08\u9ED8\u8BA4\u4F7F\u7528\u539F\u59CB Agent\uFF09").option("--timeout <seconds>", "\u6700\u5927\u7B49\u5F85\u56DE\u590D\u65F6\u95F4\uFF08\u79D2\uFF09", "60").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09", "2000").option("--dry-run", "\u4EC5\u8F93\u51FA\u622A\u65AD\u540E\u7684\u4E0A\u4E0B\u6587 msg_list\uFF0C\u4E0D\u53D1\u9001", false).action(async (recordId, opts) => {
-    try {
-      const relations = await getRecordRelations(recordId);
-      const { conversation, agent_config: agentConfig } = relations;
-      const conversationId = conversation.conversation_id;
-      const agentConfigId = opts.agent ?? agentConfig.config_id;
-      const userName = conversation.user_name ?? "cli-user";
-      const records = await getConversationRecords({
-        conversationId,
-        pageSize: 200,
-        direction: "prev"
-      });
-      const truncated = truncateBeforeRecord(records, recordId);
-      const msgList = recordsToMsgList(truncated);
-      if (opts.dryRun) {
-        formatOutput(
-          {
-            success: true,
-            data: {
-              original_record_id: recordId,
-              agent_config_id: agentConfigId,
-              agent_config_name: agentConfig.config_name,
-              user_name: userName,
-              context_messages_count: msgList.length,
-              msg_list: msgList
-            }
-          },
-          program2.opts().table
-        );
-        return;
-      }
-      const conv = await createDebugConversation({
-        agentConfigId,
-        userName
-      });
-      await sendAgentMessage({
-        conversationId: conv.conversation_id,
-        msgList
-      });
-      const agentRecords = await pollAgentReply(conv.conversation_id, {
-        timeout: Number(opts.timeout) * 1e3,
-        pollInterval: Number(opts.pollInterval),
-        category: "agent_response"
-      });
-      let traceId = null;
-      try {
-        const debugInfo = await getRecordDebugInfo(agentRecords[0].record_id);
-        traceId = debugInfo.trace_id ?? null;
-      } catch {
-      }
-      formatOutput(
-        {
-          success: true,
-          data: {
-            original_record_id: recordId,
-            conversation_id: conv.conversation_id,
-            agent_config_id: agentConfigId,
-            agent_config_name: agentConfig.config_name,
-            user_name: userName,
-            context_messages_count: msgList.length,
-            trace_id: traceId,
-            reply: agentRecords
-          }
-        },
-        program2.opts().table
-      );
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
-    }
-  });
-  debug.command("trace").description(
-    "\u6839\u636E Langfuse Trace ID \u83B7\u53D6\u5B8C\u6574\u7684 Trace \u8BE6\u60C5\uFF08\u4ECE debug record \u8FD4\u56DE\u7684 flow_info \u4E2D\u63D0\u53D6 traceId\uFF09"
-  ).argument("<trace_id>", "Langfuse Trace ID\uFF08\u4ECE flow_info \u4E2D\u83B7\u53D6\uFF09").option("--env <env>", "langfuse \u73AF\u5883 dev|prod", "prod").action(async (traceId, opts) => {
-    try {
-      if (opts.env !== "dev" && opts.env !== "prod") {
-        outputError(1, "--env \u4EC5\u652F\u6301 dev \u6216 prod");
-        process.exit(1);
-      }
-      const data = await getLangfuseTrace(traceId, opts.env);
-      formatOutput({ success: true, data }, program2.opts().table);
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
+// src/client/product-api.ts
+async function listProducts(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/products", {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.agentConfigId,
+      search: opts.keyword,
+      status: opts.status?.join(","),
+      tags: opts.tags?.length ? JSON.stringify(opts.tags) : void 0,
+      page: opts.page ?? 1,
+      page_size: opts.pageSize ?? 20
     }
   });
 }
-
-// src/client/faq-api.ts
-async function listFaqFiles(opts) {
+async function getProductDetail(opts) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/external", {
+  return request(getCustomerServiceUrl(), "/v1/knowledge/product/detail", {
     method: "GET",
     query: {
       customer_agent_config_id: opts.agentConfigId,
-      page: opts.page ?? 1,
-      page_size: opts.pageSize ?? 20,
-      suffix_type: "_faq"
+      db_id: opts.dbId,
+      product_id: opts.productId
     }
   });
 }
-async function saveFaqContent(opts) {
+async function updateProduct(opts) {
   const request = createRequest();
-  const body = {
-    chunks_to_delete: opts.chunksToDelete ?? [],
-    contents: opts.contents.map((c) => ({
-      content: c.content,
-      keywords: c.keywords ?? [],
-      enable: c.enable ?? true,
-      ...c.chunkId !== void 0 ? { chunk_id: c.chunkId } : {}
-    })),
-    answers: opts.answers
-  };
-  if (opts.answerGroupId !== void 0) {
+  return request(getCustomerServiceUrl(), "/v1/knowledge/product/update", {
+    method: "POST",
+    body: {
+      data_id: opts.dataId,
+      knowledge_id: opts.knowledgeId,
+      db_id: opts.dbId,
+      update_dict: opts.updateDict
+    }
+  });
+}
+async function uploadProductByUrl(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/products/upload", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      source_type: opts.sourceType ?? "manual",
+      identify: opts.identify ?? true,
+      product_urls: opts.productUrls
+    }
+  });
+}
+async function uploadProductData(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/products/upload", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      source_type: opts.sourceType ?? "manual",
+      identify: opts.identify ?? true,
+      product_items: opts.productItems
+    }
+  });
+}
+async function updateSku(opts) {
+  if (!opts.skuId && !opts.sku) {
+    throw new Error("updateSku \u9700\u8981\u63D0\u4F9B sku \u6216 sku_id \u5176\u4E2D\u4E4B\u4E00");
+  }
+  const identifier = opts.skuId ? { sku_id: opts.skuId } : { sku: opts.sku };
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/sku/update", {
+    method: "POST",
+    body: {
+      ...identifier,
+      customer_agent_config_id: opts.agentConfigId,
+      update_dict: opts.updateDict
+    }
+  });
+}
+async function syncTaobaoProducts(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/authorized-shop/sync-taobao-products", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      skip_hash_check: opts.skipHashCheck ?? false,
+      sync_type: opts.syncType ?? "full"
+    }
+  });
+}
+async function syncSingleTaobaoProduct(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/authorized-shop/sync-single-product", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      product_id: opts.productId
+    }
+  });
+}
+async function identifyAllProducts(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/products/identify/all", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId
+    }
+  });
+}
+
+// src/client/sa-api.ts
+async function listSituationActions(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/list", {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.agentConfigId,
+      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
+      event_first_label: opts.firstLabel ?? "",
+      event_second_label: opts.secondLabel ?? "",
+      page: opts.page ?? 1,
+      page_size: opts.pageSize ?? 500
+    }
+  });
+}
+async function searchSituationActions(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/search", {
+    method: "GET",
+    query: { customer_agent_config_id: opts.agentConfigId, keyword: opts.keyword }
+  });
+}
+async function createSituationAction(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/create", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
+      event_first_label: opts.firstLabel,
+      event_second_label: opts.secondLabel,
+      situation: opts.situation,
+      action: opts.action,
+      transfer_to_human: opts.transferToHuman ?? false
+    }
+  });
+}
+async function updateSituationAction(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/update", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      situation_action_id: opts.situationActionId,
+      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
+      event_first_label: opts.firstLabel,
+      event_second_label: opts.secondLabel,
+      situation: opts.situation,
+      action: opts.action,
+      transfer_to_human: opts.transferToHuman ?? false
+    }
+  });
+}
+async function deleteSituationAction(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/delete", {
+    method: "POST",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      situation_action_id: opts.situationActionId,
+      event_first_label: opts.firstLabel,
+      event_second_label: opts.secondLabel
+    }
+  });
+}
+async function listSituationActionVersions(opts) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    "/v1/knowledge/situation-actions/list/versions",
+    {
+      method: "GET",
+      query: {
+        customer_agent_config_id: opts.agentConfigId,
+        situation_action_id: opts.situationActionId
+      }
+    }
+  );
+}
+
+// src/commands/debug-snapshot.ts
+var SA_PAGE_SIZE = 500;
+var ACTIVITY_PAGE_SIZE = 100;
+var PRODUCT_PAGE_SIZE = 100;
+var PRODUCT_DETAIL_CONCURRENCY = 4;
+var PERSONALIZATION_SLOTS = [
+  "intent",
+  "general_qa",
+  "recommend",
+  "takeover_rule",
+  "image_rule",
+  "custom_qa"
+];
+var ACTIVITY_FIELDS = [
+  "activity_name",
+  "activity_rule",
+  "participate_condition",
+  "benefit_content",
+  "redeem_desc",
+  "other_info",
+  "qa"
+];
+var PRODUCT_FIELDS = [
+  "\u5546\u54C1\u6807\u9898",
+  "\u5546\u54C1\u54C1\u7C7B",
+  "\u53C2\u6570",
+  "\u5356\u70B9",
+  "\u8865\u5145\u77E5\u8BC6",
+  "\u8F6E\u64AD\u56FE\u8BC6\u522B\u7ED3\u679C",
+  "\u5546\u54C1\u8BE6\u60C5\u9875\u8BC6\u522B\u7ED3\u679C",
+  "\u5173\u8054\u77E5\u8BC6\u5E93\u547D\u4E2D"
+];
+var SKU_FIELDS = ["\u8865\u5145\u77E5\u8BC6", "sku\u56FE\u8BC6\u522B\u7ED3\u679C"];
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function toStringId(value) {
+  if (typeof value === "string" && value.length > 0) return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return void 0;
+}
+function hasDefined(record, key) {
+  return Object.prototype.hasOwnProperty.call(record, key) && record[key] !== void 0;
+}
+function readPageItems(result) {
+  const record = asRecord(result);
+  return {
+    items: asArray(record.items).map(asRecord),
+    total: typeof record.total === "number" ? record.total : void 0
+  };
+}
+function isExhausted(fetchedCount, pageItemsCount, pageSize, total) {
+  if (typeof total === "number") return fetchedCount >= total;
+  return pageItemsCount < pageSize;
+}
+async function listAllSituationActions(agentConfigId) {
+  const all = [];
+  for (let page = 1; ; page += 1) {
+    const result = await listSituationActions({
+      agentConfigId,
+      page,
+      pageSize: SA_PAGE_SIZE
+    });
+    const { items, total } = readPageItems(result);
+    all.push(...items);
+    if (isExhausted(all.length, items.length, SA_PAGE_SIZE, total)) return all;
+  }
+}
+async function listAllActivities(agentConfigId) {
+  const all = [];
+  for (let page = 1; ; page += 1) {
+    const result = await listActivities({
+      customerAgentConfigId: agentConfigId,
+      page,
+      pageSize: ACTIVITY_PAGE_SIZE
+    });
+    const { items, total } = readPageItems(result);
+    all.push(...items);
+    if (isExhausted(all.length, items.length, ACTIVITY_PAGE_SIZE, total)) return all;
+  }
+}
+function readProductId(record) {
+  const productInfo = asRecord(record["\u5546\u54C1\u4FE1\u606F"]);
+  return toStringId(record.product_id) ?? toStringId(record["\u5546\u54C1id"]) ?? toStringId(productInfo["\u5546\u54C1id"]) ?? toStringId(record.id);
+}
+async function listAllProductIds(agentConfigId) {
+  const productIds = [];
+  const seen = /* @__PURE__ */ new Set();
+  let fetchedCount = 0;
+  for (let page = 1; ; page += 1) {
+    const result = await listProducts({
+      agentConfigId,
+      page,
+      pageSize: PRODUCT_PAGE_SIZE
+    });
+    const { items, total } = readPageItems(result);
+    fetchedCount += items.length;
+    for (const item of items) {
+      const productId = readProductId(item);
+      if (productId && !seen.has(productId)) {
+        seen.add(productId);
+        productIds.push(productId);
+      }
+    }
+    if (isExhausted(fetchedCount, items.length, PRODUCT_PAGE_SIZE, total)) return productIds;
+  }
+}
+function buildPersonalization(agent) {
+  const customerConfig = asRecord(agent.customer_config);
+  const personalization = {};
+  for (const slot of PERSONALIZATION_SLOTS) {
+    const source = asRecord(customerConfig[slot]);
+    if (hasDefined(source, "flow_instruction")) {
+      personalization[slot] = { flow_instruction: source.flow_instruction };
+    }
+  }
+  return personalization;
+}
+function buildSituationActions(items) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const eventOne = toStringId(item.event_first_label) ?? "";
+    const eventTwo = toStringId(item.event_second_label) ?? "";
+    const key = `${eventOne}__${eventTwo}`;
+    let group = groups.get(key);
+    if (!group) {
+      group = {
+        sa_key: key,
+        event_one: eventOne,
+        event_two: eventTwo,
+        items: []
+      };
+      groups.set(key, group);
+    }
+    const situation = toStringId(item.situation) ?? "";
+    const patchItem = {
+      match: { situation },
+      situation,
+      scene_summary: hasDefined(item, "scene_summary") ? item.scene_summary : situation
+    };
+    if (hasDefined(item, "action")) patchItem.action = item.action;
+    if (hasDefined(item, "transfer_to_human")) {
+      patchItem.transfer_to_human = item.transfer_to_human;
+    }
+    if (hasDefined(item, "react_loop_count")) {
+      patchItem.react_loop_count = item.react_loop_count;
+    }
+    group.items.push(patchItem);
+  }
+  return [...groups.values()];
+}
+function buildActivities(items) {
+  return items.flatMap((item) => {
+    const activityId = toStringId(item.activity_id ?? item.id);
+    if (!activityId) return [];
+    const activity = { activity_id: activityId };
+    for (const field of ACTIVITY_FIELDS) {
+      if (hasDefined(item, field)) activity[field] = item[field];
+    }
+    return [activity];
+  });
+}
+function buildSkuItems(detail) {
+  const rawSkuItems = asArray(detail.skus).length > 0 ? asArray(detail.skus) : asArray(detail.sku);
+  return rawSkuItems.flatMap((raw) => {
+    const item = asRecord(raw);
+    const sku = toStringId(item.sku ?? item.sku_id);
+    if (!sku) return [];
+    const skuPatch = {
+      match: { sku },
+      sku
+    };
+    for (const field of SKU_FIELDS) {
+      if (hasDefined(item, field)) skuPatch[field] = item[field];
+    }
+    return [skuPatch];
+  });
+}
+function readProductField(detail, productInfo, field) {
+  if (hasDefined(detail, field)) return detail[field];
+  if (hasDefined(productInfo, field)) return productInfo[field];
+  return void 0;
+}
+function buildProductKnowledgeItem(detail, fallbackProductId) {
+  const productInfo = asRecord(detail["\u5546\u54C1\u4FE1\u606F"]);
+  const productId = readProductId(detail) ?? fallbackProductId;
+  const product = { product_id: productId };
+  for (const field of PRODUCT_FIELDS) {
+    const value = readProductField(detail, productInfo, field);
+    if (value !== void 0) product[field] = value;
+  }
+  product.sku = buildSkuItems(detail);
+  return product;
+}
+async function fetchProductDetails(opts) {
+  const details = [];
+  for (let i = 0; i < opts.productIds.length; i += PRODUCT_DETAIL_CONCURRENCY) {
+    const batch = opts.productIds.slice(i, i + PRODUCT_DETAIL_CONCURRENCY);
+    const batchDetails = await Promise.all(
+      batch.map(async (productId) => {
+        const detail = await getProductDetail({
+          agentConfigId: opts.agentConfigId,
+          dbId: opts.dbId,
+          productId
+        });
+        return buildProductKnowledgeItem(asRecord(detail), productId);
+      })
+    );
+    details.push(...batchDetails);
+  }
+  return details;
+}
+async function buildDebugDataOverlaySnapshot(opts) {
+  const agent = asRecord(await getAgent(opts.agentConfigId));
+  const productIds = opts.productIds && opts.productIds.length > 0 ? [...new Set(opts.productIds)] : await listAllProductIds(opts.agentConfigId);
+  const dbId = toStringId(agent.database_id);
+  if (productIds.length > 0 && !dbId) {
+    throw new Error("Agent \u8BE6\u60C5\u4E2D\u672A\u627E\u5230 database_id");
+  }
+  const [saItems, activityItems, productKnowledge] = await Promise.all([
+    listAllSituationActions(opts.agentConfigId),
+    listAllActivities(opts.agentConfigId),
+    dbId ? fetchProductDetails({
+      agentConfigId: opts.agentConfigId,
+      dbId,
+      productIds
+    }) : Promise.resolve([])
+  ]);
+  return {
+    version: 1,
+    servhub: {
+      customer_config: buildPersonalization(agent),
+      forbidden_words: asArray(agent.forbidden_words),
+      platform_config: {}
+    },
+    sop: {
+      node_templates: {},
+      sa: buildSituationActions(saItems),
+      activities: buildActivities(activityItems),
+      product_knowledge: productKnowledge
+    }
+  };
+}
+
+// src/commands/debug.ts
+function registerDebugCommand(program2) {
+  const debug = program2.command("debug").description(
+    "Agent \u8C03\u8BD5\u6D4B\u8BD5 \u2014\u2014 \u5411 Agent \u53D1\u9001\u6D4B\u8BD5\u6D88\u606F\u5E76\u83B7\u53D6\u56DE\u590D\uFF0C\u662F\u9A8C\u8BC1 Agent \u56DE\u590D\u8D28\u91CF\u7684\u4E3B\u8981\u624B\u6BB5\u3002\u652F\u6301\u5355\u6761\u6D88\u606F\u548C\u591A\u8F6E\u5BF9\u8BDD\u91CD\u653E"
+  );
+  debug.command("ask").description(
+    "\u5411 Agent \u53D1\u9001\u6D88\u606F\u5E76\u7B49\u5F85\u56DE\u590D\u3002\u8FD4\u56DE { conversation_id, reply: [{ record_id, content, ... }] }\u3002record_id \u53EF\u4F20\u7ED9 debug record \u67E5\u770B\u5185\u90E8\u63A8\u7406\u94FE\u8DEF"
+  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").option("--text <message>", "\u53D1\u9001\u7684\u6D88\u606F\u5185\u5BB9\uFF08\u4E0E --messages \u4E92\u65A5\uFF0C\u4E8C\u9009\u4E00\uFF09").option(
+    "--messages <json>",
+    '\u5B8C\u6574\u6D88\u606F\u5217\u8868 JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u91CD\u653E\u591A\u8F6E\u5BF9\u8BDD\uFF08\u4E0E --text \u4E92\u65A5\uFF09\u3002\u63A5\u53D7\u4E24\u79CD\u683C\u5F0F\uFF1A(1) JSON \u6570\u7EC4 [{ match_id, content: { text, image_url? }, timestamp, type: "TEXT", role: "user"|"assistant" }, ...] (2) \u542B msg_list \u5B57\u6BB5\u7684\u5BF9\u8C61 { msg_list: [...] }\uFF08conversation records \u7684\u539F\u59CB\u683C\u5F0F\u53EF\u76F4\u63A5\u4F7F\u7528\uFF09'
+  ).option("--user <name>", "\u6A21\u62DF\u7684\u7528\u6237\u540D\uFF08\u9ED8\u8BA4\u4F7F\u7528\u767B\u5F55\u7528\u6237\u540D\uFF09").option("--url <image_url>", "\u9644\u5E26\u7684\u56FE\u7247 URL\uFF08\u4EC5 --text \u6A21\u5F0F\u6709\u6548\uFF09").option("--conversation <id>", "\u590D\u7528\u5DF2\u6709\u4F1A\u8BDD ID\uFF0C\u7528\u4E8E\u5728\u540C\u4E00\u4E0A\u4E0B\u6587\u4E2D\u7EE7\u7EED\u5BF9\u8BDD").option("--mock <json>", "\u5DE5\u5177\u7ED3\u679C mock JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u5F62\u5982 [{ tool_name, result }]").option("--data-overlay <json>", "debug_data_overlay JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u672C\u8F6E debug \u6570\u636E\u8986\u76D6").option("--timeout <seconds>", "\u6700\u5927\u7B49\u5F85\u56DE\u590D\u65F6\u95F4\uFF08\u79D2\uFF09\uFF0C\u590D\u6742 Agent \u5EFA\u8BAE\u8C03\u9AD8", "30").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09", "2000").action(async (opts) => {
+    try {
+      if (!opts.text && !opts.messages) {
+        outputError(1, "\u5FC5\u987B\u6307\u5B9A --text \u6216 --messages \u5176\u4E2D\u4E4B\u4E00");
+        process.exit(1);
+      }
+      const userName = opts.user ?? readCredentials()?.username ?? "cli-user";
+      let conversationId;
+      if (opts.conversation) {
+        conversationId = opts.conversation;
+      } else {
+        const conv = await createDebugConversation({
+          agentConfigId: opts.agent,
+          userName
+        });
+        conversationId = conv.conversation_id;
+      }
+      let msgList;
+      if (opts.messages) {
+        const parsed = parseDataOption(opts.messages);
+        msgList = Array.isArray(parsed) ? parsed : parsed.msg_list;
+        if (!Array.isArray(msgList)) {
+          outputError(1, "--messages \u5FC5\u987B\u662F JSON \u6570\u7EC4\u6216\u5305\u542B msg_list \u5B57\u6BB5\u7684\u5BF9\u8C61");
+          process.exit(1);
+        }
+      }
+      const mock = opts.mock ? parseDataOption(opts.mock) : void 0;
+      const debugDataOverlay = opts.dataOverlay ? parseDataOption(opts.dataOverlay) : void 0;
+      await sendAgentMessage({
+        conversationId,
+        text: opts.text,
+        imageUrl: opts.url,
+        msgList,
+        mock,
+        debugDataOverlay
+      });
+      const agentRecords = await pollAgentReply(conversationId, {
+        timeout: Number(opts.timeout) * 1e3,
+        pollInterval: Number(opts.pollInterval)
+      });
+      formatOutput(
+        {
+          success: true,
+          data: {
+            conversation_id: conversationId,
+            reply: agentRecords
+          }
+        },
+        program2.opts().table
+      );
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  debug.command("record").description("\u83B7\u53D6\u67D0\u6761\u56DE\u590D\u7684\u5185\u90E8\u63A8\u7406\u94FE\u8DEF\uFF08flow_info\uFF09\uFF0C\u7528\u4E8E\u8BCA\u65AD Agent \u4E3A\u4F55\u7ED9\u51FA\u7279\u5B9A\u56DE\u590D").argument("<record_id>", "\u56DE\u590D\u8BB0\u5F55 ID\uFF08\u4ECE debug ask \u8FD4\u56DE\u7684 reply[].record_id \u83B7\u53D6\uFF09").option(
+    "--deep",
+    "\u6DF1\u5EA6\u89E3\u6790\uFF1A\u989D\u5916\u8C03\u7528 ai-api \u7684 flow execute_log \u63A5\u53E3\uFF0C\u62C9\u53D6 flow_info.flow_id + task_id \u5BF9\u5E94\u7684\u5B8C\u6574\u6267\u884C\u65E5\u5FD7\uFF08log_url \u5185\u5BB9\uFF09\uFF0C\u7528\u4E8E\u6392\u67E5\u8282\u70B9\u7EA7\u8F93\u5165\u8F93\u51FA",
+    false
+  ).option("--flow-workspace <id>", "flow \u6240\u5728 workspace ID\uFF08--deep \u65F6\u4F7F\u7528\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u5185\u7F6E\u56FA\u5B9A\u503C\uFF09").action(async (recordId, opts) => {
+    try {
+      const data2 = await getRecordDebugInfo(recordId);
+      let deep;
+      if (opts.deep) {
+        const flowInfo = data2.flow_info;
+        const flowId = flowInfo?.flow_id;
+        const taskId = flowInfo?.task_id;
+        if (!flowId || !taskId) {
+          deep = { error: "flow_info \u4E2D\u7F3A\u5C11 flow_id \u6216 task_id\uFF0C\u65E0\u6CD5\u6DF1\u5EA6\u89E3\u6790" };
+        } else {
+          try {
+            deep = await getFlowExecuteLog({
+              flowId,
+              taskId,
+              workspaceId: opts.flowWorkspace
+            });
+          } catch (err) {
+            deep = { error: err.message };
+          }
+        }
+      }
+      formatOutput(
+        { success: true, data: opts.deep ? { ...data2, deep } : data2 },
+        program2.opts().table
+      );
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  debug.command("reproduce").description(
+    "\u6839\u636E record_id \u590D\u73B0\u4E00\u6B21 Agent \u56DE\u590D\u3002\u81EA\u52A8\u83B7\u53D6\u5173\u8054\u4F1A\u8BDD\u3001\u622A\u53D6\u4E0A\u4E0B\u6587\u3001\u7528\u539F\u59CB user_name \u521B\u5EFA debug \u4F1A\u8BDD\u5E76\u91CD\u65B0\u53D1\u9001"
+  ).argument("<record_id>", "\u8981\u590D\u73B0\u7684\u56DE\u590D\u8BB0\u5F55 ID").option("--agent <config_id>", "\u4F7F\u7528\u6307\u5B9A Agent \u590D\u73B0\uFF08\u9ED8\u8BA4\u4F7F\u7528\u539F\u59CB Agent\uFF09").option("--timeout <seconds>", "\u6700\u5927\u7B49\u5F85\u56DE\u590D\u65F6\u95F4\uFF08\u79D2\uFF09", "60").option("--poll-interval <ms>", "\u8F6E\u8BE2\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09", "2000").option("--mock <json>", "\u5DE5\u5177\u7ED3\u679C mock JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u5F62\u5982 [{ tool_name, result }]").option("--data-overlay <json>", "debug_data_overlay JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u672C\u8F6E debug \u6570\u636E\u8986\u76D6").option("--dry-run", "\u4EC5\u8F93\u51FA\u622A\u65AD\u540E\u7684\u4E0A\u4E0B\u6587 msg_list\uFF0C\u4E0D\u53D1\u9001", false).action(async (recordId, opts) => {
+    try {
+      const relations = await getRecordRelations(recordId);
+      const { conversation, agent_config: agentConfig } = relations;
+      const conversationId = conversation.conversation_id;
+      const agentConfigId = opts.agent ?? agentConfig.config_id;
+      const userName = conversation.user_name ?? "cli-user";
+      const records = await getConversationRecords({
+        conversationId,
+        pageSize: 200,
+        direction: "prev"
+      });
+      const truncated = truncateBeforeRecord(records, recordId);
+      const msgList = recordsToMsgList(truncated);
+      const mock = opts.mock ? parseDataOption(opts.mock) : void 0;
+      const debugDataOverlay = opts.dataOverlay ? parseDataOption(opts.dataOverlay) : void 0;
+      if (opts.dryRun) {
+        formatOutput(
+          {
+            success: true,
+            data: {
+              original_record_id: recordId,
+              agent_config_id: agentConfigId,
+              agent_config_name: agentConfig.config_name,
+              user_name: userName,
+              context_messages_count: msgList.length,
+              msg_list: msgList,
+              mock,
+              debug_data_overlay: debugDataOverlay
+            }
+          },
+          program2.opts().table
+        );
+        return;
+      }
+      const conv = await createDebugConversation({
+        agentConfigId,
+        userName
+      });
+      await sendAgentMessage({
+        conversationId: conv.conversation_id,
+        msgList,
+        mock,
+        debugDataOverlay
+      });
+      const agentRecords = await pollAgentReply(conv.conversation_id, {
+        timeout: Number(opts.timeout) * 1e3,
+        pollInterval: Number(opts.pollInterval),
+        category: "agent_response"
+      });
+      let traceId = null;
+      try {
+        const debugInfo = await getRecordDebugInfo(agentRecords[0].record_id);
+        traceId = debugInfo.trace_id ?? null;
+      } catch {
+      }
+      formatOutput(
+        {
+          success: true,
+          data: {
+            original_record_id: recordId,
+            conversation_id: conv.conversation_id,
+            agent_config_id: agentConfigId,
+            agent_config_name: agentConfig.config_name,
+            user_name: userName,
+            context_messages_count: msgList.length,
+            trace_id: traceId,
+            reply: agentRecords
+          }
+        },
+        program2.opts().table
+      );
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  const data = debug.command("data").description("debug \u6570\u636E\u5DE5\u5177");
+  data.command("snapshot").description("\u751F\u6210\u53EF\u76F4\u63A5\u4F20\u7ED9 --data-overlay @file \u7684 debug_data_overlay v1 JSON").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").option("--product-id <id...>", "\u53EA\u5BFC\u51FA\u6307\u5B9A\u5546\u54C1 ID\uFF1B\u4E0D\u4F20\u5219\u5206\u9875\u5BFC\u51FA\u5168\u91CF\u5546\u54C1").action(async (opts) => {
+    try {
+      const snapshot = await buildDebugDataOverlaySnapshot({
+        agentConfigId: opts.agent,
+        productIds: opts.productId
+      });
+      process.stdout.write(`${JSON.stringify(snapshot, null, 2)}
+`);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  debug.command("trace").description(
+    "\u6839\u636E Langfuse Trace ID \u83B7\u53D6\u5B8C\u6574\u7684 Trace \u8BE6\u60C5\uFF08\u4ECE debug record \u8FD4\u56DE\u7684 flow_info \u4E2D\u63D0\u53D6 traceId\uFF09"
+  ).argument("<trace_id>", "Langfuse Trace ID\uFF08\u4ECE flow_info \u4E2D\u83B7\u53D6\uFF09").option("--env <env>", "langfuse \u73AF\u5883 dev|prod", "prod").action(async (traceId, opts) => {
+    try {
+      if (opts.env !== "dev" && opts.env !== "prod") {
+        outputError(1, "--env \u4EC5\u652F\u6301 dev \u6216 prod");
+        process.exit(1);
+      }
+      const data2 = await getLangfuseTrace(traceId, opts.env);
+      formatOutput({ success: true, data: data2 }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
+// src/client/faq-api.ts
+async function listFaqFiles(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/external", {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.agentConfigId,
+      page: opts.page ?? 1,
+      page_size: opts.pageSize ?? 20,
+      suffix_type: "_faq"
+    }
+  });
+}
+async function saveFaqContent(opts) {
+  const request = createRequest();
+  const body = {
+    chunks_to_delete: opts.chunksToDelete ?? [],
+    contents: opts.contents.map((c) => ({
+      content: c.content,
+      keywords: c.keywords ?? [],
+      enable: c.enable ?? true,
+      ...c.chunkId !== void 0 ? { chunk_id: c.chunkId } : {}
+    })),
+    answers: opts.answers
+  };
+  if (opts.answerGroupId !== void 0) {
     body.answer_group_id = opts.answerGroupId;
   }
   return request(
@@ -2035,33 +2559,469 @@ async function saveFaqContent(opts) {
       method: "POST",
       body
     }
-  );
+  );
+}
+async function listFaqContents(opts) {
+  const request = createRequest();
+  return request(
+    getAiApiUrl(),
+    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/faq_contents`,
+    {
+      method: "GET",
+      query: {
+        page_size: opts.pageSize ?? 20,
+        search_words: opts.searchWords,
+        next_group_id: opts.nextGroupId,
+        need_total: opts.needTotal ?? true
+      }
+    }
+  );
+}
+async function deleteFaqGroup(opts) {
+  const request = createRequest();
+  return request(
+    getAiApiUrl(),
+    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/faq_contents/${opts.answerGroupId}`,
+    {
+      method: "DELETE"
+    }
+  );
+}
+
+// src/client/knowledge-api.ts
+async function listExternalKnowledge(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/knowledge/external", {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.agentConfigId,
+      page: opts.page ?? 1,
+      page_size: opts.pageSize ?? 20,
+      suffix_type: "_common"
+    }
+  });
+}
+async function listKnowledgeContents(opts) {
+  const request = createRequest();
+  return request(getAiApiUrl(), `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents`, {
+    method: "GET",
+    query: {
+      page_size: opts.pageSize ?? 20,
+      need_total: opts.needTotal ?? true,
+      direction: opts.direction ?? "down"
+    }
+  });
+}
+async function addKnowledgeContent(opts) {
+  const request = createRequest();
+  const ts = (opts.now ?? Date.now)();
+  const identifier = `temp_${ts}`;
+  const body = {
+    operations: [
+      {
+        action: "add",
+        original_identifier: opts.afterChunkId ?? "0",
+        identifier
+      }
+    ],
+    content_updates: { [identifier]: opts.content },
+    keywords_updates: { [identifier]: opts.keywords ?? [] },
+    extra_info_updates: { [identifier]: { chunk_status: "done" } }
+  };
+  return request(
+    getAiApiUrl(),
+    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
+    {
+      method: "POST",
+      body
+    }
+  );
+}
+async function updateKnowledgeContent(opts) {
+  const request = createRequest();
+  const operation = {
+    action: "update",
+    identifier: opts.chunkId,
+    enable: opts.enable
+  };
+  const contentUpdates = opts.content !== void 0 ? { [opts.chunkId]: opts.content } : {};
+  const keywordsUpdates = opts.keywords !== void 0 ? { [opts.chunkId]: opts.keywords } : {};
+  const extraInfoUpdates = opts.content !== void 0 || opts.keywords !== void 0 ? { [opts.chunkId]: { chunk_status: "done" } } : {};
+  const body = {
+    operations: [operation],
+    content_updates: contentUpdates,
+    keywords_updates: keywordsUpdates,
+    extra_info_updates: extraInfoUpdates
+  };
+  return request(
+    getAiApiUrl(),
+    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
+    {
+      method: "POST",
+      body
+    }
+  );
+}
+async function findKnowledgeChunk(opts) {
+  const result = await listKnowledgeContents({
+    knowledgeId: opts.knowledgeId,
+    pageSize: opts.pageSize ?? 500,
+    needTotal: true,
+    direction: "down"
+  });
+  return result.contents?.find((c) => c.chunk_id === opts.chunkId);
+}
+async function deleteKnowledgeContent(opts) {
+  const request = createRequest();
+  const body = {
+    operations: [{ action: "delete", identifier: opts.chunkId }],
+    content_updates: {},
+    keywords_updates: {},
+    extra_info_updates: {}
+  };
+  return request(
+    getAiApiUrl(),
+    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
+    {
+      method: "POST",
+      body
+    }
+  );
+}
+
+// src/client/product-knowledge-binding-api.ts
+var PATH_PREFIX2 = "/v1/knowledge/product-bindings";
+async function listProductKnowledgeBindings(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.agentConfigId,
+      product_id: opts.productId,
+      knowledge_type: opts.knowledgeType,
+      file_id: opts.fileId
+    }
+  });
+}
+async function replaceProductKnowledgeBindingsByProduct(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/by-product`, {
+    method: "PUT",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      product_id: opts.productId,
+      bindings: opts.bindings
+    }
+  });
 }
-async function listFaqContents(opts) {
+async function replaceProductKnowledgeBindingsByFile(opts) {
   const request = createRequest();
-  return request(
-    getAiApiUrl(),
-    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/faq_contents`,
-    {
-      method: "GET",
-      query: {
-        page_size: opts.pageSize ?? 20,
-        search_words: opts.searchWords,
-        next_group_id: opts.nextGroupId,
-        need_total: opts.needTotal ?? true
-      }
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/by-file`, {
+    method: "PUT",
+    body: {
+      customer_agent_config_id: opts.agentConfigId,
+      knowledge_type: opts.knowledgeType,
+      file_id: opts.fileId,
+      file_name: opts.fileName,
+      partition_id: opts.partitionId,
+      partition_name: opts.partitionName,
+      products: opts.productIds.map((product_id) => ({ product_id }))
     }
-  );
+  });
 }
-async function deleteFaqGroup(opts) {
-  const request = createRequest();
-  return request(
-    getAiApiUrl(),
-    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/faq_contents/${opts.answerGroupId}`,
-    {
-      method: "DELETE"
+
+// src/commands/product-knowledge-binding.ts
+function parsePositiveInt(value, fieldName) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`${fieldName} \u5FC5\u987B\u4E3A\u6B63\u6574\u6570`);
+  }
+  return n;
+}
+function parseKnowledgeType(value) {
+  if (value === "qa" || value === "common") return value;
+  throw new Error("--type \u4EC5\u63A5\u53D7 qa | common");
+}
+function dedupeStrings(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const value of values) {
+    const trimmed = String(value || "").trim();
+    if (!trimmed || seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    result.push(trimmed);
+  }
+  return result;
+}
+function bindingKey(item) {
+  return `${item.knowledge_type}:${item.file_id}`;
+}
+function toBindingInput(item) {
+  return {
+    knowledge_type: item.knowledge_type,
+    file_id: parsePositiveInt(item.file_id, "file_id"),
+    file_name: item.file_name ?? null,
+    partition_id: parsePositiveInt(item.partition_id, "partition_id"),
+    partition_name: item.partition_name ?? null
+  };
+}
+function normalizeBindingInput(value) {
+  if (!value || typeof value !== "object") {
+    throw new Error("bindings \u6BCF\u9879\u5FC5\u987B\u662F\u5BF9\u8C61");
+  }
+  const item = value;
+  return {
+    knowledge_type: parseKnowledgeType(String(item.knowledge_type ?? "")),
+    file_id: parsePositiveInt(item.file_id, "file_id"),
+    file_name: item.file_name ?? null,
+    partition_id: parsePositiveInt(item.partition_id, "partition_id"),
+    partition_name: item.partition_name ?? null
+  };
+}
+function parseBindingsOption(raw) {
+  const parsed = parseDataOption(raw);
+  if (!Array.isArray(parsed)) {
+    throw new Error("--bindings \u5FC5\u987B\u662F\u6570\u7EC4");
+  }
+  return parsed.map(normalizeBindingInput);
+}
+function fileIdOf(item) {
+  return parsePositiveInt(item.knowledge_id ?? item.file_id, "file_id");
+}
+function partitionIdOf(item) {
+  return parsePositiveInt(item.partition_id, "partition_id");
+}
+function failWithMessage(message) {
+  outputError(1, message);
+  process.exit(1);
+}
+async function listFilesByType(knowledgeType, agentConfigId) {
+  const result = knowledgeType === "qa" ? await listFaqFiles({ agentConfigId, page: 1, pageSize: 100 }) : await listExternalKnowledge({ agentConfigId, page: 1, pageSize: 100 });
+  return result.items ?? [];
+}
+async function resolveFile(opts) {
+  if (opts.file && (opts.fileId || opts.partitionId)) {
+    throw new Error("--file \u4E0E --file-id/--partition-id \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528");
+  }
+  if (opts.file) {
+    const files = await listFilesByType(opts.knowledgeType, opts.agentConfigId);
+    const matched = files.filter((item2) => item2.file_name === opts.file);
+    if (matched.length === 0) {
+      failWithMessage(`\u672A\u627E\u5230\u77E5\u8BC6\u5E93\u6587\u4EF6: ${opts.file}`);
     }
-  );
+    if (matched.length > 1) {
+      failWithMessage(`\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\u4E0D\u552F\u4E00: ${opts.file}\uFF0C\u8BF7\u6539\u7528 --file-id/--partition-id`);
+    }
+    const item = matched[0];
+    return {
+      fileId: fileIdOf(item),
+      fileName: item.file_name ?? opts.file,
+      partitionId: partitionIdOf(item),
+      partitionName: item.partition_name ?? null
+    };
+  }
+  if (!opts.fileId || !opts.partitionId) {
+    throw new Error("\u8BF7\u63D0\u4F9B --file \u6216\u540C\u65F6\u63D0\u4F9B --file-id \u4E0E --partition-id");
+  }
+  return {
+    fileId: parsePositiveInt(opts.fileId, "file_id"),
+    fileName: opts.fileName,
+    partitionId: parsePositiveInt(opts.partitionId, "partition_id"),
+    partitionName: opts.partitionName
+  };
+}
+async function replaceProductBindings(opts) {
+  return replaceProductKnowledgeBindingsByProduct({
+    agentConfigId: opts.agentConfigId,
+    productId: opts.productId,
+    bindings: opts.bindings
+  });
+}
+async function getProductBindingInputs(opts) {
+  const current = await listProductKnowledgeBindings({
+    agentConfigId: opts.agentConfigId,
+    productId: opts.productId
+  });
+  return (current.items ?? []).map(toBindingInput);
+}
+async function replaceFileBindings(opts) {
+  return replaceProductKnowledgeBindingsByFile({
+    agentConfigId: opts.agentConfigId,
+    knowledgeType: opts.knowledgeType,
+    fileId: opts.file.fileId,
+    fileName: opts.file.fileName,
+    partitionId: opts.file.partitionId,
+    partitionName: opts.file.partitionName,
+    productIds: opts.productIds
+  });
+}
+async function getFileProductIds(opts) {
+  const current = await listProductKnowledgeBindings({
+    agentConfigId: opts.agentConfigId,
+    knowledgeType: opts.knowledgeType,
+    fileId: opts.fileId
+  });
+  return dedupeStrings((current.items ?? []).map((item) => item.product_id));
+}
+function handleError(err) {
+  reportCaughtError(err);
+  process.exit(toExitCode(err));
+}
+function registerProductRelatedKnowledgeCommand(product, program2) {
+  const related = product.command("related-knowledge").description("\u5546\u54C1\u8BE6\u60C5\u5173\u8054\u77E5\u8BC6\u5E93\u6587\u4EF6\u7BA1\u7406\uFF1Alist / add / remove / set");
+  related.command("list").description("\u5217\u51FA\u6307\u5B9A\u5546\u54C1\u7ED1\u5B9A\u7684 QA / \u6269\u5C55\u77E5\u8BC6\u5E93\u6587\u4EF6").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").requiredOption("--product-id <product_id>", "\u5546\u54C1 ID").action(async (opts) => {
+    try {
+      const data = await listProductKnowledgeBindings({
+        agentConfigId: opts.agent,
+        productId: opts.productId
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  related.command("add").description(
+    "\u7ED9\u5546\u54C1\u8FFD\u52A0\u4E00\u4E2A\u5173\u8054\u77E5\u8BC6\u5E93\u6587\u4EF6\u3002\u652F\u6301 --file \u7CBE\u786E\u5339\u914D\uFF0C\u6216\u663E\u5F0F\u4F20 --file-id + --partition-id"
+  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").requiredOption("--product-id <product_id>", "\u5546\u54C1 ID").requiredOption("--type <qa|common>", "\u77E5\u8BC6\u5E93\u7C7B\u578B\uFF1Aqa \u6216 common").option("--file <exact_name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\uFF0C\u7CBE\u786E\u5339\u914D").option("--file-id <id>", "\u77E5\u8BC6\u5E93\u6587\u4EF6 ID").option("--file-name <name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\u5FEB\u7167").option("--partition-id <id>", "\u77E5\u8BC6\u5E93\u5206\u533A ID").option("--partition-name <name>", "\u77E5\u8BC6\u5E93\u5206\u533A\u540D\u5FEB\u7167").action(async (opts) => {
+    try {
+      const knowledgeType = parseKnowledgeType(opts.type);
+      const file = await resolveFile({ ...opts, agentConfigId: opts.agent, knowledgeType });
+      const current = await getProductBindingInputs({
+        agentConfigId: opts.agent,
+        productId: opts.productId
+      });
+      const byKey = new Map(current.map((item) => [bindingKey(item), item]));
+      byKey.set(bindingKey({ knowledge_type: knowledgeType, file_id: file.fileId }), {
+        knowledge_type: knowledgeType,
+        file_id: file.fileId,
+        file_name: file.fileName ?? null,
+        partition_id: file.partitionId,
+        partition_name: file.partitionName ?? null
+      });
+      const data = await replaceProductBindings({
+        agentConfigId: opts.agent,
+        productId: opts.productId,
+        bindings: Array.from(byKey.values())
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  related.command("remove").description("\u79FB\u9664\u5546\u54C1\u7ED1\u5B9A\u7684\u4E00\u4E2A\u77E5\u8BC6\u5E93\u6587\u4EF6\uFF1B\u76EE\u6807\u4E0D\u5B58\u5728\u65F6\u4FDD\u6301\u5E42\u7B49\u6210\u529F").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").requiredOption("--product-id <product_id>", "\u5546\u54C1 ID").requiredOption("--type <qa|common>", "\u77E5\u8BC6\u5E93\u7C7B\u578B\uFF1Aqa \u6216 common").requiredOption("--file-id <id>", "\u77E5\u8BC6\u5E93\u6587\u4EF6 ID").action(async (opts) => {
+    try {
+      const knowledgeType = parseKnowledgeType(opts.type);
+      const fileId = parsePositiveInt(opts.fileId, "file_id");
+      const current = await getProductBindingInputs({
+        agentConfigId: opts.agent,
+        productId: opts.productId
+      });
+      const next = current.filter(
+        (item) => !(item.knowledge_type === knowledgeType && item.file_id === fileId)
+      );
+      const data = await replaceProductBindings({
+        agentConfigId: opts.agent,
+        productId: opts.productId,
+        bindings: next
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  related.command("set").description("\u8986\u76D6\u6307\u5B9A\u5546\u54C1\u7684\u5168\u90E8\u5173\u8054\u77E5\u8BC6\u5E93\u6587\u4EF6\u3002--bindings \u652F\u6301 JSON \u6216 @file").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").requiredOption("--product-id <product_id>", "\u5546\u54C1 ID").requiredOption("--bindings <json>", "\u7ED1\u5B9A\u6570\u7EC4 JSON \u6216 @\u6587\u4EF6\u8DEF\u5F84").action(async (opts) => {
+    try {
+      const bindings = parseBindingsOption(opts.bindings);
+      const data = await replaceProductBindings({
+        agentConfigId: opts.agent,
+        productId: opts.productId,
+        bindings
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
+function registerKnowledgeFileBindProductsCommand(parent, program2, kind) {
+  const knowledgeType = kind === "faq" ? "qa" : "common";
+  const bind = parent.command("bind-products").description("\u77E5\u8BC6\u5E93\u6587\u4EF6\u7ED1\u5B9A\u5546\u54C1\u7BA1\u7406\uFF1Alist / add / remove / set");
+  function addFileOptions(command) {
+    return command.requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").option("--file <exact_name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\uFF0C\u7CBE\u786E\u5339\u914D").option("--file-id <id>", "\u77E5\u8BC6\u5E93\u6587\u4EF6 ID").option("--file-name <name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\u5FEB\u7167").option("--partition-id <id>", "\u77E5\u8BC6\u5E93\u5206\u533A ID").option("--partition-name <name>", "\u77E5\u8BC6\u5E93\u5206\u533A\u540D\u5FEB\u7167");
+  }
+  bind.command("list").description("\u5217\u51FA\u6307\u5B9A\u77E5\u8BC6\u5E93\u6587\u4EF6\u7ED1\u5B9A\u7684\u5546\u54C1").requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID").option("--file <exact_name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\uFF0C\u7CBE\u786E\u5339\u914D").option("--file-id <id>", "\u77E5\u8BC6\u5E93\u6587\u4EF6 ID").option("--file-name <name>", "\u77E5\u8BC6\u5E93\u6587\u4EF6\u540D\u5FEB\u7167").option("--partition-id <id>", "\u77E5\u8BC6\u5E93\u5206\u533A ID").option("--partition-name <name>", "\u77E5\u8BC6\u5E93\u5206\u533A\u540D\u5FEB\u7167").action(async (opts) => {
+    try {
+      const file = await resolveFile({ ...opts, agentConfigId: opts.agent, knowledgeType });
+      const data = await listProductKnowledgeBindings({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        fileId: file.fileId
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  addFileOptions(
+    bind.command("add").description("\u7ED9\u77E5\u8BC6\u5E93\u6587\u4EF6\u8FFD\u52A0\u7ED1\u5B9A\u5546\u54C1\uFF1B\u5DF2\u7ED1\u5B9A\u5546\u54C1\u4F1A\u81EA\u52A8\u53BB\u91CD").requiredOption("--product-id <id...>", "\u5546\u54C1 ID\uFF0C\u53EF\u4F20\u591A\u4E2A")
+  ).action(async (opts) => {
+    try {
+      const file = await resolveFile({ ...opts, agentConfigId: opts.agent, knowledgeType });
+      const currentIds = await getFileProductIds({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        fileId: file.fileId
+      });
+      const productIds = dedupeStrings([...currentIds, ...opts.productId ?? []]);
+      const data = await replaceFileBindings({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        file,
+        productIds
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  addFileOptions(
+    bind.command("remove").description("\u4ECE\u77E5\u8BC6\u5E93\u6587\u4EF6\u79FB\u9664\u7ED1\u5B9A\u5546\u54C1\uFF1B\u76EE\u6807\u4E0D\u5B58\u5728\u65F6\u4FDD\u6301\u5E42\u7B49\u6210\u529F").requiredOption("--product-id <id...>", "\u5546\u54C1 ID\uFF0C\u53EF\u4F20\u591A\u4E2A")
+  ).action(async (opts) => {
+    try {
+      const file = await resolveFile({ ...opts, agentConfigId: opts.agent, knowledgeType });
+      const removing = new Set(dedupeStrings(opts.productId ?? []));
+      const currentIds = await getFileProductIds({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        fileId: file.fileId
+      });
+      const data = await replaceFileBindings({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        file,
+        productIds: currentIds.filter((productId) => !removing.has(productId))
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+  addFileOptions(
+    bind.command("set").description("\u8986\u76D6\u77E5\u8BC6\u5E93\u6587\u4EF6\u7ED1\u5B9A\u7684\u5168\u90E8\u5546\u54C1").requiredOption("--product-id <id...>", "\u5546\u54C1 ID\uFF0C\u53EF\u4F20\u591A\u4E2A")
+  ).action(async (opts) => {
+    try {
+      const file = await resolveFile({ ...opts, agentConfigId: opts.agent, knowledgeType });
+      const data = await replaceFileBindings({
+        agentConfigId: opts.agent,
+        knowledgeType,
+        file,
+        productIds: dedupeStrings(opts.productId ?? [])
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      handleError(err);
+    }
+  });
 }
 
 // src/commands/faq.ts
@@ -2196,6 +3156,7 @@ function registerFaqCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  registerKnowledgeFileBindProductsCommand(faq, program2, "faq");
 }
 
 // src/client/issue-api.ts
@@ -2261,11 +3222,9 @@ async function getIssueStats(opts) {
   const query = {};
   if (opts.dateStart) query.date_start = opts.dateStart;
   if (opts.dateEnd) query.date_end = opts.dateEnd;
-  const result = await request(getCustomerAgentUrl(), "/api/issues/stats", {
+  const result = await request(getCsAdminUrl(), "/api/issues/stats", {
     method: "GET",
-    query,
-    headers: buildCookieHeaders(),
-    skipAuth: true
+    query
   });
   return result.data ?? result;
 }
@@ -2926,148 +3885,45 @@ function registerIssueCommand(program2) {
     try {
       const data = await listIssueComments(issueId);
       formatOutput({ success: true, data }, program2.opts().table);
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
-    }
-  });
-  comment.command("add").description("\u6DFB\u52A0\u8BC4\u8BBA").argument("<issue_id>", "\u5DE5\u5355 ID").requiredOption("--content <text>", "\u8BC4\u8BBA\u5185\u5BB9").action(async (issueId, opts) => {
-    try {
-      const data = await addIssueComment(issueId, opts.content);
-      formatOutput({ success: true, data }, program2.opts().table);
-    } catch (err) {
-      reportCaughtError(err);
-      process.exit(toExitCode(err));
-    }
-  });
-}
-async function resolveSessionsForIssues(issues, workspaceId) {
-  const out = [];
-  for (let i = 0; i < issues.length; i++) {
-    const it = issues[i];
-    let conversationId;
-    if (it.conversation_id) {
-      conversationId = it.conversation_id;
-    } else if (it.user_name) {
-      try {
-        conversationId = await resolveSession({ userName: it.user_name, workspaceId });
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new Error(`issues[${i}] \u53CD\u67E5\u4F1A\u8BDD\u5931\u8D25\uFF1A${msg}`);
-      }
-    } else {
-      throw new Error(`issues[${i}] \u65E2\u65E0 conversation_id \u4E5F\u65E0 user_name`);
-    }
-    out.push({ issue: it, conversationId });
-  }
-  return out;
-}
-
-// src/commands/knowledge.ts
-import fs8 from "fs";
-
-// src/client/knowledge-api.ts
-async function listExternalKnowledge(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/external", {
-    method: "GET",
-    query: {
-      customer_agent_config_id: opts.agentConfigId,
-      page: opts.page ?? 1,
-      page_size: opts.pageSize ?? 20,
-      suffix_type: "_common"
-    }
-  });
-}
-async function listKnowledgeContents(opts) {
-  const request = createRequest();
-  return request(getAiApiUrl(), `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents`, {
-    method: "GET",
-    query: {
-      page_size: opts.pageSize ?? 20,
-      need_total: opts.needTotal ?? true,
-      direction: opts.direction ?? "down"
-    }
-  });
-}
-async function addKnowledgeContent(opts) {
-  const request = createRequest();
-  const ts = (opts.now ?? Date.now)();
-  const identifier = `temp_${ts}`;
-  const body = {
-    operations: [
-      {
-        action: "add",
-        original_identifier: opts.afterChunkId ?? "0",
-        identifier
-      }
-    ],
-    content_updates: { [identifier]: opts.content },
-    keywords_updates: { [identifier]: opts.keywords ?? [] },
-    extra_info_updates: { [identifier]: { chunk_status: "done" } }
-  };
-  return request(
-    getAiApiUrl(),
-    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
-    {
-      method: "POST",
-      body
-    }
-  );
-}
-async function updateKnowledgeContent(opts) {
-  const request = createRequest();
-  const operation = {
-    action: "update",
-    identifier: opts.chunkId,
-    enable: opts.enable
-  };
-  const contentUpdates = opts.content !== void 0 ? { [opts.chunkId]: opts.content } : {};
-  const keywordsUpdates = opts.keywords !== void 0 ? { [opts.chunkId]: opts.keywords } : {};
-  const extraInfoUpdates = opts.content !== void 0 || opts.keywords !== void 0 ? { [opts.chunkId]: { chunk_status: "done" } } : {};
-  const body = {
-    operations: [operation],
-    content_updates: contentUpdates,
-    keywords_updates: keywordsUpdates,
-    extra_info_updates: extraInfoUpdates
-  };
-  return request(
-    getAiApiUrl(),
-    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
-    {
-      method: "POST",
-      body
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  comment.command("add").description("\u6DFB\u52A0\u8BC4\u8BBA").argument("<issue_id>", "\u5DE5\u5355 ID").requiredOption("--content <text>", "\u8BC4\u8BBA\u5185\u5BB9").action(async (issueId, opts) => {
+    try {
+      const data = await addIssueComment(issueId, opts.content);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
     }
-  );
-}
-async function findKnowledgeChunk(opts) {
-  const result = await listKnowledgeContents({
-    knowledgeId: opts.knowledgeId,
-    pageSize: opts.pageSize ?? 500,
-    needTotal: true,
-    direction: "down"
   });
-  return result.contents?.find((c) => c.chunk_id === opts.chunkId);
 }
-async function deleteKnowledgeContent(opts) {
-  const request = createRequest();
-  const body = {
-    operations: [{ action: "delete", identifier: opts.chunkId }],
-    content_updates: {},
-    keywords_updates: {},
-    extra_info_updates: {}
-  };
-  return request(
-    getAiApiUrl(),
-    `/mebsuta/api/v1/dataset/${opts.knowledgeId}/contents/perform-operations`,
-    {
-      method: "POST",
-      body
+async function resolveSessionsForIssues(issues, workspaceId) {
+  const out = [];
+  for (let i = 0; i < issues.length; i++) {
+    const it = issues[i];
+    let conversationId;
+    if (it.conversation_id) {
+      conversationId = it.conversation_id;
+    } else if (it.user_name) {
+      try {
+        conversationId = await resolveSession({ userName: it.user_name, workspaceId });
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`issues[${i}] \u53CD\u67E5\u4F1A\u8BDD\u5931\u8D25\uFF1A${msg}`);
+      }
+    } else {
+      throw new Error(`issues[${i}] \u65E2\u65E0 conversation_id \u4E5F\u65E0 user_name`);
     }
-  );
+    out.push({ issue: it, conversationId });
+  }
+  return out;
 }
 
 // src/commands/knowledge.ts
+import fs8 from "fs";
 function readContentArg(value) {
   if (value.startsWith("@")) {
     return fs8.readFileSync(value.slice(1), "utf-8");
@@ -3203,6 +4059,7 @@ function registerKnowledgeCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  registerKnowledgeFileBindProductsCommand(knowledge, program2, "common");
 }
 
 // src/client/monitor-api.ts
@@ -4136,7 +4993,7 @@ function registerOpsAgentCommand(program2) {
 }
 
 // src/client/operations-record-api.ts
-var PATH_PREFIX2 = "/v1/agent_operations_records";
+var PATH_PREFIX3 = "/v1/agent_operations_records";
 async function listOperationsRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -4144,34 +5001,34 @@ async function listOperationsRecords(opts) {
   if (opts.agentId) query.agent_id = opts.agentId;
   if (opts.page) query.page = opts.page;
   if (opts.pageSize) query.page_size = opts.pageSize;
-  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX3, {
     method: "GET",
     query
   });
 }
 async function getOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX3}/${recordId}`, {
     method: "GET"
   });
 }
 async function createOperationsRecord(data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX3, {
     method: "POST",
     body: data
   });
 }
 async function updateOperationsRecord(recordId, data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX3}/${recordId}`, {
     method: "PUT",
     body: data
   });
 }
 async function deleteOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX3}/${recordId}`, {
     method: "DELETE"
   });
 }
@@ -4249,114 +5106,6 @@ function registerOperationsRecordCommand(program2) {
   });
 }
 
-// src/client/product-api.ts
-async function listProducts(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/products", {
-    method: "GET",
-    query: {
-      customer_agent_config_id: opts.agentConfigId,
-      search: opts.keyword,
-      status: opts.status?.join(","),
-      tags: opts.tags?.length ? JSON.stringify(opts.tags) : void 0,
-      page: opts.page ?? 1,
-      page_size: opts.pageSize ?? 20
-    }
-  });
-}
-async function getProductDetail(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/product/detail", {
-    method: "GET",
-    query: {
-      customer_agent_config_id: opts.agentConfigId,
-      db_id: opts.dbId,
-      product_id: opts.productId
-    }
-  });
-}
-async function updateProduct(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/product/update", {
-    method: "POST",
-    body: {
-      data_id: opts.dataId,
-      knowledge_id: opts.knowledgeId,
-      db_id: opts.dbId,
-      update_dict: opts.updateDict
-    }
-  });
-}
-async function uploadProductByUrl(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/products/upload", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      source_type: opts.sourceType ?? "manual",
-      identify: opts.identify ?? true,
-      product_urls: opts.productUrls
-    }
-  });
-}
-async function uploadProductData(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/products/upload", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      source_type: opts.sourceType ?? "manual",
-      identify: opts.identify ?? true,
-      product_items: opts.productItems
-    }
-  });
-}
-async function updateSku(opts) {
-  if (!opts.skuId && !opts.sku) {
-    throw new Error("updateSku \u9700\u8981\u63D0\u4F9B sku \u6216 sku_id \u5176\u4E2D\u4E4B\u4E00");
-  }
-  const identifier = opts.skuId ? { sku_id: opts.skuId } : { sku: opts.sku };
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/sku/update", {
-    method: "POST",
-    body: {
-      ...identifier,
-      customer_agent_config_id: opts.agentConfigId,
-      update_dict: opts.updateDict
-    }
-  });
-}
-async function syncTaobaoProducts(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/authorized-shop/sync-taobao-products", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      skip_hash_check: opts.skipHashCheck ?? false,
-      sync_type: opts.syncType ?? "full"
-    }
-  });
-}
-async function syncSingleTaobaoProduct(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/authorized-shop/sync-single-product", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      product_id: opts.productId
-    }
-  });
-}
-async function identifyAllProducts(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/products/identify/all", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId
-    }
-  });
-}
-
 // src/commands/product.ts
 async function getDbId(agentConfigId) {
   const agent = await getAgent(agentConfigId);
@@ -4366,12 +5115,20 @@ async function getDbId(agentConfigId) {
   return agent.database_id;
 }
 async function findProduct(agentConfigId, productId) {
-  const result = await listProducts({ agentConfigId, page: 1, pageSize: 100 });
-  const matched = result.items?.find((p) => p.product_id === productId);
-  if (!matched) {
-    throw new Error(`\u672A\u627E\u5230\u5546\u54C1 product_id=${productId}`);
+  const pageSize = 100;
+  for (let page = 1; ; page += 1) {
+    const result = await listProducts({ agentConfigId, page, pageSize });
+    const items = result.items ?? [];
+    const matched = items.find((p) => p.product_id === productId);
+    if (matched) {
+      return matched;
+    }
+    const fetched = page * pageSize;
+    const exhausted = items.length < pageSize || typeof result.total === "number" && fetched >= result.total;
+    if (exhausted) {
+      throw new Error(`\u672A\u627E\u5230\u5546\u54C1 product_id=${productId}`);
+    }
   }
-  return matched;
 }
 function registerProductCommand(program2) {
   const product = program2.command("product").description(
@@ -4558,10 +5315,11 @@ function registerProductCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  registerProductRelatedKnowledgeCommand(product, program2);
 }
 
 // src/client/repair-record-api.ts
-var PATH_PREFIX3 = "/api/repair-records";
+var PATH_PREFIX4 = "/api/repair-records";
 async function listRepairRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -4570,21 +5328,21 @@ async function listRepairRecords(opts) {
   if (opts.workspaceId) query.workspace_id = opts.workspaceId;
   if (opts.page) query.page = opts.page;
   if (opts.pageSize) query.page_size = opts.pageSize;
-  return request(getCsAdminUrl(), PATH_PREFIX3, {
+  return request(getCsAdminUrl(), PATH_PREFIX4, {
     method: "GET",
     query
   });
 }
 async function createRepairRecord(data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), PATH_PREFIX3, {
+  return request(getCsAdminUrl(), PATH_PREFIX4, {
     method: "POST",
     body: data
   });
 }
 async function updateRepairRecord(recordId, data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), `${PATH_PREFIX3}/${recordId}`, {
+  return request(getCsAdminUrl(), `${PATH_PREFIX4}/${recordId}`, {
     method: "PUT",
     body: data
   });
@@ -4660,86 +5418,6 @@ function registerRepairRecordCommand(program2) {
   });
 }
 
-// src/client/sa-api.ts
-async function listSituationActions(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/list", {
-    method: "GET",
-    query: {
-      customer_agent_config_id: opts.agentConfigId,
-      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
-      event_first_label: opts.firstLabel ?? "",
-      event_second_label: opts.secondLabel ?? "",
-      page: opts.page ?? 1,
-      page_size: opts.pageSize ?? 500
-    }
-  });
-}
-async function searchSituationActions(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/search", {
-    method: "GET",
-    query: { customer_agent_config_id: opts.agentConfigId, keyword: opts.keyword }
-  });
-}
-async function createSituationAction(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/create", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
-      event_first_label: opts.firstLabel,
-      event_second_label: opts.secondLabel,
-      situation: opts.situation,
-      action: opts.action,
-      transfer_to_human: opts.transferToHuman ?? false
-    }
-  });
-}
-async function updateSituationAction(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/update", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      situation_action_id: opts.situationActionId,
-      sub_agent_intent: opts.subAgentIntent ?? "GENERAL_QA",
-      event_first_label: opts.firstLabel,
-      event_second_label: opts.secondLabel,
-      situation: opts.situation,
-      action: opts.action,
-      transfer_to_human: opts.transferToHuman ?? false
-    }
-  });
-}
-async function deleteSituationAction(opts) {
-  const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/knowledge/situation-actions/delete", {
-    method: "POST",
-    body: {
-      customer_agent_config_id: opts.agentConfigId,
-      situation_action_id: opts.situationActionId,
-      event_first_label: opts.firstLabel,
-      event_second_label: opts.secondLabel
-    }
-  });
-}
-async function listSituationActionVersions(opts) {
-  const request = createRequest();
-  return request(
-    getCustomerServiceUrl(),
-    "/v1/knowledge/situation-actions/list/versions",
-    {
-      method: "GET",
-      query: {
-        customer_agent_config_id: opts.agentConfigId,
-        situation_action_id: opts.situationActionId
-      }
-    }
-  );
-}
-
 // src/commands/sa.ts
 function registerSACommand(program2) {
   const sa = program2.command("sa").description(
@@ -5661,6 +6339,23 @@ 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) => {
+    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 data = await getPointsConsumes({ page, pageSize });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
   workspace.command("points-consumes-daily").description(
     "\u6309\u5929\u67E5\u8BE2\u5F53\u524D\u5DE5\u4F5C\u7A7A\u95F4\u7684\u79EF\u5206\u6D88\u8017\u3002\u9ED8\u8BA4\u6700\u8FD1 30 \u5929\uFF08end=\u4ECA\u5929\uFF0Cstart=\u4ECA\u5929-29d\uFF09\uFF0C\u8FD4\u56DE consume_date / total_consume_points \u5217\u8868"
   ).option("--start <YYYY-MM-DD>", "\u8D77\u59CB\u65E5\u671F\uFF08\u542B\uFF09\uFF0C\u9ED8\u8BA4\u4ECA\u5929-29d").option("--end <YYYY-MM-DD>", "\u7ED3\u675F\u65E5\u671F\uFF08\u542B\uFF09\uFF0C\u9ED8\u8BA4\u4ECA\u5929").action(async (opts) => {