@alipay/alipay-aipay 1.5.9-beta → 1.5.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.5.9-beta",
+  "version": "1.5.9",
   "description": "支付宝 AI 付 Skill 安装包 - 优先安装 Agent Skill，并在 macOS/Linux 后台准备用户级 CLI 工具",
   "type": "module",
   "bin": {

package/skill/VERSION

@@ -1 +1 @@
-1.5.9-beta
+1.5.9

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

@@ -51,7 +51,7 @@ const categoryNames = {
 const materialFieldsByCategory = Object.freeze({
   signing: ['APP名称', '首页截图', '商品页截图', '支付页截图'],
   service: ['服务名称', '服务描述', '服务地址', '服务单价', '请求示例JSON'],
-  application: ['iOS Bundle ID（bundleId）', 'Android 应用包名（appPackage）', 'Android 应用签名摘要（appSign）', '应用公钥']
+  application: ['应用平台和对应资料', 'iOS Bundle ID（bundleId）', 'Android 应用包名（appPackage）', 'Android 应用签名摘要（appSign）', '应用公钥']
 });
 
 const materialStates = {
@@ -531,6 +531,12 @@ async function runMaterialCollect(args) {
 
   if (state === 'APP_WEB_INITIAL' || state === 'APP_MOBILE_INITIAL') {
     if (category !== 'application') throw new Error(`${state} 只适用于 application 类别`);
+    if (state === 'APP_WEB_INITIAL' && productType === 'apppay') {
+      throw new Error('APP_WEB_INITIAL 只适用于 aipay、webpay');
+    }
+    if (state === 'APP_MOBILE_INITIAL' && productType !== 'apppay') {
+      throw new Error('APP_MOBILE_INITIAL 只适用于 apppay');
+    }
     return renderMessage('materials.category.collect', stateRule.variant, {
       categoryName: '应用资料',
       currentStatus: stateRule.currentStatus,
@@ -544,10 +550,17 @@ async function runMaterialCollect(args) {
   const variant = state === 'INITIAL' && category === 'service'
     ? 'SERVICE_INITIAL'
     : stateRule.variant;
+  const missingFields = normalizeMissingFields(category, input.missingFields);
+  if (category === 'application' && productType !== 'apppay') {
+    const incompatibleFields = missingFields.split('、').filter((field) => field !== '应用公钥');
+    if (incompatibleFields.length > 0) {
+      throw new Error(`${productType} 的应用资料只允许应用公钥`);
+    }
+  }
   return renderMessage('materials.category.collect', variant, {
     categoryName,
     currentStatus: stateRule.currentStatus,
-    missingFields: normalizeMissingFields(category, input.missingFields)
+    missingFields
   }, { productType });
 }
 
@@ -621,8 +634,14 @@ async function runApplicationRecheck(args) {
       }
     : await readStdin();
   if (!input || typeof input !== 'object' || Array.isArray(input)) throw new Error('应用候选重查输入必须是 JSON 对象');
-  if (canonicalCandidates(input.previousCandidates) === canonicalCandidates(input.currentCandidates)) return '';
-  return renderApplicationCandidates(applicationType, input.currentCandidates);
+  if (canonicalCandidates(input.previousCandidates) === canonicalCandidates(input.currentCandidates)) {
+    process.stderr.write(`${internalPrefix}APPLICATION_RECHECK_RESULT=UNCHANGED\n`);
+    return '';
+  }
+  const output = renderApplicationCandidates(applicationType, input.currentCandidates);
+  const result = input.currentCandidates.length === 0 ? 'CHANGED_EMPTY' : 'CHANGED_NONEMPTY';
+  process.stderr.write(`${internalPrefix}APPLICATION_RECHECK_RESULT=${result}\n`);
+  return output;
 }
 
 function closeoutInputFromArgs(args) {

package/skill/references/onboarding/flow.md

@@ -396,11 +396,11 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" service save --service-
 
 **应用分支**：按量付费/网站支付使用 `WEBAPP`，APP 支付使用 `MOBILEAPP`。仅 Step 3.1 查询成功、类型合法且候选为数组时继续；失败、缺失或非法时阻断。上下文、移动字段、`appSign`、MCP 参数和返回由 `app.sh` 托管。
 
-候选为空：送达事实后直接收集材料，无需回复 `新建`，禁止默认、占位或猜值。当前 Agent 会话无用户公钥时依次执行并送达 `key-tool`、材料消息；已有公钥时不下载，材料未齐由材料消息说明工具，已齐则先发 `key-tool-guide` 再重查。公钥存在性只认本会话用户输入，不查历史或文件。
+候选为空：送达事实后收集材料，无需回复 `新建`，禁用默认/占位/猜测值。本会话未收到用户公钥时依次送达 `key-tool` 和材料消息；已收到则不下载，材料未齐由材料消息提示工具，已齐先送达 `key-tool-guide` 再重查。只有本会话用户输入可证明公钥已提供。
 
-候选非空：有 `ON_LINE` 时接受当前完整 `appId` 或明确新建；仅非上线候选时另接受 `暂不新建`。新建可同条附全部材料；候选消息给示例和工具链接但不自动下载。只回复 `新建`、材料缺失/错误时保留意图，只补对应项；序号、历史/自报 ID 等执行 Step 4 `invalid`，不写入。用户明确要求下载时执行并送达 `key-tool`，随后返回原等待态。
+候选非空：有 `ON_LINE` 时接受当前完整 `appId` 或 `新建+材料`；仅非上线时另接受 `暂不新建`。候选消息展示示例和工具链接但不自动下载。只回复 `新建` 或材料缺失/错误时保留意图并补对应项；其他输入走 Step 4 `invalid`，不写入。明确要求下载时送达 `key-tool` 后返回原等待态。
 
-新建 `WEBAPP` 需应用公钥；`MOBILEAPP` 需 `IOS+bundleId`、`ANDROID+appPackage+appSign` 或 `ALL+三项客户端资料`，并同条提供应用公钥。接口无应用名称/描述字段，禁止索取或虚构。首次用对应消息，之后 `PARTIAL|INVALID` 只补中文字段：
+`WEBAPP` 新建需公钥；`MOBILEAPP` 需 `IOS+bundleId`、`ANDROID+appPackage+appSign` 或 `ALL+三项`，并提供公钥。接口无名称/描述。`APP_WEB_INITIAL` 仅限 `aipay|webpay`，`APP_MOBILE_INITIAL` 仅限 `apppay`，错配即拒绝。`PARTIAL|INVALID` 只补中文字段；平台未定时用“应用平台和对应资料”：
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" key-tool
@@ -409,7 +409,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message mate
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message material-collect --category application --state APP_MOBILE_INITIAL --product-type "$PRODUCT_TYPE"
 ```
 
-缺公钥时禁止创建或调用 `createKeyConfirmPage`。完整材料经候选重查后创建，取得实际 `appId` 即用同一公钥生成确认页；页面确认后执行 `verify-key-and-audit`，复用安全响应 guard 并提审。工具只下载，不安装、启动或生成密钥；禁止 OpenSSL 方案。
+缺公钥禁止创建或调用 `createKeyConfirmPage`。材料完整且重查允许后创建，以实际 `appId` 和同一公钥生成确认页；页面确认后执行 `verify-key-and-audit`，复用安全响应 guard 提审。工具只下载，不安装、启动或生成密钥；禁用 OpenSSL。
 
 <!-- ALIPAY_AIPAY_PRODUCT:apppay:START -->
 APP 支付通过 Skill 创建只支持 `IOS`、`ANDROID` 和 `ALL`，其中 `ALL` 只表示 iOS + Android。HarmonyOS 移动应用不得调用 `app.sh create`；执行固定 runner 命令输出 `application.harmony.manual_create`，用户在开放平台完成创建及平台要求的后续配置后明确表示操作完成，只重新执行下方同一条轻量 `app list` 查询，不得重新运行 Step 3.1 全量 discovery。只有实际查询到 `ON_LINE` 候选后才能按既有复用路径继续，否则应用分支保持人工待办。
@@ -457,7 +457,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" app audit --product-typ
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" app list --product-type "$PRODUCT_TYPE" --sales-code "$SALES_CODE"
 ```
 
-`CREATE` 将本次快照记为 `RECHECK_APP_CANDIDATES_JSON` 后运行下方比较器：stdout 空且材料齐才创建，非空则原文送达并重选；失败只阻断应用分支。非 `ON_LINE` 不可复用，`FLOW:PENDING_APPLICATIONS` 不是空列表。HarmonyOS 直接用查询结果进入候选判断，不比较 CREATE 快照。
+`CREATE` 以本次快照为 `RECHECK_APP_CANDIDATES_JSON` 运行比较器，只接受唯一内部事实 `APPLICATION_RECHECK_RESULT=UNCHANGED|CHANGED_EMPTY|CHANGED_NONEMPTY`。`UNCHANGED` stdout 为空并创建；`CHANGED_EMPTY` 只送达最新空事实，再沿用新建意图和材料创建；`CHANGED_NONEMPTY` 送达最新候选/提示后重选。marker、正文、候选矛盾或比较失败只阻断应用分支。非 `ON_LINE` 不可复用；HarmonyOS 不比较。
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message application-recheck --application-type "$APPLICATION_TYPE" --previous-candidates-json "$APP_CANDIDATES_JSON" --current-candidates-json "$RECHECK_APP_CANDIDATES_JSON"

package/skill/references/onboarding/modules/app-release.md

@@ -40,21 +40,21 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message appl
 
 HarmonyOS 用户完成平台操作后只重查下方列表，不跑全量 discovery；仅实际 `ON_LINE` 可复用，用户表达不证明创建、配置或上线。
 
-只复用 `ON_LINE`，其他状态如实展示。空候选直接收完整材料；非空有上线候选时接受当前 appId 或 `新建+材料`，仅未上线时接受 `新建+材料|暂不新建`。无效选择重显且不写。创建前重查并比较快照：
+`ON_LINE` 才可复用。空候选收材料；非空接受当前 appId 或 `新建+材料`；仅未上线时可 `暂不新建`；无效选择不写。创建前重查：`UNCHANGED` 直创，`CHANGED_EMPTY` 送达新事实后沿用意图创建，`CHANGED_NONEMPTY` 重选：
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" app list --product-type "$PRODUCT_TYPE" --sales-code "$SALES_CODE"
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message application-recheck --application-type "$APPLICATION_TYPE" --previous-candidates-json "$APP_CANDIDATES_JSON" --current-candidates-json "$RECHECK_APP_CANDIDATES_JSON"
 ```
 
-空候选提交完整材料或非空候选明确新建即确认创建；之后只补缺项。`WEBAPP` 需应用公钥；`MOBILEAPP` 需 `IOS+bundleId`、`ANDROID+appPackage+appSign` 或 `ALL+三项`，并同条提供公钥。接口无应用名称/描述。首次消息：
+材料齐或非空明确新建即确认创建；之后只补缺项。`WEBAPP` 需公钥；`MOBILEAPP` 需平台资料和公钥，平台未定时补“应用平台和对应资料”，`mobilePlatform` 由 runner 归一化。`APP_WEB_INITIAL` 仅限 `aipay|webpay`，`APP_MOBILE_INITIAL` 仅限 `apppay`：
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message material-collect --category application --state APP_WEB_INITIAL --product-type "$PRODUCT_TYPE"
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message material-collect --category application --state APP_MOBILE_INITIAL --product-type "$PRODUCT_TYPE"
 ```
 
-空候选且本会话无用户公钥时自动执行 `runtime.mjs key-tool`；非空候选只提示，明确要求才下载。结果均原文展示；只下载，不安装、启动或生成密钥。材料齐、快照未变才创建，随后以实际 appId 和同一公钥进入确认页、有限校验和提审。
+空候选且未收到公钥时执行 `runtime.mjs key-tool`；非空提示，明确要求下载。只下载，不安装/启动/生成密钥。材料齐且重查允许才创建，以 appId 和同一公钥进入确认页、校验和提审。
 
 ## 公钥边界