@alipay/alipay-aipay 1.6.6-beta1 → 1.6.6-beta2

package/package.json

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

package/skill/VERSION

@@ -1 +1 @@
-1.6.6-beta1
+1.6.6-beta2

package/skill/references/onboarding/flow.md

@@ -315,7 +315,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message mate
 
 仅 `NOT_SIGNED` 执行本节；其他状态禁止重复提交。使用当前产品、MCC 和已验证材料执行固定命令；脚本冻结字段、FLOW 信号和解析。按量付费无页面材料；网站支付需三个图片引用；APP 支付需 APP 名称和三个图片引用。若 MCC 需特殊资质，用户必须选择一个 `qualificationGroups` 组合；`attaType` 非空项按提示顺序上传并生成 `specialLicense`，空值项只作文字条件。字段缺失/校验失败回 Step 4 `materials.category.collect`；材料完整后直接执行 5.1，不增加回复 `1`。
 
-网站支付收首页、商品页、支付页；APP 支付再加 APP 名称且签约状态参数固定 `OFFLINE`。支付页必须展示支付宝付款方式并等待付款，不是支付成功页。三张截图按序执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" screenshots --product-type "$PRODUCT_TYPE" <img1> <img2> <img3>`；只送达脚本 stdout，图片引用只取 `SCREENSHOT_HOME_REF|SCREENSHOT_SHOP_REF|SCREENSHOT_PAY_REF`。特殊资质上传同截图，由 `special-license` 调 `alipay-cli file upload -s payMerchantcodeSkill --json`，返回值作 `licensePic`；不得要求 HTTPS URL 或复述 fileKey。并行认证失效只允许一个全局恢复事实，并保留已验证 APP 名称。
+网站支付收首页、商品页、支付页；APP 支付再加 APP 名称且签约状态参数固定 `OFFLINE`。支付页必须展示支付宝付款方式并等待付款，不是支付成功页。三张截图按序执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" screenshots --product-type "$PRODUCT_TYPE" <img1> <img2> <img3>`；串行上传三次，禁并发。只送达 stdout，引用只取 `SCREENSHOT_HOME_REF|SCREENSHOT_SHOP_REF|SCREENSHOT_PAY_REF`。特殊资质由 `special-license` 调 `alipay-cli file upload -s payMerchantcodeSkill --json`，返回 `licensePic`；不得要求 HTTPS URL 或复述 fileKey。认证失效仅一条事实；不 logout、不显示退出文案，保留 APP 名称。
 
 特殊资质上传只传所选组合中 `attaType` 非空的材料，顺序必须与回执一致；纯文字组合不调用上传命令，签约时传所选组合序号和空数组：
 

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

@@ -20,7 +20,7 @@
 
 发现阶段的单分支失败不得伪装为空列表，也不得回滚其他已成功分支；认证失效或授权不匹配属于查询组全局阻断，重新授权后恢复尚未执行的查询，主体一致性无法确认时重新查询全部适用状态。`logged_in=false` 只在已认证的签约、服务、应用和上传等资源动作中属于认证失效；`auth.sh whoami` 的成功未登录结果仍是正常登录入口，失败响应即使携带该字段也不能证明已退出。discovery 的恢复优先级固定为真实认证/授权阻断、本地 CLI 状态权限、网络权限、普通分支失败；`AUTH_FLOW:RETRY_WITH_NETWORK|RETRY_WITH_LOCAL_FS_PERMISSION|LOGOUT_STILL_LOGGED_IN` 不是 discovery 子查询的认证失效证据，不得映射为 `AUTHORIZATION_INVALID`。
 
-discovery runner 和截图上传这类并发/分组动作不得让每个子进程各自 logout。子脚本在分组环境下只上报认证失效事实；由 flow 登记的唯一授权恢复入口执行一次 logout 后置条件确认。三张截图同时认证失败时只允许产生一个全局认证恢复 marker。
+discovery runner 的并发子查询不得让每个子进程各自 logout。三张截图固定串行上传，禁止多个 `alipay-cli file upload` 进程并发读取认证态；截图和 discovery 子脚本在受抑制环境下只上报一次认证失效事实，不渲染“正在退出当前登录”，由 flow 登记的唯一授权恢复入口处理。
 
 ## 解包与业务错误
 

package/skill/references/onboarding/modules/product-sign.md

@@ -40,7 +40,7 @@
 
 材料缺失或校验失败时使用 flow 登记的 `materials.category.collect`，不得提交。完整通过后直接执行签约脚本，不增加确认。截图只走 `upload_screenshots.sh`。特殊资质上传和签约都必须携带本轮 run 的 `MCC_CONTEXT_RECEIPT` 与用户所选组合序号；脚本按回执精确校验 `licenseType` 顺序，纯文字组合不上传并在签约校验中使用空数组。
 
