@bty/customer-service-cli 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.5.4 (2026-06-03)
+
+- `ops-agent` 新增 `conversations` 子命令：`ops-agent conversations [--agent-id <id>] [--customer-id <id>] [--page N] [--page-size N]`，对接 `GET /v1/ops-agent/conversations`，按当前 workspace 查询客服助手会话列表，返回 `workspace_id`、`customer_id`、`title`、`agent_id`、`created_at`、`updated_at`。
+- 补充 `ops-agent` 命令注册测试与 API 客户端测试，覆盖会话列表查询命令注册、请求路径、workspace 透传与筛选参数。
+- `product` 新增 `identify-all` 子命令：`product identify-all --agent <id>`，对接 `POST /v1/knowledge/products/identify/all`，为当前 Agent 一键提交所有待增强商品进入增强学习队列。
+- 补充 `product` CLI 测试与 API 客户端测试，覆盖增强学习命令注册、请求路径与请求体。
+- `testset` 新增 `create` 子命令：`testset create --customer-agent-config-id <id> --file <cases.xlsx> [--name <text>] [--description <text>] [--use-type <text>]`，对接 `POST /v1/test_sets/file/upload`，通过 xlsx 模板上传创建测试集。
+
+## 0.5.3 (2026-05-28)
+
+- 新增 `activity` 主语，覆盖活动 V2（Issue #34）增删改查 + per-tenant 总开关。对接 `customer-servhub-api /v1/activity*`，契约详情参见 [`docs/devkit/specs/2026-05-28-activity-v2-api-reference.md`](../../docs/devkit/specs/2026-05-28-activity-v2-api-reference.md)：
+  - `activity list --agent <id> [--page N] [--page-size N] [--search <text>]`：列出活动（含 `total`、`v2_activity_enabled`、`items[]`）。
+  - `activity by-product --agent <id> --product-id <id>`：按 product_id 反查当前生效活动（仅 enabled，items[].products 恒为 []）。
+  - `activity create --data <json|@file>`：创建活动（完整 `IActivityWritePayload`，文件路径加 `@` 前缀走 JSON 解析）。
+  - `activity update <activity_id> --data <json|@file>`：整体更新活动（products 整组替换，非增量 diff；customer_agent_config_id 不可变更）。
+  - `activity set-enabled <activity_id> --enabled true|false`：列表行 toggle 用，PATCH `/enabled`，仅写 enabled 一个字段。
+  - `activity delete <activity_id>`：软删活动 + 级联软删 activity_product 关联。
+  - `activity v2-enabled --agent <id> --enabled true|false`：per-tenant 总开关，写 `agent_activity_setting.v2_activity_enabled`，控制 sop V2 链路是否生效。
+- `activity_id` 路径参数本地校验为正整数；`--enabled` 仅接受 `true|false`，非法值直接报错优于让服务端 500。
+- 业务失败统一服务端 200 + `code:400`，CLI 透传为 `exit 1` + `INVALID_PAYLOAD: …` 消息。
+
 ## 0.5.2 (2026-05-28)
 
 **修复：`repair-record` 命令 404 问题**

package/README.md

@@ -224,6 +224,7 @@ cs-cli workspace points-consumes-daily --start 2026-04-01 --end 2026-04-23
 | `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 默认开启） |
+| `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>` | 触发单个淘宝商品同步 |
 
@@ -233,6 +234,8 @@ cs-cli workspace points-consumes-daily --start 2026-04-01 --end 2026-04-23
 
 `product learn` 提交商品详情页 URL 进入异步学习队列（`/v1/knowledge/products/upload`），返回 `flow_id` 和 `knowledge_ids`。`--url` 可多值，用空格分隔；`--source` 默认 `manual`；传 `--no-identify` 可关闭自动识别。
 
+`product identify-all` 对接 `POST /v1/knowledge/products/identify/all`，会为当前 Agent 一键提交所有“已可用但尚未增强”的商品进入增强学习队列。它不是全量重学；当没有待增强商品时，服务端会返回“暂无需要识图的商品”。
+
 `product sync-taobao` / `product sync-taobao-item` 调用 customer-servhub-api 的授权店铺同步接口，要求 `--agent` 已唯一绑定一个淘宝授权店铺。前者支持 `--sync-type full|incremental`，默认 `full`；后者按 `product_id` 补同步单个淘宝商品。
 
 注意：这两个命令仅对已开通“高级工具”的店铺 Agent 生效。未开通高级工具时，即使 `--agent` 已绑定淘宝授权店铺，请求也可能在服务端失败。
@@ -255,6 +258,47 @@ cs-cli product update-sku --agent <id> --sku-id 6072595054179 --update '{"补充
 ```
 
 
