@bty/customer-service-cli 0.6.14 → 0.6.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.6.18 (2026-09-21)
+
+- `agent update` 只应传需要修改的字段：`--data` 的帮助文案不再宣传 `knowledge_base_config` / `database_config`，并明确提示不要 `agent get` 导出后整对象回传。这两个字段由服务端维护，`customer-servhub-api PUT /v1/customer-agent/{config_id}` 已改为拒绝更新（传入返回 400）。背景：整份回传会把知识库/数据库列表整份写回，并在 fork 时被放大成平台侧大量重复分区创建。
+
+## 0.6.17 (2026-09-10)
+
+- 新增 `product image-identify`：按自定义提示词只重新识别某一张主图/详情图，寻址用 `--main <n>` / `--detail <n>`（从 1 开始，二选一），`--prompt "..."`（支持 `@文件`）覆盖本次提示词。默认只打印新旧对照，`--apply` 才写回识别文字（main→`轮播图识别结果`，detail→`商品详情页识别结果`）；`--show-prompt` 只回当前生效提示词与解析出的图片 URL，不识别、不写回。对接 `customer-servhub-api POST /v1/knowledge/product/image/identify`。
+
+## 0.6.16 (2026-09-08)
+
+- 新增 `product shelf`：批量设置商品上下架状态，写 BTY「店铺商品目录」的「商品状态」列（合法值仅 `上架` / `下架`），与商品详情页的上架/下架下拉框同一个 `POST /v1/knowledge/product/update` 接口。标为 `下架` 后商品推荐类工具不再选中该商品（服务端据此派生只读的 `is_downshelf`）。商品用 `--ids` / `--ids-file` 指定；批量前先整体翻一遍商品列表建 `product_id → knowledge_id` 索引（避免逐个商品重复分页）；已是目标状态的商品跳过不写；每条写入后**回读校验**「商品状态」确实变更，防接口假成功。支持 `--concurrency`（默认 5）与 `--yes`（≥20 条时跳过二次确认），输出标准批量报告，部分失败退出码 2、全部失败 1。
+
 ## 0.6.14 (2026-09-02)
 
 - `agent fork` 新增 `--copy-authorized-shop-id`：与 `--clone-tools` 同用时，克隆的工具沿用来源工具的店铺授权 `authorized_shop_id`；默认关闭（清空），仅在用户明确要求全量复制工具时开启。

package/README.md

@@ -247,6 +247,7 @@ cs-cli workspace points-consumes-daily --start 2026-04-01 --end 2026-04-23
 | `product list --agent <id> [--keyword <关键词>] [--status <状态>] [--tag <标签>]` | 列出商品 |
 | `product get --agent <id> --product-id <商品ID>` | 获取商品详情（自动获取 db_id） |
 | `product update --agent <id> --product-id <商品ID> --update <json\|@file>` | 更新商品信息 |
+| `product shelf --agent <id> --status <上架\|下架> (--ids <id,id> \| --ids-file <path>) [--concurrency <n>] [--yes]` | 批量设置商品上下架状态（写「商品状态」列，写后回读校验） |
 | `product update-sku --agent <id> (--sku <SKU名称> \| --sku-id <id>) --update <json\|@file>` | 更新 SKU 信息（`--sku-id` 优先于 `--sku`） |
 | `product add --agent <id> --data <json\|@file> [--source <type>] [--no-identify]` | 直接传入结构化商品数据（JSON 数组）异步学习（manual / identify 默认开启） |
 | `product learn --agent <id> --url <URL...> [--source <type>] [--no-identify]` | 通过商品 URL 异步学习（manual / identify 默认开启） |

package/dist/bin.js

@@ -563,6 +563,13 @@ async function patchActivityEnabled(activityId, enabled) {
     body: { enabled }
   });
 }