-特殊资质图片上传与首页/商品页/支付页截图上传一致，均调用 `alipay-cli file upload -s payMerchantcodeSkill --json` 并使用返回的图片引用值。`scripts/upload_special_license.sh` 只把用户选择组合中 `attaType` 非空的材料转换为 `[{licenseType,licensePic}]`；`licensePic` 使用上传返回值，不要求 HTTPS URL。提交签约时，非空 `specialLicense` 作为 `businessProperty` 中与 `mccCode` 并列的字段传给 `ar-sign.apply`。
+特殊资质图片上传与首页/商品页/支付页截图上传一致，均调用 `alipay-cli file upload -s payMerchantcodeSkill --json` 并使用返回的图片引用值；三张页面截图固定串行上传，避免多个 CLI 进程并发读取认证态。`scripts/upload_special_license.sh` 只把用户选择组合中 `attaType` 非空的材料转换为 `[{licenseType,licensePic}]`；`licensePic` 使用上传返回值，不要求 HTTPS URL。提交签约时，非空 `specialLicense` 作为 `businessProperty` 中与 `mccCode` 并列的字段传给 `ar-sign.apply`。
 
 提交成功只表示申请已受理，不等于签约生效；服务和应用分支按各自前置条件继续，不依赖本次签约写成功。写操作仅明确 `NOT_SENT` 时可自动重试；`MAYBE_SENT` 必须先用现有签约查询核验，无法确认进入 `UNKNOWN`，禁止重复提交。
 

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

@@ -645,14 +645,14 @@ render_logout_still_logged_in() {
 
 # ─── MCP 认证错误处理 ──────────────────────────────────────────────────────
 handle_mcp_auth_error() {
-  render_error_message error.mcp.auth START '{}' || {
-    emit_control "AUTH_FLOW:FAILED"
-    return 1
-  }
   if [ "${ALIPAY_AIPAY_SUPPRESS_AUTH_LOGOUT:-}" = "1" ]; then
     emit_control "AUTH_FLOW:AUTH_REQUIRED"
     return 1
   fi
+  render_error_message error.mcp.auth START '{}' || {
+    emit_control "AUTH_FLOW:FAILED"
+    return 1
+  }
   confirm_logout_postcondition
   case "$ALIPAY_LOGOUT_POSTCONDITION" in
     COMMAND_CONFIRMED_SUCCESS|POSTCONDITION_LOGGED_OUT)

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

@@ -1,7 +1,7 @@
 #!/bin/bash
 #=============================================================================
 # 脚本名称: upload_screenshots.sh
-# 功能描述: 并行上传截图文件并解析可用于签约的图片引用值
+# 功能描述: 串行上传截图文件并解析可用于签约的图片引用值
 # 调用位置: Step 4 签约材料类别
 # 调用前置: 脚本通过 error_handler.sh 间接初始化 DEV_TOOL_NAME/PLATFORM_ID；需传入产品类型和3个文件路径
 # 用法: bash upload_screenshots.sh --product-type <webpay|apppay> "$HOME_IMG" "$SHOP_IMG" "$PAY_IMG"
@@ -90,16 +90,14 @@ TMP_HOME_ERR=$(mktemp "${TMP_BASE}/upload_home_err.XXXXXX") || { echo "❌ 创
 TMP_SHOP_ERR=$(mktemp "${TMP_BASE}/upload_shop_err.XXXXXX") || { echo "❌ 创建临时文件失败"; exit 1; }
 TMP_PAY_ERR=$(mktemp "${TMP_BASE}/upload_pay_err.XXXXXX") || { echo "❌ 创建临时文件失败"; exit 1; }
 
-# 并行上传 3 张截图。PLATFORM_ID、ALIPAYCLI_BIZ_INFO 与 PRODUCT 均由公共上下文初始化。
-PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$HOME_IMG" -s payMerchantcodeSkill --json >"$TMP_HOME" 2>"$TMP_HOME_ERR" &
-PID_HOME=$!
-PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$SHOP_IMG" -s payMerchantcodeSkill --json >"$TMP_SHOP" 2>"$TMP_SHOP_ERR" &
-PID_SHOP=$!
-PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$PAY_IMG" -s payMerchantcodeSkill --json >"$TMP_PAY" 2>"$TMP_PAY_ERR" &
-PID_PAY=$!
-wait "$PID_HOME"; HOME_UPLOAD_RC=$?
-wait "$PID_SHOP"; SHOP_UPLOAD_RC=$?
-wait "$PID_PAY"; PAY_UPLOAD_RC=$?
+# 已验证多个 file upload 进程会竞争本地认证态；三张截图固定串行。
+# PLATFORM_ID、ALIPAYCLI_BIZ_INFO 与 PRODUCT 均由公共上下文初始化。
+PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$HOME_IMG" -s payMerchantcodeSkill --json >"$TMP_HOME" 2>"$TMP_HOME_ERR"
+HOME_UPLOAD_RC=$?
+PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$SHOP_IMG" -s payMerchantcodeSkill --json >"$TMP_SHOP" 2>"$TMP_SHOP_ERR"
+SHOP_UPLOAD_RC=$?
+PLATFORM="${DEV_TOOL_NAME:-unknown}" PLATFORM_ID="${PLATFORM_ID:-}" ALIPAYCLI_BIZ_INFO="$ALIPAYCLI_BIZ_INFO" PRODUCT="${PRODUCT:-}" alipay-cli file upload "$PAY_IMG" -s payMerchantcodeSkill --json >"$TMP_PAY" 2>"$TMP_PAY_ERR"
+PAY_UPLOAD_RC=$?
 
 upload_combined_output() {
   local stdout_file="$1" stderr_file="$2"