@alipay/alipay-aipay 1.5.3 → 1.5.5-beta

package/package.json

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

package/skill/VERSION

@@ -1 +1 @@
-1.5.3
+1.5.5-beta

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/json/customer-messages.json

@@ -43,10 +43,10 @@
       "trigger": "onboarding.windows_platform",
       "blocking": false,
       "allowedReplies": [],
-      "variables": [],
+      "variables": [{ "name": "officialUrl", "type": "officialTemporaryUrl", "required": true, "urlKind": "windowsOnboardingRedirect" }],
       "requiredPolicyIds": [],
       "variants": {
-        "DEFAULT": { "templateLines": ["当前为 Windows 系统，请您暂时前往支付宝 AI 付站点完成产品开通：", "https://aipay.alipay.com/?from=alipay-aipay-skill"] }
+        "DEFAULT": { "templateLines": ["当前为 Windows 系统，请您暂时前往支付宝 AI 付站点完成产品开通：", "{{officialUrl}}"] }
       }
     },
     {

package/skill/references/normal/json/policy-rules.json

@@ -174,6 +174,12 @@
       "path": "/public-key-confirm",
       "requiredQueryParams": ["keyConfirmToken"],
       "optionalQueryParams": []
+    },
+    "windowsOnboardingRedirect": {
+      "host": "aipay.alipay.com",
+      "path": "/",
+      "requiredQueryParams": ["from", "reason", "platform_id"],
+      "optionalQueryParams": []
     }
   }
 }

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/normal/scripts/onboarding_discovery_runner.mjs

