@alipay/alipay-aipay 1.5.8-beta2 → 1.5.8-beta3

package/package.json

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

package/skill/VERSION

@@ -1 +1 @@
-1.5.8-beta2
+1.5.8-beta3

package/skill/references/onboarding/flow.md

@@ -203,6 +203,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    ├─ AUTH_FLOW:READY_TO_OPEN → 输出非阻塞授权页，执行第 2 项
    │  └─ 若同时存在 AUTH_STATE:SAVE_FAILED：授权页 stdout 已送达，后续 open 仅可降级为 AUTH_OPEN:LINK_ONLY；wait/confirm 仍使用本条命令显式上下文继续，禁止重新生成授权页
    ├─ 底层 init 命中 SCOPE_MISMATCH / MCC_MISMATCH → runtime 在同一命令内自动调用既有第 4 项，只透传 mismatch 的最终结果；唯一 AUTH_AUTO_MISMATCH 仅供内部诊断，不是终态
+   ├─ AUTH_FLOW:AUTH_REQUIRED → 当前失效会话已按脚本后置条件处理；原样重新执行第 1 项一次，生成当前上下文的新授权页；再次命中则停止循环
    ├─ AUTH_FLOW:RETRY_WITH_NETWORK → 取得联网权限后重试同一完整命令
    ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 取得 CLI 私有状态目录权限后原样重试本命令一次
    ├─ AUTH_FLOW:LOGOUT_STILL_LOGGED_IN → 自动 mismatch 的 logout 后置条件未成立，按第 4 项同名分支停止
@@ -216,6 +217,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    ├─ AUTH_FLOW:PENDING → 输出 auth.pending，等待用户明确表示扫码已完成
    ├─ AUTH_FLOW:EXPIRED → 重新执行第 1 项生成授权链接
    ├─ AUTH_FLOW:CONTEXT_MISMATCH → 当前动作未执行 login --complete/logout；使用当前已确认的完整参数重新执行第 1 项
+   ├─ AUTH_FLOW:AUTH_REQUIRED → 当前授权会话已失效，旧页面不再作为恢复依据；原样重新执行第 1 项一次，再次命中则停止循环
    ├─ AUTH_FLOW:RETRY_WITH_NETWORK → 取得联网权限后重试同一完整命令
    ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 保留当前授权页短时状态，取得 CLI 私有状态目录权限后原样重试当前 wait 命令一次
    ├─ AUTH_FLOW:FAILED → 停止并按错误输出恢复，禁止进入 Step 3.1

package/skill/references/onboarding/modules/authorization.md

@@ -22,6 +22,7 @@
 - `AUTH_FLOW:PENDING`：有限轮询耗尽或单次恢复查询尚未得到有效本机登录态；不等于失败，也不证明用户未扫码。
 - `AUTH_FLOW:EXPIRED`：当前页面实际返回过期，旧页面和旧回复失效，重新执行 flow 登记的 init。
 - `AUTH_FLOW:SCOPE_MISMATCH|MCC_MISMATCH`：只能走 `auth.sh mismatch`。统一 runtime 的 `auth init` 在底层 init 唯一返回 mismatch 且 stdout 为空时，会在同一命令内自动调用既有 `auth.sh mismatch`，抑制中间 mismatch 终态并只透传最终结果；`wait|confirm` 返回 mismatch 时仍按 flow 显式调用 mismatch。logout 后置条件未成立前不得重授权；仍登录返回 `AUTH_FLOW:LOGOUT_STILL_LOGGED_IN`。
+- `AUTH_FLOW:AUTH_REQUIRED`：`whoami` 或已认证资源校验已证明当前 CLI 会话失效，且脚本已完成既有 logout 后置条件处理；按 flow 原样重新执行当前上下文的 `auth init` 一次，旧授权页不再作为恢复依据，再次命中时停止循环。
 - `AUTH_FLOW:RETRY_WITH_NETWORK`：当前 Agent 环境无法确认结果，申请联网权限后原样重试同一命令；不得解释为用户本机登录失败。
 - `AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION`：授权状态命令 preflight 失败，或实际输出命中 CLI 私有状态写失败证据。可恢复阶段 stdout 为空；仅允许当前受控 runtime 命令访问 CLI 私有状态目录后原样重试一次；`wait|confirm` 保留短时授权状态，不重建授权页。Agent 禁止读取、列举、打印或复制已有凭据与日志；拒绝、不支持或重试仍命中同一 marker 时才输出最小失败说明。
 

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

