@alipay/alipay-aipay 1.5.0 → 1.5.1

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

@@ -131,6 +131,32 @@ function runPlatformEntry() {
     : '';
 }
 
+function optional(args, name) {
+  const value = args[name];
+  return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+
+function parseJsonArg(args, name, label) {
+  const raw = required(args, name);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`${label} 必须是合法 JSON`);
+  }
+}
+
+function runProductClarify() {
+  return renderMessage('product.clarify', 'DEFAULT', {});
+}
+
+function runEnterpriseUnsupported(args) {
+  const variant = required(args, 'variant');
+  if (!['ONBOARDING_ONLY', 'FULL_PROCESS'].includes(variant)) {
+    throw new Error('variant 非法，仅支持 ONBOARDING_ONLY、FULL_PROCESS');
+  }
+  return renderMessage('onboarding.enterprise.unsupported', variant, {});
+}
+
 async function runMccClarify(args) {
   const productType = required(args, 'product-type');
   const product = productFor({ ...args, 'product-type': productType });
@@ -212,13 +238,34 @@ async function runMccCandidates(args) {
   }, { productType });
 }
 
-async function runMccResolve(args) {
+function renderPlanConfirm(productType, mccCandidate) {
+  const product = productFor({ 'product-type': productType });
+  return renderMessage('onboarding.plan.confirm', product.variant, {
+    mccCode: mccCandidate.mccCode,
+    mccName: mccCandidate.mccName,
+    mccQualification: mccCandidate.qualification
+  }, { productType });
+}
+
+async function runPlanConfirm(args) {
+  const productType = required(args, 'product-type');
+  productFor({ ...args, 'product-type': productType });
+  return renderPlanConfirm(productType, {
+    mccCode: required(args, 'mcc-code'),
+    mccName: required(args, 'mcc-name'),
+    qualification: required(args, 'mcc-qualification')
+  });
+}
+
+async function runMccResolve(args, { renderPlan = false } = {}) {
   const productType = required(args, 'product-type');
   productFor({ ...args, 'product-type': productType });
   emitStageMetricAsync('onboarding.mcc_prepare.start', { productType });
   const result = mccSearchResult(required(args, 'query'));
   process.stderr.write(`ALIPAY_AIPAY_INTERNAL:MCC_RESOLUTION=${JSON.stringify(result)}\n`);
-  if (result.matchType === 'UNIQUE') return '';
+  if (result.matchType === 'UNIQUE') {
+    return renderPlan ? renderPlanConfirm(productType, result.candidates[0]) : '';
+  }
   if (result.matchType === 'NONE') {
     return renderMessage('onboarding.mcc.no_match', 'DEFAULT', {}, { productType });
   }
@@ -294,7 +341,9 @@ async function runMaterialCollect(args) {
     }, { productType });
   }
 