+### 活动管理 (`activity`)
+
+活动 V2（Issue #34）增删改查 + per-tenant V2 总开关。服务端 `customer-servhub-api /v1/activity*`；契约详情参见 [`docs/devkit/specs/2026-05-28-activity-v2-api-reference.md`](../../docs/devkit/specs/2026-05-28-activity-v2-api-reference.md)。
+
+| 命令 | 说明 |
+| --- | --- |
+| `activity list --agent <id> [--page N] [--page-size N] [--search <text>]` | 列出活动（返回 `total` / `v2_activity_enabled` / `items[]`） |
+| `activity by-product --agent <id> --product-id <id>` | 按 `product_id` 反查当前生效活动（仅 enabled、product_scope='all' 必入） |
+| `activity create --data <json\|@file>` | 创建活动（payload 见 `IActivityWritePayload`） |
+| `activity update <activity_id> --data <json\|@file>` | 整体更新活动（products 整组替换，非增量） |
+| `activity set-enabled <activity_id> --enabled <true\|false>` | 切换单条活动启用状态（仅写 enabled） |
+| `activity delete <activity_id>` | 软删活动 + 级联软删关联 |
+| `activity v2-enabled --agent <id> --enabled <true\|false>` | per-tenant 启停 V2 链路 |
+
+- `--agent <id>` 对应服务端 `customer_agent_config_id`（与 `sa` / `product` 命令同口径）。
+- `activity create` / `update` payload 必填：`customer_agent_config_id`、`activity_name`、`effective_type`、`activity_rule`；`effective_type=time_range` 要求 `start_time` + `end_time`；`product_scope='specific'`（缺省）要求 `products ≥ 1`。
+- 业务失败（参数非法 / 跨 workspace / 不存在）服务端返 HTTP 200 + `code:400`，CLI 转为 `exit 1` 并打印 `INVALID_PAYLOAD: …`。
+
+```bash
+# 列出活动
+cs-cli activity list --agent <cfg_id> --search 返现
+
+# 按商品反查
+cs-cli activity by-product --agent <cfg_id> --product-id 914494989518
+
+# 创建活动（从文件读 payload）
+cs-cli activity create --data @activity.json
+
+# 整体更新
+cs-cli activity update 6 --data @activity.json
+
+# 列表行 toggle 启用
+cs-cli activity set-enabled 6 --enabled false
+
+# 软删活动
+cs-cli activity delete 6
+
+# 为某 agent 启用 V2 链路
+cs-cli activity v2-enabled --agent <cfg_id> --enabled true
+```
+
 ### 工单管理 (`issue`)
 
 
@@ -537,6 +581,7 @@ cs-cli change-consumer delivery complete <delivery_id> --status completed \
 | 命令 | 说明 |
 | --- | --- |
 | `testset list --customer-agent-config-id <id>` | 列出测试集（分页，Agent ID 必填） |
+| `testset create --customer-agent-config-id <id> --file <cases.xlsx> [--name ...] [--description ...] [--use-type ...]` | 通过 xlsx 模板上传创建测试集 |
 | `testset show <id>` | 测试集详情 |
 | `testset update <id> [--name ...] [--description ...] [--data @file.json]` | 更新测试集元数据（至少一项） |
 | `testset delete <id>` | 软删除测试集 |
@@ -786,3 +831,19 @@ cs-cli ops-record update <record_id> --data '{"remark":"已完成配置更新","
 # 删除运维操作记录
 cs-cli ops-record delete <record_id>
 ```
+
+### Ops Agent (`ops-agent`)
+
+| 命令 | 说明 |
+| --- | --- |
+| `ops-agent conversations [--agent-id <id>] [--customer-id <id>] [--page N] [--page-size N]` | 查询客服助手会话列表 |
+
+`ops-agent conversations` 对接 `customer-servhub-api /v1/ops-agent/conversations`，返回字段固定为 `workspace_id`、`customer_id`、`title`、`agent_id`、`created_at`、`updated_at`。命令会自动带当前 `workspace-id`；`--agent-id` 对应 Ops Agent 配置 ID（`customer_agent_config_id`），`--customer-id` 可选。
+
+```bash
+# 查询当前 workspace 下某个客服运维助手的会话
+cs-cli ops-agent conversations --agent-id <customer_agent_config_id>
+
+# 按 customer 进一步过滤
+cs-cli ops-agent conversations --agent-id <customer_agent_config_id> --customer-id <customer_id>
+```

package/dist/bin.js

@@ -276,7 +276,7 @@ function toExitCode(err) {
   return 1;
 }
 function createRequest(globalTimeout) {
-  return async function request(baseUrl, path5, options) {
+  return async function request(baseUrl, path6, options) {
     const headers = {
       "Content-Type": "application/json",
       ...options.headers
@@ -304,7 +304,7 @@ function createRequest(globalTimeout) {
     if (workspaceId) {
       headers["workspace-id"] = workspaceId;
     }
-    let url = `${baseUrl}${path5}`;
+    let url = `${baseUrl}${path6}`;
     if (options.query) {
       const params = new URLSearchParams();
       for (const [key, value] of Object.entries(options.query)) {
@@ -487,26 +487,66 @@ function buildCookieHeaders() {
   return { Cookie: `auth_token=${creds.accessToken}` };
 }
 
-// src/client/agent-api.ts
-async function listAgents(opts) {
-  const wsId = getWorkspaceId(opts.workspaceId);
+// src/client/activity-api.ts
+var PATH_PREFIX = "/v1/activity";
+async function listActivities(opts) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), "/v1/customer-agent/list", {
+  const query = {
+    customer_agent_config_id: opts.customerAgentConfigId,
+    page: opts.page ?? 1,
+    page_size: opts.pageSize ?? 20
+  };
+  if (opts.search) query.search = opts.search;
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/list`, {
     method: "GET",
-    query: { page: opts.page ?? 1, page_size: opts.pageSize ?? 20, workspace_id: wsId }
+    query
   });
 }
