@bty/customer-service-cli 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
-## 0.6.0 (2026-06-09)
+## 0.6.2 (2026-06-15)
+
+- `workspace` 新增 `points-consumes` 子命令：分页查询当前工作空间的积分账户消耗流水（`POST /v1/workspace/points_consumes`），支持 `--page` / `--page-size`，CLI 固定传 `debug: true`，返回中包含服务端 `extra` 调试字段。
+- `customer-servhub-api` 的 `POST /v1/workspace/points_consumes` 新增 `debug` 请求参数：默认 `false` 不返回 `extra`，传 `true` 时返回 `extra` 方便调试。
+
+## 0.6.1 (2026-06-11)
+
+- `product` 新增 `related-knowledge` 子命令组，支持按商品维护“关联知识库”文件级绑定：
+  - `product related-knowledge list --agent <id> --product-id <id>`：列出商品绑定的 QA / 扩展知识库文件。
+  - `product related-knowledge add --agent <id> --product-id <id> --type qa|common (--file <name> | --file-id <id> --partition-id <id>)`：给商品追加绑定文件，重复文件幂等去重。
+  - `product related-knowledge remove --agent <id> --product-id <id> --type qa|common --file-id <id>`：移除指定绑定，目标不存在时保持幂等。
+  - `product related-knowledge set --agent <id> --product-id <id> --bindings <json|@file>`：覆盖商品的全部关联知识库文件。
+- `faq` / `knowledge` 新增文件侧 `bind-products` 子命令组，分别固定写入 `knowledge_type=qa` / `knowledge_type=common`：
+  - `list`：按知识库文件反查绑定商品。
+  - `add` / `remove`：read-modify-replace 维护绑定商品，重复添加或移除不存在的商品保持幂等。
+  - `set`：覆盖该文件绑定的全部商品。
+- 新增 `product-knowledge-binding-api` 客户端封装，对接 customer-servhub-api `/v1/knowledge/product-bindings*` 现有接口；CLI 不改变服务端绑定表或 sop-engine 命中逻辑。
 
 - 新增 `node-template describe [--stage <s>]`：节点编写说明书命令（AI 编写前必读）——输出每个节点的职责/可编辑面/输出契约/平台锁定段，以及该节点可 `@引用` 的变量目录。纯静态、与具体 agent 无关，无需 `--agent`。
 - `node-template` 节点 stage 新增 `image_understanding` 伪 stage（图片理解方法论可配置化，spec 2026-06-08）：`describe` / `get` / `set-draft` / `publish` / `versions` / `version` / `restore` 均纳入；发布前 `{{}}` 合法性校验白名单同步放行。

package/README.md

@@ -227,6 +227,10 @@ cs-cli workspace points-consumes-daily --start 2026-04-01 --end 2026-04-23
 | `product identify-all --agent <id>` | 一键增强学习当前 Agent 下所有待增强商品 |
 | `product sync-taobao --agent <id> [--skip-hash-check] [--sync-type <full\|incremental>]` | 触发淘宝店铺商品同步 |
 | `product sync-taobao-item --agent <id> --product-id <商品ID>` | 触发单个淘宝商品同步 |
+| `product related-knowledge list --agent <id> --product-id <商品ID>` | 列出商品详情绑定的 QA / 扩展知识库文件 |
+| `product related-knowledge add --agent <id> --product-id <商品ID> --type <qa\|common> (--file <文件名> \| --file-id <id> --partition-id <id>)` | 给商品追加关联知识库文件 |
+| `product related-knowledge remove --agent <id> --product-id <商品ID> --type <qa\|common> --file-id <id>` | 移除商品绑定的指定知识库文件 |
+| `product related-knowledge set --agent <id> --product-id <商品ID> --bindings <json\|@file>` | 覆盖商品绑定的全部知识库文件 |
 
 `product update` 支持更新的字段包括：`卖点`、`补充知识`、`tag`、`参数`、`轮播图识别结果`、`商品详情页识别结果` 等。`--update` 接受 JSON 字符串或 `@文件路径`。
 
