@xbongbong/xbbcli 2.0.0

package/README.md

@@ -0,0 +1,436 @@
+# xbbcli
+
+销帮帮 CRM (`xbb`) 命令行工具。所有命令直接调用 HTTP API，不依赖 `opencli` 或浏览器。
+
+## 安装
+
+```bash
+npm install -g @xbongbong/xbbcli
+xbbcli --help
+```
+
+开发目录中也可以直接运行 `node bin/xbbcli.js`。
+
+需要升级时运行 `npm update -g @xbongbong/xbbcli`。
+
+## 初始化配置
+
+首次使用先保存 `corpid`、`token` 和 `userId`：
+
+```bash
+xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>
+```
+
+执行后会写入：
+
+```text
+~/.xbbcli/config.env
+```
+
+文件内容包含：
+
+- `corpid`
+- `token`
+- `baseurl`
+- `userId`
+
+同时会自动拉取两份表单清单并合并缓存到：
+
+```text
+~/.xbbcli/<corpid>.formlist.json
+```
+
+初始化过程会直接调用接口拉取两份表单清单：
+
+```bash
+xbbcli form-list --saasMark 2 -f json
+xbbcli form-list --saasMark 1 -f json
+```
+
+`baseurl` 路由规则：
+
+- `corpid` 以 `ding` 开头，或包含 `$$ding` 时，使用 `https://proapi.xbongbong.com`
+- 其他 `corpid` 使用 `https://appapi.xbongbong.com`
+
+## 当前支持的命令
+
+### 配置
+
+- `token-set`：保存个人 token、`corpid`、`userId`、`baseurl`，并刷新本地表单缓存；传入的 token 不以 `user_` 开头时，会先为该 `userId` 刷新并保存个人 token
+- `token-generate`：生成/获取个人 token，`--resetToken 0` 获取（默认）、`1` 刷新；`--checkUserId` 未传则用配置中的 `userId`
+
+### 组织与人员
+
+- `user-list`：用户列表
+- `user-add`：新建用户
+- `user-edit`：编辑用户
+- `user-del`：删除用户
+- `user-handover`：用户交接
+- `department-list`：部门列表
+- `department-add`：新建部门
+- `department-edit`：编辑部门
+- `department-del`：删除部门
+- `role-list`：角色列表
+
+### CRM 主数据
+
+- `customer-list`：客户列表
+- `customer-detail`：客户详情
+- `customer-add`：新增客户
+- `customer-edit`：编辑客户
+- `customer-add-couser`：客户添加协同人
+- `customer-del`：删除客户
+- `customer-back`：客户退回公海
+- `customer-handover`：客户移交
+- `customer-distribution`：客户分配
+- `customer-delete-mainuser`：客户删除负责人
+- `customer-delete-couser`：客户删除协同人
+- `customer-invoice-info`：客户开票信息列表
+- `customer-invoice-info-add`：新增客户开票信息
+- `customer-invoice-info-edit`：编辑客户开票信息
+- `customer-invoice-address`：客户开票地址列表
+- `customer-invoice-address-add`：新增客户开票地址
+- `customer-invoice-address-edit`：编辑客户开票地址
+- `clue-list`：线索列表
+- `clue-add`：新建线索
+- `clue-edit`：编辑线索
+- `clue-detail`：线索详情
+- `clue-del`：删除线索
+- `clue-add-couser`：线索添加协同人
+- `clue-delete-couser`：线索删除协同人
+- `clue-delete-mainuser`：线索删除负责人
+- `clue-distribution`：线索分配
+- `clue-back`：线索退回公海
+- `clue-thorough-delete`：线索彻底删除
+- `contact-list`：联系人列表
+- `contact-add`：新建联系人
+- `contact-edit`：编辑联系人
+- `contact-detail`：联系人详情
+- `contact-del`：删除联系人
+- `contact-add-couser`：联系人添加协同人
+- `contact-add-mainuser`：联系人添加负责人
+- `contact-delete-couser`：联系人删除协同人
+- `contact-delete-mainuser`：联系人删除负责人
+- `contact-handover`：联系人移交
+
+### 销售机会操作
+
+- `opportunity-add`：新建销售机会
+- `opportunity-edit`：编辑销售机会
+- `opportunity-list`：销售机会列表
+- `opportunity-detail`：销售机会详情
+- `opportunity-del`：删除销售机会
+- `opportunity-handover`：销售机会移交
+- `opportunity-add-mainuser`：销售机会添加负责人
+- `opportunity-delete-mainuser`：销售机会删除负责人
+- `opportunity-add-couser`：销售机会添加协同人
+- `opportunity-delete-couser`：销售机会删除协同人
+
+### 合同订单操作
+
+- `contract-add`：新建合同订单
+- `contract-edit`：编辑合同订单
+- `contract-list`：合同订单列表
+- `contract-detail`：合同订单详情
+- `contract-del`：删除合同订单
+- `contract-handover`：合同订单移交
+- `contract-add-mainuser`：合同订单添加负责人
+- `contract-outstock-add`：新建销售出库单
+- `contract-outstock-edit`：编辑销售出库单
+- `contract-outstock-detail`：销售出库单详情
+- `contract-outstock-del`：删除销售出库单
+- `contract-outstock-list`：销售出库单列表
+- `contract-delete-mainuser`：合同订单删除负责人
+- `contract-add-couser`：合同订单添加协同人
+- `contract-delete-couser`：合同订单删除协同人
+
+### 跟进记录操作
+
+- `communicate-add`：新建跟进记录
+- `communicate-edit`：编辑跟进记录
+- `communicate-list`：跟进记录列表
+- `communicate-detail`：跟进记录详情
+- `communicate-del`：删除跟进记录
+- `communicate-plan-list`：拜访计划列表
+- `communicate-plan-detail`：拜访计划详情
+- `communicate-plan-add`：拜访计划新建
+- `communicate-plan-cancel`：拜访计划取消
+- `communicate-plan-del`：拜访计划删除
+- `communicate-plan-single-operate`：拜访计划延期
+- `market-activity-list`：市场活动列表
+- `market-activity-add`：新建市场活动
+- `market-activity-edit`：编辑市场活动
+- `market-activity-detail`：市场活动详情
+- `market-activity-del`：删除市场活动
+- `market-activity-handover`：市场活动移交
+
+### 表单相关
+
+- `form-list`：表单模板列表
+- `form-get`：表单模板字段定义，在填充参数时不清楚参数含义/下拉框可选项值，调用本接口获取 form 解释
+- `form-data-list`：自定义表单数据列表
+- `form-data-detail`：自定义表单数据详情
+- `form-data-add`：新增自定义表单数据
+- `form-data-edit`：编辑自定义表单数据
+- `form-data-del`：删除自定义表单数据
+- `form-data-add-mainuser`：自定义表单添加负责人
+- `form-data-delete-mainuser`：自定义表单删除负责人
+- `form-data-add-couser`：自定义表单添加协同人
+- `form-data-delete-couser`：自定义表单删除协同人
+- `form-data-handover`：自定义表单移交
+
+### 产品
+
+- `product-list`：产品列表
+- `product-detail`：产品详情
+- `product-add`：新建产品
+- `product-edit`：编辑产品
+- `product-del`：删除产品
+- `product-online`：产品上下架
+- `product-category-list`：产品分类列表
+- `product-category-add`：新建产品分类
+- `product-category-update`：编辑产品分类
+- `product-category-del`：删除产品分类
+
+### 应收款操作
+
+- `payment-list`：应收款列表
+- `payment-add`：新建应收款
+- `payment-edit`：编辑应收款
+- `payment-detail`：应收款详情
+- `payment-del`：删除应收款
+- `payment-handover`：应收款移交
+- `payment-add-mainuser`：应收款添加负责人
+- `payment-delete-mainuser`：应收款删除负责人
+- `payment-add-couser`：应收款添加协同人
+- `payment-delete-couser`：应收款删除协同人
+
+### 回款与退款
+
+- `payment-sheet-list`：回款单列表
+- `payment-sheet-add-write-off`：新建核销回款单
+- `payment-sheet-edit-write-off`：编辑核销回款单
+- `payment-sheet-add-red`：新建红冲回款单
+- `payment-sheet-edit-red`：编辑红冲回款单
+- `payment-sheet-add-bad-debt`：新建坏账回款单
+- `payment-sheet-edit-bad-debt`：编辑坏账回款单
+- `payment-sheet-add-pre`：新建预收款回款单
+- `payment-sheet-get-amount-detail`：回款单金额明细
+- `payment-sheet-detail`：回款单详情
+- `payment-sheet-del`：删除回款单
+- `payment-sheet-handover`：回款单移交
+- `pay-plan-add`：新增付款计划
+- `pay-plan-add-couser`：付款计划添加协同人
+- `pay-plan-add-mainuser`：付款计划添加负责人
+- `pay-plan-delete-couser`：付款计划删除协同人
+- `pay-plan-delete-mainuser`：付款计划删除负责人
+- `pay-sheet-list`：付款单列表
+- `pay-sheet-add-write-off`：新建付款单
+- `pay-sheet-edit-write-off`：编辑付款单
+- `pay-sheet-add-red`：新建核销付款单红冲
+- `pay-sheet-edit-red`：编辑核销付款单红冲
+- `pay-sheet-add-bad`：新建核销付款单坏账
+- `pay-sheet-edit-bad`：编辑核销付款单坏账
+- `pay-sheet-add-couser`：付款单添加协同人
+- `pay-sheet-add-mainuser`：付款单添加负责人
+- `pay-sheet-delete-couser`：付款单删除协同人
+- `pay-sheet-delete-mainuser`：付款单删除负责人
+- `pay-sheet-get-amount-detail`：付款单金额明细
+- `pay-sheet-detail`：付款单详情
+- `pay-sheet-del`：删除付款单
+- `refund-list`：退货退款单列表
+- `refund-add`：新建退货退款单
+- `refund-edit`：编辑退货退款单
+- `refund-detail`：退货退款单详情
+- `refund-del`：删除退货退款单
+
+### 新版工单（服务云）
+- `work-order-list`：新版工单列表命令
+- `work-order-detail`：工单详情
+- `work-order-add`：新增工单
+- `work-order-edit`：编辑工单
+- `work-order-del`：删除工单
+- `work-order-operate`：工单流转
+- `work-order-template-list`：工单模板列表
+- `work-order-template-detail`：工单模板详情
+- `workorder-handover`：移交工单负责人
+- `workorder-add-couser`：添加工单协同人
+- `workorder-delete-couser`：删除工单协同人
+
+
+### 工作报告
+
+- `work-report-daily-list`：日报列表
+- `work-report-daily-detail`：日报详情
+- `work-report-daily-add`：新建日报
+- `work-report-daily-edit`：编辑日报
+- `work-report-daily-del`：删除日报
+- `work-report-daily-get-work-plan`：获取工作计划
+- `work-report-weekly-list`：周报列表
+- `work-report-weekly-detail`：周报详情
+- `work-report-weekly-add`：新建周报
+- `work-report-weekly-edit`：编辑周报
+- `work-report-weekly-del`：删除周报
+- `work-report-monthly-list`：月报列表
+- `work-report-monthly-detail`：月报详情
+- `work-report-monthly-add`：新建月报
+- `work-report-monthly-edit`：编辑月报
+- `work-report-monthly-del`：删除月报
+
+### 阶段流转
+
+- `stage-get`：阶段获取
+- `stage-jump`：阶段跳转
+
+### 旧工单（已过时，不建议使用）
+- `workorderlist`：旧版工单列表命令
+- `workorderproductlist`：工单配件列表
+- `worktimerecordlist`：工时记录列表
+- `worktimerecorddetail`：工时记录详情
+
+## 命名说明
+
+仓库里现在同时保留两套工单命名：
+
+- 旧命名：`workorderlist`、`workorderproductlist`
+- 新命名：`work-order-list`、`work-order-detail`、`work-order-add`、`work-order-edit`、`work-order-del`、`work-order-operate`
+
+建议新接入优先使用带连字符的 `work-order-*` 命令。`workorderlist` 仍保留，主要用于兼容旧功能。
+
+## 通用行为
+
+- 先执行一次 `token-set` 保存有效的 `corpid`、`token`、`userId`
+- 除 `token-set` 外，其余命令都会从 `~/.xbbcli/config.env` 读取 `corpid`
+- 大部分命令会从 `~/.xbbcli/config.env` 读取 `token`
+- 所有命令会从配置中读取 `userId` 并附加到请求 header 中
+- 大部分命令需要 formId 参数，可以根据业务名称或 businessType 从 `~/.xbbcli/<corpid>.formlist.json` 中获取 formId
+- 未传入的可选参数不会进入请求体
+- `--attr` 和 `--value` 只有同时提供时才会拼入查询条件
+- `--limit` 是在响应映射之后截断结果
+- 失败时返回的是带 `code` / `msg` 的结果行，不抛异常
+- 加 `--debug` 可以输出 `requestBody` 和 `responseBody`
+- 加 `--raw` 可以输出接口返回的原始 JSON 字符串（所有 list 命令均支持）
+- 在填充参数时不清楚参数含义/下拉框可选项值，调用 `form-get` 命令获取 form 解释
+
+## 常用示例
+
+### 基础配置/初始化
+
+```bash
+xbbcli token-set --corpid your_corpid --token your_token --userId your_userid
+```
+
+### 员工信息
+
+```bash
+xbbcli user-list
+xbbcli user-list --nameLike 张三 --debug
+```
+
+### 表单查询
+
+```bash
+xbbcli form-list --saasMark 1
+xbbcli form-list --saasMark 1 --businessType 100
+xbbcli form-list --saasMark 2 --name 工单
+
+xbbcli form-get --formId 19274
+xbbcli form-get --formId 19277 --subBusinessType 100
+```
+
+### 客户
+
+```bash
+xbbcli customer-list --formId 12345
+xbbcli customer-list --formId 12345 --attr text_1 --value apiTest.001
+
+xbbcli customer-add --formId 19274 --dataList '{"text_1":"apiTest.001"}'
+xbbcli customer-edit --formId 19274 --dataId 310992 --dataList '{"text_1":"apiTest.001-编辑"}'
+xbbcli customer-detail --dataId 310992
+xbbcli customer-add-couser --dataId 310995 --businessUserIdList '["xbbTest002"]'
+```
+
+### 表单模型/业务数据
+
+```bash
+xbbcli form-data-list --formId 19274
+xbbcli form-data-detail --dataId 310992
+xbbcli form-data-add --formId 19274 --dataList '{"text_1":"apiTest.001"}'
+xbbcli form-data-edit --dataId 310992 --dataList '{"text_1":"apiTest.001-编辑"}'
+xbbcli form-data-del --dataId 310992
+```
+
+### 产品、回款、退款
+
+```bash
+xbbcli product-list --attr serialNo --value CP.API.0001
+xbbcli product-detail --dataId 10001
+xbbcli product-category-list
+xbbcli product-category-update --dataId 306 --name 分类A
+xbbcli product-category-del --dataId 306
+
+xbbcli payment-list --attr serialNo --value PMO.API.0001
+xbbcli payment-sheet-list --attr serialNo --value RMO.API.0001
+xbbcli payment-sheet-list --subBusinessType 702
+xbbcli payment-sheet-edit-write-off --dataId 1194 --dataList '{"text_7":"编辑备注"}'
+xbbcli payment-sheet-add-red --dataList '{"serialNo":"RMO.API.0001"}'
+xbbcli payment-sheet-edit-red --dataId 1198 --dataList '{"text_7":"编辑红冲备注"}'
+xbbcli payment-sheet-add-bad-debt --dataList '{"serialNo":"RMO.API.0002"}'
+xbbcli refund-list --attr serialNo --value RFO.API.0001
+```
+
+### 工单新命名
+
+```bash
+xbbcli work-order-list --formId 7526034
+xbbcli work-order-list --formId 7526034 --attr serialNo --value WOO.20210616001
+xbbcli work-order-list --formId 7526034 --conditions "[{\"attr\":\"text_4\",\"value\":[4],\"symbol\":\"in\"},{\"attr\":\"ownerId\",\"value\":[\"02415643151585\"],\"symbol\":\"equal\"}]"
+
+xbbcli work-order-detail --dataId 663
+xbbcli work-order-add --formId 7526034 --dataList '{"text_1":"测试工单"}'
+xbbcli work-order-edit --dataId 663 --dataList '{"text_1":"测试工单-更新"}'
+xbbcli work-order-del --dataId 663
+xbbcli work-order-operate --dataId 663 --operateType 12 --userId "02415643151585"
+xbbcli work-order-operate --dataId 663 --operateType 1 --data '{"cancelReason":"测试取消"}'
+```
+
+### 工单旧命名与工时
+
+```bash
+xbbcli workorderlist --formId 689 --attr serialNo --value WOO.20210616001
+xbbcli workorderproductlist --dataId 663
+xbbcli work-order-template-list
+xbbcli work-order-template-detail --formId 689
+
+xbbcli worktimerecordlist
+xbbcli worktimerecordlist --conditions "[{\"attr\":\"ownerId\",\"value\":[\"02415643151585\"],\"symbol\":\"equal\"}]"
+xbbcli worktimerecorddetail --dataId 10001
+```
+
+## 参数约定
+
+- `dataList`：JSON 对象字符串，例如 `{"text_1":"value"}`
+- `conditions`：JSON 数组字符串，例如 `[{"attr":"text_4","value":[4],"symbol":"in"}]`
+- `businessUserIdList`：支持 JSON 数组或逗号分隔字符串
+- `operateType` 常见值：
+  - `1` 取消
+  - `2` 重启
+  - `3` 移交
+  - `4` 分配
+  - `8` 接受
+  - `10` 开始
+  - `11` 签到
+  - `12` 完成
+  - `13` 签退
+  - `15` 回退
+  - `16` 结算
+  - `17` 回访
+  - `18` 指派
+  - `19` 自由节点完成
+  - `20` 编辑回执单
+
+## 调试
+
+命令加 `--debug` 后，会把请求体和原始响应一起带回结果列，便于排查签名、参数拼装和接口返回问题。
+
+命令加 `--raw` 后，直接返回接口原始 JSON 字符串（单行 `{ raw: "..." }`），适合管道处理或人工检查响应结构。所有 list 命令均支持该参数。

