@xbongbong/xbbcli 2.0.0

package/opportunity-handover.js

@@ -0,0 +1,130 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.xbbcli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/opportunity/handover';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+
+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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    resultMsg: '',
+    resultType: '',
+    code,
+    msg,
+  }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'opportunity-handover',
+  description: '销售机会移交接口（businessType: 301）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataIdList', type: 'str', help: '销售机会id列表，JSON数组字符串，最多200条（必填）' },
+    { name: 'businessUserId', type: 'str', help: '移交目标人员id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['resultMsg', 'resultType', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+
+    const payload = {
+      corpid,
+      businessUserId: String(kwargs.businessUserId || ''),
+    };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+
+    let dataIdList;
+    try {
+      dataIdList = JSON.parse(String(kwargs.dataIdList || ''));
+    } catch {
+      dataIdList = null;
+    }
+    if (Array.isArray(dataIdList)) {
+      payload.dataIdList = dataIdList;
+    }
+
+    const body = JSON.stringify(payload);
+
+    if (!payload.corpid) {
+      return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    }
+    if (!Array.isArray(dataIdList) || !dataIdList.length) {
+      return makeErrorRow('NO_DATAIDLIST', '缺少 --dataIdList 或格式不正确，需为JSON数组');
+    }
+    if (!payload.businessUserId) {
+      return makeErrorRow('NO_BUSINESSUSERID', '缺少 --businessUserId');
+    }
+    if (!token) {
+      return makeErrorRow('NO_TOKEN', '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    }
+
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, userId ? { userId } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body,
+    });
+
+    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 result = data.result || {};
+    return [{
+      resultMsg: result.resultMsg || '',
+      resultType: result.resultType || '',
+      code: data.code ?? '',
+      msg: data.msg || '',
+    }];
+  },
+});

package/opportunity-list.js

