@alipay/alipay-aipay 1.5.4 → 1.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "description": "支付宝 AI 付 Skill 安装包 - 安装 Agent Skill，并检测/后台准备 alipay-cli；jq 可通过 --with-jq 尝试准备",
   "type": "module",
   "bin": {

package/skill/VERSION

@@ -1 +1 @@
-1.5.4
+1.5.5

package/skill/references/normal/alipay-cli-env.md

@@ -43,6 +43,7 @@ fi
 - 对已知需要联网的命令，如果当前 Agent 环境网络受限且支持显式授权，应首次执行即申请可联网权限，不要先在受限沙箱内试跑。
 - 若命令已经因网络失败，重试时必须复用同一条命令并申请可联网权限；不要把该失败解释为用户网络故障。
 - `auth.sh init|confirm|mismatch` 返回 `AUTH_FLOW:RETRY_WITH_NETWORK` 时，表示当前 Agent 执行环境没有取得可确认 CLI 结果；必须申请联网权限后重试同一条完整脚本命令，不得解释为支付宝业务失败、logout 失败或 login 失败，也不得要求用户手动 logout/login 代替本轮脚本事实。
+- `auth.sh init|wait|confirm|mismatch` 返回 `AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION` 时，仅表示授权状态命令缺少 CLI 私有状态目录权限。宿主支持时，允许当前同一条受控 runtime 命令访问 `$HOME/.alipay-cli/credentials` 和 `${XDG_DATA_HOME:-$HOME/.local/share}/alipay-cli/logs` 后原样重试一次；权限只供 CLI 自身使用，Agent 禁止读取、列举、打印或复制已有凭据与日志。该规则不改变 MCP、上传或沙箱脚本边界。
 - 本地纯解析、文件检查、`bash -n`、`jq` 校验等不联网命令仍可在默认沙箱内执行。
 
 **减少重复授权：**

package/skill/references/normal/scripts/common.sh

@@ -12,6 +12,81 @@ require_command() {
   fi
 }
 
+ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE=77
+ALIPAY_CLI_LOCAL_STATE_ACCESS_CONFIRMED=false
+
+alipay_cli_credentials_dir() {
+  case "${HOME:-}" in
+    /*) [ "$HOME" != "/" ] || return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE" ;;
+    *) return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE" ;;
+  esac
+  printf '%s/.alipay-cli/credentials' "$HOME"
+}
+
+alipay_cli_logs_dir() {
+  local data_home="${XDG_DATA_HOME:-}"
+  if [ -z "$data_home" ]; then
+    case "${HOME:-}" in
+      /*) [ "$HOME" != "/" ] || return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE" ;;
+      *) return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE" ;;
+    esac
+    data_home="$HOME/.local/share"
+  fi
+  case "$data_home" in
+    /*) ;;
+    *) return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE" ;;
+  esac
+  printf '%s/alipay-cli/logs' "$data_home"
+}
+
+alipay_cli_has_local_state_permission_error() {
+  local raw="${1:-}" permission_pattern private_state_pattern local_state_failure_pattern
+  [ -n "$raw" ] || return 1
+
+  permission_pattern='permission denied|operation not permitted|(^|[^[:alnum:]_])(EACCES|EPERM)([^[:alnum:]_]|$)'
+  private_state_pattern='poll_state\.enc\.tmp|session\.enc|\.alipay-cli[/\\]credentials|alipay-cli[/\\]logs'
+  local_state_failure_pattern='写入临时文件失败|删除凭据文件失败|can.?t rename log file'
+
+  printf '%s' "$raw" | grep -qiE "$local_state_failure_pattern" && return 0
+  printf '%s' "$raw" | grep -qiE "$permission_pattern" || return 1
+  printf '%s' "$raw" | grep -qiE "$private_state_pattern"
+}
+
+require_alipay_cli_local_state_access() {
+  local state_dir probe_file renamed_file
+  if [ "$ALIPAY_CLI_LOCAL_STATE_ACCESS_CONFIRMED" = true ]; then
+    return 0
+  fi
+
+  for state_dir in "$(alipay_cli_credentials_dir)" "$(alipay_cli_logs_dir)"; do
+    probe_file=""
+    renamed_file=""
+    [ -d "$state_dir" ] || mkdir -p "$state_dir" 2>/dev/null \
+      || return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    probe_file=$(mktemp "$state_dir/.alipay-aipay-access.XXXXXX" 2>/dev/null) \
+      || return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    chmod 600 "$probe_file" 2>/dev/null || {
+      rm -f "$probe_file" 2>/dev/null || true
+      return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    }
+    if ! printf 'alipay-cli-local-state-access\n' >"$probe_file" 2>/dev/null; then
+      rm -f "$probe_file" 2>/dev/null || true
+      return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    fi
+    renamed_file="${probe_file}.renamed"
+    if ! mv "$probe_file" "$renamed_file" 2>/dev/null; then
+      rm -f "$probe_file" "$renamed_file" 2>/dev/null || true
+      return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    fi
+    if ! rm -f "$renamed_file" 2>/dev/null; then
+      rm -f "$renamed_file" 2>/dev/null || true
+      return "$ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE"
+    fi
+  done
+
+  ALIPAY_CLI_LOCAL_STATE_ACCESS_CONFIRMED=true
+}
+
 emit_control() {
   printf 'ALIPAY_AIPAY_INTERNAL:%s\n' "$*" >&2
 }

package/skill/references/onboarding/flow.md

@@ -42,7 +42,7 @@
 - `P-DETERMINISTIC-HANDOFF`：flow 已登记脚本或 renderer 时只执行动作发生位置的固定命令；退出码和登记终态标记满足后立即按 flow 转移，禁止追加 jq、cat、grep、curl 或临时脚本重复解析、复核或解释同一结果。失败只走登记恢复分支；项目代码实现和运行验证除外，但不得把沙箱配置或其他敏感文件打印到工具输出。
 <!-- GENERATED:ONBOARDING-GUARDS:END -->
 
-生成区块与 `SKILL.md` 红线适用于全部步骤。Onboarding 禁止修改用户项目代码或支付配置文件，只输出需由用户自行应用的配置；CLI 调用均由脚本设置 `PLATFORM`、`PLATFORM_ID`、`PRODUCT`；`aipay|webpay|apppay` 严格映射为 `AIPAY|WEBPAY|APPPAY`，`PRODUCT` 不进入 MCP 请求 JSON；禁止硬编码 `PLATFORM` 或分号拼环境变量。scope/MCC 不匹配只走 `auth.sh mismatch`；logout 后置条件未成立不得重授权；`AUTH_FLOW:RETRY_WITH_NETWORK` 或输出不可唯一解析只表示当前 Agent 执行环境无法确认结果，必须申请联网权限后重试同一条脚本命令，不得解释为用户本机 logout/login 失败或支付宝业务失败。签约 `request+ctx` 与应用/服务 `request` 由脚本冻结，禁止绕开脚本混用或重组。
+生成区块与 `SKILL.md` 红线适用于全部步骤。Onboarding 禁止修改用户项目代码或支付配置文件，只输出需由用户自行应用的配置；CLI 调用均由脚本设置 `PLATFORM`、`PLATFORM_ID`、`PRODUCT`；`aipay|webpay|apppay` 严格映射为 `AIPAY|WEBPAY|APPPAY`，`PRODUCT` 不进入 MCP 请求 JSON；禁止硬编码 `PLATFORM` 或分号拼环境变量。scope/MCC 不匹配只走 `auth.sh mismatch`；logout 后置条件未成立不得重授权；`RETRY_WITH_NETWORK|RETRY_WITH_LOCAL_FS_PERMISSION` 分别申请联网或 CLI 私有状态目录权限后原样重试，均不得解释为用户本机 login/logout 失败或支付宝业务失败。签约 `request+ctx` 与应用/服务 `request` 由脚本冻结，禁止绕开脚本混用或重组。
 
 ### 标准消息执行规则
 
@@ -190,7 +190,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-execute-read
 
 当前方案基于完整确定事实送达后，`execute` 阶段 loader 已在原位置记录兼容 stage `onboarding.user_confirmed`；`auth.sh init` 会在固定授权上下文机器校验通过、开始授权业务动作前记录 `onboarding.auth.start`。两者都不替代登录、scope 或 MCC 完成条件，也不表示收到额外用户回复；不得另行执行 telemetry 命令造成重复事件。
 
-这些脚本是联网命令，首次执行即按 `../normal/alipay-cli-env.md` 申请权限。`AUTH_FLOW:RETRY_WITH_NETWORK` 只表示当前执行环境无法确认结果：取得权限后重试同一完整命令，不得解释为用户本机或支付宝业务失败，也不得改为手工 logout/login。
+这些脚本是联网命令，首次执行即按 `../normal/alipay-cli-env.md` 申请权限。`AUTH_FLOW:RETRY_WITH_NETWORK` 只申请联网后重试同一完整命令。`AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION` 只表示授权状态命令 preflight 失败或命中 `poll_state/session/log` 本地状态写失败证据；可恢复阶段 stdout 为空，取得 CLI 私有状态目录权限后原样重试当前 `auth.sh` 命令一次，`wait|confirm` 不重建授权页或轮询。拒绝、不支持或重试仍命中同一 marker 时才输出最小失败说明。两者都不得解释为本机 login/logout 失败、网络故障或支付宝业务失败。
 
 Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY 都是授权前置；产品或 MCC 仍缺失、冲突、非唯一或环境未就绪时禁止 login，`full_process` 也不得绕过。
 
@@ -204,6 +204,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    │  └─ 若同时存在 AUTH_STATE:SAVE_FAILED：授权页 stdout 已送达，后续 open 仅可降级为 AUTH_OPEN:LINK_ONLY；wait/confirm 仍使用本条命令显式上下文继续，禁止重新生成授权页
    ├─ AUTH_FLOW:SCOPE_MISMATCH / MCC_MISMATCH → 执行第 4 项
    ├─ AUTH_FLOW:RETRY_WITH_NETWORK → 取得联网权限后重试同一完整命令
+   ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 取得 CLI 私有状态目录权限后原样重试本命令一次
    └─ AUTH_FLOW:FAILED → 停止并按错误输出恢复，禁止进入 Step 3.1
 2. 仅 AUTH_FLOW:READY_TO_OPEN：把 init 的 stdout 原文作为独立对客消息送达后，立即执行 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth open --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME"；open 无对客 stdout，打开失败不影响已交付 URL。随后执行 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth wait --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME"
    ├─ open 返回 AUTH_FLOW:CONTEXT_MISMATCH → 不执行 wait；使用当前已确认的完整参数重新执行第 1 项
@@ -215,6 +216,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    ├─ AUTH_FLOW:EXPIRED → 重新执行第 1 项生成授权链接
    ├─ AUTH_FLOW:CONTEXT_MISMATCH → 当前动作未执行 login --complete/logout；使用当前已确认的完整参数重新执行第 1 项
    ├─ AUTH_FLOW:RETRY_WITH_NETWORK → 取得联网权限后重试同一完整命令
+   ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 保留当前授权页短时状态，取得 CLI 私有状态目录权限后原样重试当前 wait 命令一次
    ├─ AUTH_FLOW:FAILED → 停止并按错误输出恢复，禁止进入 Step 3.1
    └─ AUTH_FLOW:SCOPE_MISMATCH / MCC_MISMATCH → 执行第 4 项
 3. 仅 PENDING 后把用户原始回复传给 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-recovery auth-confirm --reply "$USER_REPLY" --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME"`；runner 复用统一肯定语义判定（包括 `1`、“继续”“好了”“已完成”“OK”等），接受后只执行一次原 `auth.sh confirm`。否定、疑问、取消、修改意见或含糊输入返回内部拒绝且不得查询；成功后的转移同第 2 项，PENDING 继续等待且不重启轮询
@@ -222,6 +224,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    ├─ AUTH_FLOW:READY_TO_OPEN → 输出非阻塞授权页并按第 2 项执行 open + wait
    ├─ AUTH_FLOW:CONTEXT_MISMATCH → 未执行 logout；使用当前已确认的完整参数重新执行第 1 项
    ├─ AUTH_FLOW:RETRY_WITH_NETWORK → 取得联网权限后重试同一完整命令
+   ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 未重启授权链路，取得 CLI 私有状态目录权限后原样重试本命令一次
    ├─ AUTH_FLOW:LOGOUT_STILL_LOGGED_IN → logout 后置条件未成立；禁止 login、签约查询和其他 onboarding 动作，排除本机登录态后重试第 4 项
    └─ mismatch 统一 logout；后置条件成立后用正确 scope 重建授权页
 ```

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

@@ -23,6 +23,7 @@
 - `AUTH_FLOW:EXPIRED`：当前页面实际返回过期，旧页面和旧回复失效，重新执行 flow 登记的 init。
 - `AUTH_FLOW:SCOPE_MISMATCH|MCC_MISMATCH`：只能走 `auth.sh mismatch`；logout 后置条件未成立前不得重授权；仍登录返回 `AUTH_FLOW:LOGOUT_STILL_LOGGED_IN`。
 - `AUTH_FLOW:RETRY_WITH_NETWORK`：当前 Agent 环境无法确认结果，申请联网权限后原样重试同一命令；不得解释为用户本机登录失败。
+- `AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION`：授权状态命令 preflight 失败，或实际输出命中 CLI 私有状态写失败证据。可恢复阶段 stdout 为空；仅允许当前受控 runtime 命令访问 CLI 私有状态目录后原样重试一次；`wait|confirm` 保留短时授权状态，不重建授权页。Agent 禁止读取、列举、打印或复制已有凭据与日志；拒绝、不支持或重试仍命中同一 marker 时才输出最小失败说明。
 
 CLI `login --complete` 成功只表示页面侧确认完成，不代表本机已取得可用登录态。返回成功但状态字段不在白名单时，脚本先用 `whoami` 复核：有效登录继续 scope/MCC 校验，仍未形成登录态则保持 `PENDING`，不可确认则 `RETRY_WITH_NETWORK`。脚本仍需复核 `whoami`、scope，并以固定授权 URL 绑定 MCC；当前后端查询没有权威 MCC 返回字段，禁止声称做了响应 MCC 等值比较。
 

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

@@ -9,6 +9,7 @@
 | `MCP_AUTH_ERROR` | HTTP 401、`Authorization is empty`、非法认证信息 | 停止查询组；logout 后置条件成立后重授权。仍登录则阻断；不可确认或无网络时只重试同一动作，不解释为用户本机或支付宝业务失败 |
 | `AUTH_MISMATCH` | `mccCode is not auth`、`salesProductCodes is not auth`、`scope is not auth` | 停止当前动作，只进 `auth.sh mismatch`；logout 后置条件未成立前禁重授权 |
 | `MCP_SERVICE_ERROR` / `SERVICE_UNSTABLE` | 已识别连接、网络或服务异常 | 按下方有限重试规则处理；耗尽后记录受影响分支，依赖允许时继续其他独立分支，最终统一收口 |
+| `CLI_LOCAL_FS_PERMISSION` | 授权状态命令 preflight 失败；或原始 stdout+stderr 命中私有状态写失败强证据，或私有状态路径与权限错误组合 | 仅用于 `auth.sh init|wait|confirm|mismatch` 的 `login/login --complete/logout` 链路；可恢复阶段 stdout 为空，只输出唯一 `AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION`，取得 CLI 私有状态目录权限后原样重试一次，不改产品、scope、MCC 或授权页 |
 | `ERROR:<code>` | 当前响应中存在可识别业务错误 | 展示登记且脱敏的业务错误，修正业务条件前不重试 |
 | `CLI_ERROR:<message>` | CLI 失败、异常结构或结果不可唯一解析 | 隐藏原始输出，停止并按登记 CLI 错误恢复，不猜成功或空结果 |
 | `SUCCESS` | 唯一合法成功结构 | 才允许进入当前脚本的业务字段解析 |
@@ -19,7 +20,7 @@ discovery runner 和截图上传这类并发/分组动作不得让每个子进
 
 ## 解包与业务错误
 
-`unwrap_mcp` 兼容纯业务 JSON、唯一 MCP `content[0].text` 信封和混合日志。CLI 捕获必须始终合并 stdout 与 stderr 后执行一次唯一性解析：单个 JSON 加普通日志可接受，相同 JSON 重复可去重，多个不同 JSON 或成功/失败冲突不得选择任一路，也不得回显原始响应。每次 MCP 调用先把唯一原始结果交给 `handle_error`，返回成功后才调用 `unwrap_mcp` 和当前脚本的业务解析；不得统一假定成功字段位于 `.success`。
+`unwrap_mcp` 兼容纯业务 JSON、唯一 MCP `content[0].text` 信封和混合日志。授权状态命令捕获先合并 stdout/stderr 检查 `写入临时文件失败|删除凭据文件失败|can't rename log file` 强证据，或 `poll_state.enc.tmp|session.enc|.alipay-cli/credentials|alipay-cli/logs` 与 `permission denied|operation not permitted|EACCES|EPERM` 组合；命中时不得按 `network_error` 处理，裸后端 `permission denied` 不算本地权限。其他 CLI 捕获再执行唯一性解析：单个 JSON 加普通日志可接受，相同 JSON 重复可去重，多个不同 JSON 或成功/失败冲突不得选择任一路，也不得回显原始响应。每次 MCP 调用先把唯一原始结果交给 `handle_error`，返回成功后才调用 `unwrap_mcp` 和当前脚本的业务解析；不得统一假定成功字段位于 `.success`。
 
 每次 logout 失败后只执行一次 `whoami` 后置核验；logout 明确成功时无需额外核验，最多尝试 3 次 logout。`whoami` 后置核验必须先满足唯一 JSON、退出码为 0 且 `detect_error=SUCCESS`，再读取类型正确的 `logged_in/is_expired`；业务失败响应即使携带 `logged_in=false` 也不能证明已退出。logout 网络/服务异常、冲突输出或结果无法确认时，即使 `whoami` 仍显示已登录，也只能转 `AUTH_FLOW:RETRY_WITH_NETWORK` 并重试同一动作。logout 是可由 `whoami` 验证最终状态的幂等恢复动作：明确业务失败且仍登录时，脚本内部使用“初次 + 2 次”固定预算、间隔 3 秒重试完全相同的 logout；任一次确认已退出即继续，全部耗尽且仍登录才转 `AUTH_FLOW:LOGOUT_STILL_LOGGED_IN`。所有失败分支都不得执行 login。每个 auth 动作只允许产生一个最终 `AUTH_FLOW:*`，具体恢复 marker 已由错误处理器输出时，调用方不得追加 `AUTH_FLOW:FAILED`。
 

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

@@ -30,6 +30,7 @@ fi
 source "${SCRIPT_DIR}/network_retry.sh"
 source "${SCRIPT_DIR}/sign_status_parser.sh"
 RENDERER="${SCRIPT_DIR}/../../../normal/scripts/render_customer_message.mjs"
+AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE="${ALIPAY_CLI_LOCAL_STATE_PERMISSION_EXIT_CODE:-77}"
 
 require_command jq || exit 1
 require_command alipay-cli || exit 1
@@ -336,8 +337,27 @@ extract_json_payload() {
   printf '%s' "$analysis" | jq -ce '.value | select(type == "object")' 2>/dev/null
 }
 
+auth_has_local_state_permission_error() {
+  alipay_cli_has_local_state_permission_error "$1"
+}
+
+auth_local_state_permission_failure() {
+  emit_control "AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION"
+}
+
+auth_require_local_state_access() {
+  require_alipay_cli_local_state_access || {
+    auth_local_state_permission_failure
+    return 1
+  }
+}
+
 auth_cli_environment_failure() {
-  local action="$1"
+  local action="$1" failure_code="${2:-1}"
+  if [ "$failure_code" -eq "$AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE" ]; then
+    auth_local_state_permission_failure
+    return
+  fi
   echo "❌ ${action} 未能在当前 Agent 执行环境取得可确认结果，已停止。"
   echo "📋 这通常表示当前执行环境缺少联网权限、CLI wrapper 混入输出，或 stdout/stderr 无法唯一解析。"
   echo "📋 这不代表支付宝业务失败，也不能据此判断用户本机 logout/login 失败。"
@@ -352,7 +372,7 @@ handle_auth_cli_result() {
     return 0
   fi
   case "$error_type" in
-    MCP_AUTH_ERROR|AUTH_MISMATCH)
+    MCP_AUTH_ERROR|AUTH_MISMATCH|CLI_LOCAL_FS_PERMISSION)
       # error_handler.sh already emitted the unique recovery marker.
       ;;
     MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
@@ -379,7 +399,7 @@ wait_for_effective_whoami() {
 
   while [ "$attempt" -le "$max_attempts" ]; do
     AUTH_WHOAMI_RESULT=$(run_json_command "alipay-cli whoami --json" alipay-cli whoami --json) || {
-      auth_cli_environment_failure "$action"
+      auth_cli_environment_failure "$action" "$?"
       return 1
     }
     handle_auth_cli_result "$AUTH_WHOAMI_RESULT" || return 1
@@ -412,6 +432,10 @@ run_json_command() {
   stderr_output=$(cat "$stderr_file")
 
   combined_output=$(printf '%s\n%s' "$stdout" "$stderr_output")
+  if auth_has_local_state_permission_error "$combined_output"; then
+    rm -f "$stderr_file"
+    return "$AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE"
+  fi
   if json_payload=$(extract_json_payload "$combined_output"); then
     rm -f "$stderr_file"
     printf '%s' "$json_payload"
@@ -442,7 +466,7 @@ validate_current_authorization() {
 
   if [ -z "$whoami_result" ]; then
     whoami_result=$(run_json_command "alipay-cli whoami --json" alipay-cli whoami --json) || {
-      auth_cli_environment_failure "登录状态复核"
+      auth_cli_environment_failure "登录状态复核" "$?"
       return 1
     }
   fi
@@ -598,7 +622,7 @@ auth_init() {
 
   # Step 1: 检查登录状态
   CHECK_RESULT=$(run_json_command "alipay-cli whoami --json" alipay-cli whoami --json) || {
-    auth_cli_environment_failure "登录状态检查"
+    auth_cli_environment_failure "登录状态检查" "$?"
     return 1
   }
   handle_auth_cli_result "$CHECK_RESULT" || return 1
@@ -627,8 +651,9 @@ auth_init() {
   fi
 
   # Step 2: 执行登录
+  auth_require_local_state_access || return 1
   LOGIN_RESULT=$(run_json_command "alipay-cli login --non-interactive --scope" alipay-cli login --non-interactive --scope "$SCOPE" --json) || {
-    auth_cli_environment_failure "授权登录发起"
+    auth_cli_environment_failure "授权登录发起" "$?"
     return 1
   }
   handle_auth_cli_result "$LOGIN_RESULT" || return 1
@@ -741,8 +766,9 @@ auth_confirm() {
   fi
 
   # Step 1: 执行授权确认
+  auth_require_local_state_access || return 1
   LOGIN_COMPLETE_RESULT=$(run_json_command "alipay-cli login --complete --json" alipay-cli login --complete --json) || {
-    auth_cli_environment_failure "授权完成确认"
+    auth_cli_environment_failure "授权完成确认" "$?"
     return 1
   }
 
@@ -871,6 +897,7 @@ auth_wait() {
 
 # ─── auth mismatch: 授权范围不满足 → logout → 重新授权 ──────────────────────
 auth_mismatch() {
+  local mismatch_message=""
   if [ "${1:-}" = "--defer-open" ]; then
     shift
   else
@@ -895,7 +922,8 @@ auth_mismatch() {
   fi
 
   # Step 2: mismatch 是授权不匹配恢复路径中唯一执行 logout 的入口。
-  if ! printf '%s' '{}' | ALIPAY_AIPAY_RENDERER_MANAGED_CALLER=auth.sh node "$RENDERER" auth.mismatch --variant DEFAULT; then
+  auth_require_local_state_access || return 1
+  if ! mismatch_message=$(printf '%s' '{}' | ALIPAY_AIPAY_RENDERER_MANAGED_CALLER=auth.sh node "$RENDERER" auth.mismatch --variant DEFAULT); then
     emit_control "AUTH_FLOW:FAILED"
     return 1
   fi
@@ -908,12 +936,17 @@ auth_mismatch() {
       emit_control "AUTH_FLOW:LOGOUT_STILL_LOGGED_IN"
       return 1
       ;;
+    LOCAL_FS_PERMISSION)
+      auth_local_state_permission_failure
+      return 1
+      ;;
     *)
       render_logout_unconfirmed || return 1
       emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
       return 1
       ;;
   esac
+  printf '%s\n' "$mismatch_message"
 
   # Step 3: 调用 auth init 执行登录 + 构建授权链接 + 输出唯一授权消息。
   # DEV_TOOL_NAME 已 export，子进程可继承。

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

@@ -322,7 +322,7 @@ extract_checked_errors() {
 
 # ─── 统一错误检测 ──────────────────────────────────────────────────────────
 # 参数: $1 - CLI 执行结果文本（原始输出，含信封或不含）
-# 返回: MCP_AUTH_ERROR | MCP_SERVICE_ERROR | AUTH_MISMATCH | SERVICE_UNSTABLE | ERROR:xxx | CLI_ERROR:xxx | SUCCESS
+# 返回: 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"
 
@@ -332,6 +332,11 @@ detect_error() {
     return
   fi
 
+  if alipay_cli_has_local_state_permission_error "$CLI_RESULT"; then
+    echo "CLI_LOCAL_FS_PERMISSION"
+    return
+  fi
+
   # 先解包 MCP 信封，再进行错误检测
   local UNWRAPPED=$(unwrap_mcp "$CLI_RESULT")
 
@@ -404,6 +409,11 @@ run_alipay_cli_json_capture() {
   rm -f "$stderr_file"
 
   combined_output=$(printf '%s\n%s' "$stdout" "$stderr_output")
+  if type auth_has_local_state_permission_error >/dev/null 2>&1 &&
+     auth_has_local_state_permission_error "$combined_output"; then
+    ALIPAY_CLI_JSON_CAPTURE=""
+    return "${AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE:-77}"
+  fi
   if ALIPAY_CLI_JSON_CAPTURE=$(extract_captured_json "$combined_output"); then
     return 0
   fi
@@ -414,7 +424,7 @@ run_alipay_cli_json_capture() {
 
 confirm_logout_postcondition() {
   local logout_error_type whoami_error_type whoami_state
-  local logout_result_state attempt=1
+  local logout_result_state logout_capture_rc whoami_capture_rc attempt=1
   local max_attempts=3
   local interval_seconds=3
 
@@ -427,7 +437,9 @@ confirm_logout_postcondition() {
 
   while [ "$attempt" -le "$max_attempts" ]; do
     logout_result_state="UNCONFIRMED"
-    if run_alipay_cli_json_capture alipay-cli logout --json; then
+    run_alipay_cli_json_capture alipay-cli logout --json
+    logout_capture_rc=$?
+    if [ "$logout_capture_rc" -eq 0 ]; then
       logout_error_type=$(detect_error "$ALIPAY_CLI_JSON_CAPTURE")
       if [ "$ALIPAY_CLI_JSON_EXIT_CODE" -eq 0 ] && [ "$logout_error_type" = "SUCCESS" ]; then
         ALIPAY_LOGOUT_POSTCONDITION="COMMAND_CONFIRMED_SUCCESS"
@@ -446,11 +458,20 @@ confirm_logout_postcondition() {
           logout_result_state="EXPLICIT_FAILURE"
           ;;
       esac
+    elif [ "$logout_capture_rc" -eq "${AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE:-77}" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="LOCAL_FS_PERMISSION"
+      return 1
     else
       ALIPAY_LOGOUT_ERROR_MESSAGE="退出命令未返回可唯一解析结果"
     fi
 
-    if ! run_alipay_cli_json_capture alipay-cli whoami --json; then
+    run_alipay_cli_json_capture alipay-cli whoami --json
+    whoami_capture_rc=$?
+    if [ "$whoami_capture_rc" -eq "${AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE:-77}" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="LOCAL_FS_PERMISSION"
+      return 1
+    fi
+    if [ "$whoami_capture_rc" -ne 0 ]; then
       ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
       return 1
     fi
@@ -525,6 +546,13 @@ handle_mcp_auth_error() {
       }
       emit_control "AUTH_FLOW:LOGOUT_STILL_LOGGED_IN"
       ;;
+    LOCAL_FS_PERMISSION)
+      if type auth_local_state_permission_failure >/dev/null 2>&1; then
+        auth_local_state_permission_failure
+      else
+        emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
+      fi
+      ;;
     *)
       render_logout_unconfirmed || {
         emit_control "AUTH_FLOW:FAILED"
@@ -639,6 +667,16 @@ handle_error() {
     "SERVICE_UNSTABLE")
       handle_service_unstable
       ;;
+    "CLI_LOCAL_FS_PERMISSION")
+      if type auth_local_state_permission_failure >/dev/null 2>&1; then
+        auth_local_state_permission_failure
+      else
+        MESSAGE_INPUT=$(jq -cn \
+          --arg errorMessage "alipay-cli 本地状态目录权限不足" \
+          '{errorMessage:$errorMessage,bizTips:"",checkedErrors:[]}')
+        render_error_message error.cli DEFAULT "$MESSAGE_INPUT"
+      fi
+      ;;
     "ERROR:"*)
       local CODE="${ERROR_TYPE#ERROR:}"
       handle_backend_error "$CLI_RESULT" "$CODE"