@bty/customer-service-cli 0.5.5 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 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` 均纳入；发布前 `{{}}` 合法性校验白名单同步放行。
+- **下线 `node-template enroll` / `enroll-status` 命令**：高级模式开关从「运维 CLI 灰度准入」改为「客户在 cs-client 内自助开关」（spec 2026-06-09），CLI 不再提供开启路径；servhub `enrolled` 端点仍在，供 cs-client 使用。
+
 ## 0.5.5 (2026-06-07)
 
 - 修复 `debug ask --messages` 重放多轮对话时，历史消息时间戳晚于当前时间导致本次 Agent 回复插入历史消息中间、review 页面消息乱序的问题。

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"
 ```
 
 
@@ -299,6 +311,24 @@ cs-cli activity delete 6
 cs-cli activity v2-enabled --agent <cfg_id> --enabled true
 ```
 
+### 节点模板 (`node-template`)
+
+高级模板（4 真节点提示词 + `image_understanding` 图片理解方法论伪 stage）操作：编写说明书 + 获取内容 + 改动发布 + 历史/回溯。服务端 `customer-servhub-api /v1/customer-agent/{config_id}/customer_config/node-templates*`；契约见 [`docs/devkit/specs/2026-06-08-节点模板-cli-操作面.md`](../../docs/devkit/specs/2026-06-08-节点模板-cli-操作面.md)。**节点 stage：`planner|composer|qa_inspector|image_understanding`（`tool_selector` 暂不放出）。**
+
+> 高级模式开关已改为**客户自助**（在 cs-client 内开关），CLI 不再提供 `enroll` / `enroll-status` 开启路径（已下线）。
+
+| 命令 | 说明 |
+| --- | --- |
+| `node-template describe [--stage <s>]` | 节点编写说明书（AI 编写前必读）：每节点职责/可编辑面/输出契约/平台锁定段 + 可 `@引用` 变量目录；纯静态、无需 `--agent` |
+| `node-template get --agent <id> [--stage <s>]` | 获取内容（不传 stage=全部已开放节点） |
+| `node-template set-draft --agent <id> --stage <s> (--content <t>\|--content-file <p>\|--stdin)` | 写单节点草稿（整段覆盖；空串=回落出厂默认） |
+| `node-template publish --agent <id> --stage <s> [--force]` | 发布草稿上线（发布前校验 `{{}}`，`--force` 越过） |
+| `node-template versions --agent <id> --stage <s>` | 列该节点历史 |
+| `node-template version --agent <id> --stage <s> --version <n>` | 取某版本正文 |
+| `node-template restore --agent <id> --stage <s> --version <n>` | 回溯某版本成草稿（需再 publish） |
+
+典型流（该 agent 已由客户在 cs-client 开启高级模式后）：`get` 看现状 → `set-draft` 改草稿 → `publish` 上线。`publish` 会拒绝含非法 `{{插值}}` 名的草稿（笔误防呆）。
+
 ### 工单管理 (`issue`)
 
 
@@ -387,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`。
@@ -403,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`)
 
@@ -435,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
@@ -3786,6 +4156,317 @@ function registerMonitorCommand(program2) {
   });
 }
 
+// src/commands/node-template.ts
+import { readFileSync } from "fs";
+
+// src/client/node-template-api.ts
+function base(configId) {
+  return `/v1/customer-agent/${configId}/customer_config/node-templates`;
+}
+async function getNodeTemplates(configId) {
+  const request = createRequest();
+  return request(getCustomerServiceUrl(), base(configId), {
+    method: "GET"
+  });
+}
+async function setNodeTemplateDraft(configId, stage, content) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    `${base(configId)}/${stage}/draft`,
+    { method: "PUT", body: { content } }
+  );
+}
+async function publishNodeTemplate(configId, stage) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    `${base(configId)}/${stage}/publish`,
+    { method: "POST", body: {} }
+  );
+}
+async function listNodeTemplateVersions(configId, stage) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    `${base(configId)}/${stage}/versions`,
+    { method: "GET" }
+  );
+}
+async function getNodeTemplateVersion(configId, stage, versionNo) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    `${base(configId)}/${stage}/versions/${versionNo}`,
+    { method: "GET" }
+  );
+}
+async function restoreNodeTemplateVersion(configId, stage, versionNo) {
+  const request = createRequest();
+  return request(
+    getCustomerServiceUrl(),
+    `${base(configId)}/${stage}/versions/${versionNo}/restore`,
+    { method: "POST", body: {} }
+  );
+}
+
+// src/lib/node-template-references.ts
+var NODE_TEMPLATE_REFERENCES = [
+  // ── 数据源 fact_alias（当轮实时事实，运行时取最新数据） ──
+  { name: "product_data", label: "\u5546\u54C1\u4E8B\u5B9E", desc: "\u5546\u54C1\u53C2\u6570/\u5E93\u5B58/\u4EF7\u683C\u7B49\u5546\u54C1\u4E8B\u5B9E\u6570\u636E", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "order_status", label: "\u8BA2\u5355/\u7269\u6D41\u72B6\u6001", desc: "\u8BA2\u5355\u72B6\u6001\u3001\u7269\u6D41\u8FDB\u5EA6\u7B49", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "faq_knowledge", label: "FAQ/\u5386\u53F2\u95EE\u7B54", desc: "\u5E97\u94FA\u5E38\u89C1\u95EE\u7B54\u4E0E\u5386\u53F2\u95EE\u7B54", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "common_knowledge", label: "\u901A\u7528\u77E5\u8BC6", desc: "\u5E97\u94FA\u901A\u7528\u77E5\u8BC6/\u8865\u5145\u77E5\u8BC6", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "activity_knowledge", label: "\u6D3B\u52A8\u77E5\u8BC6", desc: "\u5F53\u524D\u5E97\u94FA\u6D3B\u52A8\u4FE1\u606F", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "product_recommendation", label: "\u5546\u54C1\u63A8\u8350", desc: "\u627E\u76F8\u4F3C\u6B3E/\u63A8\u8350\u5546\u54C1", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  { name: "size_recommendation", label: "\u5C3A\u7801\u63A8\u8350", desc: "\u6309\u8EAB\u9AD8\u4F53\u91CD\u7B49\u63A8\u8350\u5C3A\u7801", category: "fact_alias", stages: ["tool_selector", "composer"] },
+  // ── 店铺设置 customer_slot（你在「个性化」里填的 SOP 文本，可引用进模板） ──
+  { name: "intent_instruction", label: "\u610F\u56FE\u8BC6\u522B\u89C4\u5219", desc: "\u4F60\u586B\u7684\u5E97\u94FA\u7EA7\u610F\u56FE\u8DEF\u7531 SOP", category: "customer_slot", stages: ["planner"] },
+  { name: "general_qa_instruction", label: "\u901A\u7528\u54A8\u8BE2\u8BDD\u672F", desc: "\u4F60\u586B\u7684\u901A\u7528\u54A8\u8BE2/\u5BA2\u670D\u8EAB\u4EFD SOP", category: "customer_slot", stages: ["planner", "composer"] },
+  { name: "recommendation_instruction", label: "\u63A8\u8350\u8BDD\u672F", desc: "\u4F60\u586B\u7684\u5546\u54C1\u63A8\u8350\u8BDD\u672F\u89C4\u5219", category: "customer_slot", stages: ["composer"] },
+  { name: "takeover_rule_instruction", label: "\u8F6C\u4EBA\u5DE5\u63A5\u7BA1\u7B56\u7565", desc: "\u4F60\u586B\u7684\u633D\u7559/\u8F6C\u4EBA\u5DE5\u89C4\u5219", category: "customer_slot", stages: ["planner", "composer"] },
+  { name: "image_rule_instruction", label: "\u56FE\u7247\u573A\u666F\u89C4\u5219", desc: "\u4F60\u586B\u7684\u56FE\u7247\u76F8\u5173\u4E1A\u52A1 SOP", category: "customer_slot", stages: ["planner", "composer", "qa_inspector"] },
+  { name: "forbidden_words", label: "\u8FDD\u7981\u8BCD", desc: "\u4F60\u914D\u7F6E\u7684\u8FDD\u7981\u8BCD\u6E05\u5355", category: "customer_slot", stages: ["composer"] },
+  // ── 平台只读块 platform_block（平台运行时注入，内容锁定，作者只决定是否/在哪引用） ──
+  { name: "glossary_block", label: "\u672F\u8BED\u8868", desc: "\u5E73\u53F0\u672F\u8BED/\u6982\u5FF5\u5B9A\u4E49", category: "platform_block", stages: ["planner", "tool_selector", "qa_inspector"], readOnly: true },
+  { name: "sa_summaries_block", label: "SA \u6458\u8981\u7D22\u5F15", desc: "\u5F53\u8F6E\u547D\u4E2D\u7684\u573A\u666F\u6458\u8981\u5217\u8868", category: "platform_block", stages: ["planner"], readOnly: true },
+  { name: "tool_results_block", label: "\u5F53\u8F6E\u5DE5\u5177\u7ED3\u679C", desc: "\u672C\u8F6E\u5DF2\u53D6\u56DE\u7684\u5DE5\u5177\u4E8B\u5B9E\u6458\u8981", category: "platform_block", stages: ["composer", "qa_inspector"], readOnly: true },
+  { name: "environment_awareness_block", label: "\u73AF\u5883/\u65F6\u95F4", desc: "\u5E73\u53F0\u4E0E\u5F53\u524D\u65F6\u95F4\u4FE1\u606F", category: "platform_block", stages: ["planner", "composer", "qa_inspector"], readOnly: true },
+  { name: "image_understanding_rules", label: "\u56FE\u7247\u4FE1\u53F7\u89C4\u5219", desc: "\u5E73\u53F0\u56FE\u7247\u7406\u89E3\u89C4\u5219", category: "platform_block", stages: ["planner", "tool_selector", "composer", "qa_inspector"], readOnly: true },
+  { name: "shop_image_rule_block", label: "\u5E97\u94FA\u56FE\u7247\u89C4\u5219", desc: "\u6709\u56FE\u7247\u4FE1\u53F7\u65F6\u6CE8\u5165\u7684\u5E97\u94FA\u56FE\u7247\u89C4\u5219", category: "platform_block", stages: ["composer", "qa_inspector"], readOnly: true },
+  // 「① 背景层下放」（spec 2026-06-08）新增 @平台块：原 ① shell 直注的背景，现作者可 @引用 / 删 / 换。
+  { name: "internal_terms_blacklist", label: "\u5185\u90E8\u672F\u8BED\u9ED1\u540D\u5355", desc: "\u7981\u8BCD/\u6CC4\u9732\u8BCD\u6E05\u7406\u5F15\u7528\u7684\u5185\u90E8\u672F\u8BED\u6E05\u5355", category: "platform_block", stages: ["composer", "qa_inspector"], readOnly: true },
+  { name: "dialog_consumption_rules", label: "\u591A\u8F6E\u6D88\u8D39\u89C4\u5219", desc: "recent_chat / \u5BF9\u8BDD\u5386\u53F2\u7684\u6D88\u8D39\u89C4\u5219", category: "platform_block", stages: ["composer", "planner"], readOnly: true },
+  { name: "takeover_entry_background", label: "\u63A5\u7BA1\u5165\u53E3\u80CC\u666F", desc: "\u7528\u6237\u4E3B\u52A8\u8981\u4EBA\u5DE5\u65F6\u627F\u63A5\u7684\u5E73\u53F0\u80CC\u666F\u5B9A\u4E49", category: "platform_block", stages: ["composer"], readOnly: true },
+  { name: "takeover_reversal_background", label: "\u63A5\u7BA1\u53CD\u8F6C\u80CC\u666F", desc: "takeover \u573A\u666F\u53CD\u8F6C\u6821\u9A8C\u7684\u5E73\u53F0\u80CC\u666F\u5B9A\u4E49", category: "platform_block", stages: ["qa_inspector"], readOnly: true },
+  { name: "action_description_signal_rules", label: "\u52A8\u4F5C\u63CF\u8FF0\u4FE1\u53F7\u89C4\u5219", desc: "\u8DEF\u7531\u7528\u52A8\u4F5C\u63CF\u8FF0\u4FE1\u53F7\u7684\u6D88\u8D39\u89C4\u5219", category: "platform_block", stages: ["planner"], readOnly: true },
+  { name: "fact_trust_rules", label: "\u4E8B\u5B9E\u4FE1\u4EFB\u5C42\u7EA7", desc: "\u5F53\u524D\u8F6E\u4E8B\u5B9E vs \u5386\u53F2\u4E8B\u5B9E\u7684\u4FE1\u4EFB\u89C4\u5219", category: "platform_block", stages: ["planner"], readOnly: true },
+  { name: "takeover_trigger_background", label: "\u63A5\u7BA1\u89E6\u53D1\u80CC\u666F", desc: "\u5E97\u94FA\u8F6C\u4EBA\u5DE5\u63A5\u7BA1\u89E6\u53D1\u6761\u4EF6\u80CC\u666F\u5B9A\u4E49", category: "platform_block", stages: ["planner"], readOnly: true }
+];
+var ALL_REFERENCE_NAMES = NODE_TEMPLATE_REFERENCES.map((r) => r.name);
+function referencesForStage(stage) {
+  return NODE_TEMPLATE_REFERENCES.filter((r) => r.stages.includes(stage));
+}
+var NODE_CHARTERS = {
+  planner: {
+    role: "\u610F\u56FE\u8BC6\u522B / \u8DEF\u7531\u8282\u70B9\uFF1A\u5224\u5B9A\u672C\u8F6E\u8D70\u5B8C\u6574\u4E1A\u52A1\u94FE\u8DEF\u8FD8\u662F\u8F6C\u4EBA\u5DE5\uFF0C\u5E76\u4EA7\u51FA\u300CSA \u6458\u8981 \u2192 \u547D\u4E2D scene\u300D\u7684\u8DEF\u7531\u3002",
+    editable: "\u2461 \u4F5C\u8005\u6B63\u6587\uFF1A\u8DEF\u7531\u5224\u65AD\u903B\u8F91\u3001\u8DEF\u7531\u7EAA\u5F8B\u3001\u552E\u540E\u573A\u666F\u5224\u65AD\u3001@\u5F15\u7528\u5E97\u94FA\u610F\u56FE/\u63A5\u7BA1 SOP\u3002",
+    mustOutput: "JSON \u5BF9\u8C61 {d, a, r}\uFF1Ad=\u51B3\u7B56\u7F16\u7801\uFF08business_full\u21922 / transfer\u21923\uFF09\uFF0Ca=\u662F\u5426\u552E\u540E\u573A\u666F\uFF08bool\uFF09\uFF0Cr=\u53CC\u4E0B\u6807\u8DEF\u7531\u6570\u7EC4 [[sa, sc], ...]\u3002\u683C\u5F0F\u7531\u5E73\u53F0 \u2462 \u9501\u5B9A\u2014\u2014\u4F60\u7684\u6B63\u6587\u7528\u51B3\u7B56\u540D\u5224\u65AD\u5373\u53EF\uFF0C\u4E0D\u8981\u81EA\u9020\u8F93\u51FA\u683C\u5F0F\u3002",
+    locked: ["\u2462 \u8F93\u51FA\u5951\u7EA6 / JSON Schema\uFF08{d,a,r} \u7F16\u7801\u4E0E r \u53CC\u4E0B\u6807\u89C4\u5219\uFF09", "\u2463 \u8FD0\u884C\u65F6\u6570\u636E\u533A\uFF08SA \u6458\u8981 / \u8DEF\u7531\u4FE1\u53F7 / \u73AF\u5883\u65F6\u95F4\uFF0C\u6BCF\u8F6E\u81EA\u52A8\u6CE8\u5165\uFF09"]
+  },
+  composer: {
+    role: "\u6210\u6587\u8282\u70B9\uFF1A\u4F9D\u636E\u5F53\u8F6E\u4E8B\u5B9E/\u6D41\u7A0B\uFF0C\u751F\u6210\u6700\u7EC8\u53D1\u7ED9\u7528\u6237\u7684\u5BA2\u670D\u8BDD\u672F\uFF08\u542B\u8F6C\u4EBA\u5DE5\u4FE1\u53F7\uFF09\u3002",
+    editable: "\u2461 \u4F5C\u8005\u6B63\u6587\uFF1A\u56DE\u590D\u7B56\u7565\u3001\u8C03\u6027\u3001\u4E8B\u5B9E\u6D88\u8D39\u89C4\u5219\u3001@\u5F15\u7528\u5E97\u94FA\u901A\u7528\u8BDD\u672F/\u63A8\u8350/\u63A5\u7BA1 SOP\u3002",
+    mustOutput: "JSON \u5BF9\u8C61 {messages:[...], transfer_to_human:bool}\uFF1Amessages \u4E3A\u7EAF\u6587\u672C\u6D88\u606F\u6570\u7EC4\uFF08\u56FE\u7247 URL \u5355\u72EC\u6210\u6761\uFF09\uFF0C\u8F6C\u4EBA\u5DE5\u7F6E transfer_to_human=true\u3002\u683C\u5F0F\u7531\u5E73\u53F0 \u2462 \u9501\u5B9A\u3002",
+    locked: ["\u2462 \u8F93\u51FA\u5951\u7EA6 / JSON Schema\uFF08messages + transfer_to_human + \u5E73\u53F0\u8C03\u6027\u793A\u4F8B\uFF09", "\u2463 \u8FD0\u884C\u65F6\u6570\u636E\u533A\uFF08\u5DE5\u5177\u7ED3\u679C / SA action / \u4E8B\u5B9E\u5206\u7EA7\uFF0C\u6BCF\u8F6E\u81EA\u52A8\u6CE8\u5165\uFF09"]
+  },
+  qa_inspector: {
+    role: "\u8D28\u68C0\u8282\u70B9\uFF1A\u5BF9 composer \u4EA7\u51FA\u7684\u7528\u6237\u53EF\u89C1\u56DE\u590D\u505A\u5408\u89C4/\u91CD\u590D\u6821\u9A8C\uFF0C\u51B3\u5B9A\u653E\u884C / \u6539\u5199 / \u8F6C\u4EBA\u5DE5\u3002",
+    editable: "\u2461 \u4F5C\u8005\u6B63\u6587\uFF1A\u5224\u5B9A\u6807\u51C6\uFF08\u4F55\u4E3A\u5408\u683C / \u95EE\u9898 / \u8BED\u4E49\u91CD\u590D / \u8BE5\u8F6C\u4EBA\u5DE5\uFF09\u3001\u6E05\u7406\u89C4\u5219\u3001@\u5F15\u7528\u56FE\u7247\u89C4\u5219\u3002",
+    mustOutput: '\u7ED3\u8BBA\u6309\u5E73\u53F0 \u2462 \u7F16\u7801\uFF1A\u5408\u683C\u2192`0`\uFF0C\u8BED\u4E49\u91CD\u590D\u2192`-1`\uFF0C\u6539\u5199\u2192`{"messages":[...]}`\uFF0C\u8F6C\u4EBA\u5DE5\u2192`{"messages":[...,"TRANSFER"]}`\uFF08\u672B\u9879\u6052\u4E3A "TRANSFER"\uFF09\u3002\u2462 \u53EA\u5B9A\u4E49\u300C\u7ED3\u8BBA\u2192\u7F16\u7801\u300D\u63A5\u53E3\uFF0C\u5224\u5B9A\u6807\u51C6\u5168\u5728\u4F60\u7684\u6B63\u6587\u3002',
+    locked: ["\u2462 \u8F93\u51FA\u5951\u7EA6\uFF08\u7ED3\u8BBA\u2192\u7F16\u7801\uFF1A0 / -1 / JSON / TRANSFER \u534F\u8BAE\uFF09", "\u2463 \u8FD0\u884C\u65F6\u6570\u636E\u533A\uFF08\u73AF\u5883 / \u65F6\u95F4\uFF0C\u6BCF\u8F6E\u81EA\u52A8\u6CE8\u5165\uFF09"]
+  },
+  // 伪 stage（spec 2026-06-08）：不是产出完整 system prompt 的真节点，而是被 planner/tool_selector/
+  // composer/qa 四节点共享注入的「图片处理方法论」片段。
+  image_understanding: {
+    role: "\u56FE\u7247\u7406\u89E3\u65B9\u6CD5\u8BBA\uFF08\u4F2A stage\uFF09\uFF1A\u5B9A\u4E49\u770B\u5230\u56FE\u7247\u540E\u600E\u4E48\u63D0\u53D6\u4E8B\u5B9E / \u7ED3\u5408\u610F\u56FE / \u8DEF\u7531\uFF0C\u88AB 4 \u4E2A\u8282\u70B9\u5171\u4EAB\u6CE8\u5165\u3002",
+    editable: "\u6574\u6BB5\u65B9\u6CD5\u8BBA\uFF1A\u56FE\u7247\u4E09\u6B65\u6D41\u7A0B\u7684\u63AA\u8F9E\u3001\u5E97\u94FA\u8BC6\u522B\u8868 / \u6613\u6DF7\u6DC6\u89C4\u5219 / \u56DE\u7B54\u5185\u5BB9\u5E93\u3002\u6BCF\u5BB6\u5E97\u56FE\u7247\u4E1A\u52A1\u4E0D\u540C\uFF0C\u53EF\u81EA\u7531\u6539\u5199\u3002",
+    mustOutput: "\u65E0\u72EC\u7ACB\u8F93\u51FA\u5951\u7EA6\u2014\u2014\u672C\u914D\u7F6E\u662F\u88AB\u6CE8\u5165\u8FDB {{image_understanding_rules}} \u7684\u65B9\u6CD5\u8BBA\u7247\u6BB5\uFF0C\u4E0D\u4EA7\u51FA JSON\u3002\u9501\u5B9A\u7684\u54C1\u724C\u5F52\u5C5E\u7EA2\u7EBF / \u56FE\u7247\u4E8B\u5B9E\u7EA2\u7EBF / \u56FE\u7247\u5448\u73B0\u673A\u5236\u7531\u5E73\u53F0 code-assemble \u5305\u88F9\uFF0C\u4E0D\u5728\u4F60\u7684\u53EF\u7F16\u8F91\u5185\u5BB9\u91CC\u3001\u4E5F\u65E0\u6CD5\u88AB\u5220\u6539\u3002",
+    locked: ["\u54C1\u724C\u5F52\u5C5E\u7EA2\u7EBF\uFF08\u4EC5 composer/qa reply \u8282\u70B9 code-assemble\uFF09", "\u56FE\u7247\u4E8B\u5B9E\u7EA2\u7EBF reply_fact\uFF08\u542B\u7EAF\u56FE\u5148\u6F84\u6E05\uFF0C\u4EC5 reply \u8282\u70B9\uFF09", "\u56FE\u7247\u5448\u73B0\u673A\u5236\uFF08\u6700\u8FD1\u56FE\u7247\u76F4\u63A5\u770B / \u66F4\u65E9\u56FE\u7247 [\u5386\u53F2\u56FE\u7247] \u5360\u4F4D\uFF09"]
+  }
+};
+var EDITING_RULES = "\u6B63\u6587\u91CC @\u5F15\u7528 \u5199 {{name}}\uFF08\u4EC5 ASCII \u6807\u8BC6\u7B26\u88AB\u89E3\u6790\uFF1B\u4E2D\u6587/\u591A\u8BCD\u6309\u5B57\u9762\u6587\u672C\u4E0D\u89E3\u6790\uFF09\uFF1B\u53EA\u80FD\u5F15\u7528 variables \u91CC\u7684 name\uFF1B\u2462\u2463 \u5E73\u53F0\u9501\u5B9A\u3001\u4E0D\u51FA\u73B0\u5728\u4F60\u7684\u6B63\u6587\u91CC\uFF0C\u522B\u5C1D\u8BD5\u6539\uFF1B\u7A7A\u4E32\u8349\u7A3F = \u56DE\u843D\u5E73\u53F0\u51FA\u5382\u9ED8\u8BA4\u3002";
+function buildNodeDescribe(stage) {
+  const charter = NODE_CHARTERS[stage];
+  if (!charter) {
+    throw new Error(`\u65E0\u8BE5\u8282\u70B9 charter\uFF1A${stage}`);
+  }
+  return {
+    stage,
+    charter,
+    variables: referencesForStage(stage).map((r) => ({
+      name: r.name,
+      label: r.label,
+      desc: r.desc,
+      category: r.category,
+      readOnly: !!r.readOnly
+    })),
+    editing_rules: EDITING_RULES
+  };
+}
+
+// src/utils/node-template-validate.ts
+var EXPOSED_NODE_STAGES = ["planner", "composer", "qa_inspector", "image_understanding"];
+function isExposedStage(stage) {
+  return EXPOSED_NODE_STAGES.includes(stage);
+}
+var INTERP_RE = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+function extractInterpolationNames(text) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of text.matchAll(INTERP_RE)) {
+    const name = m[1];
+    if (!seen.has(name)) {
+      seen.add(name);
+      out.push(name);
+    }
+  }
+  return out;
+}
+function computeUnknownNames(content, factoryDefault) {
+  const legal = /* @__PURE__ */ new Set([
+    ...ALL_REFERENCE_NAMES,
+    ...extractInterpolationNames(factoryDefault)
+  ]);
+  return extractInterpolationNames(content).filter((n) => !legal.has(n));
+}
+
+// src/commands/node-template.ts
+var STAGE_HINT = EXPOSED_NODE_STAGES.join("|");
+function assertStage(stage) {
+  if (!isExposedStage(stage)) {
+    throw new Error(`\u4E0D\u652F\u6301\u7684\u8282\u70B9\uFF1A${stage}\uFF08\u5F53\u524D\u53EF\u7528\uFF1A${STAGE_HINT}\uFF09`);
+  }
+  return stage;
+}
+function parseVersionNo(raw) {
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n <= 0) {
+    throw new Error(`\u975E\u6CD5\u7684 version_no: ${raw}\uFF08\u5FC5\u987B\u4E3A\u6B63\u6574\u6570\uFF09`);
+  }
+  return n;
+}
+function resolveContent(opts) {
+  const provided = [opts.content !== void 0, !!opts.contentFile, !!opts.stdin].filter(Boolean).length;
+  if (provided !== 1) {
+    throw new Error("\u5185\u5BB9\u6765\u6E90\u987B\u6070\u597D\u4E00\u4E2A\uFF1A--content <\u6587\u672C> | --content-file <\u8DEF\u5F84> | --stdin");
+  }
+  if (opts.content !== void 0) return opts.content;
+  if (opts.contentFile) return readFileSync(opts.contentFile, "utf8");
+  return readFileSync(0, "utf8");
+}
+function registerNodeTemplateCommand(program2) {
+  const nt = program2.command("node-template").description(
+    `\u8282\u70B9\u6A21\u677F\uFF08\u9AD8\u7EA7\u6A21\u677F\uFF09\u64CD\u4F5C \u2014\u2014 \u83B7\u53D6\u5185\u5BB9\u3001\u6539\u52A8\u53D1\u5E03\u3001\u5386\u53F2/\u56DE\u6EAF\u3002\u8282\u70B9 stage\uFF1A${STAGE_HINT}\uFF08tool_selector \u6682\u4E0D\u653E\u51FA\uFF09\u3002\u9AD8\u7EA7\u6A21\u5F0F\u5F00\u5173\u5DF2\u6539\u4E3A\u5BA2\u6237\u81EA\u52A9\uFF08cs-client \u5185\u5F00\u5173\uFF09\uFF0CCLI \u4E0D\u518D\u63D0\u4F9B enroll \u5F00\u542F\u8DEF\u5F84\u3002\u670D\u52A1\u7AEF\uFF1Acustomer-servhub-api /v1/customer-agent/{config_id}/customer_config/node-templates*\uFF1B\u5951\u7EA6 docs/devkit/specs/2026-06-08-\u8282\u70B9\u6A21\u677F-cli-\u64CD\u4F5C\u9762.md`
+  );
+  nt.command("describe").description(
+    `\u8282\u70B9\u7F16\u5199\u8BF4\u660E\u4E66\uFF08AI \u7F16\u5199\u524D\u5FC5\u8BFB\uFF09\uFF1A\u6BCF\u4E2A\u8282\u70B9\u7684\u804C\u8D23/\u53EF\u7F16\u8F91\u9762/\u8F93\u51FA\u5951\u7EA6/\u5E73\u53F0\u9501\u5B9A\u6BB5 + \u672C\u8282\u70B9\u53EF @\u5F15\u7528 \u7684\u53D8\u91CF\u76EE\u5F55\u3002\u4E0D\u4F20 --stage = \u5168\u90E8\u5DF2\u5F00\u653E\u8282\u70B9\uFF08${STAGE_HINT}\uFF09\u3002\u7EAF\u9759\u6001\u3001\u4E0E\u5177\u4F53 agent \u65E0\u5173\uFF0C\u65E0\u9700 --agent\u3002`
+  ).option("--stage <stage>", `\u5355\u8282\u70B9\uFF1A${STAGE_HINT}`).action((opts) => {
+    try {
+      if (opts.stage) {
+        const stage = assertStage(opts.stage);
+        formatOutput({ success: true, data: buildNodeDescribe(stage) }, program2.opts().table);
+        return;
+      }
+      const data = EXPOSED_NODE_STAGES.map((s) => buildNodeDescribe(s));
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("get").description("\u83B7\u53D6\u8282\u70B9\u6A21\u677F\u5185\u5BB9\uFF08\u4E0D\u4F20 --stage=\u5168\u90E8\u5DF2\u5F00\u653E\u8282\u70B9\uFF1Btool_selector \u4E00\u5F8B\u6EE4\u9664\uFF09").requiredOption("--agent <id>", "customer_agent_config_id").option("--stage <stage>", `\u5355\u8282\u70B9\u8FC7\u6EE4\uFF1A${STAGE_HINT}`).action(async (opts) => {
+    try {
+      const payload = await getNodeTemplates(opts.agent);
+      if (opts.stage) {
+        const stage = assertStage(opts.stage);
+        const data2 = {
+          config_id: payload.config_id,
+          stage,
+          node: payload.nodes?.[stage],
+          factory_default: payload.factory_defaults?.[stage] ?? ""
+        };
+        formatOutput({ success: true, data: data2 }, program2.opts().table);
+        return;
+      }
+      const exposed = new Set(EXPOSED_NODE_STAGES);
+      const nodes = {};
+      for (const [k, v] of Object.entries(payload.nodes ?? {})) {
+        if (exposed.has(k)) nodes[k] = v;
+      }
+      const factory = {};
+      for (const [k, v] of Object.entries(payload.factory_defaults ?? {})) {
+        if (exposed.has(k)) factory[k] = v;
+      }
+      const data = {
+        config_id: payload.config_id,
+        stages: (payload.stages ?? []).filter((s) => exposed.has(s)),
+        nodes,
+        factory_defaults: factory
+      };
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("set-draft").description("\u5199\u5355\u8282\u70B9\u8349\u7A3F\uFF08\u6574\u6BB5\u8986\u76D6\uFF1B\u7A7A\u4E32=\u56DE\u843D\u51FA\u5382\u9ED8\u8BA4\uFF09\u3002\u5185\u5BB9\u4E09\u9009\u4E00\uFF0C\u957F prompt \u5EFA\u8BAE --content-file").requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--stage <stage>", `\u8282\u70B9\uFF1A${STAGE_HINT}`).option("--content <text>", "\u5185\u8054\u6B63\u6587").option("--content-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u6B63\u6587").option("--stdin", "\u4ECE\u6807\u51C6\u8F93\u5165\u8BFB\u6B63\u6587", false).action(async (opts) => {
+    try {
+      const stage = assertStage(opts.stage);
+      const content = resolveContent(opts);
+      const data = await setNodeTemplateDraft(opts.agent, stage, content);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("publish").description("\u53D1\u5E03\u8BE5\u8282\u70B9\u5F53\u524D\u8349\u7A3F\u4E0A\u7EBF\uFF08\u53D1\u5E03\u524D\u6821\u9A8C {{}} \u5408\u6CD5\u6027\uFF0C\u4E0D\u5408\u6CD5\u62D2\u7EDD\uFF1B--force \u8D8A\u8FC7\u6821\u9A8C\uFF09").requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--stage <stage>", `\u8282\u70B9\uFF1A${STAGE_HINT}`).option("--force", "\u8DF3\u8FC7 {{}} \u5408\u6CD5\u6027\u6821\u9A8C\u76F4\u63A5\u53D1\u5E03", false).action(async (opts) => {
+    try {
+      const stage = assertStage(opts.stage);
+      if (!opts.force) {
+        const payload = await getNodeTemplates(opts.agent);
+        const node = payload.nodes?.[stage];
+        const draft = node?.content ?? "";
+        const factory = payload.factory_defaults?.[stage] ?? "";
+        const unknown = computeUnknownNames(draft, factory);
+        if (unknown.length > 0) {
+          throw new Error(
+            `\u8349\u7A3F\u542B\u975E\u6CD5\u63D2\u503C\u540D\uFF0C\u62D2\u7EDD\u53D1\u5E03\uFF1A${unknown.map((n) => `{{${n}}}`).join(" ")}\u3002\u8BF7\u4FEE\u6B63\u4E3A\u5408\u6CD5\u5F15\u7528\u540D\uFF0C\u6216\u786E\u8BA4\u65E0\u8BEF\u540E\u52A0 --force \u8D8A\u8FC7\u6821\u9A8C\u3002`
+          );
+        }
+      }
+      const data = await publishNodeTemplate(opts.agent, stage);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("versions").description("\u5217\u8BE5\u8282\u70B9\u5386\u53F2\u7248\u672C\u65F6\u95F4\u7EBF").requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--stage <stage>", `\u8282\u70B9\uFF1A${STAGE_HINT}`).action(async (opts) => {
+    try {
+      const stage = assertStage(opts.stage);
+      const data = await listNodeTemplateVersions(opts.agent, stage);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("version").description("\u53D6\u8BE5\u8282\u70B9\u67D0\u7248\u672C\u6B63\u6587\uFF08\u9884\u89C8/diff\uFF09").requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--stage <stage>", `\u8282\u70B9\uFF1A${STAGE_HINT}`).requiredOption("--version <no>", "\u7248\u672C\u53F7\uFF08\u6B63\u6574\u6570\uFF09").action(async (opts) => {
+    try {
+      const stage = assertStage(opts.stage);
+      const versionNo = parseVersionNo(opts.version);
+      const data = await getNodeTemplateVersion(opts.agent, stage, versionNo);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+  nt.command("restore").description("\u628A\u8BE5\u8282\u70B9\u67D0\u5386\u53F2\u7248\u672C\u590D\u5236\u6210\u8349\u7A3F\uFF08\u4E0D\u76F4\u63A5\u751F\u6548\uFF0C\u9700\u518D publish\uFF09").requiredOption("--agent <id>", "customer_agent_config_id").requiredOption("--stage <stage>", `\u8282\u70B9\uFF1A${STAGE_HINT}`).requiredOption("--version <no>", "\u8981\u56DE\u6EAF\u5230\u7684\u7248\u672C\u53F7\uFF08\u6B63\u6574\u6570\uFF09").action(async (opts) => {
+    try {
+      const stage = assertStage(opts.stage);
+      const versionNo = parseVersionNo(opts.version);
+      const data = await restoreNodeTemplateVersion(opts.agent, stage, versionNo);
+      formatOutput({ success: true, data }, program2.opts().table);
+    } catch (err) {
+      reportCaughtError(err);
+      process.exit(toExitCode(err));
+    }
+  });
+}
+
 // src/client/ops-agent-api.ts
 async function listOpsAgentConversations(opts) {
   const workspaceId = getWorkspaceId(opts.workspaceId);
@@ -3825,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 = {};
@@ -3833,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"
   });
 }
@@ -4247,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 = {};
@@ -4259,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
   });
@@ -5350,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) => {
@@ -5416,6 +6115,7 @@ registerFaqCommand(program);
 registerConversationCommand(program);
 registerDebugCommand(program);
 registerMonitorCommand(program);
+registerNodeTemplateCommand(program);
 registerDashboardCommand(program);
 registerRepairRecordCommand(program);
 registerOperationsRecordCommand(program);

package/package.json

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