@@ -306,20 +306,22 @@ async function runDiscovery(args) {
   if (globalBlocker) envelope.global_blocker = globalBlocker;
   emitEnvelope(envelope);
 
-  let customerOutputs = executedResults
+  const customerOutputResults = globalBlocker
+    ? executedResults.filter(hasAuthBlocker)
+    : executedResults;
+  const customerOutputs = customerOutputResults
     .map((result) => result.stdout.trim())
     .filter(Boolean);
-  customerOutputs = [...new Set(customerOutputs)];
-  if (globalBlocker) {
-    customerOutputs = customerOutputs.slice(0, 1);
-  } else {
-    customerOutputs.push(renderDiscoverySummary(productType, {
+  let uniqueCustomerOutputs = [...new Set(customerOutputs)];
+  if (globalBlocker) uniqueCustomerOutputs = uniqueCustomerOutputs.slice(0, 1);
+  if (!globalBlocker) {
+    uniqueCustomerOutputs.push(renderDiscoverySummary(productType, {
       signStatus: envelope.signing.query_status === 'SUCCESS' ? envelope.signing.sign_status : 'QUERY_FAILED',
       serviceFlow: envelope.service.query_status === 'SUCCESS' ? envelope.service.flow : 'QUERY_FAILED',
       appFlow: envelope.application.query_status === 'SUCCESS' ? envelope.application.flow : 'QUERY_FAILED'
     }));
   }
-  if (customerOutputs.length > 0) process.stdout.write(`${customerOutputs.join('\n\n')}\n`);
+  if (uniqueCustomerOutputs.length > 0) process.stdout.write(`${uniqueCustomerOutputs.join('\n\n')}\n`);
   return globalBlocker ? 2 : 0;
 }
 

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

@@ -5,8 +5,8 @@ import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { isWindowsPlatform } from './platform_compat.mjs';
-import { loadMccRecords, renderMessage } from './render_customer_message.mjs';
-import { emitStageMetricAsync, emitTerminalMetric } from './telemetry.mjs';
+import { buildWindowsOnboardingRedirectUrl, loadMccRecords, renderMessage } from './render_customer_message.mjs';
+import { currentRunContext, emitStageMetricAsync, emitTerminalMetric } from './telemetry.mjs';
 
 const productTypes = {
   aipay: { variant: 'AIPAY', productName: 'AI 按量付费' },
@@ -129,9 +129,14 @@ async function readStdin() {
 }
 
 function runPlatformEntry() {
-  return isWindowsPlatform()
-    ? renderMessage('onboarding.windows.redirect', 'DEFAULT', {})
-    : '';
+  if (!isWindowsPlatform()) return '';
+  const runContext = currentRunContext();
+  if (!runContext || runContext.terminal || !['onboarding_only', 'full_process'].includes(runContext.root_intent)) {
+    throw new Error('Windows 产品开通引导缺少有效的当前 Onboarding run context');
+  }
+  return renderMessage('onboarding.windows.redirect', 'DEFAULT', {
+    officialUrl: buildWindowsOnboardingRedirectUrl(runContext.run_id)
+  });
 }
 
 function optional(args, name) {
@@ -297,16 +302,18 @@ function resolveMccResult(query, args) {
   const deterministicCodes = deterministicMatches.map(({ record }) => record.code);
   const agentCodes = agent.codes;
   if (agent.semanticStatus !== 'MATCHED') {
+    const finalCodes = deterministicStrongCodes.slice(0, 8);
+    const candidates = finalCodes.map((code) => mccCandidateFromRecord(records.get(code)));
     return {
-      matchType: 'NONE',
+      matchType: candidates.length === 1 ? 'UNIQUE' : candidates.length === 0 ? 'NONE' : 'MULTIPLE',
       semanticStatus: agent.semanticStatus,
       deterministicCandidateCodes: deterministicCodes,
       deterministicStrongCandidateCodes: deterministicStrongCodes,
       deterministicWeakCandidateCodes: deterministicWeakCodes,
       agentCandidateCodes: agentCodes,
-      mergedCandidateCodes: [],
+      mergedCandidateCodes: finalCodes,
       mccTableSummary: mccTableSummary(records),
-      candidates: []
+      candidates
     };
   }
   const deterministicCodeSet = new Set(deterministicCodes);

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

@@ -140,6 +140,26 @@ function validateUrl(value, policy, urlKind, expected = {}) {
     }
     if (/[\r\n]/.test(parsed.searchParams.get('keyConfirmToken'))) throw new Error('publicKeyConfirmation URL keyConfirmToken 无效');
   }
+  if (urlKind === 'windowsOnboardingRedirect') {
+    const required = allowed.requiredQueryParams || ['from', 'reason', 'platform_id'];
+    const allowedKeys = new Set(required);
+    const actualKeys = [...parsed.searchParams.keys()];
+    if (actualKeys.some((key) => !allowedKeys.has(key))) throw new Error('windowsOnboardingRedirect URL 包含未允许的查询参数');
+    for (const key of required) {
+      if (parsed.searchParams.getAll(key).length !== 1 || !parsed.searchParams.get(key)) {
+        throw new Error('windowsOnboardingRedirect URL 缺少必要查询参数或参数重复');
+      }
+    }
+    if (parsed.searchParams.get('from') !== 'alipay-aipay-skill') {
+      throw new Error('windowsOnboardingRedirect URL from 无效');
+    }
+    if (parsed.searchParams.get('reason') !== 'alipay-aipay-skill-onboarding-not-support-windows') {
+      throw new Error('windowsOnboardingRedirect URL reason 无效');
+    }
+    if (/[\u0000-\u001f\u007f,^=]/u.test(parsed.searchParams.get('platform_id'))) {
+      throw new Error('windowsOnboardingRedirect URL platform_id 无效');
+    }
+  }
   return parsed;
 }
 
@@ -191,6 +211,19 @@ export function buildAuthorizationUrl(input) {
   return value;
 }
 
+export function buildWindowsOnboardingRedirectUrl(platformId) {
+  if (typeof platformId !== 'string' || !platformId || /[\u0000-\u001f\u007f,^=]/u.test(platformId)) {
+    throw new Error('Windows 产品开通引导缺少合法的当前流程 run_id');
+  }
+  const url = new URL('https://aipay.alipay.com/');
+  url.searchParams.set('from', 'alipay-aipay-skill');
+  url.searchParams.set('reason', 'alipay-aipay-skill-onboarding-not-support-windows');
+  url.searchParams.set('platform_id', platformId);
+  const value = url.toString();
+  validateUrl(value, loadJson(policyPath), 'windowsOnboardingRedirect');
+  return value;
+}
+
 function validateValue(definition, value, policy) {
   if (value === undefined || value === null || value === '') {
     if (definition.required) throw new Error(`缺少必填变量 ${definition.name}`);

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

@@ -240,6 +240,17 @@ function readRunState(env = process.env) {
   }
 }
 
+export function currentRunContext(env = process.env) {
+  const state = readRunState(env);
+  if (!state) return null;
+  return Object.freeze({
+    run_id: state.run_id,
+    root_intent: state.root_intent,
+    product_type: state.product_type,
+    terminal: state.terminal === true
+  });
+}
+
 function canReadImplicitRunState(env = process.env) {
   return !isMaintenanceProcess(env);
 }

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` 由脚本冻结，禁止绕开脚本混用或重组。
 
 ### 标准消息执行规则
 
@@ -82,7 +82,7 @@ Step 1: 方案规划 → Step 2: 环境检查 → Step 3: 登录授权
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message platform-entry
 ```
 
-- Windows：runner stdout 是唯一对客正文，必须原文发送；发送后停止本 flow 的产品开通动作，不再执行 Step 1、MCC 澄清、方案展示、登录或材料收集。`onboarding_only` 在根意图识别后进入本 flow 即执行；`full_process` 保留已完成的 Integration 实际结果，在衔接本 flow 时执行。
+- Windows：runner 从当前私有 run context 读取同一个 `run_id`，编码为站点引导 URL 的 `platform_id`；禁止 Agent 读取 marker 后手写、传入或拼接该参数。runner stdout 是唯一对客正文，必须原文发送；发送后停止本 flow 的产品开通动作，不再执行 Step 1、MCC 澄清、方案展示、登录或材料收集。`onboarding_only` 在根意图识别后进入本 flow 即执行；`full_process` 保留已完成的 Integration 实际结果，在衔接本 flow 时执行。
 - 非 Windows：runner 成功且 stdout 为空，直接继续下方既有流程，不输出平台提示，不改变步骤、确认或完成条件。
 - 命令失败或输出无法唯一判断时停止并核对 runner，禁止手写、改写或补发近似引导。
 
@@ -134,7 +134,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message mcc-
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message mcc-resolve-plan --query "$MCC_SEARCH_QUERY" --product-type "$PRODUCT_TYPE" --agent-mcc-status "$AGENT_MCC_STATUS" [--agent-mcc-codes "$AGENT_MCC_CODES"]
 ```
 
-`AGENT_MCC_STATUS` 仅允许 `MATCHED|INSUFFICIENT|UNSUPPORTED`；`MATCHED` 必须提供 1 到 3 个用英文逗号分隔的完整编码，后两者不得提供编码。runner 会重新执行确定性召回并校验 Agent 编码确实存在于当前 MCC 表，名称、适用商家和特殊资质全部从同一表重建；非法、重复、超量、状态与候选数量矛盾或表外编码均为 Skill 契约错误，禁止降级为 Agent 自报结果。只有 `MATCHED` 才允许把确定性候选与 Agent 候选合并推进；`INSUFFICIENT|UNSUPPORTED` 时确定性候选只作为内部诊断记录，不得覆盖语义状态自动输出方案或进入授权。确定性候选最多 5 个，最终合并候选最多 8 个；交集候选优先，其次是确定性强命中、Agent 独立候选和确定性弱命中。按次收费、支付渠道和目标产品只用于产品决策，不能改变 MCC 排名。
+`AGENT_MCC_STATUS` 仅允许 `MATCHED|INSUFFICIENT|UNSUPPORTED`；`MATCHED` 必须提供 1 到 3 个用英文逗号分隔的完整编码，后两者不得提供编码。runner 会重新执行确定性召回并校验 Agent 编码确实存在于当前 MCC 表，名称、适用商家和特殊资质全部从同一表重建；非法、重复、超量、状态与候选数量矛盾或表外编码均为 Skill 契约错误，禁止降级为 Agent 自报结果。`MATCHED` 时按交集候选、确定性强命中、Agent 独立候选和确定性弱命中的顺序合并；`INSUFFICIENT|UNSUPPORTED` 不得否决确定性强命中，强命中仍可形成唯一或多候选结果，但确定性弱命中不得单独推进。确定性候选最多 5 个，最终合并候选最多 8 个。按次收费、支付渠道和目标产品只用于产品决策，不能改变 MCC 排名。
 
 只接受唯一 `ALIPAY_AIPAY_INTERNAL:MCC_RESOLUTION=<json>`，其中必须包含 `semanticStatus`、`deterministicCandidateCodes`、`agentCandidateCodes`、`mergedCandidateCodes` 和 `mccTableSummary`：`matchType=UNIQUE` 时必须恰有一条候选，stdout 已直接渲染同一候选绑定的 `onboarding.plan.confirm`，必须原文发送但不停止、不等待回复，随后立即进入 `execute`；`MULTIPLE` 时 runner stdout 已直接渲染固定候选消息，必须原文发送并停止，等待用户回复序号、MCC 二级类目名称或编码；`NONE` 时 runner stdout 已直接渲染独立 `onboarding.mcc.no_match`，必须原文发送并停止。禁止再次调用旧的 `mcc-search`/`mcc-candidates` 组合、自由拼候选表、解释、示例或“是否继续”等近似问法。
 
@@ -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,10 +224,13 @@ 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 重建授权页
 ```
 
+`mismatch` 中 logout 明确业务失败但 `whoami` 仍登录时，脚本内部以“初次 + 2 次”固定预算、间隔 3 秒重试完全相同的 logout。每次 logout 失败后只执行一次 `whoami` 后置核验；logout 明确成功时无需额外核验。任一次证明已退出即继续重新授权；预算耗尽且仍登录才输出 `AUTH_FLOW:LOGOUT_STILL_LOGGED_IN`。网络/服务异常、冲突输出或结果无法确认不消耗该业务重试预算，只转 `AUTH_FLOW:RETRY_WITH_NETWORK`。整个过程不增加用户确认或 Agent 命令，logout 未证明成功前禁止 login。
+
 `AUTH_FLOW:CONTEXT_MISMATCH` 适用于 `open|wait|confirm|mismatch` 的显式上下文与同一次 init 短时状态不一致；脚本必须在任何 `login --complete/logout` 前停止且不输出对客正文。Agent 不得忽略差异、改用旧状态继续或手工清理状态；必须立即用当前 Step 1 已确认的完整参数重新执行第 1 项。新的 init 先完成固定产品/MCC 机器校验，再安全替换旧短时状态；若 CLI 仍处于登录态，因为签约查询没有权威 MCC 字段，init 必须返回对应 `SCOPE_MISMATCH/MCC_MISMATCH` 并转第 4 项，不得返回 `SKIP`。CLI 未登录时直接生成当前上下文的新授权页。两种分支都不得复用旧 deviceCode 或新增用户确认。
 
 `auth.page` 非阻塞并追加“扫码完成后请回到 Agent 对话页面”；`auth.pending` 仅由 wait 耗尽或单次 confirm 的 PENDING 渲染，其他对客终态由脚本渲染对应消息。自动轮询期间即使 `login --complete` 已返回可复核状态，只要 `whoami` 尚未取得有效本机登录态，也继续按 PENDING 处理并消耗本次 wait 预算，不输出断头失败文案。剔除 `ALIPAY_AIPAY_INTERNAL:` 内部行后的 stdout 是当前动作唯一对客正文；禁止再次调用 renderer、另写近似话术、输出 stderr 或内部行、重复转述。授权脚本明确返回链接过期时必须重建，旧回复失效。

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,9 @@ discovery runner 和截图上传这类并发/分组动作不得让每个子进
 
 ## 解包与业务错误
 
-`unwrap_mcp` 兼容纯业务 JSON、唯一 MCP `content[0].text` 信封和混合日志。混合输出只从完整闭合结构形成候选；多个信封或 JSON 候选冲突时不选择、不回显原始响应，并由错误检测阻断。每次 MCP 调用先把原 stdout 交给 `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`。
 
 业务错误对象可能位于顶层、`data.response` 或 `errorContext.errorStack[]`。保留脚本当前字段优先级：读取 `errorCode` 的字符串或对象形式、`errorMessage|errorMsg`、`bizTips`、`checkedError`、`errorScene` 和 `errorSpecific`；只有已验证的服务写入协议 `data.success=false` 才优先使用 `data.subMsg|data.msg`，并忽略只表示外层调用成功的顶层 `msg="Success"`。`APP_MAX_ERROR` 只说明应用数量达到上限，引导复用已有上线应用或前往支付宝开放平台处理配额，不推断其他审核规则。
 
@@ -28,7 +31,7 @@ discovery runner 和截图上传这类并发/分组动作不得让每个子进
 ## 网络重试与写后核验
 
 - `MCP_SERVICE_ERROR`、`SERVICE_UNSTABLE` 和已识别本地网络错误：初次调用后最多重试 2 次，每次间隔 3 秒，始终复用完全相同的 argv、请求 JSON、业务请求号、资源名和动态字段。
-- 认证、授权不匹配、参数、业务错误和结构歧义不进入网络重试。stderr 不拼入待解析 JSON。
+- 认证、授权不匹配、参数、业务错误和结构歧义不进入通用网络重试。唯一例外是上述可验证最终状态的幂等 logout 恢复，它使用同一三次总预算且不经通用 `network_retry.sh`。stderr 不拼入待解析 JSON。
 - 只读调用可使用完整重试预算。非幂等写操作只有明确 `NOT_SENT` 才自动重试；DNS 失败、connection refused 或宿主在连接前明确拒绝网络访问可归为 `NOT_SENT`。
 - timeout、连接中断、发送阶段不明和 `SERVICE_UNSTABLE` 一律归为 `MAYBE_SENT`，停止写重试并使用现有只读能力核验；无法确认输出 `UNKNOWN`。
 - 签约提交用签约查询核验；服务修改只有列表按完整 `serviceId` 和五项资料精确匹配才算成功；服务新建和应用创建不得按同名候选猜测；应用提审只看现有应用信息状态。没有登记核验能力的公钥确认页不得凭页面或同名结果推断成功。

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 失败。"
@@ -345,12 +365,32 @@ auth_cli_environment_failure() {
   emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
 }
 
+handle_auth_cli_result() {
+  local cli_result="$1" error_type
+  error_type=$(detect_error "$cli_result")
+  if handle_error "$cli_result"; then
+    return 0
+  fi
+  case "$error_type" in
+    MCP_AUTH_ERROR|AUTH_MISMATCH|CLI_LOCAL_FS_PERMISSION)
+      # error_handler.sh already emitted the unique recovery marker.
+      ;;
+    MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
+      emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
+      ;;
+    *)
+      emit_control "AUTH_FLOW:FAILED"
+      ;;
+  esac
+  return 1
+}
+
 wait_for_effective_whoami() {
   local action="$1"
   local max_attempts=3
   local interval_seconds=2
   local attempt=1
-  local logged_in is_expired whoami_error_type
+  local logged_in is_expired
 
   AUTH_WHOAMI_RESULT=""
   if [ "${ALIPAY_AIPAY_TEST_MODE:-0}" = "1" ] && [[ "${AUTH_WHOAMI_RECHECK_INTERVAL_SECONDS:-}" =~ ^[0-9]+$ ]]; then
@@ -359,22 +399,10 @@ 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
     }
-    whoami_error_type=$(detect_error "$AUTH_WHOAMI_RESULT")
-    if ! handle_error "$AUTH_WHOAMI_RESULT"; then
-      case "$whoami_error_type" in
-        MCP_AUTH_ERROR|AUTH_MISMATCH) ;;
-        MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
-          emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
-          ;;
-        *)
-          emit_control "AUTH_FLOW:FAILED"
-          ;;
-      esac
-      return 1
-    fi
+    handle_auth_cli_result "$AUTH_WHOAMI_RESULT" || return 1
 
     logged_in=$(echo "$AUTH_WHOAMI_RESULT" | jq -r '.data.logged_in // false')
     is_expired=$(echo "$AUTH_WHOAMI_RESULT" | jq -r '.data.is_expired // false')
@@ -403,19 +431,11 @@ run_json_command() {
   exit_code=$?
   stderr_output=$(cat "$stderr_file")
 
-  if json_payload=$(extract_json_payload "$stdout"); then
-    rm -f "$stderr_file"
-    printf '%s' "$json_payload"
-    return 0
-  fi
-
-  if json_payload=$(extract_json_payload "$stderr_output"); then
+  combined_output=$(printf '%s\n%s' "$stdout" "$stderr_output")
+  if auth_has_local_state_permission_error "$combined_output"; then
     rm -f "$stderr_file"
-    printf '%s' "$json_payload"
-    return 0
+    return "$AUTH_LOCAL_STATE_PERMISSION_EXIT_CODE"
   fi
-
-  combined_output=$(printf '%s\n%s' "$stdout" "$stderr_output")
   if json_payload=$(extract_json_payload "$combined_output"); then
     rm -f "$stderr_file"
     printf '%s' "$json_payload"
@@ -433,7 +453,7 @@ validate_current_authorization() {
   local whoami_result="${1:-}"
   local logged_in is_expired granted_scope required_scope
   local scope_match mcc_verify_result mcc_verify_unwrapped mcc_match mcc_raw retry_rc
-  local mcc_error_type mcc_error_code mcc_success whoami_error_type
+  local mcc_error_type mcc_error_code mcc_success
   local mismatch_type sign_status_output sign_status_marker sign_flow_marker sign_reuse_receipt
   local granted_scope_item required_scope_item required_scope_found
   local -a granted_scope_items required_scope_items
@@ -446,24 +466,12 @@ 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
 
-  whoami_error_type=$(detect_error "$whoami_result")
-  if ! handle_error "$whoami_result"; then
-    case "$whoami_error_type" in
-      MCP_AUTH_ERROR|AUTH_MISMATCH) ;;
-      MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
-        emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
-        ;;
-      *)
-        emit_control "AUTH_FLOW:FAILED"
-        ;;
-    esac
-    return 1
-  fi
+  handle_auth_cli_result "$whoami_result" || return 1
 
   logged_in=$(echo "$whoami_result" | jq -r '.data.logged_in // false')
   is_expired=$(echo "$whoami_result" | jq -r '.data.is_expired // false')
@@ -614,13 +622,10 @@ 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
   }
-  if ! handle_error "$CHECK_RESULT"; then
-    emit_control "AUTH_FLOW:FAILED"
-    return 1
-  fi
+  handle_auth_cli_result "$CHECK_RESULT" || return 1
   LOGGED_IN=$(echo "$CHECK_RESULT" | jq -r '.data.logged_in // false')
   IS_EXPIRED=$(echo "$CHECK_RESULT" | jq -r '.data.is_expired // false')
 
@@ -646,14 +651,12 @@ 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
   }
