@xbongbong/xbbcli 2.0.0

package/role-list.js

@@ -0,0 +1,85 @@
+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/role/list';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+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, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ rank: '', id: '', roleName: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'role-list',
+  description: '角色列表接口（businessType: -1）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'roleNameLike', type: 'str', default: '', help: '角色名称模糊检索（可选）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+    { name: 'raw', type: 'bool', default: false, help: '输出接口返回的原文' },
+  ],
+  columns: ['rank', 'id', 'roleName', 'code', 'msg'],
+  footerExtra: () => (lastPagination ? `totalCount ${lastPagination.totalCount} / totalPage ${lastPagination.totalPage}` : undefined),
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = { corpid };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    if (String(kwargs.roleNameLike || '').trim()) payload.roleNameLike = String(kwargs.roleNameLike);
+    const requestBody = 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', 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();
+    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?.roleList) ? data.result.roleList : [];
+    if (!list.length) return makeErrorRow('NO_DATA', '接口成功，但 roleList 为空');
+    return list.map((item, index) => ({ rank: index + 1, id: item.id || '', roleName: item.roleName || '', code: '', msg: '' }));
+  },
+});

package/sign-in-list.js

@@ -0,0 +1,136 @@
+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/signIn/list';
+const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+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 parseArray(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 buildPayload(kwargs, corpid) {
+  const payload = { corpid };
+  const stringFields = ['userId', 'signInUserId', 'signInUserName', 'country', 'province', 'city', 'district', 'address', 'nameLike', 'startAddTime', 'endAddTime', 'outCountry', 'outProvince', 'outCity', 'outDistrict', 'outAddress', 'startOutTime', 'endOutTime'];
+  for (const field of stringFields) {
+    if (String(kwargs[field] ?? '') !== '') payload[field] = String(kwargs[field]);
+  }
+  const numberFields = ['signInCustomerId', 'page', 'pageSize', 'status', 'linkBusinessType'];
+  for (const field of numberFields) {
+    if (String(kwargs[field] ?? '') !== '') payload[field] = Number(kwargs[field]);
+  }
+  const signInUserIdIn = parseArray(kwargs.signInUserIdIn);
+  if (Array.isArray(signInUserIdIn)) payload.signInUserIdIn = signInUserIdIn;
+  const signInCustomerIdIn = parseArray(kwargs.signInCustomerIdIn);
+  if (Array.isArray(signInCustomerIdIn)) payload.signInCustomerIdIn = signInCustomerIdIn;
+  return payload;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ rank: '', userId: '', userName: '', customerId: '', customerName: '', status: '', inTime: '', outTime: '', address: '', outAddress: '', data: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'sign-in-list',
+  description: '签到列表接口（businessType: 2001）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'signInUserId', type: 'str', default: '', help: '签到人userId（可选）' },
+    { name: 'signInUserName', type: 'str', default: '', help: '签到人姓名精确匹配（可选）' },
+    { name: 'signInCustomerId', type: 'int', default: '', help: '签到客户id（可选）' },
+    { name: 'signInUserIdIn', type: 'str', default: '', help: '签到人userId集合，JSON数组字符串（可选）' },
+    { name: 'signInCustomerIdIn', type: 'str', default: '', help: '签到客户id集合，JSON数组字符串（可选）' },
+    { name: 'country', type: 'str', default: '', help: '签到国家（可选）' },
+    { name: 'province', type: 'str', default: '', help: '签到省份（可选）' },
+    { name: 'city', type: 'str', default: '', help: '签到城市（可选）' },
+    { name: 'district', type: 'str', default: '', help: '签到区县（可选）' },
+    { name: 'address', type: 'str', default: '', help: '签到详情地址（可选）' },
+    { name: 'nameLike', type: 'str', default: '', help: '客户名称模糊查询（可选）' },
+    { name: 'page', type: 'str', default: '', help: '页码（可选）' },
+    { name: 'pageSize', type: 'str', default: '', help: '每页数量（可选）' },
+    { name: 'startAddTime', type: 'str', default: '', help: '开始签到时间（可选）' },
+    { name: 'endAddTime', type: 'str', default: '', help: '结束签到时间（可选）' },
+    { name: 'outCountry', type: 'str', default: '', help: '签退国家（可选）' },
+    { name: 'outProvince', type: 'str', default: '', help: '签退省份（可选）' },
+    { name: 'outCity', type: 'str', default: '', help: '签退城市（可选）' },
+    { name: 'outDistrict', type: 'str', default: '', help: '签退区县（可选）' },
+    { name: 'outAddress', type: 'str', default: '', help: '签退详情地址（可选）' },
+    { name: 'status', type: 'int', default: '', help: '签到状态（可选）' },
+    { name: 'linkBusinessType', type: 'int', default: '', help: '签到对象业务类型（可选）' },
+    { name: 'startOutTime', type: 'str', default: '', help: '开始签退时间（可选）' },
+    { name: 'endOutTime', type: 'str', default: '', help: '结束签退时间（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+    { name: 'raw', type: 'bool', default: false, help: '输出接口返回的原文' },
+  ],
+  columns: ['rank', 'userId', 'userName', 'customerId', 'customerName', 'status', 'inTime', 'outTime', 'address', 'outAddress', 'data', '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', MISSING_TOKEN_MESSAGE);
+    if (String(kwargs.signInUserIdIn ?? '').trim() && !Array.isArray(parseArray(kwargs.signInUserIdIn))) return makeErrorRow('INVALID_SIGNINUSERIDIN', '--signInUserIdIn 必须是 JSON 数组字符串');
+    if (String(kwargs.signInCustomerIdIn ?? '').trim() && !Array.isArray(parseArray(kwargs.signInCustomerIdIn))) return makeErrorRow('INVALID_SIGNINCUSTOMERIDIN', '--signInCustomerIdIn 必须是 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();
+    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?.signInList) ? data.result.signInList : [];
+    if (!list.length) return makeErrorRow('NO_DATA', '接口成功，但 signInList 为空');
+    return list.map((item, index) => ({ rank: index + 1, userId: item.userId || '', userName: item.userName || '', customerId: item.customerId || '', customerName: item.customerName || '', status: item.status ?? '', inTime: item.inTime || '', outTime: item.outTime || '', address: item.address || '', outAddress: item.outAddress || '', data: JSON.stringify(item || {}), code: '', msg: '' }));
+  },
+});

