@alipay/alipay-aipay 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "支付宝 AI 支付技能包 - 一键安装 Agent Skill，并后台准备 alipay-cli 环境",
   "type": "module",
   "bin": {

package/skill/references/onboarding/flow.md

@@ -412,6 +412,8 @@ bash modules/scripts/ar_sign_apply.sh --product apppay --sales-code "I1080300001
 
 **查询应用**：执行 `bash modules/scripts/app.sh list --product-type "$PRODUCT_TYPE" --sales-code "$SALES_CODE"`。APP支付会按 `--product-type apppay` 或 `--sales-code I1080300001000041313` 自动查询 `MOBILEAPP`。
 
+APP支付新建 `MOBILEAPP` 时，`appSign` 仅表示 Android 应用签名摘要字段。采集 `appSign` 时只向用户索要其 Android 应用对应的签名摘要值，禁止引导用户通过支付宝开放平台官方密钥生成工具、签名工具或格式转换工具获取；阶段 4 的应用公钥生成引导只适用于 `createKeyConfirmPage` 的 `publicKey`，不得套用到 `appSign`。
+
 ```bash
 # 按量付费/网站支付
 bash modules/scripts/app.sh list --product-type "<aipay|webpay>" --sales-code "<当前产品码>"
@@ -430,7 +432,7 @@ bash modules/scripts/app.sh create --product-type "apppay" --sales-code "I108030
 bash modules/scripts/app.sh create --product-type "apppay" --sales-code "I1080300001000041313" --mobile-platform "ALL" --bundle-id "<bundleId>" --app-package "<appPackage>" --app-sign "<appSign>"
 ```
 
-**创建应用**：执行 `bash modules/scripts/app.sh create --product-type "$PRODUCT_TYPE" --sales-code "$SALES_CODE"`。APP支付会自动创建 `MOBILEAPP`，但只在进入 5.3 创建应用阶段后采集移动应用平台信息：`IOS` 需要传 `--bundle-id`，`ANDROID` 需要传 `--app-package` 和 `--app-sign`，`ALL` 需要三项都传。字段缺失时先向用户补问，禁止用最小入参创建 `MOBILEAPP`。
+**创建应用**：执行 `bash modules/scripts/app.sh create --product-type "$PRODUCT_TYPE" --sales-code "$SALES_CODE"`。APP支付会自动创建 `MOBILEAPP`，但只在进入 5.3 创建应用阶段后采集移动应用平台信息：`IOS` 需要传 `--bundle-id`，`ANDROID` 需要传 `--app-package` 和 `--app-sign`，`ALL` 需要三项都传。字段缺失时先向用户补问，禁止用最小入参创建 `MOBILEAPP`。补问 `appSign` 时只索要 Android 应用签名摘要值，不引导用户使用支付宝开放平台官方密钥/签名工具。
 
 **设置公钥**：执行 `bash modules/scripts/app.sh key <appId> <用户提供的公钥>`。
 
@@ -549,7 +551,7 @@ SUCCESS=$(echo "$BUSINESS" | jq -r '.success // false')
 ```
 
 > 内存状态只保存流程上下文和非敏感产物引用。禁止写入私钥、公钥原文、签名串、授权 token、完整支付表单或其他业务凭据。
-> `appSign` 指 Android 应用签名摘要字段，只在应用创建阶段使用，不是支付签名串或私钥；不得把支付签名串、私钥或其他业务凭据写入内存。
+> `appSign` 指 Android 应用签名摘要字段，只在应用创建阶段使用，不是应用公钥、支付签名串或私钥；不得把支付签名串、私钥或其他业务凭据写入内存，也不得引导用户通过支付宝开放平台官方密钥/签名工具获取。
 
 **productType 与 productName 对应关系**：
 | productName | productType | 说明 |

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

@@ -78,6 +78,8 @@
 - `mobilePlatform=ANDROID`：必须同时传 `appPackage` 和 `appSign`。
 - `mobilePlatform=ALL`：必须同时传 `bundleId`、`appPackage` 和 `appSign`。
 - 用户说“bundle_id”时，映射到脚本参数 `--bundle-id`，MCP 请求字段为 `bundleId`。
+- `appSign` 是 Android 应用签名摘要字段，只在创建 `MOBILEAPP` 时作为 `createApplication` 入参采集；它不是应用公钥、支付签名串或私钥。
+- 采集 `appSign` 时只要求用户提供其 Android 应用对应的签名摘要值；不得引导用户通过支付宝开放平台官方密钥生成工具、签名工具或格式转换工具获取，也不得把阶段 4 的应用公钥生成引导套用到 `appSign`。
 - 不确定字段值时不要编造，也不要用包名、签名摘要或 bundleId 的占位符调用 `createApplication`。
 
 ---
@@ -275,6 +277,8 @@ APP支付缺少平台或对应字段时，先向用户补问，禁止调用 `cre
 | 创建成功 | 获取 appId，进入阶段 4 设置应用公钥 |
 | 创建失败 | 返回错误，停止后续流程 |
 
+如果 `createApplication` 返回 `APP_MAX_ERROR` / `应用数量达到上限`，不要继续调整 `appSign`、`bundleId`、`mobilePlatform` 等创建参数，也不要重复新建。应明确告知用户当前主体应用数量已达到上限，优先返回阶段 2 复用已有 `ON_LINE` 应用；如必须新建，引导用户前往支付宝开放平台处理应用配额或联系支付宝技术支持。
+
 ---
 
 ## 阶段 4: 设置应用公钥

package/skill/references/onboarding/modules/error-handling.md

@@ -150,11 +150,15 @@
 }
 ```
 
+> ⚠️ 有些 MCP 返回会把真实业务响应包在 `data.response` 或 `errorContext.errorStack[]` 下。错误检测必须优先定位业务错误对象：既要兼容 `errorCode: "xxx"`，也要兼容 `errorCode: { "code": "xxx", "desc": "...", "message": "...", "errorScene": "...", "errorSpecific": "..." }`。错误信息应从同一错误对象提取 `errorMessage` / `errorMsg` / `errorCode.desc` / `errorCode.message` / `bizTips` / `errorScene` / `errorSpecific`，不得只读取顶层字段后兜底为“未知错误”。
+
 ### 处理原则
 ```
 ✅ errorCode 存在 → 展示 errorMessage
 ✅ 如有 bizTips → 一并展示给用户
 ✅ 如有 checkedError → 逐条展示字段级校验错误描述
