@xbongbong/xbbcli 2.4.5 → 2.4.6

package/README.md

@@ -203,7 +203,7 @@ note      config.env 中存在 2 个 enable=true，仅第一条生效，请用 x
 - Windows：用 `setx` 写入用户级环境变量，**只对新开的终端生效**
 - macOS/Linux：写入 `~/.xbbcli/env.sh`（`export` 形式，权限 600），需要 `source ~/.xbbcli/env.sh` 才在当前 shell 生效
 
-`token-list` 会把环境变量行（`source=env`）与 `config.env` 中的公司行（`source=config`）一起列出：环境变量行在 `msg` 列标注「XBB_* 环境变量存在（仅供外部系统，业务命令不再读取）」，`config.env` 的启用行固定标注「来源为 config.env，当前生效」；`token-use` 在切换 `config.env` 启用公司的同时，若检测到 `XBB_*` 有值，会把该公司凭证同步写回环境变量（目标公司缺 `token` 时拒绝切换，避免残留旧 `XBB_TOKEN`），便于外部系统跟随切换；`token-del` 默认在删除公司的同时一并删除 `XBB_*` 环境变量（`--env 0` 可保留），并在 `message` 说明删除后的实际生效来源。
+`token-list` 会把环境变量行（`source=env`）与 `config.env` 中的公司行（`source=config`）一起列出：环境变量行在 `msg` 列标注「XBB_* 环境变量存在（仅供外部系统，业务命令不再读取）」，`config.env` 的启用行固定标注「来源为 config.env，当前生效」；`token-use` 只切换 `config.env` 中的启用公司，不读写 `XBB_*` 环境变量；`token-del` 默认在删除公司的同时一并删除 `XBB_*` 环境变量（`--env 0` 可保留），并在 `message` 说明删除后的实际生效来源。
 
 > 注意：`token-del --env 0` 保留环境变量时，`XBB_*` 仍会存在（仅供外部系统使用；业务命令不再读取），`message` 会给出提示；要连环境变量一起清理，用 `token-del` 默认行为（不传 `--env`）或执行 `xbbcli auth-logout`（默认就会清除 `XBB_*`）；也可以手工执行 `setx XBB_TOKEN ""`（其余 `XBB_*` 同理，Windows 需重开终端）或删除 `~/.xbbcli/env.sh` 并 `unset` 当前 shell 中已导出的变量。
 
@@ -216,8 +216,8 @@ note      config.env 中存在 2 个 enable=true，仅第一条生效，请用 x
 - `auth-logout`：删除 `config.env` 中 `enable=true` 的那一条配置，删除前整份备份为 `~/.xbbcli/config.env.bak`；不自动把其他公司提升为启用；默认同时清除 `XBB_*` 环境变量（`--env 0` 跳过，返回 `envStored` / `envFile`）；既无启用公司又无环境变量时返回 `NO_ACTIVE_CONFIG` 且不改动文件
 - `auth-refresh-cache`：对当前启用公司重新拉取表单缓存、命令映射与部门/员工缓存，并回填 `corpName` / `userName`；失败时返回 `code=CACHE_REFRESH_FAILED`，`message` 注明中断步骤（`formlist` / `command-map` / `department-user` / `profile`），已完成的部分照常输出；支持 `--userId`、`--debug`
 - `token-set`：保存个人 token、`corpid`、`userId`、`baseurl`，并刷新本地表单缓存、命令映射文件与部门/员工缓存；传入的 token 不以 `user_` 开头时，会先为该 `userId` 刷新并保存个人 token；`--env` 控制存储方式：`0`（默认）仅写入本地文件，`1` 仅写入 `XBB_*` 环境变量（供外部系统使用，本 CLI 不读取；Windows 用 `setx`，其他平台写 `~/.xbbcli/env.sh`）且不写任何本地文件；返回 `envStored` / `envFile` 两列
