@alipay/alipay-aipay 1.2.2 → 1.4.9

package/skill/references/normal/scripts/onboarding_message_runner.mjs

@@ -0,0 +1,436 @@
+#!/usr/bin/env node
+
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { isWindowsPlatform } from './platform_compat.mjs';
+import { loadMccRecords, renderMessage } from './render_customer_message.mjs';
+import { emitStageMetric, emitTerminalMetric } from './telemetry.mjs';
+
+const productTypes = {
+  aipay: { variant: 'AIPAY', productName: '按量付费' },
+  webpay: { variant: 'WEBPAY', productName: '网站支付' },
+  apppay: { variant: 'APPPAY', productName: 'APP 支付' }
+};
+
+const signingStatusMap = {
+  NOT_SIGNED: '未签约',
+  SIGN_SUBMITTED: '已提交待生效',
+  SIGNED_EFFECTIVE: '已生效',
+  OTHER_STATUS: '其他状态待核验',
+  QUERY_FAILED: '查询失败',
+  FAILED: '查询失败',
+  ERROR: '查询失败'
+};
+
+const serviceFlowMap = {
+  'FLOW:CREATE_NEW': '无已有服务',
+  'FLOW:SELECT': '已有服务候选',
+  QUERY_FAILED: '查询失败',
+  'FLOW:ERROR': '查询失败',
+  ERROR: '查询失败'
+};
+
+const applicationFlowMap = {
+  'FLOW:CREATE_NEW': '无同类型应用',
+  'FLOW:SELECT': '有上线应用可复用',
+  'FLOW:PENDING_APPLICATIONS': '仅有未上线应用',
+  QUERY_FAILED: '查询失败',
+  'FLOW:ERROR': '查询失败',
+  ERROR: '查询失败'
+};
+
+const categoryNames = {
+  signing: '签约材料',
+  service: '服务资料',
+  application: '应用资料'
+};
+
+const materialStates = {
+  INITIAL: { variant: 'INITIAL', currentStatus: '待补充' },
+  PARTIAL: { variant: 'PARTIAL', currentStatus: '部分已提供，待补充' },
+  INVALID: { variant: 'INVALID', currentStatus: '校验失败，需更正' },
+  APP_MOBILE_INITIAL: { variant: 'APP_MOBILE_INITIAL', currentStatus: '待补充' }
+};
+
+const directFieldAliases = new Map([
+  ['APP名称', ['APP名称']],
+  ['appName', ['APP名称']],
+  ['首页截图', ['首页截图']],
+  ['商品页截图', ['商品页截图']],
+  ['支付页截图', ['支付页截图']],
+  ['服务名称', ['服务名称']],
+  ['serviceName', ['服务名称']],
+  ['服务描述', ['服务描述']],
+  ['serviceDesc', ['服务描述']],
+  ['服务地址', ['服务地址']],
+  ['resourceUrl', ['服务地址']],
+  ['服务单价', ['服务单价']],
+  ['pricing', ['服务单价']],
+  ['请求示例JSON', ['请求示例JSON']],
+  ['请求示例 JSON', ['请求示例JSON']],
+  ['schemaUrl', ['请求示例JSON']],
+  ['应用平台和对应资料', ['应用平台和对应资料']],
+  ['mobilePlatform', ['应用平台和对应资料']],
+  ['iOS Bundle ID（bundleId）', ['iOS Bundle ID（bundleId）']],
+  ['iOS Bundle ID', ['iOS Bundle ID（bundleId）']],
+  ['bundleId', ['iOS Bundle ID（bundleId）']],
+  ['Android 应用包名（appPackage）', ['Android 应用包名（appPackage）']],
+  ['Android 应用包名', ['Android 应用包名（appPackage）']],
+  ['appPackage', ['Android 应用包名（appPackage）']],
+  ['Android 应用签名摘要（appSign）', ['Android 应用签名摘要（appSign）']],
+  ['Android 应用签名摘要', ['Android 应用签名摘要（appSign）']],
+  ['appSign', ['Android 应用签名摘要（appSign）']],
+  ['应用公钥', ['应用公钥']],
+  ['publicKey', ['应用公钥']]
+]);
+
+function parseArgs(argv) {
+  const command = argv[2];
+  const args = {};
+  for (let index = 3; index < argv.length; index += 1) {
+    const key = argv[index];
+    if (!key.startsWith('--')) throw new Error(`未知参数 ${key}`);
+    const value = argv[index + 1];
+    if (value === undefined || value.startsWith('--')) throw new Error(`参数 ${key} 缺少取值`);
+    args[key.slice(2)] = value;
+    index += 1;
+  }
+  return { command, args };
+}
+
+function required(args, name) {
+  const value = args[name];
+  if (typeof value !== 'string' || value.length === 0) throw new Error(`缺少参数 --${name}`);
+  return value;
+}
+
+function productFor(args) {
+  const productType = required(args, 'product-type');
+  const mapping = productTypes[productType];
+  if (!mapping) throw new Error('product-type 非法，仅支持 aipay、webpay、apppay');
+  return mapping;
+}
+
+function normalizeEnum(value, map, label) {
+  if (typeof value !== 'string' || value.length === 0) throw new Error(`缺少 ${label}`);
+  const normalized = map[value];
+  if (!normalized) throw new Error(`${label} 不在允许脚本标记中；允许值：${Object.keys(map).join('、')}`);
+  return normalized;
+}
+
+async function readStdin() {
+  let input = '';
+  for await (const chunk of process.stdin) input += chunk;
+  return input.trim() ? JSON.parse(input) : {};
+}
+
+function runPlatformEntry() {
+  return isWindowsPlatform()
+    ? renderMessage('onboarding.windows.redirect', 'DEFAULT', {})
+    : '';
+}
+
+async function runMccClarify(args) {
+  const productType = required(args, 'product-type');
+  const product = productFor({ ...args, 'product-type': productType });
+  emitStageMetric('onboarding.mcc_prepare.start', { productType });
+  return renderMessage('onboarding.mcc.clarify', 'DEFAULT', {
+    productName: product.productName
+  }, { productType });
+}
+
+function normalizeSearch(value) {
+  return value.toLocaleLowerCase('zh-CN').replace(/[\s，,。；;、/（）()\-_]/gu, '');
+}
+
+function assertMccQuery(query) {
+  if (query.length > 500 || /[\u0000-\u001f\u007f]/u.test(query)) throw new Error('query 包含控制字符或过长');
+  const normalizedQuery = normalizeSearch(query);
+  if (normalizedQuery.length < 2) throw new Error('query 过短，无法执行确定性 MCC 检索');
+  return normalizedQuery;
+}
+
+const mccAliasRules = [
+  {
+    queryTerms: ['电商', '电子商务', '网上商城', '线上商城', '网络购物'],
+    targetTerms: ['电商', '网上商城', '线上商城']
+  }
+];
+
+function mccSearchResult(query) {
+  const normalizedQuery = assertMccQuery(query);
+  const scored = [];
+  for (const record of loadMccRecords().values()) {
+    const name = normalizeSearch(record.name);
+    const businesses = normalizeSearch(record.applicableBusinesses);
+    const code = normalizeSearch(record.code);
+    const haystack = `${name}${businesses}`;
+    let score = 0;
+    if (code === normalizedQuery || normalizedQuery.includes(code) || name === normalizedQuery) score = Math.max(score, 100);
+    if (normalizedQuery.includes(name) || name.includes(normalizedQuery)) score = Math.max(score, 80);
+    if (businesses.includes(normalizedQuery)) score = Math.max(score, 70);
+    for (const rule of mccAliasRules) {
+      if (rule.queryTerms.some((term) => normalizedQuery.includes(term)) && rule.targetTerms.some((term) => haystack.includes(term))) {
+        score = Math.max(score, 50);
+      }
+    }
+    if (score > 0) scored.push({ record, score });
+  }
+  const strongMatches = scored.filter(({ score }) => score >= 70);
+  const ranked = strongMatches.length > 0 ? strongMatches : scored;
+  const candidates = ranked
+    .sort((left, right) => right.score - left.score || left.record.code.localeCompare(right.record.code))
+    .slice(0, 8)
+    .map(({ record }) => ({
+      mccCode: record.code,
+      mccName: record.name,
+      applicableBusinesses: record.applicableBusinesses,
+      qualification: record.qualification
+    }));
+  return {
+    matchType: candidates.length === 1 ? 'UNIQUE' : candidates.length === 0 ? 'NONE' : 'MULTIPLE',
+    candidates
+  };
+}
+
+async function runMccSearch(args) {
+  const productType = args['product-type'];
+  if (productType !== undefined) productFor({ ...args, 'product-type': productType });
+  emitStageMetric('onboarding.mcc_prepare.start', { productType });
+  const query = required(args, 'query');
+  return JSON.stringify(mccSearchResult(query));
+}
+
+async function runMccCandidates(args) {
+  const productType = required(args, 'product-type');
+  productFor({ ...args, 'product-type': productType });
+  const result = mccSearchResult(required(args, 'query'));
+  if (result.candidates.length === 0) return renderMessage('onboarding.mcc.no_match', 'DEFAULT', {}, { productType });
+  return renderMessage('onboarding.mcc.candidates', 'DEFAULT', {
+    mccCandidates: result.candidates
+  }, { productType });
+}
+
+async function runDiscoverySummary(args) {
+  const product = productFor(args);
+  const input = await readStdin();
+  const variables = {
+    signingStatus: normalizeEnum(input.signStatus, signingStatusMap, 'signStatus'),
+    applicationStatus: normalizeEnum(input.appFlow, applicationFlowMap, 'appFlow')
+  };
+  if (product.variant === 'AIPAY') {
+    variables.serviceStatus = normalizeEnum(input.serviceFlow, serviceFlowMap, 'serviceFlow');
+  }
+  return renderMessage('onboarding.discovery.summary', product.variant, variables);
+}
+
+function splitFieldInput(value) {
+  if (Array.isArray(value)) return value.flatMap((item) => splitFieldInput(item));
+  if (typeof value !== 'string') throw new Error('missingFields 必须是字符串或字符串数组');
+  return value
+    .split(/[、,，\n]/u)
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+function normalizeMaterialField(category, raw) {
+  if (directFieldAliases.has(raw)) return directFieldAliases.get(raw);
+  if (category === 'signing' && /签约.*截图/.test(raw)) return ['首页截图', '商品页截图', '支付页截图'];
+  if (/首页.*截图/.test(raw)) return ['首页截图'];
+  if (/商品.*截图/.test(raw)) return ['商品页截图'];
+  if (/支付.*截图/.test(raw)) return ['支付页截图'];
+  if (category === 'signing' && /^(?:截图|三张截图|3张截图)$/.test(raw)) return ['首页截图', '商品页截图', '支付页截图'];
+  if (/服务.*价格|服务.*单价/.test(raw)) return ['服务单价'];
+  if (/请求.*示例.*JSON/i.test(raw)) return ['请求示例JSON'];
+  if (/iOS.*Bundle/i.test(raw)) return ['iOS Bundle ID（bundleId）'];
+  if (/Android.*包名/i.test(raw)) return ['Android 应用包名（appPackage）'];
+  if (/Android.*签名/i.test(raw)) return ['Android 应用签名摘要（appSign）'];
+  throw new Error(`材料字段不在允许范围：${raw}`);
+}
+
+function normalizeMissingFields(category, missingFields) {
+  const normalized = [];
+  for (const raw of splitFieldInput(missingFields)) {
+    for (const field of normalizeMaterialField(category, raw)) {
+      if (!normalized.includes(field)) normalized.push(field);
+    }
+  }
+  if (normalized.length === 0) throw new Error('缺少 missingFields');
+  return normalized.join('、');
+}
+
+async function runMaterialCollect(args) {
+  const productType = required(args, 'product-type');
+  productFor({ ...args, 'product-type': productType });
+  const category = required(args, 'category');
+  const categoryName = categoryNames[category];
+  if (!categoryName) throw new Error('category 非法，仅支持 signing、service、application');
+
+  const state = required(args, 'state').toUpperCase().replace(/-/g, '_');
+  const stateRule = materialStates[state];
+  if (!stateRule) throw new Error('state 非法，仅支持 INITIAL、PARTIAL、INVALID、APP_MOBILE_INITIAL');
+
+  if (state === 'APP_MOBILE_INITIAL') {
+    if (category !== 'application') throw new Error('APP_MOBILE_INITIAL 只适用于 application 类别');
+    return renderMessage('materials.category.collect', stateRule.variant, {
+      categoryName: '应用资料',
+      currentStatus: stateRule.currentStatus,
+      missingFields: '应用平台和对应资料'
+    }, { productType });
+  }
+
+  const input = await readStdin();
+  return renderMessage('materials.category.collect', stateRule.variant, {
+    categoryName,
+    currentStatus: stateRule.currentStatus,
+    missingFields: normalizeMissingFields(category, input.missingFields)
+  }, { productType });
+}
+
+async function runApplicationCandidates(args) {
+  const applicationType = required(args, 'application-type');
+  if (!['WEBAPP', 'MOBILEAPP'].includes(applicationType)) throw new Error('application-type 非法，仅支持 WEBAPP、MOBILEAPP');
+  const applicationCandidates = await readStdin();
+  if (!Array.isArray(applicationCandidates)) throw new Error('应用候选输入必须是 JSON 数组');
+  const onlineCount = applicationCandidates.filter((candidate) => candidate?.status === 'ON_LINE').length;
+  const variant = applicationCandidates.length === 0
+    ? 'EMPTY'
+    : onlineCount === 0
+      ? 'PENDING_ONLY'
+      : 'ONLINE_WITH_OPTIONAL_PENDING';
+  const facts = renderMessage('application.candidates.facts', variant, { applicationType, applicationCandidates });
+  if (applicationCandidates.length === 0) return facts;
+  const selectionVariant = onlineCount === 0 ? 'PENDING_OR_NEW' : 'ONLINE_OR_NEW';
+  const selection = renderMessage('application.candidate.select', selectionVariant, {});
+  return `${facts}\n\n${selection}`;
+}
+
+async function runServiceCandidates() {
+  const serviceCandidates = await readStdin();
+  if (!Array.isArray(serviceCandidates)) throw new Error('服务候选输入必须是 JSON 数组');
+  const variant = serviceCandidates.length === 0 ? 'EMPTY' : 'DEFAULT';
+  const facts = renderMessage('service.candidates.facts', variant, { serviceCandidates });
+  if (serviceCandidates.length === 0) return facts;
+  return `${facts}\n\n${renderMessage('service.candidate.select', 'DEFAULT', {})}`;
+}
+
+function canonicalCandidates(candidates) {
+  if (!Array.isArray(candidates)) throw new Error('应用候选快照必须是 JSON 数组');
+  return JSON.stringify([...candidates].sort((left, right) => {
+    const leftId = typeof left?.appId === 'string' ? left.appId : '';
+    const rightId = typeof right?.appId === 'string' ? right.appId : '';
+    return leftId.localeCompare(rightId);
+  }));
+}
+
+async function runApplicationRecheck(args) {
+  const applicationType = required(args, 'application-type');
+  if (!['WEBAPP', 'MOBILEAPP'].includes(applicationType)) throw new Error('application-type 非法，仅支持 WEBAPP、MOBILEAPP');
+  const input = await readStdin();
+  if (!input || typeof input !== 'object' || Array.isArray(input)) throw new Error('应用候选重查输入必须是 JSON 对象');
+  if (canonicalCandidates(input.previousCandidates) === canonicalCandidates(input.currentCandidates)) return '';
+  const applicationCandidates = input.currentCandidates;
+  const onlineCount = applicationCandidates.filter((candidate) => candidate?.status === 'ON_LINE').length;
+  const variant = applicationCandidates.length === 0
+    ? 'EMPTY'
+    : onlineCount === 0
+      ? 'PENDING_ONLY'
+      : 'ONLINE_WITH_OPTIONAL_PENDING';
+  const facts = renderMessage('application.candidates.facts', variant, { applicationType, applicationCandidates });
+  if (applicationCandidates.length === 0) return facts;
+  const selectionVariant = onlineCount === 0 ? 'PENDING_OR_NEW' : 'ONLINE_OR_NEW';
+  return `${facts}\n\n${renderMessage('application.candidate.select', selectionVariant, {})}`;
+}
+
+function normalizeCloseoutInput(input) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) {
+    throw new Error('closeout 输入必须是 JSON 对象');
+  }
+  const variables = { ...input };
+  if (variables.applicationOperation !== undefined) {
+    const operation = variables.applicationOperation;
+    if (!operation || typeof operation !== 'object' || Array.isArray(operation)) {
+      throw new Error('applicationOperation 必须是 JSON 对象');
+    }
+    const allowedOperationKeys = new Set(['appId', 'actualStatus', 'nextAction']);
+    for (const key of Object.keys(operation)) {
+      if (!allowedOperationKeys.has(key)) throw new Error(`applicationOperation 包含未知字段 ${key}`);
+    }
+    variables.applicationOperationAppId = operation.appId;
+    variables.applicationOperationActualStatus = operation.actualStatus;
+    variables.applicationOperationNextAction = operation.nextAction;
+    delete variables.applicationOperation;
+  }
+  for (const key of [
+    'sandboxConfigState',
+    'manualVerificationItems',
+    'applicationOperationAppId',
+    'applicationOperationActualStatus',
+    'applicationOperationNextAction'
+  ]) {
+    if (variables[key] === '') delete variables[key];
+  }
+  return variables;
+}
+
+async function runCloseout() {
+  const variables = normalizeCloseoutInput(await readStdin());
+  const rendered = renderMessage('process.partial_result', 'DEFAULT', variables);
+  emitTerminalMetric({ productName: variables.productName });
+  return rendered;
+}
+
+async function main() {
+  const { command, args } = parseArgs(process.argv);
+  if (command === 'platform-entry') {
+    const message = runPlatformEntry();
+    if (message) console.log(message);
+    return;
+  }
+  if (command === 'mcc-clarify') {
+    console.log(await runMccClarify(args));
+    return;
+  }
+  if (command === 'mcc-search') {
+    console.log(await runMccSearch(args));
+    return;
+  }
+  if (command === 'mcc-candidates') {
+    console.log(await runMccCandidates(args));
+    return;
+  }
+  if (command === 'discovery-summary') {
+    console.log(await runDiscoverySummary(args));
+    return;
+  }
+  if (command === 'material-collect') {
+    console.log(await runMaterialCollect(args));
+    return;
+  }
+  if (command === 'application-candidates') {
+    console.log(await runApplicationCandidates(args));
+    return;
+  }
+  if (command === 'service-candidates') {
+    console.log(await runServiceCandidates());
+    return;
+  }
+  if (command === 'application-recheck') {
+    const message = await runApplicationRecheck(args);
+    if (message) console.log(message);
+    return;
+  }
+  if (command === 'closeout') {
+    console.log(await runCloseout());
+    return;
+  }
+  throw new Error('用法: onboarding_message_runner.mjs <platform-entry|mcc-search|mcc-clarify|mcc-candidates|discovery-summary|material-collect|application-candidates|service-candidates|application-recheck|closeout> ...');
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  main().catch((error) => {
+    console.error(`ONBOARDING_MESSAGE_ERROR:${error.message}`);
+    process.exitCode = 1;
+  });
+}