-  if ! handle_error "$LOGIN_RESULT"; then
-    emit_control "AUTH_FLOW:FAILED"
-    return 1
-  fi
+  handle_auth_cli_result "$LOGIN_RESULT" || return 1
   LOGIN_STATUS=$(echo "$LOGIN_RESULT" | jq -r '.data.status // ""')
 
   if [ "$LOGIN_STATUS" = "already_logged_in" ]; then
@@ -750,7 +753,6 @@ auth_open() {
 # ─── auth confirm: 授权确认 + scope 校验 + MCC 授权有效性校验 ────────────────
 auth_confirm() {
   AUTH_CONFIRM_RESULT=""
-  local complete_error_type
   # 优先使用显式传入的非敏感上下文；未传时再从状态文件兜底恢复。
   restore_auth_context_or_state "$@" || exit 1
 
@@ -764,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
   }
 
@@ -798,18 +801,8 @@ auth_confirm() {
   elif [ "$OUTER_SUCCESS" = "true" ] || [ "$DATA_STATUS" = "logged_in" ] || [ "$DATA_STATUS" = "already_logged_in" ] || [ "$DATA_STATUS" = "completed" ]; then
     :
   else
-    complete_error_type=$(detect_error "$LOGIN_COMPLETE_RESULT")
-    if ! handle_error "$LOGIN_COMPLETE_RESULT"; then
+    if ! handle_auth_cli_result "$LOGIN_COMPLETE_RESULT"; then
       cleanup_auth_state
-      case "$complete_error_type" in
-        MCP_AUTH_ERROR|AUTH_MISMATCH) ;;
-        MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
-          emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
-          ;;
-        *)
-          emit_control "AUTH_FLOW:FAILED"
-          ;;
-      esac
       return 1
     fi
     wait_for_effective_whoami "授权完成确认状态复核"
