@xbongbong/xbbcli 2.0.0

package/bin/xbbcli.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { getRegistry } from '../xbb-registry.js';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+process.stdout.on('error', (error) => {
+  if (error.code === 'EPIPE') process.exit(0);
+  throw error;
+});
+
+async function loadCommands() {
+  const files = fs.readdirSync(root)
+    .filter((name) => name.endsWith('.js') && name !== 'xbb-registry.js')
+    .sort();
+  for (const file of files) {
+    await import(`${pathToFileURL(path.join(root, file)).href}?xbbCli`);
+  }
+}
+
+function printHelp() {
+  const commands = [...getRegistry().values()].sort((a, b) => a.name.localeCompare(b.name));
+  process.stdout.write('Usage: xbbcli <command> [options]\n\nCommands:\n');
+  for (const command of commands) {
+    process.stdout.write(`  ${command.name.padEnd(34)} ${command.description || ''}\n`);
+  }
+}
+
+function printCommandHelp(command) {
+  process.stdout.write(`Usage: xbbcli ${command.name} [options]\n\n${command.description || ''}\n\nOptions:\n`);
+  for (const arg of command.args || []) {
+    const suffix = arg.default !== undefined ? ` (default: ${arg.default})` : '';
+    process.stdout.write(`  --${arg.name}${arg.type === 'bool' ? '' : ' <value>'}${suffix}\n      ${arg.help || ''}\n`);
+  }
+  process.stdout.write('  -f, --format <format>  output format: json, table, csv\n  --help                 show this help\n');
+}
+
+function parseArgs(command, argv) {
+  const kwargs = {};
+  for (const arg of command.args || []) {
+    if (arg.default !== undefined) kwargs[arg.name] = arg.default;
+  }
+  let format = 'table';
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === '--help' || token === '-h') return { help: true, kwargs, format };
+    if (token === '-f' || token === '--format') {
+      format = argv[++index] || format;
+      continue;
+    }
+    if (!token.startsWith('--')) throw new Error(`未知参数：${token}`);
+    const equalIndex = token.indexOf('=');
+    const name = token.slice(2, equalIndex === -1 ? undefined : equalIndex);
+    const definition = (command.args || []).find((item) => item.name === name);
+    if (!definition) throw new Error(`未知参数：--${name}`);
+    let value = equalIndex === -1 ? undefined : token.slice(equalIndex + 1);
+    if (definition.type === 'bool') {
+      kwargs[name] = value === undefined ? true : !['false', '0', 'no'].includes(value.toLowerCase());
+      continue;
+    }
+    if (value === undefined) value = argv[++index];
+    if (value === undefined) throw new Error(`参数 --${name} 缺少值`);
+    if (definition.type === 'int') {
+      if (value === '') value = '';
+      else if (!Number.isFinite(Number(value))) throw new Error(`参数 --${name} 必须是数字`);
+      else value = Number(value);
+    }
+    kwargs[name] = value;
+  }
+  return { kwargs, format };
+}
+
+function csvCell(value) {
+  const text = String(value ?? '');
+  return /[",\n\r]/.test(text) ? `"${text.replaceAll('"', '""')}"` : text;
+}
+
+function outputRows(rows, command, format) {
+  if (format === 'json') {
+    process.stdout.write(`${JSON.stringify(rows, null, 2)}\n`);
+    return;
+  }
+  const columns = command.columns || (rows[0] ? Object.keys(rows[0]) : []);
+  if (format === 'csv') {
+    process.stdout.write(`${columns.map(csvCell).join(',')}\n`);
+    for (const row of rows) process.stdout.write(`${columns.map((column) => csvCell(row[column])).join(',')}\n`);
+    return;
+  }
+  process.stdout.write(`${columns.join('\t')}\n`);
+  for (const row of rows) process.stdout.write(`${columns.map((column) => String(row[column] ?? '')).join('\t')}\n`);
+}
+
+await loadCommands();
+const [commandName, ...argv] = process.argv.slice(2);
+if (!commandName || commandName === '--help' || commandName === '-h') {
+  printHelp();
+  process.exitCode = 0;
+} else {
+  const command = getRegistry().get(`xbb/${commandName}`);
+  if (!command) {
+    process.stderr.write(`未知命令：${commandName}\n\n`);
+    printHelp();
+    process.exitCode = 2;
+  } else {
+    try {
+      const parsed = parseArgs(command, argv);
+      if (parsed.help) printCommandHelp(command);
+      else {
+        const rows = await command.func(parsed.kwargs);
+        outputRows(rows, command, parsed.format);
+      }
+    } catch (error) {
+      process.stderr.write(`${error.message || error}\n`);
+      process.exitCode = 1;
+    }
+  }
+}

package/buyer-inquiry-detail.js

@@ -0,0 +1,112 @@
+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 BUYER_INQUIRY_DETAIL_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/buyerInquiry/detail';
+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, 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);
+  if (String(kwargs.queryFlag ?? '') !== '') payload.queryFlag = Number(kwargs.queryFlag);
+  return payload;
+}
+
+function getValidationError(payload, token) {
+  if (!payload.corpid) {
+    return { code: 'NO_CORPID', msg: '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>' };
+  }
+  if (!payload.dataId) {
+    return { code: 'NO_DATAID', msg: '缺少 --dataId' };
+  }
+  if (!token) {
+    return { code: 'NO_TOKEN', msg: MISSING_TOKEN_MESSAGE };
+  }
+  return null;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ dataId: '', formId: '', addTime: '', updateTime: '', data: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'buyer-inquiry-detail',
+  description: '采购询价详情接口（businessType: 5900）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '采购询价 id（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人 id（可选）' },
+    { name: 'queryFlag', type: 'str', default: '', help: '查询标记（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['dataId', 'formId', 'addTime', 'updateTime', 'data', 'code', 'msg'],
+  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_DETAIL_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 ?? 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 ?? '',
+    }];
+  },
+});