package/skill/references/normal/scripts/open_official_url.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+
+set -u
+
+KIND="${1:-}"
+IFS= read -r URL || URL=""
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+POLICY_FILE="${SCRIPT_DIR}/../json/policy-rules.json"
+
+case "$KIND" in authorization|public-key-confirmation) ;; *) echo "OPEN_FAILED"; exit 1 ;; esac
+command -v node >/dev/null 2>&1 || { echo "OPEN_FAILED"; exit 1; }
+[ -f "$POLICY_FILE" ] || { echo "OPEN_FAILED"; exit 1; }
+
+if ! node -e '
+const fs = require("node:fs");
+const [kind, raw, policyFile] = process.argv.slice(1);
+const policy = JSON.parse(fs.readFileSync(policyFile, "utf8"));
+if (/[\u0000-\u0020\u007f`()\[\]<>|]/.test(raw)) process.exit(1);
+let url;
+try { url = new URL(raw); } catch { process.exit(1); }
+const allowed = policy.temporaryUrlAllowlist[kind === "authorization" ? "authorization" : "publicKeyConfirmation"];
+if (!allowed || url.protocol !== "https:" || url.hostname !== allowed.host || url.pathname !== allowed.path || url.username || url.password || url.port || url.hash) process.exit(1);
+if (kind === "authorization") {
+  const required = allowed.requiredQueryParams;
+  const optional = allowed.optionalQueryParams;
+  const allowedKeys = new Set([...required, ...optional]);
+  if ([...url.searchParams.keys()].some((key) => !allowedKeys.has(key))) process.exit(1);
+  for (const key of required) {
+    if (url.searchParams.getAll(key).length !== 1 || !url.searchParams.get(key)) process.exit(1);
+  }
+  for (const key of optional) {
+    if (url.searchParams.getAll(key).length > 1) process.exit(1);
+  }
+  if (!policy.authorizationProducts.some((product) => product.salesCode === url.searchParams.get("productCode"))) process.exit(1);
+  if (!/^A\d{4}_B\d{4}$/.test(url.searchParams.get("mccCode"))) process.exit(1);
+  if (/[\r\n]/.test(url.searchParams.get("deviceCode"))) process.exit(1);
+  if (url.searchParams.has("platform") && (!url.searchParams.get("platform") || /[\r\n]/.test(url.searchParams.get("platform")))) process.exit(1);
+} else {
+  const required = allowed.requiredQueryParams || ["keyConfirmToken"];
+  const optional = allowed.optionalQueryParams || [];
+  const allowedKeys = new Set([...required, ...optional]);
+  if ([...url.searchParams.keys()].some((key) => !allowedKeys.has(key))) process.exit(1);
+  for (const key of required) {
+    if (url.searchParams.getAll(key).length !== 1 || !url.searchParams.get(key)) process.exit(1);
+  }
+  for (const key of optional) {
+    if (url.searchParams.getAll(key).length > 1) process.exit(1);
+  }
+  if (/[\r\n]/.test(url.searchParams.get("keyConfirmToken"))) process.exit(1);
+}
+' "$KIND" "$URL" "$POLICY_FILE"; then
+  echo "OPEN_FAILED"
+  exit 1
+fi
+
+OS_NAME="$(uname -s 2>/dev/null || true)"
+WINDOWS_OPENER=false
+if [ "$OS_NAME" = "Darwin" ] && command -v open >/dev/null 2>&1; then
+  OPENER=(open)
+elif [ "$OS_NAME" = "Linux" ] && command -v xdg-open >/dev/null 2>&1; then
+  OPENER=(xdg-open)
+elif [[ "$OS_NAME" = MINGW* || "$OS_NAME" = MSYS* || "$OS_NAME" = CYGWIN* ]] && command -v powershell.exe >/dev/null 2>&1; then
+  WINDOWS_OPENER=true
+  OPENER=(powershell.exe -NoProfile -NonInteractive -Command 'Start-Process -FilePath $env:ALIPAY_AIPAY_OPEN_URL')
+else
+  echo "GUI_UNAVAILABLE"
+  exit 0
+fi
+
+if [ "$WINDOWS_OPENER" = true ]; then
+  env "ALIPAY_AIPAY_OPEN_URL=$URL" "${OPENER[@]}" >/dev/null 2>&1
+  OPEN_RC=$?
+else
+  "${OPENER[@]}" "$URL" >/dev/null 2>&1
+  OPEN_RC=$?
+fi
+
+if [ "$OPEN_RC" -eq 0 ]; then
+  echo "OPENED"
+else
+  echo "OPEN_FAILED"
+fi

package/skill/references/normal/scripts/platform_compat.mjs

@@ -0,0 +1,39 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import process from 'node:process';
+
+export function runtimePlatform(env = process.env) {
+  const testPlatform = env.ALIPAY_AIPAY_TEST_MODE === '1' ? env.ALIPAY_AIPAY_TEST_PLATFORM : '';
+  return ['darwin', 'linux', 'win32'].includes(testPlatform) ? testPlatform : process.platform;
+}
+
+export function isWindowsPlatform(env = process.env) {
+  return runtimePlatform(env) === 'win32';
+}
+
+export function commandRuns(command, args = [], options = {}) {
+  const result = spawnSync(command, args, {
+    encoding: 'utf8',
+    stdio: 'ignore',
+    shell: false,
+    env: options.env || process.env
+  });
+  return result.status === 0;
+}
+
+export function currentNodeAvailable(env = process.env) {
+  return Boolean(process.execPath && fs.existsSync(process.execPath));
+}
+
+export function checkCliEnvironment(options = {}) {
+  const env = options.env || process.env;
+  const requireJq = options.requireJq ?? !isWindowsPlatform(env);
+  const requireAlipayCli = options.requireAlipayCli ?? true;
+  const missing = [];
+
+  if (!currentNodeAvailable(env)) missing.push('node');
+  if (requireJq && !commandRuns('jq', ['--version'], { env })) missing.push('jq');
+  if (requireAlipayCli && !commandRuns('alipay-cli', ['version'], { env })) missing.push('alipay-cli');
+
+  return missing;
+}