@@ -240,6 +244,8 @@ cs-cli workspace points-consumes-daily --start 2026-04-01 --end 2026-04-23
 
 注意：这两个命令仅对已开通“高级工具”的店铺 Agent 生效。未开通高级工具时，即使 `--agent` 已绑定淘宝授权店铺，请求也可能在服务端失败。
 
+`product related-knowledge` 管理商品详情的“关联知识库”文件级绑定。`--type qa` 对应 FAQ 知识库，`--type common` 对应扩展知识库。`add` / `remove` 会先读取当前绑定，再通过服务端全量替换接口写回；重复添加或移除不存在的文件保持幂等。`--file <文件名>` 会按当前 Agent 的知识库文件列表做精确匹配；文件名不存在或不唯一时，改用 `--file-id` + `--partition-id` 显式模式。
+
 ```bash
 # 更新卖点
 cs-cli product update --agent <id> --product-id <商品ID> --update '{"卖点":"新卖点内容"}'
@@ -255,6 +261,12 @@ cs-cli product update-sku --agent <id> --sku "颜色分类:粉红" --update '{"
 
 # 更新 SKU 补充知识（按 sku_id 定位，推荐）
 cs-cli product update-sku --agent <id> --sku-id 6072595054179 --update '{"补充知识":"说明内容"}'
+
+# 给商品绑定一个 FAQ 文件
+cs-cli product related-knowledge add --agent <id> --product-id <商品ID> --type qa --file "常见问题.xlsx"
+
+# 显式 ID 模式绑定扩展知识文件
+cs-cli product related-knowledge add --agent <id> --product-id <商品ID> --type common --file-id 622474 --partition-id 12345 --file-name "售后规则.md"
 ```
 
 
@@ -405,11 +417,17 @@ CLI 把 `description` + `expected` 拼成 `content`：
 | `faq add --agent <id> --file <文件名> --questions <问题1,问题2> --answers <答案=xxx>` | 添加 FAQ 内容 |
 | `faq update --agent <id> --file <文件名> --group-id <id> [--questions <...>] [--answers <...>] [--delete-chunks <id1,id2>]` | 更新已有 FAQ 答案组（`--questions` / `--answers` / `--delete-chunks` 至少一个） |
 | `faq delete --agent <id> --file <文件名> --group-id <id>` | 删除 FAQ 答案组 |
