@xbongbong/xbbcli 2.0.0

package/user-handover.js

@@ -0,0 +1,78 @@
+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(), '.xbbcli', 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/user/handover';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli 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 [{ code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'user-handover',
+  description: '用户交接接口（businessType: -1）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'fromUserId', type: 'str', help: '需要交接工作的员工userId（必填）' },
+    { name: 'toUserId', type: 'str', help: '交接目标员工userId（必填）' },
+    { 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 payload = { fromUserId: String(kwargs.fromUserId || ''), toUserId: String(kwargs.toUserId || ''), corpid };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    const requestBody = JSON.stringify(payload);
+    if (!payload.fromUserId) return makeErrorRow('NO_FROMUSERID', '缺少 --fromUserId');
+    if (!payload.toUserId) return makeErrorRow('NO_TOUSERID', '缺少 --toUserId');
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli 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 }, 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 [{ code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/user-list.js

@@ -0,0 +1,147 @@
+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 DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const USER_LIST_API_PATH = '/pro/v2/api/user/list';
+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) {
+  return `${baseUrl.replace(/\/+$/, '')}${USER_LIST_API_PATH}`;
+}
+
+function buildPayload(kwargs, corpid) {
+  const payload = {
+    corpid,
+    ...(String(kwargs.page ?? '') !== '' ? { page: Number(kwargs.page) } : {}),
+    ...(String(kwargs.pageSize ?? '') !== '' ? { pageSize: Number(kwargs.pageSize) } : {}),
+  };
+  if (kwargs.userId) payload.userId = String(kwargs.userId);
+  if (kwargs.name) payload.name = String(kwargs.name);
+  if (kwargs.nameLike) payload.nameLike = String(kwargs.nameLike);
+  if (Number(kwargs.departmentId || 0)) payload.departmentId = Number(kwargs.departmentId);
+  if (Number(kwargs.delIgnore || 0)) payload.delIgnore = Number(kwargs.delIgnore);
+  return payload;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    rank: '',
+    userId: '',
+    name: '',
+    position: '',
+    jobnumber: '',
+    avatar: '',
+    code,
+    msg,
+  }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'user-list',
+  description: '用户列表接口（businessType: -1）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'name', type: 'str', default: '', help: '员工姓名完全匹配（可选）' },
+    { name: 'nameLike', type: 'str', default: '', help: '员工姓名模糊查询（可选）' },
+    { name: 'departmentId', type: 'int', default: 0, help: '部门id筛选（可选）' },
+    { name: 'delIgnore', type: 'int', default: 0, help: '是否查询已离职员工，0不查/1查询' },
+    { 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', 'userId', 'name', 'position', 'jobnumber', 'avatar', '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 (!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 headers = {
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    };
+    if (userId) headers.userId = userId;
+    const apiUrl = buildApiUrl(baseUrl);
+
+    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?.userList) ? data.result.userList : [];
+    if (!list.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但 userList 为空');
+    }
+
+    return list.map((item, index) => ({
+      rank: index + 1,
+      userId: item.userId || '',
+      name: item.name || '',
+      position: item.position || '',
+      jobnumber: item.jobnumber || '',
+      avatar: item.avatar || '',
+      code: '',
+      msg: '',
+    }));
+  },
+});

package/version.js

@@ -0,0 +1,18 @@
+import { cli, Strategy } from './xbb-registry.js';
+
+const VERSION = 'v1.6';
+
+cli({
+  site: 'xbb',
+  name: 'version',
+  description: '查看销帮帮插件版本号',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [],
+  columns: ['version'],
+  func: async function () {
+    return [{ version: VERSION }];
+  },
+});

package/work-order-add.js