-  const input = await readStdin();
+  const input = optional(args, 'missing-fields') !== undefined
+    ? { missingFields: args['missing-fields'] }
+    : await readStdin();
   return renderMessage('materials.category.collect', stateRule.variant, {
     categoryName,
     currentStatus: stateRule.currentStatus,
@@ -305,7 +354,9 @@ async function runMaterialCollect(args) {
 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();
+  const applicationCandidates = optional(args, 'candidates-json') !== undefined
+    ? parseJsonArg(args, 'candidates-json', '应用候选输入')
+    : 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
@@ -320,8 +371,10 @@ async function runApplicationCandidates(args) {
   return `${facts}\n\n${selection}`;
 }
 
-async function runServiceCandidates() {
-  const serviceCandidates = await readStdin();
+async function runServiceCandidates(args) {
+  const serviceCandidates = optional(args, 'candidates-json') !== undefined
+    ? parseJsonArg(args, 'candidates-json', '服务候选输入')
+    : 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 });
@@ -341,7 +394,12 @@ function canonicalCandidates(candidates) {
 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();
+  const input = optional(args, 'previous-candidates-json') !== undefined || optional(args, 'current-candidates-json') !== undefined
+    ? {
+        previousCandidates: parseJsonArg(args, 'previous-candidates-json', '上一轮应用候选快照'),
+        currentCandidates: parseJsonArg(args, 'current-candidates-json', '当前应用候选快照')
+      }
+    : 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;
@@ -388,13 +446,102 @@ function normalizeCloseoutInput(input) {
   return variables;
 }
 
-async function runCloseout() {
-  const variables = normalizeCloseoutInput(await readStdin());
+function closeoutInputFromArgs(args) {
+  if (optional(args, 'input-json') !== undefined) return parseJsonArg(args, 'input-json', 'closeout 输入');
+  const mapping = {
+    'product-name': 'productName',
+    'process-result-title': 'processResultTitle',
+    'integration-result': 'integrationResult',
+    'sandbox-config-state': 'sandboxConfigState',
+    'signing-result': 'signingResult',
+    'service-result': 'serviceResult',
+    'application-result': 'applicationResult',
+    'remaining-actions': 'remainingActions',
+    'manual-verification-items': 'manualVerificationItems',
+    'application-operation-app-id': 'applicationOperationAppId',
+    'application-operation-actual-status': 'applicationOperationActualStatus',
+    'application-operation-next-action': 'applicationOperationNextAction',
+    'next-flow-reminder': 'nextFlowReminder'
+  };
+  const hasTypedInput = Object.keys(mapping).some((name) => Object.prototype.hasOwnProperty.call(args, name));
+  if (!hasTypedInput) return null;
+  const input = {};
+  for (const [argName, fieldName] of Object.entries(mapping)) {
+    if (Object.prototype.hasOwnProperty.call(args, argName)) input[fieldName] = args[argName];
+  }
+  for (const name of ['product-name', 'process-result-title', 'integration-result', 'signing-result', 'service-result', 'application-result', 'remaining-actions', 'next-flow-reminder']) {
+    required(args, name);
+  }
+  return input;
+}
+
+async function runCloseout(args) {
+  const variables = normalizeCloseoutInput(closeoutInputFromArgs(args) || await readStdin());
   const rendered = renderMessage('process.partial_result', 'DEFAULT', variables);
   emitTerminalMetric({ productName: variables.productName });
   return rendered;
 }
 
+function runServiceCreateSummary(args) {
+  return renderMessage('service.create.summary', 'DEFAULT', {
+    serviceName: required(args, 'service-name'),
+    serviceDescription: required(args, 'service-description'),
+    serviceUrl: required(args, 'service-url'),
+    servicePricing: required(args, 'service-pricing'),
+    serviceSchema: required(args, 'service-schema')
+  });
+}
+
+function runServiceUpdateConfirm(args) {
+  return renderMessage('onboarding.write.confirm', 'SERVICE_UPDATE_ONLY', {
+    sessionSummary: required(args, 'session-summary'),
+    subjectSummary: required(args, 'subject-summary'),
+    productName: 'AI 按量付费',
+    actionTypes: '服务修改',
+    serviceId: required(args, 'service-id'),
+    serviceName: required(args, 'service-name'),
+    serviceDescription: required(args, 'service-description'),
+    serviceUrl: required(args, 'service-url'),
+    servicePricing: required(args, 'service-pricing'),
+    serviceSchema: required(args, 'service-schema')
+  });
+}
+
+function runHarmonyManualCreate() {
+  return renderMessage('application.harmony.manual_create', 'DEFAULT', {});
+}
+
+function runApplicationReuseNoKey(args) {
+  return renderMessage('application.reuse.no_key', 'DEFAULT', {
+    appId: required(args, 'app-id')
+  });
+}
+
+function runSigningResult(args) {
+  const variables = {
+    actualStatus: required(args, 'actual-status'),
+    nextAction: required(args, 'next-action')
+  };
+  const feeDisplay = optional(args, 'fee-display');
+  if (feeDisplay !== undefined) variables.feeDisplay = feeDisplay;
+  return renderMessage('signing.operation.result', feeDisplay === undefined ? 'WITHOUT_FEE' : 'WITH_FEE', variables);
+}
+
+function runServiceResult(args) {
+  return renderMessage('service.operation.result', 'DEFAULT', {
+    serviceId: required(args, 'service-id'),
+    actualResult: required(args, 'actual-result')
+  });
+}
+
+function runApplicationResult(args) {
+  return renderMessage('application.operation.result', 'DEFAULT', {
+    appId: required(args, 'app-id'),
+    actualStatus: required(args, 'actual-status'),
+    nextAction: required(args, 'next-action')
+  });
+}
+
 async function main() {
   const { command, args } = parseArgs(process.argv);
   if (command === 'platform-entry') {
@@ -402,6 +549,14 @@ async function main() {
     if (message) console.log(message);
     return;
   }
+  if (command === 'product-clarify') {
+    console.log(runProductClarify());
+    return;
+  }
+  if (command === 'enterprise-unsupported') {
+    console.log(runEnterpriseUnsupported(args));
+    return;
+  }
   if (command === 'mcc-clarify') {
     console.log(await runMccClarify(args));
     return;
@@ -419,6 +574,15 @@ async function main() {
     if (message) console.log(message);
     return;
   }
+  if (command === 'mcc-resolve-plan') {
+    const message = await runMccResolve(args, { renderPlan: true });
+    if (message) console.log(message);
+    return;
+  }
+  if (command === 'plan-confirm') {
+    console.log(await runPlanConfirm(args));
+    return;
+  }
   if (command === 'material-collect') {
     console.log(await runMaterialCollect(args));
     return;
@@ -428,7 +592,7 @@ async function main() {
     return;
   }
   if (command === 'service-candidates') {
-    console.log(await runServiceCandidates());
+    console.log(await runServiceCandidates(args));
     return;
   }
   if (command === 'application-recheck') {
@@ -437,10 +601,38 @@ async function main() {
     return;
   }
   if (command === 'closeout') {
-    console.log(await runCloseout());
+    console.log(await runCloseout(args));
+    return;
+  }
+  if (command === 'service-create-summary') {
+    console.log(runServiceCreateSummary(args));
+    return;
+  }
+  if (command === 'service-update-confirm') {
+    console.log(runServiceUpdateConfirm(args));
+    return;
+  }
+  if (command === 'application-harmony-manual-create') {
+    console.log(runHarmonyManualCreate());
+    return;
+  }
+  if (command === 'application-reuse-no-key') {
+    console.log(runApplicationReuseNoKey(args));
+    return;
+  }
+  if (command === 'signing-result') {
+    console.log(runSigningResult(args));
+    return;
+  }
+  if (command === 'service-result') {
+    console.log(runServiceResult(args));
+    return;
+  }
+  if (command === 'application-result') {
+    console.log(runApplicationResult(args));
     return;
   }
-  throw new Error('用法: onboarding_message_runner.mjs <platform-entry|mcc-resolve|mcc-search|mcc-clarify|mcc-candidates|material-collect|application-candidates|service-candidates|application-recheck|closeout> ...');
+  throw new Error('用法: onboarding_message_runner.mjs <platform-entry|product-clarify|enterprise-unsupported|mcc-resolve|mcc-resolve-plan|plan-confirm|mcc-search|mcc-clarify|mcc-candidates|material-collect|application-candidates|service-candidates|application-recheck|closeout|service-create-summary|service-update-confirm|application-harmony-manual-create|application-reuse-no-key|signing-result|service-result|application-result> ...');
 }
 
 if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {

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

@@ -553,6 +553,18 @@ function validateVariantInputShape(messageId, variantName, variables) {
 }
 
 const managedEntrypoints = {
+  'product.unsupported': {
+    command: 'node scripts/integration_message_runner.mjs product-unsupported --product-name <产品名>',
+    reason: '不支持产品拒绝引导必须由 runner 接收产品名后托管输出，禁止 jq/printf 管道直调 renderer。'
+  },
+  'product.clarify': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs product-clarify，或代码开发上下文执行 node ../normal/scripts/integration_message_runner.mjs product-clarify',
+    reason: '产品澄清属于通用托管消息，禁止用 printf/renderer 管道直接输出。'
+  },
+  'onboarding.enterprise.unsupported': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs enterprise-unsupported --variant <ONBOARDING_ONLY|FULL_PROCESS>',
+    reason: '企业账号停止分支必须由 Onboarding runner 输出，禁止空 JSON 管道直调 renderer。'
+  },
   'onboarding.windows.redirect': {
     command: 'node ../normal/scripts/onboarding_message_runner.mjs platform-entry',
     reason: 'Windows 产品开通入口必须由 runner 根据真实运行平台确定；非 Windows 不得输出该消息。'
@@ -562,7 +574,7 @@ const managedEntrypoints = {
     reason: '代码开发启动确认必须绑定 runner 同一次项目扫描的项目来源、代码状态和其他支付产品，禁止手写项目扫描事实。'
   },
   'integration.checklist.result': {
-    command: 'node ../normal/scripts/integration_message_runner.mjs checklist-result --variant <AIPAY|WEBPAY|APPPAY>',
+    command: 'node ../normal/scripts/integration_message_runner.mjs checklist-result --variant <AIPAY|WEBPAY|APPPAY> --project-path <absPath> --scope-receipt <receipt> --overall-result <result> --failed-items <items> --manual-items <items> ...',
     reason: '最终 checklist 结论必须由 runner 统一接收最终证据并调用 renderer，同一次代码开发只输出一次。'
   },
   'integration.project_candidates.select': {
@@ -585,30 +597,66 @@ const managedEntrypoints = {
     command: 'node ../normal/scripts/onboarding_discovery_runner.mjs run --product-type <aipay|webpay|apppay> --sales-code <SALES_CODE>',
     reason: '该 runner 执行本轮适用查询、校验原始脚本事实、输出唯一 DISCOVERY_RESULT envelope，并在同一次 stdout 生成摘要；禁止单独重放摘要。'
   },
+  'onboarding.plan.confirm': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs mcc-resolve-plan --query <经营描述|MCC编码|MCC名称> --product-type <aipay|webpay|apppay>，或已持有唯一 MCC 事实时执行 plan-confirm --product-type <...> --mcc-code <...> --mcc-name <...> --mcc-qualification <...>',
+    reason: '方案确认必须由 runner 绑定本轮唯一 MCC 事实和产品变体生成，避免 Agent 用 jq/printf/管道手写 renderer 输入。'
+  },
   'materials.category.collect': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs material-collect --category <signing|service|application> --state <INITIAL|PARTIAL|INVALID|APP_MOBILE_INITIAL> --product-type <aipay|webpay|apppay>',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs material-collect --category <signing|service|application> --state <INITIAL|PARTIAL|INVALID|APP_MOBILE_INITIAL> --product-type <aipay|webpay|apppay> [--missing-fields <字段列表>]',
     reason: '运行时禁止手写 categoryName/currentStatus/missingFields；runner 会归一化“签约资料”“AI 网页应用收款签约截图”“mobilePlatform”等常见别名后再调用 renderer。'
   },
+  'service.create.summary': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-create-summary --service-name <name> --service-description <desc> --service-url <url> --service-pricing <amount> --service-schema <json>',
+    reason: '服务创建摘要必须由 runner 接收已校验五项资料后托管输出，禁止 jq/printf 管道直调 renderer。'
+  },
+  'onboarding.write.confirm': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-update-confirm --session-summary <summary> --subject-summary <summary> --service-id <id> --service-name <name> --service-description <desc> --service-url <url> --service-pricing <amount> --service-schema <json>',
+    reason: '服务修改确认必须由 runner 固定产品和动作，只绑定当前服务修改摘要，禁止 Agent 自行拼 actionTypes。'
+  },
+  'signing.operation.result': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs signing-result --actual-status <status> [--fee-display <fee>] --next-action <action>',
+    reason: '签约分支结果必须由 Onboarding runner 输出，避免直调 renderer 或手写状态。'
+  },
+  'service.operation.result': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-result --service-id <id> --actual-result <result>',
+    reason: '服务分支结果必须由 Onboarding runner 输出，避免直调 renderer 或手写状态。'
+  },
+  'application.harmony.manual_create': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-harmony-manual-create',
+    reason: 'HarmonyOS 移动应用边界必须由 Onboarding runner 输出，禁止空 JSON 管道直调 renderer。'
+  },
+  'application.reuse.no_key': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-reuse-no-key --app-id <appId>',
+    reason: '复用应用缺公钥提示必须由 runner 绑定当前完整 appId 后输出。'
+  },
+  'application.operation.result': {
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-result --app-id <id> --actual-status <status> --next-action <action>',
+    reason: '应用分支结果必须由 Onboarding runner 输出，避免直调 renderer 或手写状态。'
+  },
   'application.candidates.facts': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-candidates --application-type <WEBAPP|MOBILEAPP>',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-candidates --application-type <WEBAPP|MOBILEAPP> --candidates-json <APP_CANDIDATES_JSON>',
     reason: '应用候选事实和适用选择提示必须由 runner 接收结构化候选数组并统一生成，禁止脚本或 Agent 拼接 Markdown 行。'
   },
   'application.candidate.select': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-candidates --application-type <WEBAPP|MOBILEAPP>',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs application-candidates --application-type <WEBAPP|MOBILEAPP> --candidates-json <APP_CANDIDATES_JSON>',
     reason: '应用候选选择必须由 runner 绑定同一份结构化候选快照生成，禁止脚本或 Agent 单独调用。'
   },
   'service.candidates.facts': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-candidates',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-candidates --candidates-json <SERVICE_CANDIDATES_JSON>',
     reason: '服务候选事实和适用选择提示必须由 runner 接收结构化候选数组并统一生成，禁止脚本或 Agent 拼接 Markdown 行。'
   },
   'service.candidate.select': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-candidates',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs service-candidates --candidates-json <SERVICE_CANDIDATES_JSON>',
     reason: '服务候选选择必须由 runner 绑定同一份结构化候选快照生成，禁止脚本或 Agent 单独调用。'
   },
   'process.partial_result': {
-    command: 'node ../normal/scripts/onboarding_message_runner.mjs closeout',
+    command: 'node ../normal/scripts/onboarding_message_runner.mjs closeout --product-name <name> --process-result-title <title> --integration-result <result> --signing-result <result> --service-result <result> --application-result <result> --remaining-actions <actions> --next-flow-reminder <reminder>',
     reason: '产品开通 Step 6 最终收口必须由 runner 统一合并代码开发状态、产品开通分支状态、最近应用分支结果和上线前关键点；禁止 Agent 手写、缩写或删减 AI 网页应用收款限制引导。'
   },