-- `token-list`：同时列出环境变量行（`source=env`，仅 `XBB_CORPID` / `XBB_TOKEN` 有值时出现，`msg` 标注「仅供外部系统，业务命令不再读取」）与 `config.env` 中保存的全部公司（`source=config`，含 `corpName` 公司名称与 `userName` 操作人姓名），config 启用行在 `msg` 列标注「来源为 config.env，当前生效」；`--showToken` 显示完整 token（默认脱敏）
-- `token-use`：切换当前启用的公司（`xbbcli token-use --corpid <CORPID>`），保证仅且只有一个公司被启用；若环境变量 `XBB_*` 有值，同时把该公司凭证（`corpid`/`token`/`baseurl`/`userId`/`corpName`/`userName`，缺 `baseurl` 时按 `corpid` 推导）同步写回环境变量（供外部系统使用，本 CLI 不读取）——Windows 用 `setx`（需重开终端）、macOS/Linux 写 `~/.xbbcli/env.sh`（需重新 `source`）；同步失败时返回 `status=partial`，目标公司缺 `token` 时返回错误且不改动任何配置
+- `token-list`：同时列出环境变量行（`source=env`，仅 `XBB_CORPID` / `XBB_TOKEN` 有值时出现，`msg` 标注「仅供外部系统，业务命令不再读取」）与 `config.env` 中保存的全部公司（`source=config`，含 `corpName` 公司名称与 `userName` 操作人姓名），config 启用行在 `msg` 列标注「来源为 config.env，当前生效」；`--showToken` 显示完整 token（默认脱敏）；`--raw` 输出本地配置原文（token 仍按 `--showToken` 决定是否掩码）
+- `token-use`：切换当前启用的公司（`xbbcli token-use --corpid <CORPID>`），保证仅且只有一个公司被启用；只改动 `config.env`，不读写 `XBB_*` 环境变量
 - `token-del`：删除指定公司的本地配置（`xbbcli token-del --corpid <CORPID>`），并保证剩余配置中仅且只有一个公司被启用；默认同时删除 `XBB_*` 环境变量（`--env 0` 保留，返回 `envStored` / `envFile` 两列）
 - `token-generate`：生成/获取个人 token，`--resetToken 0` 获取（默认）、`1` 刷新；`--checkUserId` 未传则用配置中的 `userId`
 
@@ -234,6 +234,11 @@ note      config.env 中存在 2 个 enable=true，仅第一条生效，请用 x
 - `department-del`：删除部门
 - `role-list`：角色列表
 
+### 企业工商信息
+
+- `business-info-search`：按关键词搜索企业，返回企业准确全称与 `pid`（供 `business-info-detail` 使用）
+- `business-info-detail`：按 `pid` 查询企业工商登记信息，key/value 逐字段回显；`dateOfEstablishment` / `approvalDate` / `cancellationDate` 等时间戳转为 `YYYY-MM-DD`（UTC+8），`registeredAddress` / `shareholder` 为 JSON 字符串
+
 ### CRM 主数据
 
 - `customer-list`：客户列表
@@ -472,7 +477,6 @@ note      config.env 中存在 2 个 enable=true，仅第一条生效，请用 x
 - 当前公司名称存在 `~/.xbbcli/config.env` 的 `corpName` 字段（取部门 `id` 为 `1` 的部门名称），操作人姓名存在 `userName` 字段（按 `userId` 匹配员工列表）
 - 未传入的可选参数不会进入请求体
 - `--attr` 和 `--value` 只有同时提供时才会拼入查询条件
-- `--limit` 是在响应映射之后截断结果
 - 失败时返回的是带 `code` / `msg` 的结果行，不抛异常
 - 加 `--debug` 可以输出 `requestBody` 和 `responseBody`
 - 加 `--raw` 可以输出接口返回的原始 JSON 字符串（所有 list 命令均支持）
@@ -520,6 +524,13 @@ xbbcli customer-detail --dataId 310992
 xbbcli customer-add-couser --dataId 310995 --businessUserIdList '["xbbTest002"]'
 ```
 
+### 企业工商信息
+
+```bash
+xbbcli business-info-search --keyword 杭州逍邦网络科技有限公司
+xbbcli business-info-detail --pid 5bb73e72a9ae9a0318fd95ce
+```
+
 ### 表单模型/业务数据
 
 ```bash

package/business-info-detail.js