package/ai-call-add-task.js

@@ -0,0 +1,106 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_FILE = path.join(os.homedir(), '.opencli', 'xbb', 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/hkh/call/addTask';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 opencli xbb token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function getRuntimeConfig() {
+  const config = readConfig();
+  return {
+    corpid: String(config.corpid || '').trim(),
+    token: String(config.token || '').trim(),
+    baseUrl: String(config.baseurl || DEFAULT_BASE_URL).trim(),
+    userId: String(config.userId || '').trim(),
+  };
+}
+
+function buildApiUrl(baseUrl, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function parseJsonArray(raw) {
+  const text = String(raw || '').trim();
+  if (!text) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function makeErrorRow(code, msg) {
+  return [{ code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'ai-call-add-task',
+  description: '批量AI呼叫接口（businessType: -1；业务模块: hkh AI呼叫）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单id（必填）' },
+    { name: 'dataIdList', type: 'str', help: '客户id列表，JSON数组字符串（必填）' },
+    { name: 'id', type: 'int', help: 'AI话术ID（必填，可通过 ai-word-list 获取）' },
+    { name: 'businessType', type: 'int', help: '业务类型（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['code', 'msg'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const runtimeUserId = String(kwargs.userId || userId || '').trim();
+    const payload = { corpid };
+    payload.formId = Number(kwargs.formId || 0);
+    const parsedDataIdList = parseJsonArray(kwargs.dataIdList);
+    if (Array.isArray(parsedDataIdList)) payload.dataIdList = parsedDataIdList;
+    payload.id = Number(kwargs.id || 0);
+    payload.businessType = Number(kwargs.businessType || 0);
+    if (runtimeUserId) payload.userId = runtimeUserId;
+    const requestBody = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 opencli xbb token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!payload.formId) return makeErrorRow('NO_FORMID', '缺少 --formId');
+    if (parsedDataIdList === null) return makeErrorRow('NO_DATAIDLIST', '缺少 --dataIdList');
+    if (parsedDataIdList === undefined) return makeErrorRow('INVALID_DATAIDLIST', '--dataIdList 必须是 JSON 数组字符串');
+    if (!payload.id) return makeErrorRow('NO_ID', '缺少 --id');
+    if (!payload.businessType) return makeErrorRow('NO_BUSINESSTYPE', '缺少 --businessType');
+    if (!token) return makeErrorRow('NO_TOKEN', MISSING_TOKEN_MESSAGE);
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, runtimeUserId ? { userId: runtimeUserId } : {});
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${requestBody}\n`);
+    }
+    const resp = await fetch(apiUrl, { method: 'POST', headers, body: requestBody });
+    if (!resp.ok) {
+      const responseText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${responseText}\n`);
+      return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    }
+    const data = await resp.json();
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    return [{ code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/ai-word-list.js

@@ -0,0 +1,81 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_FILE = path.join(os.homedir(), '.opencli', 'xbb', 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/hkh/call/aiWords';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 opencli xbb token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function getRuntimeConfig() {
+  const config = readConfig();
+  return {
+    corpid: String(config.corpid || '').trim(),
+    token: String(config.token || '').trim(),
+    baseUrl: String(config.baseurl || DEFAULT_BASE_URL).trim(),
+    userId: String(config.userId || '').trim(),
+  };
+}
+
+function buildApiUrl(baseUrl, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ rank: '', id: '', wordsname: '', isonline: '', isuse: '', ismarket: '', ispy: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'ai-word-list',
+  description: '获取AI话术列表接口（businessType: -1；业务模块: hkh AI呼叫）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['rank', 'id', 'wordsname', 'isonline', 'isuse', 'ismarket', 'ispy', 'code', 'msg'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const runtimeUserId = String(kwargs.userId || userId || '').trim();
+    const payload = { corpid };
+    if (runtimeUserId) payload.userId = runtimeUserId;
+    const requestBody = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 opencli xbb token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!token) return makeErrorRow('NO_TOKEN', MISSING_TOKEN_MESSAGE);
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, runtimeUserId ? { userId: runtimeUserId } : {});
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${requestBody}\n`);
+    }
+    const resp = await fetch(apiUrl, { method: 'POST', headers, body: requestBody });
+    if (!resp.ok) {
+      const responseText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${responseText}\n`);
+      return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    }
+    const data = await resp.json();
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    const list = Array.isArray(data.result?.wordList) ? data.result.wordList : [];
+    if (!list.length) return makeErrorRow('NO_DATA', '接口成功，但 wordList 为空');
+    return list.map((item, index) => ({ rank: index + 1, id: item.id || '', wordsname: item.wordsname || '', isonline: item.isonline ?? '', isuse: item.isuse ?? '', ismarket: item.ismarket ?? '', ispy: item.ispy ?? '', code: '', msg: '' }));
+  },
+});