@@ -6,7 +6,7 @@
 
 | 内部分类 | 已验证触发 | 恢复边界 |
 | --- | --- | --- |
-| `MCP_AUTH_ERROR` | HTTP 401、`Authorization is empty`、非法认证信息 | 停止查询组；logout 后置条件成立后重授权。仍登录则阻断；不可确认或无网络时只重试同一动作，不解释为用户本机或支付宝业务失败 |
+| `MCP_AUTH_ERROR` | HTTP 401、`Authorization is empty`、非法认证信息、`用户未登录`、`not_logged_in` 等明确登录失效证据；已认证资源动作顶层或 `data.logged_in=false` | 停止查询组；logout 后置条件成立后重授权。仍登录则阻断；不可确认或无网络时只重试同一动作，不解释为用户本机或支付宝业务失败 |
 | `AUTH_MISMATCH` | `mccCode is not auth`、`salesProductCodes is not auth`、`scope is not auth` | 停止当前动作，只进 `auth.sh mismatch`；logout 后置条件未成立前禁重授权 |
 | `MCP_SERVICE_ERROR` / `SERVICE_UNSTABLE` | 已识别连接、网络或服务异常 | 按下方有限重试规则处理；耗尽后记录受影响分支，依赖允许时继续其他独立分支，最终统一收口 |
 | `DISCOVERY_FLOW:RETRY_WITH_NETWORK` | discovery 子查询重试耗尽，且原始输出包含 DNS、连接、timeout、socket/TLS、`fetch failed`、`network_error`、`网络连接失败` 或连接前沙箱禁网强证据 | 只在无授权阻断时输出一次；暂存首次 stdout，申请联网权限后原样重试同一 discovery 命令一次。拒绝、不支持或再次命中时停止申请，只送达最新一次既有 stdout |
@@ -17,7 +17,7 @@
 | `CLI_ERROR:<message>` | CLI 失败、异常结构或结果不可唯一解析 | 隐藏原始输出，停止并按登记 CLI 错误恢复，不猜成功或空结果 |
 | `SUCCESS` | 唯一合法成功结构 | 才允许进入当前脚本的业务字段解析 |
 
-发现阶段的单分支失败不得伪装为空列表，也不得回滚其他已成功分支；认证失效或授权不匹配属于查询组全局阻断，重新授权后恢复尚未执行的查询，主体一致性无法确认时重新查询全部适用状态。
+发现阶段的单分支失败不得伪装为空列表，也不得回滚其他已成功分支；认证失效或授权不匹配属于查询组全局阻断，重新授权后恢复尚未执行的查询，主体一致性无法确认时重新查询全部适用状态。`logged_in=false` 只在已认证的签约、服务、应用和上传等资源动作中属于认证失效；`auth.sh whoami` 的成功未登录结果仍是正常登录入口，失败响应即使携带该字段也不能证明已退出。
 
 discovery runner 和截图上传这类并发/分组动作不得让每个子进程各自 logout。子脚本在分组环境下只上报认证失效事实；由 flow 登记的唯一授权恢复入口执行一次 logout 后置条件确认。三张截图同时认证失败时只允许产生一个全局认证恢复 marker。
 

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