@@ -904,6 +897,7 @@ auth_wait() {
 
 # ─── auth mismatch: 授权范围不满足 → logout → 重新授权 ──────────────────────
 auth_mismatch() {
+  local mismatch_message=""
   if [ "${1:-}" = "--defer-open" ]; then
     shift
   else
@@ -928,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
@@ -941,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")
 
@@ -348,7 +353,7 @@ detect_error() {
   fi
 
   # 3. MCP 调用失败（网络/连接错误）
-  if echo "$UNWRAPPED" | grep -qiE "MCP 调用失败|connection refused|timeout|network error"; then
+  if echo "$UNWRAPPED" | grep -qiE "MCP 调用失败|connection refused|timeout|network[ _]error|网络连接失败"; then
     echo "MCP_SERVICE_ERROR"
     return
   fi
@@ -403,13 +408,12 @@ run_alipay_cli_json_capture() {
   stderr_output=$(cat "$stderr_file")
   rm -f "$stderr_file"
 
-  if ALIPAY_CLI_JSON_CAPTURE=$(extract_captured_json "$stdout"); then
-    return 0
-  fi
-  if ALIPAY_CLI_JSON_CAPTURE=$(extract_captured_json "$stderr_output"); then
-    return 0
-  fi
   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
@@ -419,48 +423,90 @@ run_alipay_cli_json_capture() {
 }
 
 confirm_logout_postcondition() {
-  local logout_error_type whoami_error_type whoami_has_state logged_in is_expired
+  local logout_error_type whoami_error_type whoami_state
+  local logout_result_state logout_capture_rc whoami_capture_rc attempt=1
+  local max_attempts=3
+  local interval_seconds=3
 
   ALIPAY_LOGOUT_POSTCONDITION=""
   ALIPAY_LOGOUT_ERROR_MESSAGE=""
 
-  if run_alipay_cli_json_capture alipay-cli logout --json; 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"
-      return 0
-    fi
-    ALIPAY_LOGOUT_ERROR_MESSAGE=$(sanitize_customer_error_text "$(extract_error_message "$ALIPAY_CLI_JSON_CAPTURE")")
-  else
-    ALIPAY_LOGOUT_ERROR_MESSAGE="退出命令未返回可唯一解析结果"
+  if [ "${ALIPAY_AIPAY_TEST_MODE:-0}" = "1" ]; then
+    interval_seconds=0
   fi
 
-  if ! run_alipay_cli_json_capture alipay-cli whoami --json; then
-    ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
-    return 1
-  fi
+  while [ "$attempt" -le "$max_attempts" ]; do
+    logout_result_state="UNCONFIRMED"
+    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"
+        return 0
+      fi
+      ALIPAY_LOGOUT_ERROR_MESSAGE=$(sanitize_customer_error_text "$(extract_error_message "$ALIPAY_CLI_JSON_CAPTURE")")
+      case "$logout_error_type" in
+        MCP_SERVICE_ERROR|SERVICE_UNSTABLE)
+          logout_result_state="RETRYABLE"
+          ;;
+        SUCCESS)
+          # A success payload paired with a non-zero exit code cannot prove the command result.
+          logout_result_state="UNCONFIRMED"
+          ;;
+        *)
+          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
 
-  whoami_has_state=$(echo "$ALIPAY_CLI_JSON_CAPTURE" | jq -r '
-    if (.data | type) == "object" and ((.data | has("logged_in")) or (.data | has("is_expired"))) then "true" else "false" end
-  ' 2>/dev/null)
-  if [ "$whoami_has_state" != "true" ]; then
-    ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
-    return 1
-  fi
-  logged_in=$(echo "$ALIPAY_CLI_JSON_CAPTURE" | jq -r '.data.logged_in // false' 2>/dev/null)
-  is_expired=$(echo "$ALIPAY_CLI_JSON_CAPTURE" | jq -r '.data.is_expired // false' 2>/dev/null)
-  if [ "$logged_in" = "true" ] && [ "$is_expired" != "true" ]; then
-    ALIPAY_LOGOUT_POSTCONDITION="STILL_LOGGED_IN"
-    return 1
-  fi
-  whoami_error_type=$(detect_error "$ALIPAY_CLI_JSON_CAPTURE")
-  if [ "$ALIPAY_CLI_JSON_EXIT_CODE" -ne 0 ] || { [ "$whoami_error_type" != "SUCCESS" ] && [ "$logged_in" = "true" ] && [ "$is_expired" != "true" ]; }; then
-    ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
-    return 1
-  fi
+    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
+
+    whoami_error_type=$(detect_error "$ALIPAY_CLI_JSON_CAPTURE")
+    if [ "$ALIPAY_CLI_JSON_EXIT_CODE" -ne 0 ] || [ "$whoami_error_type" != "SUCCESS" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
+      return 1
+    fi
 
-  ALIPAY_LOGOUT_POSTCONDITION="POSTCONDITION_LOGGED_OUT"
-  return 0
+    whoami_state=$(echo "$ALIPAY_CLI_JSON_CAPTURE" | jq -r '
+      if (.data | type) != "object" then "UNCONFIRMED"
+      elif (.data.logged_in? | type) == "boolean" and .data.logged_in == false then "LOGGED_OUT"
+      elif (.data.is_expired? | type) == "boolean" and .data.is_expired == true then "LOGGED_OUT"
+      elif (.data.logged_in? | type) == "boolean" and .data.logged_in == true and
+           ((.data | has("is_expired") | not) or ((.data.is_expired? | type) == "boolean" and .data.is_expired == false)) then "STILL_LOGGED_IN"
+      else "UNCONFIRMED"
+      end
+    ' 2>/dev/null)
+    if [ "$whoami_state" = "LOGGED_OUT" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="POSTCONDITION_LOGGED_OUT"
+      return 0
+    fi
+    if [ "$whoami_state" != "STILL_LOGGED_IN" ] || [ "$logout_result_state" != "EXPLICIT_FAILURE" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="UNCONFIRMED"
+      return 1
+    fi
+
+    if [ "$attempt" -eq "$max_attempts" ]; then
+      ALIPAY_LOGOUT_POSTCONDITION="STILL_LOGGED_IN"
+      return 1
+    fi
+    sleep "$interval_seconds"
+    attempt=$((attempt + 1))
+  done
 }
 
 render_logout_unconfirmed() {
@@ -476,7 +522,10 @@ render_logout_still_logged_in() {
 
 # ─── MCP 认证错误处理 ──────────────────────────────────────────────────────
 handle_mcp_auth_error() {
-  render_error_message error.mcp.auth START '{}' || return 1
+  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
@@ -484,15 +533,31 @@ handle_mcp_auth_error() {
   confirm_logout_postcondition
   case "$ALIPAY_LOGOUT_POSTCONDITION" in
     COMMAND_CONFIRMED_SUCCESS|POSTCONDITION_LOGGED_OUT)
-      render_error_message error.mcp.auth LOGOUT_SUCCESS '{}' || return 1
+      render_error_message error.mcp.auth LOGOUT_SUCCESS '{}' || {
+        emit_control "AUTH_FLOW:FAILED"
+        return 1
+      }
       emit_control "AUTH_FLOW:AUTH_REQUIRED"
       ;;
     STILL_LOGGED_IN)
-      render_logout_still_logged_in || return 1
+      render_logout_still_logged_in || {
+        emit_control "AUTH_FLOW:FAILED"
+        return 1
+      }
       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 || return 1
+      render_logout_unconfirmed || {
+        emit_control "AUTH_FLOW:FAILED"
+        return 1
+      }
       emit_control "AUTH_FLOW:RETRY_WITH_NETWORK"
       ;;
   esac
@@ -602,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"

package/skill/references/runtime-entry.md

@@ -44,7 +44,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" render <messageId> --va
 | `onboarding_only` | 只要求签约、入驻或产品开通，未同时要求代码开发 | 执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-bootstrap --root-intent onboarding_only` | 当前阶段的授权、查询或写分支模块 |
 | `full_process` | 明确要求完整接入、一站式，或同一请求同时要求代码开发和产品开通 | `normal/full-process-routing.md` | 先 Integration，满足衔接条件后 Onboarding |
 
-`onboarding_only` 正常入口使用 `onboarding-bootstrap --root-intent onboarding_only`，该组合动作只串行执行 `telemetry start-run`、`onboarding-message platform-entry` 和 `flow onboarding entry` 三个既有无业务写入动作；Windows 只发送登记引导并停止 Skill 内产品开通，非 Windows 继续返回 entry 执行契约。执行该组合动作后不得再单独重复执行这三条原子命令。`full_process` 衔接 Onboarding 时已存在同一根流程 run，不使用带 `start-run` 的 bootstrap；仍先执行 flow 登记的 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message platform-entry`，再按需加载 Onboarding entry，避免重复 `run.intent_detected`。
+`onboarding_only` 正常入口使用 `onboarding-bootstrap --root-intent onboarding_only`，该组合动作只串行执行 `telemetry start-run`、`onboarding-message platform-entry` 和 `flow onboarding entry` 三个既有无业务写入动作；Windows 只发送登记引导并停止 Skill 内产品开通，且引导 URL 的 `platform_id` 由 runner 读取本次已创建的同一 `run_id` 后编码生成，禁止 Agent 传入或拼接；非 Windows 继续返回 entry 执行契约。执行该组合动作后不得再单独重复执行这三条原子命令。`full_process` 衔接 Onboarding 时已存在同一根流程 run，不使用带 `start-run` 的 bootstrap；仍先执行 flow 登记的 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message platform-entry`，再按需加载 Onboarding entry，避免重复 `run.intent_detected`。
 
 识别根意图后立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry start-run --root-intent <integration_only|onboarding_only|full_process>`；产品已唯一确定时追加 `--product-type <aipay|webpay|apppay>`。唯一例外是 `onboarding_only` 已按上表执行 `onboarding-bootstrap --root-intent onboarding_only` 时，bootstrap 已包含同一次 `start-run`，不得重复执行本条 telemetry。命令创建/复用当前流程 `run_id`，并在遥测开启时记录 `run.intent_detected`：同一意图和产品继续复用，`UNKNOWN` 补全产品仍复用同一 `run_id`；明确换产品、换根意图或既有 run 已终态才重建。第三方平台项目 ID 仍优先固定为 `run_id`，不得被显式 run ID 或本地生成值覆盖。业务 stage 只由登记 runner/script 异步记录。