@xbongbong/xbbcli 2.0.0

package/work-task-add.js

@@ -0,0 +1,242 @@
+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/workTask/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 parseJsonLikeObject(text) {
+  let index = 0;
+
+  function skipWhitespace() {
+    while (index < text.length && /\s/.test(text[index])) index += 1;
+  }
+
+  function consume(char) {
+    skipWhitespace();
+    if (text[index] !== char) throw new Error('Invalid input');
+    index += 1;
+  }
+
+  function parseQuotedString(quote) {
+    let value = '';
+    index += 1;
+    while (index < text.length) {
+      const char = text[index];
+      if (char === '\\') {
+        const next = text[index + 1];
+        if (next === undefined) throw new Error('Invalid input');
+        value += next === quote || next === '\\' ? next : char + next;
+        index += 2;
+        continue;
+      }
+      if (char === quote) {
+        index += 1;
+        return value;
+      }
+      value += char;
+      index += 1;
+    }
+    throw new Error('Invalid input');
+  }
+
+  function parseBareValue(stopChars) {
+    const start = index;
+    while (index < text.length && !stopChars.includes(text[index])) index += 1;
+    const raw = text.slice(start, index).trim();
+    if (!raw) throw new Error('Invalid input');
+    if (raw === 'true') return true;
+    if (raw === 'false') return false;
+    if (raw === 'null') return null;
+    if (/^-?(?:\d+|\d*\.\d+)(?:[eE][+-]?\d+)?$/.test(raw)) return Number(raw);
+    return raw;
+  }
+
+  function parseValue(stopChars) {
+    skipWhitespace();
+    const char = text[index];
+    if (char === '{') return parseObject();
+    if (char === '[') return parseArray();
+    if (char === '"' || char === "'") return parseQuotedString(char);
+    return parseBareValue(stopChars);
+  }
+
+  function parseObject() {
+    const value = {};
+    consume('{');
+    skipWhitespace();
+    if (text[index] === '}') {
+      index += 1;
+      return value;
+    }
+    while (index < text.length) {
+      skipWhitespace();
+      let key;
+      if (text[index] === '"' || text[index] === "'") {
+        key = parseQuotedString(text[index]);
+      } else {
+        const keyStart = index;
+        while (index < text.length && ![':', ',', '}'].includes(text[index])) index += 1;
+        key = text.slice(keyStart, index).trim();
+      }
+      if (!key) throw new Error('Invalid input');
+      consume(':');
+      value[key] = parseValue(',}');
+      skipWhitespace();
+      if (text[index] === ',') {
+        index += 1;
+        continue;
+      }
+      consume('}');
+      return value;
+    }
+    throw new Error('Invalid input');
+  }
+
+  function parseArray() {
+    const value = [];
+    consume('[');
+    skipWhitespace();
+    if (text[index] === ']') {
+      index += 1;
+      return value;
+    }
+    while (index < text.length) {
+      value.push(parseValue(',]'));
+      skipWhitespace();
+      if (text[index] === ',') {
+        index += 1;
+        continue;
+      }
+      consume(']');
+      return value;
+    }
+    throw new Error('Invalid input');
+  }
+
+  const parsed = parseValue('');
+  skipWhitespace();
+  if (index !== text.length) throw new Error('Invalid input');
+  return parsed;
+}
+
+function parseDataList(raw) {
+  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+    return raw;
+  }
+
+  const text = String(raw || '').trim();
+  if (!text) {
+    return null;
+  }
+
+  const candidates = [text];
+  if (text.includes('\\"')) candidates.push(text.replaceAll('\\"', '"'));
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(candidate);
+      if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+        return parsed;
+      }
+    } catch {
+      // Try the repaired JSON and JSON-like fallbacks below.
+    }
+  }
+
+  try {
+    const parsed = parseJsonLikeObject(text);
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function buildPayload(kwargs, parsedDataList, corpid, defaultUserId) {
+  const payload = { corpid };
+  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 (!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 对象字符串。PowerShell 示例：opencli.cmd --% xbb work-task-add --dataList "{\\"text_1\\":\\"name1\\"}"' };
+  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-task-add',
+  description: '新增任务接口（businessType: 21500）,{ "text_1": "{任务名称}", "ownerId": [ "{执行人userId}"  ],"date_1":1788969600 ,"date_2":1789833600 ,"text_3":"{任务描述}"}',
+  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 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 }, 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 makeSuccessRow(data);
+  },
+});

package/work-task-delete-couser.js