package/buyer-inquiry-list.js

@@ -0,0 +1,142 @@
+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 BUYER_INQUIRY_LIST_API_URL = 'https://proapi.xbongbong.com/pro/v2/api/buyerInquiry/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 buildPayload(kwargs, corpid) {
+  return {
+    corpid,
+    page: Number(String(kwargs.page ?? '') === '' ? 1 : kwargs.page),
+    pageSize: Number(String(kwargs.pageSize ?? '') === '' ? 20 : kwargs.pageSize),
+  };
+}
+
+function getValidationError(payload, token) {
+  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: '',
+    inquiryId: '',
+    inquiryNo: '',
+    buyerName: '',
+    status: '',
+    createTime: '',
+    data: '',
+    code,
+    msg,
+  }];
+}
+
+function makeSuccessRows(list) {
+  return list.map((item, index) => ({
+    rank: index + 1,
+    inquiryId: item.inquiryId ?? item.dataId ?? item.id ?? '',
+    inquiryNo: item.inquiryNo ?? item.no ?? item.serialNo ?? '',
+    buyerName: item.buyerName ?? item.customerName ?? item.name ?? '',
+    status: item.status ?? item.state ?? '',
+    createTime: item.createTime ?? item.addTime ?? item.updateTime ?? '',
+    data: JSON.stringify(item),
+    code: '',
+    msg: '',
+  }));
+}
+
+cli({
+  site: 'xbb',
+  name: 'buyer-inquiry-list',
+  description: '采购询价列表接口（businessType: 5900）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'page', type: 'str', default: '1', help: '页码' },
+    { name: 'pageSize', type: 'str', default: '20', help: '每页数量' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+    { 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),
+  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 list = Array.isArray(data.result?.list) ? data.result.list : [];
+    if (!list.length) {
+      return makeErrorRow('NO_DATA', '接口成功，但 list 为空');
+    }
+    return makeSuccessRows(list);
+  },
+});

package/clue-add-couser.js

@@ -0,0 +1,86 @@
+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_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 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 [{ resultCode: '', resultMsg: '', messageList: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'clue-add-couser',
+  description: '线索添加协同人接口（businessType: 8000）',
+  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: 'mainUserId', type: 'str', default: '', help: '团队负责人id（可选）' },
+    { 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);
+    if (String(kwargs.mainUserId || '').trim()) payload.mainUserId = String(kwargs.mainUserId);
+    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', 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) 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/clue-add.js

@@ -0,0 +1,102 @@
+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/clue/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 makeErrorRow(code, msg) {
+  return [{ dataId: '', resultCode: '', resultMsg: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'clue-add',
+  description: '新建线索接口（businessType: 8000；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 = { corpid, formId: Number(kwargs.formId || 0) };
+    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 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 || '' }];
+  },
+});

package/clue-back.js

@@ -0,0 +1,82 @@
+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_FILE = path.join(os.homedir(), '.xbbcli', 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/clue/back';
+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 [{ resultType: '', resultMsg: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'clue-back',
+  description: '线索退回公海接口（businessType: 8000）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataIdList', type: 'str', help: '线索id列表，JSON数组字符串（必填）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['resultType', '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);
+    let dataIdList;
+    try {
+      dataIdList = JSON.parse(String(kwargs.dataIdList || ''));
+    } catch {
+      dataIdList = null;
+    }
+    if (Array.isArray(dataIdList)) payload.dataIdList = dataIdList;
+    const requestBody = 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 (!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) 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 [{ resultType: data.result?.resultType || '', resultMsg: data.result?.resultMsg || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});