+| `faq bind-products list --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>)` | 列出 FAQ 文件绑定的商品 |
+| `faq bind-products add --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 给 FAQ 文件追加绑定商品 |
+| `faq bind-products remove --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 从 FAQ 文件移除绑定商品 |
+| `faq bind-products set --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 覆盖 FAQ 文件绑定的全部商品 |
 
 `faq content` 走 `GET /mebsuta/api/v1/dataset/{knowledge_id}/faq_contents`，列出文件内的答案组及其 `answer_group_id`，是 `faq update` / `faq delete` 拿 `--group-id` 的来源（`faq list` 只给文件，文件内的 group-id 要靠这条命令查）。支持 `--keyword` 搜索、`--page-size` 分页、`--next-group-id` 游标续翻。
 
 `faq update` 按 `answer_group_id` 定位目标组，POST 同一个 `faq_contents/save` 接口完成字段替换、问题替换与 chunk 级删除。`faq delete` 走 `DELETE /faq_contents/{group_id}` 整组删除。
 
+`faq bind-products` 固定写入 `knowledge_type=qa` 的商品绑定关系，适合从 FAQ 文件视角批量维护关联商品。`--file` 为精确文件名匹配；文件名不唯一时请传 `--file-id` 和 `--partition-id`。
+
 ### 扩展知识库 (`knowledge`)
 
 Agent 关联的通用规则知识库（`suffix_type=_common`），与 FAQ / 商品知识并列的第三类知识源，支持段落（chunk）级 CRUD，统一走 `/mebsuta/api/v1/dataset/{id}/contents/perform-operations`。
@@ -421,9 +439,15 @@ Agent 关联的通用规则知识库（`suffix_type=_common`），与 FAQ / 商
 | `knowledge content add --knowledge-id <id> --content <text\|@file> [--keyword <k...>] [--after <chunk_id>]` | 新增段落 |
 | `knowledge content update --knowledge-id <id> --chunk-id <id> [--content <text\|@file>] [--keyword <k...>] [--enable \| --disable]` | 更新段落（四个变更字段至少一个；未指定 `--enable` / `--disable` 时自动保留当前启停状态，避免后端 enable 必填校验失败） |
 | `knowledge content delete --knowledge-id <id> --chunk-id <id>` | 删除段落 |
+| `knowledge bind-products list --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>)` | 列出扩展知识文件绑定的商品 |
+| `knowledge bind-products add --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 给扩展知识文件追加绑定商品 |
+| `knowledge bind-products remove --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 从扩展知识文件移除绑定商品 |
+| `knowledge bind-products set --agent <id> (--file <文件名> \| --file-id <id> --partition-id <id>) --product-id <商品ID...>` | 覆盖扩展知识文件绑定的全部商品 |
 
 `knowledge content add` / `update` 的 `--content` 支持 `@路径` 前缀从文件读取**纯文本**（不是 JSON）。`--keyword` 为 variadic 选项，空格分隔多个关键词。
 
+`knowledge bind-products` 固定写入 `knowledge_type=common` 的商品绑定关系，适合从扩展知识文件视角批量维护关联商品。`add` / `remove` 会 read-modify-replace，重复添加或移除不存在的商品保持幂等。
+
 
 ### 会话管理 (`conversation`)
 
@@ -453,6 +477,14 @@ Agent 关联的通用规则知识库（`suffix_type=_common`），与 FAQ / 商
 
 `debug trace`（v0.4.0 起，**行为变更**）不再由 CLI 直连 Langfuse REST API，改为请求 customer-servhub-api 的 `GET /v1/debug/langfuse/trace/{trace_id}?env=<env>`，走 CLI 标准 Bearer 鉴权，由服务端按 env 选择 Langfuse 凭据并代理拉取 Trace。Trace ID 从 `debug record` 返回的 `trace_id` 字段获取。
 
+### 工作空间 (`workspace`)
+
+| 命令 | 说明 |
+| --- | --- |
+| `workspace list` | 列出当前账号可访问的工作空间 |
+| `workspace points-consumes [--page <n>] [--page-size <n>]` | 分页查询积分账户消耗流水，固定返回 `extra` 调试字段 |
+| `workspace points-consumes-daily [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>]` | 按天查询积分消耗趋势 |
+
 - `--env <dev|prod>`：指定 Langfuse 环境，默认 `prod`。只接受 `dev` / `prod`，传其它值命令直接报错并以非 0 退出（不发请求）。
 
 ```bash

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) {
@@ -2064,6 +2101,442 @@ async function deleteFaqGroup(opts) {
   );
 }
 
+// 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 replaceProductKnowledgeBindingsByFile(opts) {
+  const request = createRequest();
+  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 }))
+    }
+  });
+}
+
+// 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
 function parseQuestions(input) {
   return input.split(",").map((q) => q.trim()).filter((q) => q.length > 0).map((q) => ({ content: q, keywords: [], enable: true }));
@@ -2196,6 +2669,7 @@ function registerFaqCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  registerKnowledgeFileBindProductsCommand(faq, program2, "faq");
 }
 
 // src/client/issue-api.ts
@@ -2261,11 +2735,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;
 }
@@ -2965,109 +3437,6 @@ async function resolveSessionsForIssues(issues, workspaceId) {
 
 // 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
-    }
-  );
-}
-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/commands/knowledge.ts
 function readContentArg(value) {
   if (value.startsWith("@")) {
     return fs8.readFileSync(value.slice(1), "utf-8");
@@ -3203,6 +3572,7 @@ function registerKnowledgeCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  registerKnowledgeFileBindProductsCommand(knowledge, program2, "common");
 }
 
 // src/client/monitor-api.ts
@@ -4136,7 +4506,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 +4514,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"
   });
 }
@@ -4558,10 +4928,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 +4941,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
   });
@@ -5661,6 +6032,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) => {

package/package.json

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