@@ -0,0 +1,85 @@
+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/workTask/deleteCoUser';
+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 makeErrorRow(code, msg) {
+  return [{ resultCode: '', resultMsg: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-task-delete-couser',
+  description: '工作任务删除协同人接口（businessType: 21500）',
+  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', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    const payload = { corpid, dataId: Number(kwargs.dataId || 0) };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    let userIdList;
+    try {
+      userIdList = JSON.parse(String(kwargs.businessUserIdList || ''));
+    } catch {
+      userIdList = null;
+    }
+    if (Array.isArray(userIdList)) payload.businessUserIdList = userIdList;
+    const body = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!payload.dataId) return makeErrorRow('NO_DATAID', '缺少 --dataId');
+    if (!Array.isArray(userIdList) || !userIdList.length) return makeErrorRow('NO_USERIDLIST', '缺少 --businessUserIdList 或格式不正确，需为JSON数组');
+    if (!token) return makeErrorRow('NO_TOKEN', MISSING_TOKEN_MESSAGE);
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, userId ? { userId } : {});
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, { method: 'POST', headers, body });
+    if (!resp.ok) return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    const data = await resp.json();
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    return [{ resultCode: data.code ?? '', resultMsg: data.msg || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/work-task-detail.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(), '.xbbcli', 'config.env');
+const API_URL = 'https://proapi.xbongbong.com/pro/v2/api/workTask/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, apiUrl) {
+  const apiPath = new URL(apiUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ dataId: '', taskName: '', taskStartTime: '', taskEndTime: '', remark: '', code, msg }];
+}
+
+function formatTimestampSeconds(value) {
+  const timestamp = Number(value);
+  if (value === null || value === undefined || value === '' || !Number.isFinite(timestamp) || timestamp <= 0) {
+    return '';
+  }
+
+  const parts = new Intl.DateTimeFormat('zh-CN', {
+    timeZone: 'Asia/Shanghai',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+  }).formatToParts(new Date(timestamp * 1000)).reduce((acc, part) => {
+    if (part.type !== 'literal') acc[part.type] = part.value;
+    return acc;
+  }, {});
+
+  return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}:${parts.second}`;
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-task-detail',
+  description: '工作任务详情接口（businessType: 21500）',
+  strategy: Strategy.PUBLIC,
+  access: 'read',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', type: 'int', help: '任务id（必填）' },
+    { name: 'queryFlag', type: 'int', default: 0, help: '查询标记（可选）' },
+    { name: 'userId', type: 'str', default: '', help: '操作人id（可选）' },
+    { name: 'debug', type: 'bool', default: false, help: '输出请求体和返回体调试信息' },
+  ],
+  columns: ['dataId', 'taskName', 'taskStartTime', 'taskEndTime', 'remark', 'code', 'msg'],
+  func: async (kwargs) => {
+    const debug = Boolean(kwargs.debug);
+    const { corpid, token, baseUrl, userId } = getRuntimeConfig();
+    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);
+    const requestBody = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    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 } : {});
+    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 ?? '未知错误');
+    const result = data.result || {};
+    return [{ dataId: result.dataId || '', taskName: result.data?.text_1 || '', taskStartTime: formatTimestampSeconds(result.data?.date_1), taskEndTime: formatTimestampSeconds(result.data?.date_2), remark: result.data?.text_3?.taskMemoText || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});

package/work-task-edit.js

@@ -0,0 +1,116 @@
+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/workTask/edit';
+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, dataId: Number(kwargs.dataId || 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.dataId) return { code: 'NO_DATAID', msg: '缺少 --dataId' };
+  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-task-edit',
+  description: '编辑工作任务接口（businessType: 21500）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataId', 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 }, 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 makeSuccessRow(data);
+  },
+});

package/work-task-handover.js

@@ -0,0 +1,85 @@
+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/workTask/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, defaultUrl) {
+  const apiPath = new URL(defaultUrl).pathname;
+  return `${baseUrl.replace(/\/+$/, '')}${apiPath}`;
+}
+
+function makeErrorRow(code, msg) {
+  return [{ resultType: '', resultMsg: '', code, msg }];
+}
+
+cli({
+  site: 'xbb',
+  name: 'work-task-handover',
+  description: '工作任务移交接口（businessType: 21500）',
+  strategy: Strategy.PUBLIC,
+  access: 'write',
+  browser: false,
+  domain: 'proapi.xbongbong.com',
+  args: [
+    { name: 'dataIdList', type: 'str', help: '任务id列表，JSON数组字符串（必填）' },
+    { name: 'businessUserId', type: 'str', help: '移交目标人员id（必填）' },
+    { 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, businessUserId: String(kwargs.businessUserId || '') };
+    if (kwargs.userId) payload.userId = String(kwargs.userId);
+    let dataIdList;
+    try {
+      dataIdList = JSON.parse(String(kwargs.dataIdList || ''));
+    } catch {
+      dataIdList = null;
+    }
+    if (Array.isArray(dataIdList)) payload.dataIdList = dataIdList;
+    const body = JSON.stringify(payload);
+    if (!payload.corpid) return makeErrorRow('NO_CORPID', '缺少本地 corpid；请先执行 xbbcli token-set --corpid <CORPID> --token <TOKEN> --userId <USERID>');
+    if (!Array.isArray(dataIdList) || !dataIdList.length) return makeErrorRow('NO_DATAIDLIST', '缺少 --dataIdList 或格式不正确，需为JSON数组');
+    if (!payload.businessUserId) return makeErrorRow('NO_BUSINESSUSERID', '缺少 --businessUserId');
+    if (!token) return makeErrorRow('NO_TOKEN', MISSING_TOKEN_MESSAGE);
+    const sign = crypto.createHash('sha256').update(body + token).digest('hex');
+    const headers = Object.assign({ 'Content-Type': 'application/json;charset=UTF-8', sign }, userId ? { userId } : {});
+    const apiUrl = buildApiUrl(baseUrl, API_URL);
+    if (debug) {
+      process.stderr.write(`[debug] URL: ${apiUrl}\n[debug] Headers: ${JSON.stringify(headers)}\n[debug] RequestBody: ${body}\n`);
+    }
+    const resp = await fetch(apiUrl, { method: 'POST', headers, body });
+    if (!resp.ok) return makeErrorRow(resp.status, `HTTP ${resp.status} ${resp.statusText}`);
+    const data = await resp.json();
+    const responseBody = JSON.stringify(data);
+    if (debug) process.stderr.write(`[debug] ResponseBody: ${responseBody}\n`);
+    if (data.code !== 1) return makeErrorRow(data.code ?? '', data.msg ?? '未知错误');
+    return [{ resultType: data.result?.resultType || '', resultMsg: data.result?.resultMsg || '', code: data.code ?? '', msg: data.msg || '' }];
+  },
+});