+  'sandbox.android.client': {
+    command: 'node ../normal/scripts/integration_message_runner.mjs sandbox-android-client',
+    reason: '沙箱支付宝 Android 下载说明必须由 Integration runner 输出，避免 Agent 为静态消息直调 renderer 或追加 shell 过滤。'
+  },
   'auth.page': {
     command: 'bash modules/scripts/auth.sh init --defer-open --scope <scope> --sales-code <code> --mcc-code <code> --product-name <name> --mcc-name <name>，页面 stdout 独立送达后执行 bash modules/scripts/auth.sh open ...',
     reason: '授权页必须由 auth.sh 绑定本次 CLI deviceCode、固定产品/MCC 上下文和 URL 白名单；受控 opener 必须在页面消息独立送达后执行，后续 auth.pending 不得合并到同一条对客回复。',
@@ -1245,6 +1293,18 @@ async function readStdin() {
   return input.trim() ? JSON.parse(input) : {};
 }
 
+function inputJsonArg() {
+  const index = process.argv.indexOf('--input-json');
+  if (index < 0) return null;
+  const value = process.argv[index + 1];
+  if (value === undefined || value.startsWith('--')) throw new Error('参数 --input-json 缺少取值');
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error('--input-json 必须是合法 JSON 对象');
+  }
+}
+
 async function main() {
   if (process.argv.includes('--check-catalog')) {
     const errors = validateCatalog();
@@ -1275,7 +1335,7 @@ async function main() {
   const variant = variantIndex >= 0 ? process.argv[variantIndex + 1] : 'DEFAULT';
   if (!messageId) throw new Error('用法: render_customer_message.mjs <messageId> [--variant NAME]');
   assertManagedCliAllowed(messageId);
-  const variables = await readStdin();
+  const variables = inputJsonArg() ?? await readStdin();
   console.log(renderMessageWithFallback(messageId, variant, variables));
 }
 

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

@@ -396,7 +396,9 @@ export function messageMetricEvent(messageId, variantName, variables = {}, conte
 
 export function emitMetricEvent(event, { env = process.env, stream = process.stderr, upload = true } = {}) {
   if (!telemetryEnabled(env) || !event) return false;
-  stream.write(`${internalPrefix}METRIC_EVENT=${JSON.stringify(event)}\n`);
+  if (stream && typeof stream.write === 'function') {
+    stream.write(`${internalPrefix}METRIC_EVENT=${JSON.stringify(event)}\n`);
+  }
   if (upload) scheduleSyncLogUpload(event, env);
   return true;
 }
@@ -448,7 +450,7 @@ export function emitMessageMetric(messageId, variantName, variables = {}, contex
   try {
     const event = messageMetricEvent(messageId, variantName, variables, context);
     if (event?.stage === 'run.terminal' && telemetryEnabled()) updateExistingRunStateFromEvent(event);
-    return emitMetricEvent(event);
+    return emitMetricEvent(event, { stream: null });
   } catch {
     return false;
   }
@@ -460,7 +462,7 @@ export function emitTerminalMetric(context = {}) {
     const event = stageMetricEvent('run.terminal', context);
     if (!event) return false;
     updateExistingRunStateFromEvent(event);
-    return emitMetricEvent(event);
+    return emitMetricEvent(event, { stream: null });
   } catch {
     return false;
   }