@@ -0,0 +1,171 @@
+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(), '.xbbcli', 'config.env');
+const WORK_ORDER_ADD_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/workOrderV2/add';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli 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 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;
+  }
+}
+
+function buildPayload(kwargs, parsedDataList, corpid, defaultUserId) {
+  const payload = {
+    corpid,
+    formId: Number(kwargs.formId || 0),
+  };
+
+  const userId = String(kwargs.userId || defaultUserId || '').trim();
+  if (userId) {
+    payload.userId = userId;
+  }
+  if (parsedDataList) {
+    payload.dataList = parsedDataList;
+  }
+
+  return payload;
+}
+
+function getValidationError(payload, token, parsedDataList) {
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+  if (!payload.formId) {
+    return { code: 'NO_FORMID', msg: '缺少 --formId' };
+  }
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+  if (parsedDataList === null) {
+    return { code: 'NO_DATALIST', msg: '缺少 --dataList' };
+  }
+  if (parsedDataList === undefined) {
+    return { code: 'INVALID_DATALIST', msg: '--dataList 必须是 JSON 对象字符串' };
+  }
+
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    dataId: '',
+    resultCode: '',
+    resultMsg: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRow(data) {
+  const result = data.result || {};
+  return [{
+    dataId: result.dataId || '',
+    resultCode: result.code ?? '',
+    resultMsg: result.msg || '',
+    code: data.code ?? '',
+    msg: data.msg || '',
+  }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-order-add',
+  description: '新增工单接口（businessType: 20300；formId必填）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单模板id（必填）' },
+    { 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 function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const parsedDataList = parseDataList(kwargs.dataList);
+    const payload = buildPayload(kwargs, parsedDataList, corpid, userId);
+    const requestBody = JSON.stringify(payload);
+
+    const validationError = getValidationError(payload, token, parsedDataList);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const sign = crypto.createHash('sha256').update(requestBody + token).digest('hex');
+    const headers = Object.assign({
+      'Content-Type': 'application/json;charset=UTF-8',
+      sign,
+    }, payload.userId ? { userId: payload.userId } : {});
+    const apiUrl = buildApiUrl(baseUrl, WORK_ORDER_ADD_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 makeSuccessRow(data);
+  },
+});

package/work-order-asset-add-couser.js

@@ -0,0 +1,101 @@
+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/workOrderV2/asset/addCoUser';
+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 [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-order-asset-add-couser',
+  description: '资产添加协同人接口（businessType: -1；workOrderV2 资产）',
+  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 function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const runtimeUserId = String(kwargs.userId || userId || '').trim();
+    const payload = { corpid };
+    payload.dataId = Number(kwargs.dataId || 0);
+    const parsedBusinessUserIdList = parseJsonArray(kwargs.businessUserIdList);
+    if (Array.isArray(parsedBusinessUserIdList)) payload.businessUserIdList = parsedBusinessUserIdList;
+    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.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (parsedBusinessUserIdList === null) return makeErrorRow('NO_BUSINESSUSERIDLIST', '缺少 --businessUserIdList');
+    if (parsedBusinessUserIdList === undefined) return makeErrorRow('INVALID_BUSINESSUSERIDLIST', '--businessUserIdList 必须是 JSON 数组字符串');
+    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 result = data.result || {};
+    return [{ resultCode: data.code ?? '', resultMsg: data.msg || '', messageList: JSON.stringify(result.messageList || []), code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/work-order-asset-add-mainuser.js

@@ -0,0 +1,104 @@
+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/workOrderV2/asset/addMinUser';
+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 [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-order-asset-add-mainuser',
+  description: '资产添加负责人接口（businessType: -1；workOrderV2 资产）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单id（必填）' },
+    { 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 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);
+    payload.dataId = Number(kwargs.dataId || 0);
+    const parsedBusinessUserIdList = parseJsonArray(kwargs.businessUserIdList);
+    if (Array.isArray(parsedBusinessUserIdList)) payload.businessUserIdList = parsedBusinessUserIdList;
+    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 (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (parsedBusinessUserIdList === null) return makeErrorRow('NO_BUSINESSUSERIDLIST', '缺少 --businessUserIdList');
+    if (parsedBusinessUserIdList === undefined) return makeErrorRow('INVALID_BUSINESSUSERIDLIST', '--businessUserIdList 必须是 JSON 数组字符串');
+    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 result = data.result || {};
+    return [{ resultCode: data.code ?? '', resultMsg: data.msg || '', messageList: JSON.stringify(result.messageList || []), code: data.code ?? '', msg: data.msg || '' }];
+  },
+});