package/stage-get.js

@@ -0,0 +1,100 @@
+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/stage/get';
+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 [{ stageProcessId: '', stageId: '', stageName: '', reasonText: '', reasonValue: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'stage-get',
+  description: '阶段获取接口（businessType: -1；formId必填）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单Id（必填）' },
+    { name: 'businessType', type: 'int', help: '业务类型（必填）' },
+    { name: 'saasMark', type: 'int', help: '表单类型（必填）' },
+    { name: 'dataId', type: 'int', help: '表单数据Id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['stageProcessId', 'stageId', 'stageName', 'reasonText', 'reasonValue', 'code', 'msg'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = {
+      corpid,
+      formId: Number(kwargs.formId || 0),
+      businessType: Number(kwargs.businessType || 0),
+      saasMark: Number(kwargs.saasMark || 0),
+      dataId: Number(kwargs.dataId || 0),
+    };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    const requestBody = 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 (!payload.businessType) return makeErrorRow('NO_BUSINESSTYPE', '缺少 --businessType');
+    if (!payload.saasMark) return makeErrorRow('NO_SAASMARK', '缺少 --saasMark');
+    if (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    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 ?? '未知错误');
+    const result = data.result || {};
+    const stageList = Array.isArray(result.stageList) ? result.stageList : [];
+    const reasonList = Array.isArray(result.reasonList) ? result.reasonList : [];
+    const size = Math.max(stageList.length, reasonList.length, 1);
+    return Array.from({ length: size }).map((_, index) => ({
+      stageProcessId: result.stageProcessId || '',
+      stageId: stageList[index]?.stageId || '',
+      stageName: stageList[index]?.stageName || '',
+      reasonText: reasonList[index]?.text || '',
+      reasonValue: reasonList[index]?.value || '',
+      code: data.code ?? '',
+      msg: data.msg || '',
+    }));
+  },
+});

package/stage-jump.js

@@ -0,0 +1,109 @@
+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/stage/jump';
+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 [{ dataId: '', resultCode: '', resultMsg: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'stage-jump',
+  description: '阶段跳转接口（businessType: -1；formId必填）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'formId', type: 'int', help: '表单模板id（必填）' },
+    { name: 'businessType', type: 'int', help: '业务类型（必填）' },
+    { name: 'saasMark', type: 'int', help: '表单类型（必填）' },
+    { name: 'dataId', type: 'int', help: '表单数据id（必填）' },
+    { name: 'toStageId', type: 'int', help: '目标阶段id（必填）' },
+    { name: 'stageProcessId', type: 'int', help: '阶段流程id（必填）' },
+    { name: 'reasonId', type: 'int', default: '', help: '原因id（可选）' },
+    { name: 'memo', type: 'str', default: '', help: '备注（可选）' },
+    { 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,
+      formId: Number(kwargs.formId || 0),
+      businessType: Number(kwargs.businessType || 0),
+      saasMark: Number(kwargs.saasMark || 0),
+      dataId: Number(kwargs.dataId || 0),
+      toStageId: Number(kwargs.toStageId || 0),
+      stageProcessId: Number(kwargs.stageProcessId || 0),
+    };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    if (String(kwargs.reasonId ?? '') !== '') payload.reasonId = Number(kwargs.reasonId);
+    if (String(kwargs.memo ?? '') !== '') payload.memo = String(kwargs.memo);
+    const requestBody = 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 (!payload.businessType) return makeErrorRow('NO_BUSINESSTYPE', '缺少 --businessType');
+    if (!payload.saasMark) return makeErrorRow('NO_SAASMARK', '缺少 --saasMark');
+    if (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (!payload.toStageId) return makeErrorRow('NO_TOSTAGEID', '缺少 --toStageId');
+    if (!payload.stageProcessId) return makeErrorRow('NO_STAGEPROCESSID', '缺少 --stageProcessId');
+    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 } : {});
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${buildApiUrl(baseUrl, API_URL)}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${requestBody}\n`);
+    }
+    const resp = await fetch(buildApiUrl(baseUrl, API_URL), {
+      method: 'POST',
+      headers,
+      body: requestBody,
+    });
+
+    if (!resp.ok) {
+      const errText = await resp.text();
+      if (debug) process.stderr.write(`[debug] ResponseBody: ${errText}\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 [{ dataId: result.dataId || payload.dataId || '', resultCode: result.code ?? '', resultMsg: result.msg || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/supplier-add.js

@@ -0,0 +1,142 @@
+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/supplier/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: 'supplier-add',
+  description: '新建供应商接口（businessType: 1001）',
+  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) {
+      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 [{
+      dataId: result.dataId || '',
+      resultCode: result.code ?? '',
+      resultMsg: result.msg || '',
+      code: data.code ?? '',
+      msg: data.msg || '',
+    }];
+  },
+});