+✅ 如有 errorScene / errorSpecific → 一并展示，便于技术支持定位
+✅ createApplication 返回 APP_MAX_ERROR → 告知用户应用数量达到上限，引导复用已有上线应用或前往支付宝开放平台处理配额
 ✅ needRetry=true → 告知用户可以重试
 ❌ 禁止：忽略 errorCode 继续执行
 ❌ 禁止：向用户暴露技术性内部错误
@@ -211,8 +215,8 @@ SUCCESS=$(echo "$BUSINESS" | jq -r '.success // false')
 │   动作：退出登录 → 重新授权                                      │
 ├─────────────────────────────────────────────────────────────────┤
 │ 📋 BUSINESS_ERROR                                               │
-│   关键词：errorCode 字段存在                                     │
-│   动作：展示错误信息 + bizTips + checkedError                    │
+│   关键词：errorCode 字段存在（含 data.response 或 errorStack）    │
+│   动作：展示错误信息 + bizTips + checkedError + errorScene       │
 ├─────────────────────────────────────────────────────────────────┤
 │ ⚠️ CLI_ERROR                                                    │
 │   关键词：success=false 但无 errorCode                           │

package/skill/references/onboarding/modules/scripts/error_handler.sh

@@ -47,6 +47,136 @@ unwrap_mcp() {
   fi
 }
 