@@ -0,0 +1,126 @@
+import { cli, Strategy } from './xbb-registry.js';
+import { getRuntimeConfig, requestGateway } from './xbb-http.js';
+
+const BUSINESS_INFO_GET_API_PATH = '/pro/v2/api/businessInfo/getInfo';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+
+// 回显固定为 key/value 两列，逐字段列出工商登记信息；kind 决定取值与格式化方式
+const FIELDS = [
+  ['enterpriseName', 'text'],
+  ['pid', 'pid'],
+  ['operatingState', 'text'],
+  ['legalRepresentative', 'text'],
+  ['registeredCapital', 'text'],
+  ['unifySocialCreditCode', 'text'],
+  ['registrationNumber', 'text'],
+  ['organizationCode', 'text'],
+  ['enterpriseType', 'text'],
+  ['companySize', 'text'],
+  ['securitySize', 'text'],
+  ['dateOfEstablishment', 'date'],
+  ['approvalDate', 'date'],
+  ['operatingPeriod', 'text'],
+  ['cancellationDate', 'date'],
+  ['registrationAuthority', 'text'],
+  ['provinceCity', 'text'],
+  ['registeredAddress', 'json'],
+  ['mailingAddress', 'text'],
+  ['business', 'text'],
+  ['scopeOfBusiness', 'text'],
+  ['annualTurnover', 'text'],
+  ['shareholder', 'json'],
+  ['historyName', 'text'],
+];
+
+function buildPayload(kwargs, corpid) {
+  return {
+    pid: String(kwargs.pid || '').trim(),
+    corpid,
+  };
+}
+
+function getValidationError(payload, token) {
+  if (!payload.pid) {
+    return { code: 'NO_PID', msg: '缺少 --pid' };
+  }
+
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+
+  return null;
+}
+
+// 接口按 UTC+8 零点存储秒级时间戳（如 1426435200 → 2015-03-16），0/空表示无值
+function fmtDate(value) {
+  const seconds = Number(value || 0);
+  if (!seconds) return '';
+  return new Date((seconds + 8 * 3600) * 1000).toISOString().slice(0, 10);
+}
+
+function fieldValue(data, field, kind) {
+  if (kind === 'pid') {
+    return data.id == null ? '' : String(data.id);
+  }
+  const value = data[field];
+  if (kind === 'date') return fmtDate(value);
+  if (kind === 'json') return value == null ? '' : JSON.stringify(value);
+  return value == null ? '' : String(value);
+}
+
+function makeErrorRow(code, msg) {
+  return [{ key: code, value: msg }];
+}
+
+function makeSuccessRows(data) {
+  return FIELDS.map(([field, kind]) => ({ key: field, value: fieldValue(data, field, kind) }));
+}
+
+cli({
+  site: 'xbb',
+  name: 'business-info-detail',
+  description: '按 pid 查询企业工商登记信息（需购买工商查询服务方可调用）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'pid', type: 'str', help: '企业 pid（必填，由 business-info-search 获取）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['key', 'value'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = buildPayload(kwargs, corpid);
+
+    const validationError = getValidationError(payload, token);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const gateway = await requestGateway({
+      baseUrl,
+      apiPath: BUSINESS_INFO_GET_API_PATH,
+      payload,
+      token,
+      userId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
+    }
+
+    const result = gateway.data.result?.data;
+    if (!result || typeof result !== 'object') {
+      return makeErrorRow('NO_DATA', '接口成功，但工商信息为空');
+    }
+
+    return makeSuccessRows(result);
+  },
+});

package/business-info-search.js

@@ -0,0 +1,95 @@
+import { cli, Strategy } from './xbb-registry.js';
+import { getRuntimeConfig, requestGateway } from './xbb-http.js';
+
+const BUSINESS_INFO_LIST_API_PATH = '/pro/v2/api/businessInfo/getList';
+const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
+
+function buildPayload(kwargs, corpid) {
+  return {
+    keyword: String(kwargs.keyword || '').trim(),
+    corpid,
+  };
+}
+
+function getValidationError(payload, token) {
+  if (!payload.keyword) {
+    return { code: 'NO_KEYWORD', msg: '缺少 --keyword' };
+  }
+
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{
+    rank: '',
+    pid: '',
+    enterpriseName: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRows(items) {
+  return items.map((item, index) => ({
+    rank: index + 1,
+    pid: item.pid || '',
+    enterpriseName: item.enterpriseName || '',
+    code: '',
+    msg: '',
+  }));
+}
+
+cli({
+  site: 'xbb',
+  name: 'business-info-search',
+  description: '按关键词搜索企业，返回企业准确全称与 pid（需购买工商查询服务方可调用）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'keyword', type: 'str', help: '企业名称关键词（必填，支持模糊匹配）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+    { name: 'raw', type: 'bool', default: false, help: '输出接口返回的原文' },
+  ],
+  columns: ['rank', 'pid', 'enterpriseName', 'code', 'msg'],
+  func: async function (kwargs) {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = buildPayload(kwargs, corpid);
+
+    const validationError = getValidationError(payload, token);
+    if (validationError) {
+      return makeErrorRow(validationError.code, validationError.msg);
+    }
+
+    const gateway = await requestGateway({
+      baseUrl,
+      apiPath: BUSINESS_INFO_LIST_API_PATH,
+      payload,
+      token,
+      userId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    if (kwargs.raw) return [{ raw: gateway.responseBody }];
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
+    }
+
+    const items = Array.isArray(gateway.data.result?.data?.items) ? gateway.data.result.data.items : [];
+    if (!items.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但企业列表为空');
+    }
+
+    return makeSuccessRows(items);
+  },
+});

package/buyer-inquiry-detail.js

@@ -1,34 +1,9 @@
-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';
-import { readActiveConfig } from './xbb-config.js';
+import { getRuntimeConfig, requestGateway } from './xbb-http.js';
 
-const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
-const BUYER_INQUIRY_DETAIL_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/buyerInquiry/detail';
-const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const BUYER_INQUIRY_DETAIL_API_PATH = '/pro/v2/api/buyerInquiry/detail';
 const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
 
-function readConfig() {
-  return readActiveConfig();
-}
-
-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 buildPayload(kwargs, corpid) {
   const payload = { corpid, dataId: Number(kwargs.dataId || 0) };
   if (kwargs.userId) payload.userId = String(kwargs.userId);
@@ -72,38 +47,32 @@ cli({
     const debug = Boolean(kwargs.debug);
     const { corpid, token, baseUrl, userId } = getRuntimeConfig();
     const payload = buildPayload(kwargs, corpid);
-    const body = JSON.stringify(payload);
 
     const validationError = getValidationError(payload, token);
     if (validationError) return makeErrorRow(validationError.code, validationError.msg);
 
-    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, BUYER_INQUIRY_DETAIL_API_URL);
-    if (debug) {
-      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    const gateway = await requestGateway({
+      baseUrl,
+      apiPath: BUYER_INQUIRY_DETAIL_API_PATH,
+      payload,
+      token,
+      userId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
     }
-    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 || {};
+    const result = gateway.data.result || {};
     return [{
       dataId: result.dataId ?? result.id ?? payload.dataId,
       formId: result.formId ?? '',
       addTime: result.addTime ?? result.createTime ?? '',
       updateTime: result.updateTime ?? '',
       data: JSON.stringify(result.data ?? result),
-      code: data.code ?? '',
-      msg: data.msg ?? '',
+      code: gateway.data.code ?? '',
+      msg: gateway.data.msg ?? '',
     }];
   },
 });

package/buyer-inquiry-list.js

@@ -1,34 +1,9 @@
-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';
-import { readActiveConfig } from './xbb-config.js';
+import { getRuntimeConfig, requestGateway, createPagination } from './xbb-http.js';
 
-const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
-const BUYER_INQUIRY_LIST_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/buyerInquiry/list';
-const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const BUYER_INQUIRY_LIST_API_PATH = '/pro/v2/api/buyerInquiry/list';
 const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
-let lastPagination = null;
-
-function readConfig() {
-  return readActiveConfig();
-}
-
-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}`;
-}
+const pagination = createPagination();
 
 function buildPayload(kwargs, corpid) {
   return {
@@ -91,46 +66,33 @@ cli({
     { name: 'raw', type: 'bool', default: false, help: '输出接口返回的原文' },
   ],
   columns: ['rank', 'inquiryId', 'inquiryNo', 'buyerName', 'status', 'createTime', 'data', 'code', 'msg'],
-  footerExtra: () => (lastPagination ? `totalCount ${lastPagination.totalCount} / totalPage ${lastPagination.totalPage}` : undefined),
+  footerExtra: pagination.footerExtra,
   func: async function (kwargs) {
     const debug = Boolean(kwargs.debug);
     const { corpid, token, baseUrl, userId } = getRuntimeConfig();
     const payload = buildPayload(kwargs, corpid);
-    const body = JSON.stringify(payload);
 
     const validationError = getValidationError(payload, token);
     if (validationError) {
       return makeErrorRow(validationError.code, validationError.msg);
     }
 
-    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, BUYER_INQUIRY_LIST_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();
-    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 gateway = await requestGateway({
+      baseUrl,
+      apiPath: BUYER_INQUIRY_LIST_API_PATH,
+      payload,
+      token,
+      userId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    pagination.update(gateway.data);
+    if (kwargs.raw) return [{ raw: gateway.responseBody }];
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
     }
 
-    const list = Array.isArray(data.result?.list) ? data.result.list : [];
+    const list = Array.isArray(gateway.data.result?.list) ? gateway.data.result.list : [];
     if (!list.length) {
       return makeErrorRow('NO_DATA', '接口成功，但 list 为空');
     }

package/clue-add-couser.js

@@ -1,34 +1,9 @@
-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';
-import { readActiveConfig } from './xbb-config.js';
+import { getRuntimeConfig, requestGateway } from './xbb-http.js';
 
-const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
-const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/clue/addCoUser';
-const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const API_PATH = '/pro/v2/api/clue/addCoUser';
 const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
 
-function readConfig() {
-  return readActiveConfig();
-}
-
-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 [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
 }
@@ -62,22 +37,22 @@ cli({
       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', 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 gateway = await requestGateway({
+      baseUrl,
+      apiPath: API_PATH,
+      payload,
+      token,
+      userId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
     }
-    const resp = await fetch(buildApiUrl(baseUrl, API_URL), { 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 || '' }];
+    return [{ resultCode: gateway.data.code ?? '', resultMsg: gateway.data.msg || '', messageList: JSON.stringify(gateway.data.result?.messageList || []), code: gateway.data.code ?? '', msg: gateway.data.msg || '' }];
   },
 });

package/clue-add.js

@@ -1,34 +1,9 @@
-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';
-import { readActiveConfig } from './xbb-config.js';
+import { getRuntimeConfig, requestGateway } from './xbb-http.js';
 
-const CONFIG_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
-const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/clue/add';
-const DEFAULT_BASE_URL = 'https://proapi.xbongbong.com';
+const API_PATH = '/pro/v2/api/clue/add';
 const MISSING_TOKEN_MESSAGE = '缺少 token；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>';
 
-function readConfig() {
-  return readActiveConfig();
-}
-
-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;
@@ -75,25 +50,24 @@ cli({
     const runtimeUserId = String(kwargs.userId || userId || '').trim();
     if (runtimeUserId) payload.userId = runtimeUserId;
     if (parsedDataList) payload.dataList = parsedDataList;
-    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 (!token) return makeErrorRow('NO_TOKEN', MISSING_TOKEN_MESSAGE);
     if (parsedDataList === null) return makeErrorRow('NO_DATALIST', '缺少 --dataList');
     if (parsedDataList === undefined) return makeErrorRow('INVALID_DATALIST', '--dataList 必须是 JSON 对象字符串');
-    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 gateway = await requestGateway({
+      baseUrl,
+      apiPath: API_PATH,
+      payload,
+      token,
+      userId: runtimeUserId,
+      debug,
+    });
+    if (!gateway.ok) return makeErrorRow(gateway.code, gateway.msg);
+    if (gateway.data.code !== 1) {
+      return makeErrorRow(gateway.data.code ?? '', gateway.data.msg ?? '未知错误');
     }
-    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 || {};
-    return [{ dataId: result.dataId || '', resultCode: result.code ?? '', resultMsg: result.msg || '', code: data.code ?? '', msg: data.msg || '' }];
+    const result = gateway.data.result || {};
+    return [{ dataId: result.dataId || '', resultCode: result.code ?? '', resultMsg: result.msg || '', code: gateway.data.code ?? '', msg: gateway.data.msg || '' }];
   },
 });