+async function patchActivityFeatured(activityId, isFeatured) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}/featured`, {
+    method: "PATCH",
+    body: { is_featured: isFeatured }
+  });
+}
 async function deleteActivity(activityId) {
   const request = createRequest();
   return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}`, {
@@ -704,6 +711,19 @@ function registerActivityCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  activity.command("set-featured").description(
+    "\u5207\u6362\u5355\u6761\u6D3B\u52A8\u4E3B\u63A8\u72B6\u6001\uFF08\u5217\u8868\u884C toggle \u7528\uFF0CPATCH /featured\uFF09\u3002\u4EC5\u5199 is_featured \u4E00\u4E2A\u5B57\u6BB5"
+  ).argument("<activity_id>", "\u6D3B\u52A8 ID").requiredOption("--featured <bool>", "true | false").action(async (activityIdRaw, opts) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const featured = parseEnabledFlag(opts.featured);
+      const data = await patchActivityFeatured(activityId, featured);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
   activity.command("delete").description("\u8F6F\u5220\u6D3B\u52A8 + \u7EA7\u8054\u8F6F\u5220 activity_product \u5173\u8054").argument("<activity_id>", "\u6D3B\u52A8 ID").action(async (activityIdRaw) => {
     try {
       const activityId = parseActivityId(activityIdRaw);
@@ -800,10 +820,10 @@ function registerAgentCommand(program2) {
     }
   });
   agent.command("update").description(
-    "\u66F4\u65B0 Agent \u914D\u7F6E\uFF08\u5982 customer_config\u3001forbidden_words \u7B49\uFF09\u3002\u5EFA\u8BAE\u5148 agent get \u5BFC\u51FA\u5F53\u524D\u914D\u7F6E\u518D\u4FEE\u6539"
+    "\u66F4\u65B0 Agent \u914D\u7F6E\uFF08\u5982 customer_config\u3001forbidden_words \u7B49\uFF09\u3002\u53EA\u4F20\u9700\u8981\u4FEE\u6539\u7684\u5B57\u6BB5\uFF0C\u4E0D\u8981\u6574\u5BF9\u8C61\u56DE\u4F20"
   ).argument("<config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").requiredOption(
     "--data <json>",
-    "JSON \u6570\u636E\u6216 @\u6587\u4EF6\u8DEF\u5F84\u3002\u53EF\u66F4\u65B0\u5B57\u6BB5\u5305\u62EC customer_config\u3001forbidden_words\u3001knowledge_base_config \u7B49"
+    "JSON \u6570\u636E\u6216 @\u6587\u4EF6\u8DEF\u5F84\u3002\u53EF\u66F4\u65B0\u5B57\u6BB5\u5305\u62EC customer_config\u3001forbidden_words \u7B49\uFF1Bdatabase_config / knowledge_base_config \u7531\u670D\u52A1\u7AEF\u7EF4\u62A4\uFF0CCLI \u62D2\u7EDD\u66F4\u65B0"
   ).action(async (configId, opts) => {
     try {
       const body = parseDataOption(opts.data);
@@ -1784,6 +1804,9 @@ function csvToRows(csv) {
     return obj;
   });
 }
+function toPublicOssDownloadUrl(url) {
+  return url.replace("-internal.aliyuncs.com", ".aliyuncs.com");
+}
 async function exportShopData(opts) {
   const request = createRequest();
   const body = {
@@ -1797,10 +1820,11 @@ async function exportShopData(opts) {
     `${DASHBOARD_PREFIX}/export`,
     { method: "POST", body }
   );
-  const downloadUrl = data?.download_url;
-  if (!downloadUrl) {
+  const rawDownloadUrl = data?.download_url;
+  if (!rawDownloadUrl) {
     throw new APIError(1, "\u5BFC\u51FA\u63A5\u53E3\u672A\u8FD4\u56DE download_url");
   }
+  const downloadUrl = toPublicOssDownloadUrl(rawDownloadUrl);
   const timeoutMs = getRuntimeRequestTimeoutMs() ?? 6e4;
   const resp = await fetch(downloadUrl, { signal: AbortSignal.timeout(timeoutMs) });
   if (!resp.ok) {
@@ -2231,6 +2255,24 @@ async function syncSingleTaobaoProduct(opts) {
     }
   });
 }
+async function identifyProductImage(opts) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    "/v1/knowledge/product/image/identify",
+    {
+      method: "POST",
+      body: {
+        customer_agent_config_id: opts.agentConfigId,
+        product_id: opts.productId,
+        image_type: opts.imageType,
+        image_index: opts.imageIndex,
+        ...opts.prompt !== void 0 ? { prompt: opts.prompt } : {},
+        dry_run: opts.dryRun ?? false
+      }
+    }
+  );
+}
 async function identifyAllProducts(opts) {
   const request = createRequest();
   return request(getCustomerServiceUrl(), "/v1/knowledge/products/identify/all", {
@@ -5609,6 +5651,40 @@ function registerOpsAgentCommand(program2) {
 // src/commands/product.ts
 import fs10 from "fs";
 
+// src/lib/product-image.ts
+function applyImageRecognition(list, index0, value, imageUrl) {
+  const next = Array.isArray(list) ? list.map((item) => ({ ...item })) : [];
+  while (next.length <= index0) {
+    const fillIdx = next.length;
+    next.push({
+      [`image_url${fillIdx + 1}`]: "",
+      [`image_desc${fillIdx + 1}`]: ""
+    });
+  }
+  const urlKey = `image_url${index0 + 1}`;
+  const descKey = `image_desc${index0 + 1}`;
+  const existingUrl = next[index0]?.[urlKey] || "";
+  next[index0] = {
+    [urlKey]: existingUrl || imageUrl || "",
+    [descKey]: value
+  };
+  return next;
+}
+
+// src/lib/product-shelf.ts
+var SHELF_STATUSES = ["\u4E0A\u67B6", "\u4E0B\u67B6"];
+function normalizeShelfStatus(raw) {
+  return String(raw ?? "").trim() === "\u4E0B\u67B6" ? "\u4E0B\u67B6" : "\u4E0A\u67B6";
+}
+function parseShelfStatusOption(value) {
+  const normalized = String(value ?? "").trim();
+  const matched = SHELF_STATUSES.find((status) => status === normalized);
+  if (!matched) {
+    throw new Error(`--status \u53EA\u80FD\u662F ${SHELF_STATUSES.join(" \u6216 ")}\uFF0C\u6536\u5230: ${value}`);
+  }
+  return matched;
+}
+
 // src/lib/supplement.ts
 function parseSupplementField(value) {
   let current = value;
@@ -5698,6 +5774,57 @@ async function findProduct(agentConfigId, productId) {
     }
   }
 }
+async function buildProductIndex(agentConfigId) {
+  const pageSize = 100;
+  const index = /* @__PURE__ */ new Map();
+  for (let page = 1; ; page += 1) {
+    const result = await listProducts({ agentConfigId, page, pageSize });
+    const items = result.items ?? [];
+    for (const item of items) {
+      if (!index.has(item.product_id)) index.set(item.product_id, item.knowledge_id);
+    }
+    const fetched = page * pageSize;
+    const exhausted = items.length < pageSize || typeof result.total === "number" && fetched >= result.total;
+    if (exhausted) return index;
+  }
+}
+function resolveImageTarget(opts) {
+  const hasMain = opts.main !== void 0;
+  const hasDetail = opts.detail !== void 0;
+  if (hasMain === hasDetail) {
+    throw new Error("\u8BF7\u4E14\u4EC5\u6307\u5B9A --main <n> \u6216 --detail <n> \u5176\u4E2D\u4E4B\u4E00");
+  }
+  const rawValue = hasMain ? opts.main : opts.detail;
+  const imageIndex = Number.parseInt(rawValue, 10);
+  if (!Number.isInteger(imageIndex) || imageIndex < 1) {
+    throw new Error("\u56FE\u7247\u5E8F\u53F7\u5FC5\u987B\u662F\u4ECE 1 \u5F00\u59CB\u7684\u6B63\u6574\u6570");
+  }
+  return { imageType: hasMain ? "main" : "detail", imageIndex };
+}
+function readPromptText(value) {
+  if (value.startsWith("@")) {
+    const filePath = value.slice(1);
+    if (!filePath) {
+      throw new Error("@ \u540E\u7684\u6587\u4EF6\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    return fs10.readFileSync(filePath, "utf-8");
+  }
+  return value;
+}
+function parseRecognitionField(value) {
+  if (Array.isArray(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim()) {
+    try {
+      const parsed = JSON.parse(value);
+      return Array.isArray(parsed) ? parsed : [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
 async function loadProductSupplement(agentConfigId, productId) {
   const [dbId, matched] = await Promise.all([
     getDbId(agentConfigId),
@@ -5809,6 +5936,131 @@ function registerProductCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  product.command("image-identify").description(
+    "\u5355\u56FE\u91CD\u65B0\u8BC6\u522B\uFF1A\u6309\u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\u53EA\u91CD\u8BC6\u522B\u67D0\u4E00\u5F20\u4E3B\u56FE/\u8BE6\u60C5\u56FE\u3002\u9ED8\u8BA4\u53EA\u6253\u5370\u65B0\u65E7\u5BF9\u7167\uFF0C--apply \u624D\u5199\u56DE\u8BC6\u522B\u6587\u5B57\u3002--show-prompt \u53EA\u770B\u5F53\u524D\u751F\u6548\u63D0\u793A\u8BCD"
+  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").requiredOption("--product-id <product_id>", "\u5546\u54C1 ID\uFF08\u4ECE product list \u83B7\u53D6\uFF09").option("--main <n>", "\u7B2C\u51E0\u5F20\u4E3B\u56FE\uFF08\u4ECE 1 \u5F00\u59CB\uFF09\uFF0C\u4E0E --detail \u4E8C\u9009\u4E00").option("--detail <n>", "\u7B2C\u51E0\u5F20\u8BE6\u60C5\u56FE\uFF08\u4ECE 1 \u5F00\u59CB\uFF09\uFF0C\u4E0E --main \u4E8C\u9009\u4E00").option("--prompt <text|@file>", "\u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\uFF0C@\u524D\u7F00\u8BFB\u6587\u4EF6\uFF1B\u7559\u7A7A\u56DE\u9000\u5E73\u53F0\u9ED8\u8BA4").option("--show-prompt", "\u53EA\u6253\u5370\u5F53\u524D\u751F\u6548\u63D0\u793A\u8BCD\u4E0E\u89E3\u6790\u51FA\u7684\u56FE\u7247 URL\uFF0C\u4E0D\u8BC6\u522B\u3001\u4E0D\u5199\u56DE", false).option("--apply", "\u628A\u8BC6\u522B\u7ED3\u679C\u5199\u56DE\u5546\u54C1\u8BC6\u522B\u6587\u5B57\uFF08\u9ED8\u8BA4\u53EA\u6253\u5370\u5BF9\u7167\uFF09", false).action(async (opts) => {
+    try {
+      const { imageType, imageIndex } = resolveImageTarget(opts);
+      const prompt = opts.prompt !== void 0 ? readPromptText(opts.prompt) : void 0;
+      if (opts.showPrompt) {
+        const data = await identifyProductImage({
+          agentConfigId: opts.agent,
+          productId: opts.productId,
+          imageType,
+          imageIndex,
+          prompt,
+          dryRun: true
+        });
+        formatOutput({ success: true, data }, program2.opts().table);
+        return;
+      }
+      const result = await identifyProductImage({
+        agentConfigId: opts.agent,
+        productId: opts.productId,
+        imageType,
+        imageIndex,
+        prompt
+      });
+      if (!opts.apply) {
+        formatOutput({ success: true, data: { ...result, applied: false } }, program2.opts().table);
+        return;
+      }
+      const [dbId, matched] = await Promise.all([
+        getDbId(opts.agent),
+        findProduct(opts.agent, opts.productId)
+      ]);
+      const detail = await getProductDetail({
+        agentConfigId: opts.agent,
+        dbId,
+        productId: opts.productId
+      });
+      const field = imageType === "main" ? "\u8F6E\u64AD\u56FE\u8BC6\u522B\u7ED3\u679C" : "\u5546\u54C1\u8BE6\u60C5\u9875\u8BC6\u522B\u7ED3\u679C";
+      const nextList = applyImageRecognition(
+        parseRecognitionField(detail[field]),
+        imageIndex - 1,
+        result.identify_result,
+        result.image_url
+      );
+      await updateProduct({
+        dataId: detail.id,
+        knowledgeId: matched.knowledge_id,
+        dbId,
+        updateDict: { [field]: JSON.stringify(nextList) }
+      });
+      formatOutput({ success: true, data: { ...result, applied: true, field } }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  product.command("shelf").description(
+    "\u6279\u91CF\u8BBE\u7F6E\u5546\u54C1\u4E0A\u4E0B\u67B6\u72B6\u6001\uFF08\u5199 BTY\u300C\u5546\u54C1\u72B6\u6001\u300D\u5217\uFF0C\u4E0E\u5546\u54C1\u8BE6\u60C5\u9875\u7684\u4E0A\u67B6/\u4E0B\u67B6\u4E0B\u62C9\u6846\u540C\u4E00\u63A5\u53E3\uFF09\u3002\u6807\u4E3A\u300C\u4E0B\u67B6\u300D\u540E\u5546\u54C1\u63A8\u8350\u7C7B\u5DE5\u5177\u4E0D\u518D\u9009\u8BE5\u5546\u54C1\u3002\u6BCF\u6761\u5199\u5B8C\u56DE\u8BFB\u6821\u9A8C\uFF0C\u5DF2\u662F\u76EE\u6807\u72B6\u6001\u7684\u8DF3\u8FC7"
+  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001: \u4E0A\u67B6 | \u4E0B\u67B6").option("--ids <ids>", "\u5546\u54C1 ID\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u4E0E --ids-file \u4E8C\u9009\u4E00\uFF09").option("--ids-file <path>", "\u5546\u54C1 ID \u6587\u4EF6\uFF0C\u4E00\u884C\u4E00\u4E2A\uFF1B\u7A7A\u884C\u4E0E # \u5F00\u5934\u884C\u5FFD\u7565").option("--concurrency <n>", "\u5E76\u53D1\u6570\uFF08\u9ED8\u8BA4 5\uFF09", "5").option("--yes", "\u8DF3\u8FC7 20 \u6761\u4EE5\u4E0A\u7684\u4E8C\u6B21\u786E\u8BA4\uFF08CI / \u811A\u672C\uFF09").action(async (opts) => {
+    let batchReport = null;
+    try {
+      const status = parseShelfStatusOption(opts.status);
+      const ids = parseIdsInput({ ids: opts.ids, idsFile: opts.idsFile });
+      const concurrency = Number(opts.concurrency);
+      if (!Number.isFinite(concurrency) || concurrency < 1) {
+        throw new Error(`--concurrency \u5FC5\u987B\u4E3A\u6B63\u6574\u6570\uFF0C\u6536\u5230: ${opts.concurrency}`);
+      }
+      await confirmBatch({
+        count: ids.length,
+        action: `\u5C06\u5546\u54C1\u72B6\u6001\u6539\u4E3A\u300C${status}\u300D`,
+        yes: opts.yes
+      });
+      const [dbId, index] = await Promise.all([
+        getDbId(opts.agent),
+        buildProductIndex(opts.agent)
+      ]);
+      batchReport = await runBatch({
+        ids,
+        concurrency,
+        perItem: async (id) => {
+          const knowledgeId = index.get(id);
+          if (!knowledgeId) {
+            throw new Error(`\u672A\u627E\u5230\u5546\u54C1 product_id=${id}\uFF08\u4E0D\u5728\u8BE5 Agent \u7684\u5546\u54C1\u5E93\u91CC\uFF09`);
+          }
+          const detail = await getProductDetail({
+            agentConfigId: opts.agent,
+            dbId,
+            productId: id
+          });
+          if (normalizeShelfStatus(detail.\u5546\u54C1\u72B6\u6001) === status) {
+            return { status: "skipped", id, reason: `\u5DF2\u662F\u300C${status}\u300D` };
+          }
+          await updateProduct({
+            dataId: detail.id,
+            knowledgeId,
+            dbId,
+            updateDict: { \u5546\u54C1\u72B6\u6001: status }
+          });
+          const after = await getProductDetail({
+            agentConfigId: opts.agent,
+            dbId,
+            productId: id
+          });
+          const actual = normalizeShelfStatus(after.\u5546\u54C1\u72B6\u6001);
+          if (actual !== status) {
+            throw new Error(`\u56DE\u8BFB\u6821\u9A8C\u5931\u8D25\uFF1A\u671F\u671B\u300C${status}\u300D\uFF0C\u5B9E\u9645\u300C${actual}\u300D`);
+          }
+          return { status: "success", id };
+        }
+      });
+      formatOutput(
+        { success: batchReport.failed_count === 0, data: batchReport },
+        program2.opts().table
+      );
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+      return;
+    }
+    if (batchReport !== null) {
+      const code = reportToExitCode(batchReport);
+      if (code !== 0) process.exit(code);
+    }
+  });
   product.command("learn").description(
     "\u901A\u8FC7\u5546\u54C1 URL \u8BA9 Agent \u5B66\u4E60\u5546\u54C1\uFF08\u5F02\u6B65\u4E0A\u4F20\u8BC6\u522B\uFF09\uFF0C\u9ED8\u8BA4 source_type=manual / identify=true\u3002--no-identify \u53EF\u5173\u95ED\u81EA\u52A8\u8BC6\u522B"
   ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").requiredOption("--url <urls...>", "\u5546\u54C1 URL \u5217\u8868\uFF08\u53EF\u591A\u4E2A\uFF0C\u7A7A\u683C\u5206\u9694\uFF09").option("--source <type>", "\u6765\u6E90\u7C7B\u578B\uFF08\u5982 manual / batch\uFF09", "manual").option("--no-identify", "\u5173\u95ED\u81EA\u52A8\u8BC6\u522B\u5546\u54C1\u4FE1\u606F\uFF08\u9ED8\u8BA4\u5F00\u542F\uFF09").action(async (opts) => {

package/package.json

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