+# ─── JSON 错误字段提取 ─────────────────────────────────────────────────────
+# 部分 MCP 后端会把真实业务响应包在 data/response 或 errorContext.errorStack 下。
+# 下面的提取函数优先定位同一个错误对象，避免 success=false 时丢失真实错误体。
+extract_first_named_field() {
+  local JSON="$1"
+  local FIELD="$2"
+  echo "$JSON" | jq -r --arg field "$FIELD" '
+    [.. | objects | .[$field]? | select(. != null and (tostring != ""))][0] // ""
+  ' 2>/dev/null
+}
+
+extract_error_object() {
+  echo "$1" | jq -c '
+    [
+      .. | objects |
+      select(
+        ((.errorCode? | type) == "string" and .errorCode != "") or
+        ((.errorCode? | type) == "object" and ((.errorCode.code? // "") != ""))
+      )
+    ][0] // empty
+  ' 2>/dev/null
+}
+
+extract_error_code() {
+  local ERROR_OBJECT
+  ERROR_OBJECT=$(extract_error_object "$1")
+  if [ -n "$ERROR_OBJECT" ]; then
+    echo "$ERROR_OBJECT" | jq -r '
+      if (.errorCode | type) == "string" then .errorCode
+      elif (.errorCode | type) == "object" then (.errorCode.code // "")
+      else ""
+      end
+    ' 2>/dev/null
+    return
+  fi
+
+  echo ""
+}
+
+extract_error_message() {
+  local JSON="$1"
+  local ERROR_OBJECT
+  ERROR_OBJECT=$(extract_error_object "$JSON")
+  if [ -n "$ERROR_OBJECT" ]; then
+    echo "$ERROR_OBJECT" | jq -r '
+      .errorMessage //
+      .errorMsg //
+      .error.message //
+      .message //
+      (if (.errorCode | type) == "object" then (.errorCode.desc // .errorCode.message) else empty end) //
+      "未知错误"
+    ' 2>/dev/null
+    return
+  fi
+
+  echo "$JSON" | jq -r '
+    [
+      .. | objects |
+      (.errorMessage?, .errorMsg?, .message?, (.error? | objects | .message?)) |
+      select(. != null and (tostring != ""))
+    ][0] // "未知错误"
+  ' 2>/dev/null
+}
+
+extract_biz_tips() {
+  local ERROR_OBJECT
+  ERROR_OBJECT=$(extract_error_object "$1")
+  if [ -n "$ERROR_OBJECT" ]; then
+    echo "$ERROR_OBJECT" | jq -r '.bizTips // ""' 2>/dev/null
+    return
+  fi
+
+  extract_first_named_field "$1" "bizTips"
+}
+
+extract_need_retry() {
+  local JSON="$1"
+  local ERROR_OBJECT
+  ERROR_OBJECT=$(extract_error_object "$JSON")
+  if [ -n "$ERROR_OBJECT" ]; then
+    echo "$ERROR_OBJECT" | jq -r 'if .needRetry == true then "true" else "false" end' 2>/dev/null
+    return
+  fi
+
+  echo "$JSON" | jq -r '
+    if any(.. | objects; .needRetry? == true) then "true" else "false" end
+  ' 2>/dev/null
+}
+
+extract_error_object_field() {
+  local JSON="$1"
+  local FIELD="$2"
+  local ERROR_OBJECT
+  ERROR_OBJECT=$(extract_error_object "$JSON")
+  if [ -n "$ERROR_OBJECT" ]; then
+    echo "$ERROR_OBJECT" | jq -r --arg field "$FIELD" '
+      .[$field] //
+      (if (.errorCode | type) == "object" then (.errorCode[$field] // "") else "" end)
+    ' 2>/dev/null
+    return
+  fi
+
+  extract_first_named_field "$JSON" "$FIELD"
+}
+
+extract_success_state() {
+  local JSON="$1"
+  echo "$JSON" | jq -r '
+    if any(.. | objects; .success? == false) then "false"
+    elif any(.. | objects; .success? == true) then "true"
+    else "null"
+    end
+  ' 2>/dev/null
+}
+
+extract_checked_errors() {
+  local JSON="$1"
+  echo "$JSON" | jq -c '
+    [
+      .. | objects |
+      (
+        .checkedError?,
+        (.resultObj? | objects | .checkedError?),
+        (.data? | objects | .checkedError?)
+      ) |
+      select(. != null)
+    ][0] // empty
+  ' 2>/dev/null
+}
+
 # ─── 统一错误检测 ──────────────────────────────────────────────────────────
 # 参数: $1 - CLI 执行结果文本（原始输出，含信封或不含）
 # 返回: MCP_AUTH_ERROR | MCP_SERVICE_ERROR | AUTH_MISMATCH | SERVICE_UNSTABLE | ERROR:xxx | CLI_ERROR:xxx | SUCCESS
@@ -94,18 +224,17 @@ detect_error() {
   fi
 
   # 5. 通用业务错误（从解包后的 JSON 中提取 errorCode）
-  local ERROR_CODE=$(echo "$UNWRAPPED" | jq -r '.errorCode // .data.errorCode // ""' 2>/dev/null)
+  local ERROR_CODE=$(extract_error_code "$UNWRAPPED")
   if [ -n "$ERROR_CODE" ] && [ "$ERROR_CODE" != "null" ]; then
     echo "ERROR:$ERROR_CODE"
     return
   fi
 
   # 6. CLI 命令本身的错误（success: false，从解包后的 JSON 提取）
-  # 注意: jq 的 // 对 false 视为 falsy 会触发 alternative，所以不能写 .success // "true"
-  # 必须先将 false 转为字符串再判断
-  local SUCCESS=$(echo "$UNWRAPPED" | jq -r 'if .success == false then "false" elif .success == true then "true" else "null" end' 2>/dev/null)
+  # 注意: MCP 业务响应可能嵌套在 data/response 下，因此递归检测 success=false。
+  local SUCCESS=$(extract_success_state "$UNWRAPPED")
   if [ "$SUCCESS" = "false" ]; then
-    local ERROR_MSG=$(echo "$UNWRAPPED" | jq -r '.error.message // .errorMessage // .message // "未知错误"' 2>/dev/null)
+    local ERROR_MSG=$(extract_error_message "$UNWRAPPED")
     echo "CLI_ERROR:$ERROR_MSG"
     return
   fi
@@ -214,14 +343,20 @@ handle_backend_error() {
   echo "📋 错误码：$ERROR_CODE"
 
   # 提取错误信息
-  local ERROR_MSG=$(echo "$UNWRAPPED" | jq -r '.errorMessage // .data.errorMessage // .error.message // .message // "未知错误"' 2>/dev/null)
-  local BIZ_TIPS=$(echo "$UNWRAPPED" | jq -r '.bizTips // .data.bizTips // ""' 2>/dev/null)
-  local NEED_RETRY=$(echo "$UNWRAPPED" | jq -r '.needRetry // .data.needRetry // "false"' 2>/dev/null)
+  local ERROR_MSG=$(extract_error_message "$UNWRAPPED")
+  local BIZ_TIPS=$(extract_biz_tips "$UNWRAPPED")
+  local NEED_RETRY=$(extract_need_retry "$UNWRAPPED")
+  local ERROR_SCENE=$(extract_error_object_field "$UNWRAPPED" "errorScene")
+  local ERROR_SPECIFIC=$(extract_error_object_field "$UNWRAPPED" "errorSpecific")
 
   echo "📋 错误信息：$ERROR_MSG"
 
+  if [ -n "$ERROR_SCENE" ] || [ -n "$ERROR_SPECIFIC" ]; then
+    echo "📋 错误场景：${ERROR_SCENE:-未知} / ${ERROR_SPECIFIC:-未知}"
+  fi
+
   # 透出 checkedError 中的详细错误描述（如 ar-sign.apply 返回的字段级校验错误）
-  local CHECKED_ERRORS=$(echo "$UNWRAPPED" | jq -r '.resultObj.checkedError // .data.checkedError // empty' 2>/dev/null)
+  local CHECKED_ERRORS=$(extract_checked_errors "$UNWRAPPED")
   if [ -n "$CHECKED_ERRORS" ] && [ "$CHECKED_ERRORS" != "null" ] && [ "$CHECKED_ERRORS" != "[]" ]; then
     echo ""
     echo "📋 详细校验错误："
@@ -235,6 +370,11 @@ handle_backend_error() {
     echo "💡 提示：$BIZ_TIPS"
   fi
 
+  if [ "$ERROR_CODE" = "APP_MAX_ERROR" ]; then
+    echo ""
+    echo "📌 处理建议：当前主体下应用数量已达到上限，无法继续新建应用。请优先复用已有上线应用；如必须新建，请前往支付宝开放平台处理应用配额或联系支付宝技术支持。"
+  fi
+
   if [ "$NEED_RETRY" = "true" ]; then
     echo ""
     echo "🔄 此错误可重试，请回复「重试」重新执行"
@@ -291,11 +431,11 @@ handle_error() {
       local MSG="${ERROR_TYPE#CLI_ERROR:}"
       echo "❌ 命令执行失败：$MSG"
       # CLI_ERROR 也透出 bizTips 和 checkedError（如果有的话）
-      local CLI_BIZ_TIPS=$(echo "$_UNWRAPPED" | jq -r '.bizTips // .data.bizTips // ""' 2>/dev/null)
+      local CLI_BIZ_TIPS=$(extract_biz_tips "$_UNWRAPPED")
       if [ -n "$CLI_BIZ_TIPS" ] && [ "$CLI_BIZ_TIPS" != "null" ] && [ "$CLI_BIZ_TIPS" != "" ]; then
         echo "💡 $CLI_BIZ_TIPS"
       fi
-      local CLI_CHECKED=$(echo "$_UNWRAPPED" | jq -r '.resultObj.checkedError // .data.checkedError // empty' 2>/dev/null)
+      local CLI_CHECKED=$(extract_checked_errors "$_UNWRAPPED")
       if [ -n "$CLI_CHECKED" ] && [ "$CLI_CHECKED" != "null" ] && [ "$CLI_CHECKED" != "[]" ]; then
         echo "📋 详细校验错误："
         echo "$CLI_CHECKED" | jq -r '.[]? | .errorDesc // .message // . // empty' 2>/dev/null | while IFS= read -r line; do