@@ -0,0 +1,169 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.xbbcli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+const OPPORTUNITY_LIST_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/opportunity/list';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+let lastPagination = null;
+
+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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function buildConditions(kwargs) {
+  const conditions = [];
+  if (kwargs.attr && kwargs.value) {
+    conditions.push({
+      attr: String(kwargs.attr),
+      value: [String(kwargs.value)],
+      symbol: String(kwargs.symbol || 'equal'),
+    });
+  }
+  return conditions;
+}
+
+function buildPayload(kwargs, corpid) {
+  const payload = {
+    corpid,
+    formId: Number(kwargs.formId || 0),
+    ...(String(kwargs.page ?? '') !== '' ? { page: Number(kwargs.page) } : {}),
+    ...(String(kwargs.pageSize ?? '') !== '' ? { pageSize: Number(kwargs.pageSize) } : {}),
+  };
+  if (kwargs.userId) payload.userId = String(kwargs.userId);
+  if (String(kwargs.viewApproval || '') !== '') payload.viewApproval = String(kwargs.viewApproval);
+  const conditions = buildConditions(kwargs);
+  if (conditions.length) payload.conditions = conditions;
+  return payload;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    rank: '',
+    dataId: '',
+    formId: '',
+    name: '',
+    serialNo: '',
+    customerId: '',
+    opportunityAmount: '',
+    ownerId: '',
+    addTime: '',
+    updateTime: '',
+    code,
+    msg,
+  }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'opportunity-list',
+  description: '销售机会列表接口（businessType: 301；formId必填）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'viewApproval', type: 'str', default: '', help: '是否查询审批中数据，1是，0否' },
+    { name: 'attr', type: 'str', default: '', help: '筛选字段 attr，例如 serialNo' },
+    { name: 'value', type: 'str', default: '', help: '筛选值，和 --attr 配合使用' },
+    { name: 'symbol', type: 'str', default: 'equal', help: '筛选操作符，默认 equal' },
+    { name: 'page', type: 'str', default: '', help: '页码（可选）' },
+    { name: 'pageSize', type: 'str', default: '', help: '每页数量（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+    { name: 'raw', type: 'bool', default: false, help: '输出接口返回的原文' },
+  ],
+  columns: ['rank', 'dataId', 'formId', 'name', 'serialNo', 'customerId', 'opportunityAmount', 'ownerId', 'addTime', 'updateTime', 'code', 'msg'],
+  footerExtra: () => (lastPagination ? `totalCount ${lastPagination.totalCount} / totalPage ${lastPagination.totalPage}` : undefined),
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = buildPayload(kwargs, corpid);
+    const body = JSON.stringify(payload);
+
+    if (!payload.corpid) {
+      return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    }
+    if (!payload.formId) {
+      return makeErrorRow('NO_FORMID', '缺少 --formId');
+    }
+    if (!token) {
+      return makeErrorRow('NO_TOKEN', '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    }
+
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, OPPORTUNITY_LIST_API_URL);
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, userId ? { userId } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body,
+    });
+
+    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();
+    lastPagination = data?.code === 1 && data?.result?.totalCount != null && data?.result?.totalPage != null
+      ? { totalCount: data.result.totalCount, totalPage: data.result.totalPage }
+      : null;
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (kwargs.raw) return [{ raw: responseBody }];
+    if (data.code !== 1) {
+      return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    }
+
+    const list = Array.isArray(data.result?.list) ? data.result.list : [];
+    if (!list.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但 list 为空');
+    }
+
+    return list.map((item, index) => ({
+      rank: index + 1,
+      dataId: item.dataId || '',
+      formId: item.formId || '',
+      name: item.data?.text_1 || '',
+      serialNo: item.data?.serialNo || '',
+      customerId: item.data?.text_3 || '',
+      opportunityAmount: item.data?.num_1 || '',
+      ownerId: item.data?.creatorId || '',
+      addTime: item.addTime || '',
+      updateTime: item.updateTime || '',
+      code: '',
+      msg: '',
+    }));
+  },
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@xbongbong/xbbcli",
+  "version": "2.0.0",
+  "description": "销帮帮 CRM 的独立命令行工具",
+  "type": "module",
+  "bin": {
+    "xbbcli": "./bin/xbbcli.js"
+  },
+  "files": [
+    "bin",
+    "*.js",
+    "README.md"
+  ],
+  "keywords": [
+    "xbb",
+    "销帮帮",
+    "crm",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chenhb1988/opencli-plugin-xbb.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chenhb1988/opencli-plugin-xbb/issues"
+  },
+  "homepage": "https://github.com/chenhb1988/opencli-plugin-xbb#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/pay-plan-add-couser.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.xbbcli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/payPlan/addCoUser';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+
+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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'pay-plan-add-couser',
+  description: '付款计划添加协同人接口（businessType: 801）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '付款计划id（必填）' },
+    { name: 'businessUserIdList', type: 'str', help: '需添加的协同人id列表，JSON数组字符串（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['resultCode', 'resultMsg', 'messageList', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = { dataId: Number(kwargs.dataId || 0), corpid };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+
+    let businessUserIdList;
+    try {
+      businessUserIdList = JSON.parse(String(kwargs.businessUserIdList || ''));
+    } catch {
+      businessUserIdList = null;
+    }
+    if (Array.isArray(businessUserIdList)) payload.businessUserIdList = businessUserIdList;
+
+    const requestBody = JSON.stringify(payload);
+    if (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!Array.isArray(businessUserIdList) || !businessUserIdList.length) return makeErrorRow('NO_USERIDLIST', '缺少 --businessUserIdList 或格式不正确，需为JSON数组');
+    if (!token) return makeErrorRow('NO_TOKEN', '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, userId ? { userId } : {});
+    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) 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 [{ resultCode: data.code ?? '', resultMsg: data.msg || '', messageList: JSON.stringify(data.result?.messageList || []), code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/pay-plan-add-mainuser.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.xbbcli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/payPlan/addMainUser';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+
+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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'pay-plan-add-mainuser',
+  description: '付款计划添加负责人接口（businessType: 801）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '付款计划id（必填）' },
+    { name: 'businessUserIdList', type: 'str', help: '需添加的负责人id列表，JSON数组字符串（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['resultCode', 'resultMsg', 'messageList', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = { dataId: Number(kwargs.dataId || 0), corpid };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+
+    let businessUserIdList;
+    try {
+      businessUserIdList = JSON.parse(String(kwargs.businessUserIdList || ''));
+    } catch {
+      businessUserIdList = null;
+    }
+    if (Array.isArray(businessUserIdList)) payload.businessUserIdList = businessUserIdList;
+
+    const requestBody = JSON.stringify(payload);
+    if (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!Array.isArray(businessUserIdList) || !businessUserIdList.length) return makeErrorRow('NO_USERIDLIST', '缺少 --businessUserIdList 或格式不正确，需为JSON数组');
+    if (!token) return makeErrorRow('NO_TOKEN', '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, userId ? { userId } : {});
+    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) 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 [{ resultCode: data.code ?? '', resultMsg: data.msg || '', messageList: JSON.stringify(data.result?.messageList || []), code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/pay-plan-add.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { cli, Strategy } from './xbb-registry.js';
+
+const CONFIG_DIR = path.join(os.homedir(), '.xbbcli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/payPlan/add';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+
+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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ dataId: '', resultCode: '', resultMsg: '', code, msg }];
+}
+
+function parseDataList(raw) {
+  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+    return raw;
+  }
+  const text = String(raw || '').trim();
+  if (!text) return null;
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+cli({
+  site: 'xbb',
+  name: 'pay-plan-add',
+  description: '新增付款计划（businessType: 801）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataList', type: 'str', help: '表单数据JSON字符串（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['dataId', 'resultCode', 'resultMsg', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = { corpid };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+
+    const parsedDataList = parseDataList(kwargs.dataList);
+    if (parsedDataList) payload.dataList = parsedDataList;
+
+    const body = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!token) return makeErrorRow('NO_TOKEN', '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (parsedDataList === null) return makeErrorRow('NO_DATALIST', '缺少 --dataList');
+    if (parsedDataList === undefined) return makeErrorRow('INVALID_DATALIST', '--dataList 必须是 JSON 对象字符串');
+
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, userId ? { userId } : {});
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, {
+      method: 'POST',
+      headers,
+      body,
+    });
+    if (!resp.ok) 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 result = data.result || {};
+    return [{ dataId: result.dataId || result.formDataId || '', resultCode: result.code ?? '', resultMsg: result.msg || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});