-async function getAgent(configId) {
+async function listActivitiesByProduct(opts) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
-    method: "GET"
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/by-product`, {
+    method: "GET",
+    query: {
+      customer_agent_config_id: opts.customerAgentConfigId,
+      product_id: opts.productId
+    }
   });
 }
-async function updateAgent(configId, data) {
+async function createActivity(body) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX, {
+    method: "POST",
+    body
+  });
+}
+async function updateActivity(activityId, body) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}`, {
     method: "PUT",
-    body: data
+    body
+  });
+}
+async function patchActivityEnabled(activityId, enabled) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}/enabled`, {
+    method: "PATCH",
+    body: { enabled }
+  });
+}
+async function deleteActivity(activityId) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${activityId}`, {
+    method: "DELETE"
+  });
+}
+async function setV2Enabled(opts) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/v2-enabled`, {
+    method: "PUT",
+    body: {
+      customer_agent_config_id: opts.customerAgentConfigId,
+      enabled: opts.enabled
+    }
   });
 }
 
@@ -540,6 +580,141 @@ function parseDataOption(value) {
   }
 }
 
+// src/commands/activity.ts
+function parseEnabledFlag(raw) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  throw new Error("--enabled \u4EC5\u63A5\u53D7 true | false");
+}
+function parseActivityId(raw) {
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`\u975E\u6CD5\u7684 activity_id: ${raw}\uFF08\u5FC5\u987B\u4E3A\u6B63\u6574\u6570\uFF09`);
+  }
+  return n;
+}
+function registerActivityCommand(program2) {
+  const activity = program2.command("activity").description(
+    "\u6D3B\u52A8 V2 \u7BA1\u7406 \u2014\u2014 \u589E\u5220\u6539\u67E5\u6D3B\u52A8\u3001\u6309\u5546\u54C1\u53CD\u67E5\u3001\u5355\u6761\u542F\u7528 toggle\u3001per-tenant V2 \u603B\u5F00\u5173\u3002\u670D\u52A1\u7AEF\uFF1Acustomer-servhub-api /v1/activity*\uFF1B\u5951\u7EA6\u53C2\u8003 docs/devkit/specs/2026-05-28-activity-v2-api-reference.md"
+  );
+  activity.command("list").description(
+    "\u5217\u51FA\u6D3B\u52A8\uFF08\u5206\u9875 + \u540D\u79F0\u641C\u7D22\uFF09\u3002\u8FD4\u56DE total / v2_activity_enabled / items[]\uFF0Citems \u542B id\u3001activity_name\u3001effective_type\u3001enabled\u3001product_scope\u3001products \u7B49"
+  ).requiredOption("--agent <id>", "customer_agent_config_id\uFF08agent \u914D\u7F6E ID\uFF0C\u4ECE agent list \u83B7\u53D6\uFF09").option("--page <number>", "\u9875\u7801\uFF08\u22651\uFF09", "1").option("--page-size <number>", "\u6BCF\u9875\u6570\u91CF\uFF081-100\uFF09", "20").option("--search <text>", "\u6309\u6D3B\u52A8\u540D\u6A21\u7CCA\u5339\u914D").action(async (opts) => {
+    try {
+      const data = await listActivities({
+        customerAgentConfigId: opts.agent,
+        page: Number(opts.page),
+        pageSize: Number(opts.pageSize),
+        search: opts.search
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("by-product").description(
+    "\u6309 product_id \u53CD\u67E5\u5F53\u524D\u751F\u6548\u6D3B\u52A8\uFF08enabled=true \u4E14\u672A\u8F6F\u5220\uFF1Bproduct_scope='all' \u5FC5\u5165\uFF0C'specific' \u8D70 activity_product \u53CD\u67E5\uFF1B\u54CD\u5E94 items[].products \u6052\u4E3A []\uFF09"
+  ).requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--product-id <id>", "\u5916\u90E8\u5546\u54C1 ID\uFF08\u4E0E activity_product.product_id \u540C\u6E90\uFF09").action(async (opts) => {
+    try {
+      const data = await listActivitiesByProduct({
+        customerAgentConfigId: opts.agent,
+        productId: opts.productId
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("create").description(
+    "\u521B\u5EFA\u6D3B\u52A8\u3002--data \u4E3A\u5B8C\u6574 IActivityWritePayload\uFF08JSON \u6216 @\u6587\u4EF6\uFF09\u3002\u5FC5\u586B\u5B57\u6BB5\uFF1Acustomer_agent_config_id\u3001activity_name\u3001effective_type\u3001activity_rule\uFF1Beffective_type=time_range \u65F6 start_time + end_time \u5FC5\u586B\uFF1Bproduct_scope='specific'\uFF08\u7F3A\u7701\uFF09\u8981\u6C42 products \u2265 1 \u884C"
+  ).requiredOption("--data <json>", "\u6D3B\u52A8 payload\uFF08JSON \u5B57\u7B26\u4E32\u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF09").action(async (opts) => {
+    try {
+      const body = parseDataOption(opts.data);
+      const data = await createActivity(body);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("update").description(
+    "\u6574\u4F53\u66F4\u65B0\u6D3B\u52A8\uFF08products \u6574\u7EC4\u66FF\u6362\uFF0C\u4E0D\u505A\u589E\u91CF diff\uFF09\u3002customer_agent_config_id \u4E0D\u53EF\u53D8\u66F4\uFF0C\u4E0E\u73B0\u884C\u4E0D\u4E00\u81F4\u4F1A\u4E1A\u52A1\u5931\u8D25 400"
+  ).argument("<activity_id>", "\u6D3B\u52A8 ID\uFF08\u4ECE activity list \u8FD4\u56DE\u7684 id \u83B7\u53D6\uFF09").requiredOption("--data <json>", "\u5B8C\u6574 IActivityWritePayload\uFF08JSON \u5B57\u7B26\u4E32\u6216 @\u6587\u4EF6\u8DEF\u5F84\uFF09").action(async (activityIdRaw, opts) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const body = parseDataOption(opts.data);
+      const data = await updateActivity(activityId, body);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("set-enabled").description(
+    "\u5207\u6362\u5355\u6761\u6D3B\u52A8\u542F\u7528\u72B6\u6001\uFF08\u5217\u8868\u884C toggle \u7528\uFF0CPATCH /enabled\uFF09\u3002\u4EC5\u5199 enabled \u4E00\u4E2A\u5B57\u6BB5\uFF0C\u5176\u5B83 payload \u5B57\u6BB5\u5FFD\u7565"
+  ).argument("<activity_id>", "\u6D3B\u52A8 ID").requiredOption("--enabled <bool>", "true | false").action(async (activityIdRaw, opts) => {
+    try {
+      const activityId = parseActivityId(activityIdRaw);
+      const enabled = parseEnabledFlag(opts.enabled);
+      const data = await patchActivityEnabled(activityId, enabled);
+      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);
+      const data = await deleteActivity(activityId);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  activity.command("v2-enabled").description(
+    "per-tenant V2 \u603B\u5F00\u5173 \u2014\u2014 \u5199 agent_activity_setting.v2_activity_enabled\uFF0C\u63A7\u5236 sop V2 \u94FE\u8DEF\u662F\u5426\u751F\u6548"
+  ).requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--enabled <bool>", "true | false").action(async (opts) => {
+    try {
+      const enabled = parseEnabledFlag(opts.enabled);
+      const data = await setV2Enabled({
+        customerAgentConfigId: opts.agent,
+        enabled
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
+// src/client/agent-api.ts
+async function listAgents(opts) {
+  const wsId = getWorkspaceId(opts.workspaceId);
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), "/v1/customer-agent/list", {
+    method: "GET",
+    query: { page: opts.page ?? 1, page_size: opts.pageSize ?? 20, workspace_id: wsId }
+  });
+}
+async function getAgent(configId) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+    method: "GET"
+  });
+}
+async function updateAgent(configId, data) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), `/v1/customer-agent/${configId}`, {
+    method: "PUT",
+    body: data
+  });
+}
+
 // src/commands/agent.ts
 function registerAgentCommand(program2) {
   const agent = program2.command("agent").description(
@@ -1168,22 +1343,22 @@ function registerConversationCommand(program2) {
 var DASHBOARD_PREFIX = "/v1/dashboard";
 async function getDashboardSummary(opts) {
   const request = createRequest();
-  const path5 = opts.configId ? `${DASHBOARD_PREFIX}/${opts.configId}/summary` : `${DASHBOARD_PREFIX}/summary`;
+  const path6 = opts.configId ? `${DASHBOARD_PREFIX}/${opts.configId}/summary` : `${DASHBOARD_PREFIX}/summary`;
   const query = {};
   if (opts.startDate) query.start_date = opts.startDate;
   if (opts.endDate) query.end_date = opts.endDate;
   if (opts.channel) query.channel = opts.channel;
-  return request(getCustomerServiceUrl(), path5, { method: "GET", query });
+  return request(getCustomerServiceUrl(), path6, { method: "GET", query });
 }
 async function getDashboardTrend(opts) {
   const request = createRequest();
-  const path5 = opts.configId ? `${DASHBOARD_PREFIX}/${opts.configId}/trend` : `${DASHBOARD_PREFIX}/trend`;
+  const path6 = opts.configId ? `${DASHBOARD_PREFIX}/${opts.configId}/trend` : `${DASHBOARD_PREFIX}/trend`;
   const query = {};
   if (opts.startDate) query.start_date = opts.startDate;
   if (opts.endDate) query.end_date = opts.endDate;
   if (opts.granularity) query.granularity = opts.granularity;
   if (opts.channel) query.channel = opts.channel;
-  return request(getCustomerServiceUrl(), path5, { method: "GET", query });
+  return request(getCustomerServiceUrl(), path6, { method: "GET", query });
 }
 async function listShopStatistics(opts) {
   const request = createRequest();
@@ -1403,12 +1578,12 @@ function registerDashboardCommand(program2) {
         channel: opts.channel
       });
       if (opts.out) {
-        const { path: path5, bytes } = await writeBinaryToFile(
+        const { path: path6, bytes } = await writeBinaryToFile(
           opts.out,
           Buffer.from(result.csv, "utf-8")
         );
         formatOutput(
-          { success: true, data: { path: path5, bytes, count: result.rows.length } },
+          { success: true, data: { path: path6, bytes, count: result.rows.length } },
           program2.opts().table
         );
       } else {
@@ -3594,8 +3769,46 @@ function registerMonitorCommand(program2) {
   });
 }
 
+// src/client/ops-agent-api.ts
+async function listOpsAgentConversations(opts) {
+  const workspaceId = getWorkspaceId(opts.workspaceId);
+  const request = createRequest();
+  const query = {
+    page: opts.page ?? 1,
+    page_size: opts.pageSize ?? 20
+  };
+  if (opts.customerId) query.customer_id = opts.customerId;
+  if (opts.agentId) query.agent_id = opts.agentId;
+  return request(getCustomerServiceUrl(), "/v1/ops-agent/conversations", {
+    method: "GET",
+    query,
+    headers: { "workspace-id": workspaceId }
+  });
+}
+
+// src/commands/ops-agent.ts
+function registerOpsAgentCommand(program2) {
+  const opsAgent = program2.command("ops-agent").description("Ops Agent\uFF08\u5BA2\u670D\u52A9\u624B\uFF09\u67E5\u8BE2\u547D\u4EE4");
+  opsAgent.command("conversations").description(
+    "\u67E5\u8BE2\u5BA2\u670D\u52A9\u624B\u4F1A\u8BDD\u5217\u8868\u3002\u8FD4\u56DE workspace_id\u3001customer_id\u3001title\u3001agent_id\u3001created_at\u3001updated_at"
+  ).option("--customer-id <id>", "\u6309 customer_id \u7B5B\u9009").option("--agent-id <id>", "\u6309 Ops Agent \u914D\u7F6E ID\uFF08customer_agent_config_id\uFF09\u7B5B\u9009").option("--page <number>", "\u9875\u7801", "1").option("--page-size <number>", "\u6BCF\u9875\u6570\u91CF", "20").action(async (opts) => {
+    try {
+      const data = await listOpsAgentConversations({
+        customerId: opts.customerId,
+        agentId: opts.agentId,
+        page: Number(opts.page),
+        pageSize: Number(opts.pageSize)
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
 // src/client/operations-record-api.ts
-var PATH_PREFIX = "/v1/agent_operations_records";
+var PATH_PREFIX2 = "/v1/agent_operations_records";
 async function listOperationsRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -3603,34 +3816,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_PREFIX, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
     method: "GET",
     query
   });
 }
 async function getOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "GET"
   });
 }
 async function createOperationsRecord(data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), PATH_PREFIX, {
+  return request(getCustomerServiceUrl(), PATH_PREFIX2, {
     method: "POST",
     body: data
   });
 }
 async function updateOperationsRecord(recordId, data) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "PUT",
     body: data
   });
 }
 async function deleteOperationsRecord(recordId) {
   const request = createRequest();
-  return request(getCustomerServiceUrl(), `${PATH_PREFIX}/${recordId}`, {
+  return request(getCustomerServiceUrl(), `${PATH_PREFIX2}/${recordId}`, {
     method: "DELETE"
   });
 }
@@ -3806,6 +4019,15 @@ async function syncSingleTaobaoProduct(opts) {
     }
   });
 }
+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) {
@@ -3943,6 +4165,19 @@ function registerProductCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  product.command("identify-all").description(
+    "\u4E00\u952E\u589E\u5F3A\u5B66\u4E60\u5F53\u524D Agent \u4E0B\u6240\u6709\u5F85\u589E\u5F3A\u5546\u54C1\u3002\u5BF9\u63A5 POST /v1/knowledge/products/identify/all\uFF0C\u5F02\u6B65\u63D0\u4EA4\u5546\u54C1\u589E\u5F3A\u5B66\u4E60\u4EFB\u52A1"
+  ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u4ECE agent list \u83B7\u53D6\uFF09").action(async (opts) => {
+    try {
+      const data = await identifyAllProducts({
+        agentConfigId: opts.agent
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
   product.command("sync-taobao").description(
     "\u89E6\u53D1\u6DD8\u5B9D\u5E97\u94FA\u5546\u54C1\u540C\u6B65\u3002\u8C03\u7528 customer-servhub-api \u7684\u6388\u6743\u5E97\u94FA\u540C\u6B65\u63A5\u53E3\uFF0C\u6309 Agent \u914D\u7F6E\u627E\u5230\u552F\u4E00\u7ED1\u5B9A\u5E97\u94FA\u540E\u5F02\u6B65\u542F\u52A8\u540C\u6B65\u4EFB\u52A1"
   ).requiredOption("--agent <config_id>", "Agent \u914D\u7F6E ID\uFF08\u5FC5\u987B\u5DF2\u552F\u4E00\u7ED1\u5B9A\u4E00\u4E2A\u6DD8\u5B9D\u6388\u6743\u5E97\u94FA\uFF09").option("--skip-hash-check", "\u8DF3\u8FC7\u54C8\u5E0C\u6821\u9A8C\uFF0C\u5F3A\u5236\u91CD\u65B0\u540C\u6B65\u5546\u54C1").option("--sync-type <type>", "\u540C\u6B65\u7C7B\u578B\uFF1Afull / incremental\uFF0C\u9ED8\u8BA4 full", "full").action(async (opts) => {
@@ -3998,7 +4233,7 @@ function registerProductCommand(program2) {
 }
 
 // src/client/repair-record-api.ts
-var PATH_PREFIX2 = "/api/repair-records";
+var PATH_PREFIX3 = "/api/repair-records";
 async function listRepairRecords(opts) {
   const request = createRequest();
   const query = {};
@@ -4007,21 +4242,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_PREFIX2, {
+  return request(getCsAdminUrl(), PATH_PREFIX3, {
     method: "GET",
     query
   });
 }
 async function createRepairRecord(data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), PATH_PREFIX2, {
+  return request(getCsAdminUrl(), PATH_PREFIX3, {
     method: "POST",
     body: data
   });
 }
 async function updateRepairRecord(recordId, data) {
   const request = createRequest();
-  return request(getCsAdminUrl(), `${PATH_PREFIX2}/${recordId}`, {
+  return request(getCsAdminUrl(), `${PATH_PREFIX3}/${recordId}`, {
     method: "PUT",
     body: data
   });
@@ -4292,10 +4527,132 @@ function registerSACommand(program2) {
   });
 }
 
-// src/commands/testset.ts
+// src/commands/special-project.ts
 import fs9 from "fs";
 
+// src/client/special-project-api.ts
+async function createSpecialProject(input) {
+  const request = createRequest();
+  return request(getCsAdminUrl(), "/api/special-projects", {
+    method: "POST",
+    body: input
+  });
+}
+async function listSpecialProjects(opts = {}) {
+  const request = createRequest();
+  const query = {};
+  if (opts.ownerUserId !== void 0) query.ownerUserId = opts.ownerUserId;
+  if (opts.status) query.status = opts.status;
+  const result = await request(getCsAdminUrl(), "/api/special-projects", {
+    method: "GET",
+    query
+  });
+  return result.rows ?? [];
+}
+async function updateSpecialProject(projectId, patch) {
+  const request = createRequest();
+  return request(
+    getCsAdminUrl(),
+    `/api/special-projects/${projectId}`,
+    { method: "PATCH", body: patch }
+  );
+}
+async function closeSpecialProject(projectId) {
+  return updateSpecialProject(projectId, { status: "\u5DF2\u5B8C\u6210" });
+}
+async function upsertSpecialProjects(items, apply) {
+  const request = createRequest();
+  return request(getCsAdminUrl(), "/api/special-projects/batch", {
+    method: "POST",
+    body: { items, apply }
+  });
+}
+
+// src/commands/special-project.ts
+function readJsonArg(value) {
+  if (value.startsWith("@")) {
+    return fs9.readFileSync(value.slice(1), "utf-8");
+  }
+  return value;
+}
+function registerSpecialProjectCommand(program2) {
+  const sp = program2.command("special-project").description(
+    "\u4E13\u9879\uFF08special_project\uFF09\u7BA1\u7406 \u2014\u2014 \u5DE5\u4F5C\u8D1F\u8F7D\u770B\u677F\u7684\u4E13\u9879\u6570\u636E\u3002\u4E3B\u529B\u5F55\u5165\u901A\u9053\uFF1A\u65E9\u4F1A\u9010\u5B57\u7A3F \u2192 Agent \u89E3\u6790 \u2192 upsert\uFF08\u5148\u770B diff\uFF0C\u786E\u8BA4\u540E --apply\uFF09"
+  );
+  sp.command("create").description("\u521B\u5EFA\u5355\u4E2A\u4E13\u9879").requiredOption("--name <name>", "\u4E13\u9879\u540D").requiredOption("--owner <id>", "\u627F\u63A5\u5DE5\u7A0B\u5E08 cs_admin_user_id").requiredOption("--daily-effort <personDays>", "\u9884\u4F30\u6BCF\u65E5\u6295\u5165\uFF08\u4EBA\u5929\uFF0C\u5982 0.5\uFF09").requiredOption("--start-date <YYYY-MM-DD>", "\u5F00\u59CB\u65E5\u671F").requiredOption("--duration-days <n>", "\u9884\u4F30\u6709\u6548\u6295\u5165\u5929\u6570").option("--workspace <id>", "\u5173\u8054\u5BA2\u6237 workspace_id\uFF08\u53EF\u7A7A\uFF0C\u5185\u90E8\u4E13\u9879\u4E0D\u586B\uFF09").option("--description <text>", "\u63CF\u8FF0").option("--source-ref <ref>", "\u7A33\u5B9A\u5916\u90E8\u952E\uFF08\u9010\u5B57\u7A3F\u6765\u6E90 id\uFF09\uFF0Cupsert \u5E42\u7B49\u7528").action(async (opts) => {
+    try {
+      const data = await createSpecialProject({
+        name: opts.name,
+        ownerUserId: Number(opts.owner),
+        dailyEffort: Number(opts.dailyEffort),
+        startDate: opts.startDate,
+        durationDays: Number(opts.durationDays),
+        workspaceId: opts.workspace,
+        description: opts.description,
+        sourceRef: opts.sourceRef
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  sp.command("list").description("\u5217\u51FA\u4E13\u9879").option("--owner <id>", "\u6309\u627F\u63A5\u5DE5\u7A0B\u5E08 cs_admin_user_id \u8FC7\u6EE4").option("--status <status>", "\u6309\u72B6\u6001\u8FC7\u6EE4\uFF08\u8FDB\u884C\u4E2D/\u6682\u505C/\u9700\u786E\u8BA4/\u5DF2\u5B8C\u6210\uFF09").action(async (opts) => {
+    try {
+      const data = await listSpecialProjects({
+        ownerUserId: opts.owner !== void 0 ? Number(opts.owner) : void 0,
+        status: opts.status
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  sp.command("update <id>").description("\u66F4\u65B0\u4E13\u9879\uFF08\u4EFB\u610F\u5B50\u96C6\uFF1B\u72B6\u6001\u8FC1\u79FB\u53D7\u670D\u52A1\u7AEF\u72B6\u6001\u673A\u7EA6\u675F\uFF09").option("--progress <n>", "\u8FDB\u5EA6 0-100").option("--status <status>", "\u72B6\u6001\uFF08\u8FDB\u884C\u4E2D/\u6682\u505C/\u9700\u786E\u8BA4/\u5DF2\u5B8C\u6210\uFF09").option("--daily-effort <personDays>", "\u6BCF\u65E5\u6295\u5165\uFF08\u4EBA\u5929\uFF09").option("--duration-days <n>", "\u6709\u6548\u6295\u5165\u5929\u6570").option("--description <text>", "\u63CF\u8FF0").action(async (id, opts) => {
+    try {
+      const patch = {};
+      if (opts.progress !== void 0) patch.progress = Number(opts.progress);
+      if (opts.status !== void 0) patch.status = opts.status;
+      if (opts.dailyEffort !== void 0) patch.dailyEffort = Number(opts.dailyEffort);
+      if (opts.durationDays !== void 0) patch.durationDays = Number(opts.durationDays);
+      if (opts.description !== void 0) patch.description = opts.description;
+      const data = await updateSpecialProject(Number(id), patch);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  sp.command("close <id>").description("\u5173\u95ED\u4E13\u9879\uFF08\u7F6E\u4E3A\u5DF2\u5B8C\u6210\uFF09").action(async (id) => {
+    try {
+      const data = await closeSpecialProject(Number(id));
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  sp.command("upsert").description(
+    "\u6279\u91CF upsert\uFF08\u9010\u5B57\u7A3F\u540C\u6B65\uFF09\u3002--items \u63A5 JSON \u6570\u7EC4\u6216 @\u6587\u4EF6\u3002\u9ED8\u8BA4\u53EA\u6253\u5370 diff \u4E0D\u5199\u5E93\uFF1B\u52A0 --apply \u624D\u843D\u5E93"
+  ).requiredOption("--items <json|@file>", "items JSON \u6570\u7EC4\uFF0C\u6216 @path \u8BFB\u6587\u4EF6").option("--apply", "\u843D\u5E93\uFF08\u7F3A\u7701\u53EA\u7B97 diff \u4E0D\u5199\uFF09", false).action(async (opts) => {
+    try {
+      const items = JSON.parse(readJsonArg(opts.items));
+      const data = await upsertSpecialProjects(items, opts.apply === true);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
+// src/commands/testset.ts
+import fs11 from "fs";
+
 // src/client/testset-api.ts
+import fs10 from "fs";
+import path5 from "path";
 function unwrapPaginated(raw, fallbackPageSize) {
   return {
     items: Array.isArray(raw?.data) ? raw?.data : [],
@@ -4321,6 +4678,28 @@ async function listTestSets(query) {
   );
   return unwrapPaginated(raw, query.pageSize ?? 20);
 }
+async function createTestSetFromFile(input) {
+  const request = createRequest();
+  const fileBytes = fs10.readFileSync(input.filePath);
+  const formData = new FormData();
+  formData.append(
+    "file",
+    new Blob([fileBytes], {
+      type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+    }),
+    path5.basename(input.filePath)
+  );
+  return request(getCustomerServiceUrl(), "/v1/test_sets/file/upload", {
+    method: "POST",
+    query: {
+      customer_agent_config_id: input.customerAgentConfigId,
+      test_set_name: input.testSetName,
+      test_set_description: input.testSetDescription,
+      use_type: input.useType
+    },
+    body: formData
+  });
+}
 async function getTestSet(id) {
   const request = createRequest();
   return request(getCustomerServiceUrl(), `/v1/test_sets/${id}`, {
@@ -4805,7 +5184,7 @@ function readPromptInput(value) {
     if (!filePath) {
       throw new Error("File path cannot be empty after @");
     }
-    return fs9.readFileSync(filePath, "utf-8");
+    return fs11.readFileSync(filePath, "utf-8");
   }
   return value;
 }
@@ -4838,6 +5217,25 @@ function registerTestsetCommand(program2) {
       process.exit(toExitCode(err));
     }
   });
+  testset.command("create").description("\u901A\u8FC7 xlsx \u6587\u4EF6\u521B\u5EFA\u6D4B\u8BD5\u96C6").requiredOption("--customer-agent-config-id <id>", "Agent \u914D\u7F6E ID\uFF08\u5FC5\u586B\uFF0C\u4E0E\u540E\u7AEF\u5951\u7EA6\u5BF9\u9F50\uFF09").requiredOption("--file <path>", "\u6D4B\u8BD5\u96C6 xlsx \u6587\u4EF6\u8DEF\u5F84").option("--name <text>", "\u6D4B\u8BD5\u96C6\u540D\u79F0\uFF1B\u4E0D\u4F20\u5219\u540E\u7AEF\u53D6\u6587\u4EF6\u540D").option("--description <text>", "\u6D4B\u8BD5\u96C6\u63CF\u8FF0").option("--use-type <text>", "\u6587\u4EF6\u7528\u9014\u6807\u8BC6").action(async (opts) => {
+    try {
+      if (!fs11.existsSync(opts.file)) {
+        outputError(1, `\u6587\u4EF6\u4E0D\u5B58\u5728: ${opts.file}`);
+        process.exit(1);
+      }
+      const data = await createTestSetFromFile({
+        customerAgentConfigId: opts.customerAgentConfigId,
+        filePath: opts.file,
+        testSetName: opts.name,
+        testSetDescription: opts.description,
+        useType: opts.useType
+      });
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
   testset.command("show").description("\u67E5\u770B\u5355\u4E2A\u6D4B\u8BD5\u96C6\u8BE6\u60C5").argument("<id>", "\u6D4B\u8BD5\u96C6 ID").action(async (id) => {
     try {
       const data = await getTestSet(id);
@@ -4990,9 +5388,11 @@ registerAuthCommand(program);
 registerConfigCommand(program);
 registerWorkspaceCommand(program);
 registerAgentCommand(program);
+registerOpsAgentCommand(program);
 registerSACommand(program);
 registerProductCommand(program);
 registerKnowledgeCommand(program);
+registerActivityCommand(program);
 registerIssueCommand(program);
 registerChatHistoryCommand(program);
 registerFaqCommand(program);
@@ -5004,6 +5404,7 @@ registerRepairRecordCommand(program);
 registerOperationsRecordCommand(program);
 registerChangeConsumerCommand(program);
 registerTestsetCommand(program);
+registerSpecialProjectCommand(program);
 process.on("uncaughtException", (err) => {
   outputError(3, err.message);
   process.exit(3);

package/package.json

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