@@ -324,7 +324,7 @@ query_security_key() {
     return 1
   fi
 
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     return 1
   fi
 
@@ -353,7 +353,7 @@ query_application_info() {
     return 1
   fi
 
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     return 1
   fi
 
@@ -590,7 +590,7 @@ app_list() {
   fi
 
   # 错误检测
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     exit 1
   fi
 
@@ -701,7 +701,7 @@ app_create() {
   fi
 
   # 错误检测
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     emit_control "APPLICATION_CREATE_RESULT=FAILED"
     exit 1
   fi
@@ -782,7 +782,7 @@ app_key() {
   fi
 
   # 错误检测
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     emit_control "KEY_PAGE_RESULT=FAILED"
     exit 1
   fi
@@ -900,7 +900,7 @@ submit_application_audit() {
   fi
 
   # 错误检测
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     emit_control "APPLICATION_AUDIT_RESULT=FAILED"
     exit 1
   fi

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

@@ -239,7 +239,7 @@ elif [ "$RETRY_RC" -ne 0 ]; then
 fi
 
 # 错误检测（先于业务解析，handle_error 内部会自动解包信封）
-if ! handle_error "$RESULT"; then
+if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
   emit_control "SIGN_APPLY_RESULT=FAILED"
   exit 1
 fi

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

@@ -529,9 +529,12 @@ validate_current_authorization() {
     }
 
     mcc_verify_unwrapped=$(unwrap_mcp "$mcc_verify_result")
-    mcc_error_type=$(detect_error "$mcc_verify_result")
+    mcc_error_type=$(detect_error "$mcc_verify_result" "MCP_AUTHENTICATED_CALL")
     if [ "$mcc_error_type" = "AUTH_MISMATCH" ]; then
       mcc_match="false"
+    elif [ "$mcc_error_type" = "MCP_AUTH_ERROR" ]; then
+      handle_error "$mcc_verify_result" "MCP_AUTHENTICATED_CALL" || true
+      return 1
     elif [ "$mcc_error_type" != "SUCCESS" ]; then
       echo "❌ MCC 校验失败"
       emit_control "AUTH_FLOW:FAILED"

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

@@ -322,9 +322,11 @@ extract_checked_errors() {
 
 # ─── 统一错误检测 ──────────────────────────────────────────────────────────
 # 参数: $1 - CLI 执行结果文本（原始输出，含信封或不含）
+#       $2 - 可选调用上下文；MCP_AUTHENTICATED_CALL 允许识别资源响应中的明确未登录状态
 # 返回: MCP_AUTH_ERROR | MCP_SERVICE_ERROR | AUTH_MISMATCH | SERVICE_UNSTABLE | CLI_LOCAL_FS_PERMISSION | ERROR:xxx | CLI_ERROR:xxx | SUCCESS
 detect_error() {
   local CLI_RESULT="$1"
+  local ERROR_CONTEXT="${2:-}"
 
   # 空输入视为异常，不应被当作 SUCCESS
   if [ -z "$CLI_RESULT" ]; then
@@ -340,8 +342,93 @@ detect_error() {
   # 先解包 MCP 信封，再进行错误检测
   local UNWRAPPED=$(unwrap_mcp "$CLI_RESULT")
 
-  # 1. 优先检测 MCP 认证错误
-  if echo "$UNWRAPPED" | grep -qiE "HTTP 401|Authorization is empty|非法的认证信息"; then
+  # 1. 优先检测 MCP 认证错误。保留既有强证据；新增中文和 token 证据
+  # 仅扫描失败形态，避免成功候选名称或描述中的同名文本触发误判。
+  if echo "$UNWRAPPED" | grep -qiE \
+    "HTTP[[:space:]]*401|Authorization is empty|非法的认证信息"; then
+    echo "MCP_AUTH_ERROR"
+    return
+  fi
+
+  local AUTH_FAILURE_SHAPED=false
+  if ! echo "$UNWRAPPED" | jq -e . >/dev/null 2>&1 ||
+     echo "$UNWRAPPED" | jq -e '
+       (type == "object") and (
+         any(.. | objects; .success? == false) or
+         (.error? != null) or
+         (.errorCode? != null) or
+         ((.errorMessage? | type) == "string" and .errorMessage != "") or
+         ((.errorMsg? | type) == "string" and .errorMsg != "") or
+         (((.code? // "") | tostring) as $code |
+           $code != "" and $code != "0" and $code != "10000") or
+         any(.. | objects; (.error? != null) or (.errorCode? != null))
+       )
+     ' >/dev/null 2>&1; then
+    AUTH_FAILURE_SHAPED=true
+  fi
+  if [ "$AUTH_FAILURE_SHAPED" = "true" ] &&
+     echo "$UNWRAPPED" | grep -qiE \
+       "用户未登录|not[ _-]+logged[ _-]+in|(authorization|authentication|login)[-[:space:]_:=]+(is[-[:space:]_:=]+)?required|(access|auth|authentication|authorization)[ _-]+token[-[:space:]_:=]+(is[-[:space:]_:=]+)?(missing|expired)|(missing|expired)[-[:space:]_:=]+(access|auth|authentication|authorization)[ _-]+token"; then
+    echo "MCP_AUTH_ERROR"
+    return
+  fi
+
+  if echo "$UNWRAPPED" | jq -e --arg context "$ERROR_CONTEXT" '
+    def is_auth_code:
+      type == "string" and (
+        ascii_downcase as $code |
+        [
+          "not_logged_in",
+          "login_required",
+          "unauthenticated",
+          "authorization_required",
+          "auth_required",
+          "access_token_missing",
+          "access_token_expired",
+          "auth_token_missing",
+          "auth_token_expired"
+        ] |
+        index($code) != null
+      );
+    [
+      .code?, .errorCode?, .status?, .reason?,
+      (.error? | objects | (.code?, .errorCode?, .status?, .reason?)),
+      (.. | objects | .error? | objects | (.code?, .errorCode?, .status?, .reason?)),
+      (
+        .. | objects | select(has("errorCode")) | .errorCode? |
+        if type == "object" then (.code?, .status?, .reason?) else . end
+      )
+    ] +
+    (
+      if any(.. | objects; .success? == false) then
+        [.. | objects | (.code?, .status?, .reason?)]
+      else
+        []
+      end
+    ) +
+    (
+      if $context == "MCP_AUTHENTICATED_CALL" and (.data? | type) == "object" then
+        [.data.code?, .data.status?, .data.reason?]
+      else
+        []
+      end
+    ) |
+    any(is_auth_code)
+  ' >/dev/null 2>&1; then
+    echo "MCP_AUTH_ERROR"
+    return
+  fi
+
+  # whoami 的 logged_in=false 是正常登录入口事实，不能全局当作错误；仅已认证
+  # CLI/MCP 资源动作返回顶层或 data.logged_in=false 时提升为认证失效。
+  if [ "$ERROR_CONTEXT" = "MCP_AUTHENTICATED_CALL" ] &&
+     echo "$UNWRAPPED" | jq -e '
+       (type == "object") and (
+         ((.logged_in? | type) == "boolean" and .logged_in == false) or
+         ((.data? | type) == "object" and
+          (.data.logged_in? | type) == "boolean" and .data.logged_in == false)
+       )
+     ' >/dev/null 2>&1; then
     echo "MCP_AUTH_ERROR"
     return
   fi
@@ -647,10 +734,12 @@ handle_service_unstable() {
 
 # ─── 统一错误处理入口 ──────────────────────────────────────────────────────
 # 参数: $1 - CLI 执行结果文本（原始输出，含信封或不含）
+#       $2 - 可选调用上下文，透传给 detect_error
 # 返回: 0=成功, 1=当前动作失败（由主流程判断恢复、阻断或继续独立分支）
 handle_error() {
   local CLI_RESULT="$1"
-  local ERROR_TYPE=$(detect_error "$CLI_RESULT")
+  local ERROR_CONTEXT="${2:-}"
+  local ERROR_TYPE=$(detect_error "$CLI_RESULT" "$ERROR_CONTEXT")
   # 解包一次供 CLI_ERROR 分支使用（其他分支由各自的 handler 自己解包）
   local _UNWRAPPED=$(unwrap_mcp "$CLI_RESULT")
 

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

@@ -85,7 +85,7 @@ if [ "$RETRY_RC" -ne 0 ]; then
 fi
 
 # 错误检测
-if ! handle_error "$RESULT"; then
+if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
   exit 1
 fi
 

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

@@ -107,7 +107,7 @@ fetch_service_page() {
     return 1
   fi
 
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     return 1
   fi
 
@@ -385,7 +385,7 @@ service_save() {
   fi
 
   # 错误检测
-  if ! handle_error "$RESULT"; then
+  if ! handle_error "$RESULT" "MCP_AUTHENTICATED_CALL"; then
     emit_control "SERVICE_SAVE_RESULT=FAILED"
     exit 1
   fi

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

@@ -84,7 +84,7 @@ wait
 # 解析图片引用值（兼容 file upload 返回 fileKey 或 URL 字段）
 parse_image_ref() {
   local RAW=$(cat "$1")
-  if [ "$(detect_error "$RAW")" != "SUCCESS" ]; then
+  if [ "$(detect_error "$RAW" "MCP_AUTHENTICATED_CALL")" != "SUCCESS" ]; then
     return 1
   fi
   # alipay-cli file upload 可能返回 MCP 信封，先解包
@@ -122,11 +122,11 @@ PAY_REF=$(parse_image_ref "$TMP_PAY")
 check_upload_error() {
   local RAW=$(cat "$1")
   local ERROR_TYPE
-  ERROR_TYPE=$(detect_error "$RAW")
+  ERROR_TYPE=$(detect_error "$RAW" "MCP_AUTHENTICATED_CALL")
   if [ "$ERROR_TYPE" = "MCP_AUTH_ERROR" ] && [ "${UPLOAD_AUTH_ERROR_SEEN:-false}" = "true" ]; then
     return 1
   fi
-  if ! handle_error "$RAW"; then
+  if ! handle_error "$RAW" "MCP_AUTHENTICATED_CALL"; then
     if [ "$ERROR_TYPE" = "MCP_AUTH_ERROR" ]; then
       UPLOAD_AUTH_ERROR_SEEN=true
     fi