@alipay/alipay-aipay 1.8.1 → 1.8.2

package/skill-pre/references/integration/flow.md

@@ -19,7 +19,7 @@
 
 先确认唯一项目和服务端语言，再在产品确定前执行步骤 1；匿名沙箱不传 `PRODUCT`，缺失时创建、存在时复核，待配置只阻止沙箱依赖动作。步骤 2 的完整方案可见送达前不得改代码；送达后按步骤 2 完成执行者分流，再由确定的执行者按同一产品、项目和技术栈开工，不再执行方案 receipt 或项目快照二次校验。`integration_only/full_process` 共用检查器事实和非阻塞 `integration.start.confirm`，一次只开发一个产品。网站支付/APP 支付必须实现下单、查询、退款、退款查询、关闭和异步通知；按量付费只实现 402、验付和履约确认。本流程不主动发起真实生产交易。
 
-生产 `appId`、应用公钥、应用私钥和支付宝公钥必须属于同一生产应用，私钥格式必须匹配当前语言，格式转换只用支付宝官方密钥工具。网站支付/APP 支付本地无公网 `notify_url` 时仍实现通知代码，可暂不传地址并用查询验收；生产上线前必须恢复公网通知及验签、幂等、关键字段、`success` 回写和补偿查询，不得提前宣称生产就绪。
+生产 `appId`、应用公钥、应用私钥和支付宝公钥必须属于同一生产应用，私钥格式必须匹配当前语言，格式转换只用支付宝官方密钥工具。网站支付/APP 支付必须同时实现通知处理和交易查询；缺少 notify_url 时下单省略该字段并由服务端主动查单兜底，不会仅因缺少该地址而报错，也不因此将本轮校验判为失败；`notify_url` 可选，生产也可省略。使用通知时验证公网 HTTPS 地址、验签、关键字段、幂等、`success` 回写及补偿查询；不使用时验证商家服务端可靠主动查单、响应验签、订单/金额/状态/归属校验、持久化幂等、后台重试及未决订单恢复。未验证所选链路前不得宣称生产就绪。
 
 ### 标准消息执行规则
 
@@ -38,7 +38,7 @@
 ## 用户阻塞点索引
 
 <!-- GENERATED:INTEGRATION-GUARDS:START -->
-共享护栏：`P-MCP-CONTRACT-FROZEN` 仅用已验证脚本；禁推断或尝试近似方法；`P-SANDBOX-CREDENTIAL-EXCEPTION` Unix/macOS/Linux 与 Windows READY 已校验快速沙箱买家密码仅限登记摘要/付款体验；Windows LEGACY/CODE_ONLY 手工资料仅入受保护项目配置，禁复述、另存或扩展到生产值；`P-SENSITIVE-STATE` 公钥限当前 app 调用且禁复述/保存；敏感值禁入回复/摘要/日志/状态/宽权限文件；临时 URL 仅由登记动作展示；`P-PROJECT-PROTECT` 禁清空/覆盖/删除既有项目；仅改已确认路径和范围；`P-CUSTOMER-OUTPUT-EXCLUSIVE` 登记 stdout 原文是唯一正文；阻塞送达后立即等待；`P-DETERMINISTIC-HANDOFF` 仅执行登记命令并按唯一终态转移；禁追加解析；失败只走登记恢复。
+共享护栏：`P-MCP-CONTRACT-FROZEN` 仅用已验证脚本；禁推断或尝试近似方法；`P-SANDBOX-CREDENTIAL-EXCEPTION` Unix/macOS/Linux 与 Windows READY 已校验快速沙箱买家密码按既有登记摘要/付款体验展示；Windows LEGACY/CODE_ONLY 手工资料用于受保护项目，仅网页收款登记摘要可明文展示买家密码；最终收口仅网页收款三项买家信息；其他原文禁复述、另存或扩展到生产值；`P-SENSITIVE-STATE` 公钥限当前 app 调用且禁复述/保存；敏感值禁入回复/摘要/日志/状态/宽权限文件；临时 URL 仅由登记动作展示；`P-PROJECT-PROTECT` 禁清空/覆盖/删除既有项目；仅改已确认路径和范围；`P-CUSTOMER-OUTPUT-EXCLUSIVE` 登记 stdout 原文是唯一正文；阻塞送达后立即等待；`P-DETERMINISTIC-HANDOFF` 仅执行登记命令并按唯一终态转移；禁追加解析；失败只走登记恢复。
 <!-- GENERATED:INTEGRATION-GUARDS:END -->
 <!-- GENERATED:INTEGRATION-GUARDS-AIPAY:START -->
 共享护栏：`P-A2M-SANDBOX` A2M 沙箱固定 api_mock_service_id 与沙箱网关；生产值仅用于正式配置；`P-A2M-SUCCESS` 联调仅在 HTTP 200、资源可归属、无业务失败且适用回执有效时通过。
@@ -162,7 +162,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" sandbox ensure "<规范
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message windows-sandbox-setup --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
 ```
 
-资料校验通过后必须建立适用的版本控制忽略和访问保护。该例外只适用于当前沙箱资料；生产环境应用私钥和密码禁止提供给 Agent。Agent 不得在回复、摘要或普通日志中复述收到的值。
+资料校验通过后必须建立适用的版本控制忽略和访问保护。该例外只适用于当前沙箱资料；生产环境应用私钥和密码禁止提供给 Agent。Agent 不得在回复、摘要或普通日志中复述收到的值；仅 AI 网页应用收款在本步骤 5 已校验后，允许登记沙箱摘要展示买家账号及两个密码，最终 summary 只展示这三项。
 
 5. Unix/macOS/Linux 或 Windows READY 的 `ensure` 只依据同一目标项目的 `.alipay-sandbox.json` 当前事实分流：文件不存在时执行既有 `create`；文件存在或为符号链接时执行既有 `verify` 安全路径。已存在配置不得再次调用 `createAnonymousSandbox`、不得覆盖，也不得因为中断重来要求用户删除配置；无效、不安全或被 Git 跟踪时不得使用，脚本按待配置终态统一输出后继续代码开发。
 6. 只有 Unix/macOS/Linux 或 Windows READY 创建分支会调用冻结的 `alipay-anonymous-sandbox.createAnonymousSandbox`、`{"request":{"appType":"PUBLICAPP"}}`、`PLATFORM`、`PLATFORM_ID`、`ALIPAYCLI_BIZ_INFO` 环境变量和 `result.content[0].text -> success -> data` 解包逻辑；`ALIPAYCLI_BIZ_INFO` 固定标识当前调用方 Skill、当前生效版本和匿名 `skill_user_id`，禁止传入 `PRODUCT`。Windows LEGACY/CODE_ONLY 不调用该方法或 `sandbox_config.sh`。
@@ -334,21 +334,21 @@ curl -sL "<当前契约 sourceUrl 中的官方页面>"
 
 **沙箱摘要展示入口**：只有 `sandboxConfigState=READY`、本步骤的代码实现和支付配置后置校验都已完成，才允许对客展示沙箱环境配置。待配置状态跳过本入口，不另写摘要或失败话术。Unix/macOS/Linux 或 Windows READY 从本 flow 所在目录执行：
 
-`environmentRows` 的具体值严禁编造、猜测、补全，禁止使用示例值、占位值或历史对话值替代本轮已校验配置。Unix/macOS/Linux 或 Windows READY 必须由登记脚本直接读取同一配置并生成四行，Agent 不得手填或改写；Windows LEGACY/CODE_ONLY 的应用 ID 和买家测试账号必须取自步骤 1/3 已校验的同一本机配置，两个密码行的固定保存提示仅在实际确认密码已写入该文件后使用。任一必需字段缺失、为空、配置无法读取或来源无法确认时，停止摘要展示并按既有配置失败分支处理，禁止为凑齐四行补值。
+`environmentRows` 的具体值严禁编造、猜测、补全，禁止使用示例值、占位值或历史对话值替代本轮已校验配置。Unix/macOS/Linux 或 Windows READY 必须由登记脚本直接读取同一配置并生成四行，Agent 不得手填或改写；Windows LEGACY/CODE_ONLY 的字段必须来自步骤 1/3 已校验的同一本机配置；网页收款使用已校验沙箱买家密码明文，其他产品两个密码行仅在确认密码已写入文件后使用固定保存提示。任一必需字段缺失、为空、配置无法读取或来源无法确认时，停止摘要展示并按既有配置失败分支处理，禁止为凑齐四行补值。
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" sandbox summary "<productType>" "<规范化项目路径>" "<已确认服务端语言>" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
 ```
 
-该命令 stdout 只渲染 `sandbox.environment.summary` 与 `sandbox.environment.reminder`；Unix/macOS/Linux 和 Windows READY 都从已校验的快速沙箱配置展示买家账号、登录密码与支付密码。命令必须产生唯一 `ALIPAY_AIPAY_INTERNAL:CUSTOMER_MESSAGE_DELIVERY_REQUIRED=sandbox.environment.summary`，带 `ALIPAY_AIPAY_INTERNAL:` 前缀的配置路径和 `FLOW:SANDBOX_CONFIGURED` 只用于流程转移，严禁对客。命令返回后下一动作必须将剔除内部行后的 stdout 原文独立送达，再进入后续沙箱测试或付款体验；不得把工具面板输出或自写摘要当作已送达。命令不重新创建沙箱，不调用 `createAnonymousSandbox`。`productType` 只能来自步骤 2 已确认的 `aipay|webpay|apppay`；配置路径和语言必须与步骤 1/3 一致。摘要展示失败时不得进入沙箱测试或付款体验，也不得改用 Agent 自写表格。
+仅 AI 网页应用收款在该命令成功交付后，在当前对话上下文保留剔除内部行的完整 stdout 为 `SANDBOX_SUMMARY`；只允许本轮原始登记摘要，不写业务状态、不摘出或复述凭据。配置后置校验失败、最终状态不再 READY 或实际配置变化时立即丢弃，禁止拿旧摘要补齐。该命令 stdout 只渲染 `sandbox.environment.summary` 与 `sandbox.environment.reminder`；Unix/macOS/Linux 和 Windows READY 都从已校验的快速沙箱配置展示买家账号、登录密码与支付密码。命令必须产生唯一 `ALIPAY_AIPAY_INTERNAL:CUSTOMER_MESSAGE_DELIVERY_REQUIRED=sandbox.environment.summary`，带 `ALIPAY_AIPAY_INTERNAL:` 前缀的配置路径和 `FLOW:SANDBOX_CONFIGURED` 只用于流程转移，严禁对客。命令返回后下一动作必须将剔除内部行后的 stdout 原文独立送达，再进入后续沙箱测试或付款体验；不得把工具面板输出或自写摘要当作已送达。命令不重新创建沙箱，不调用 `createAnonymousSandbox`。`productType` 只能来自步骤 2 已确认的 `aipay|webpay|apppay`；配置路径和语言必须与步骤 1/3 一致。摘要展示失败时不得进入沙箱测试或付款体验，也不得改用 Agent 自写表格。
 
-Windows LEGACY/CODE_ONLY 从项目实际读取的同一本机配置构造不含密码和密钥原文的 `ENVIRONMENT_ROWS`，再从本 flow 所在目录执行以下固定命令；不得重新索取或复述步骤 1 已提供的敏感值，也不得改用 Unix 快速沙箱脚本：
+Windows LEGACY/CODE_ONLY 从项目实际读取的同一本机配置构造 `ENVIRONMENT_ROWS`：网页收款允许已校验沙箱买家密码明文，其他产品继续使用本地保存提示，所有产品均不得包含密钥原文，再从本 flow 所在目录执行以下固定命令；除上述网页收款买家密码外，不得重新索取或复述步骤 1 已提供的敏感值，也不得改用 Unix 快速沙箱脚本：
 
 ```powershell
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message windows-sandbox-summary --product-name "$PRODUCT_NAME" --config-path "$CONFIG_PATH" --environment-rows "$ENVIRONMENT_ROWS" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
 ```
 
-Windows LEGACY/CODE_ONLY 的 `CONFIG_PATH` 必须是步骤 1/3 已校验的实际本机配置绝对路径；`ENVIRONMENT_ROWS` 固定依次为“沙箱支付宝应用ID（appID）”“沙箱买家测试账号”“沙箱买家登录密码”“沙箱买家支付密码”四行。前两行使用实际沙箱应用 ID 和买家登录账号；两个密码行只展示“已写入本地配置文件，默认不在对话中展开”，不得传入密码原文。不追加 pid、商家或买家 userId、sandboxId。两个 renderer 任一失败都按摘要展示失败处理，禁止手写补齐。
+Windows LEGACY/CODE_ONLY 的 `CONFIG_PATH` 必须是步骤 1/3 已校验的实际本机配置绝对路径；`ENVIRONMENT_ROWS` 固定依次为“沙箱支付宝应用ID（appID）”“沙箱买家测试账号”“沙箱买家登录密码”“沙箱买家支付密码”四行。前两行使用实际沙箱应用 ID 和买家登录账号；网页收款两个密码行使用已校验沙箱买家密码明文；其他产品两个密码行只展示“已写入本地配置文件，默认不在对话中展开”，不得传入密码原文。不追加 pid、商家或买家 userId、sandboxId。两个 renderer 任一失败都按摘要展示失败处理，禁止手写补齐。仅网页收款成功交付后保留完整原始 stdout 为 `SANDBOX_SUMMARY`，供最终收口提取三项买家信息；其他产品不保留该变量。
 
 <!-- ALIPAY_AIPAY_PRODUCT:webpay:START -->
 **网站支付回跳默认规则**：用户未特别说明时，默认实现支付后同步回跳。`return_url` 必须来自已确认目标项目的实际协议、主机、端口和路由，禁止保留 `your-domain.com`、示例端口或猜测路径。项目没有结果页时，在当前技术栈内新增与既有 UI 一致的 GET 回跳路由和页面。用户已明确不需要同步回跳时，直接按关闭分支验收，不增加第二次确认；仍必须保留异步通知、交易查询和商户订单查询页。用户未明确关闭但代码缺少 `return_url` 时，必须修复为默认同步回跳分支，不得要求用户接受遗漏。验收结论必须从实际代码重新检查，不接受调用方自报 `returnMode`。
@@ -402,7 +402,7 @@ Windows LEGACY/CODE_ONLY 的 `CONFIG_PATH` 必须是步骤 1/3 已校验的实
 3. 默认分支继续启动服务，并对不带支付结果参数的 `return_url` 发起 GET 访问。这一步只验证路由和页面壳：无订单上下文时应展示安全的中性状态，不得因没有签名参数而绕过真实回跳请求的验签和订单归属校验。确认响应成功、无认证或重定向循环；单页应用直接刷新不得返回 404。
 4. 默认分支中，Agent 具备浏览器/UI 验证能力时，实际打开回跳页，确认页面非空白、无可见报错且关键状态内容正常渲染。不具备时，不向用户追加人工确认；将“回跳页 UI 人工待验证”记录到最终 checklist 的 `manualItems`，并继续提供沙箱付款入口。
 
-5. 用户已明确关闭同步回跳时，不要求或猜测 `return_url`；确认 SDK 请求未传该字段，并改为验证异步通知处理代码、交易查询和商户订单查询页。本地生产参数验收模式下，如暂无公网 HTTPS `notify_url`，将公网异步通知联调标记为人工待验证，不以此阻塞本地正式验收。
+5. 用户已明确关闭同步回跳时，不要求或猜测 `return_url`；确认 SDK 请求未传该字段，并改为验证异步通知处理代码、交易查询和商户订单查询页。如尚未部署公网 HTTPS `notify_url`，保留上线前提醒，不单独计入本轮失败或人工待验证项；生产不使用通知时需验证服务端可靠主动查单。
 6. 输出沙箱付款说明。操作顺序为：启动服务 → 用浏览器访问支付页面 → 发起支付 → 唤起沙箱收银台 → 用户从“收银台账号登录”与“安卓沙箱支付宝扫码”中二选一完成付款 → 返回商户结果页并查询展示订单状态。
 
 回跳地址无法确定、访问失败或页面出现确定错误时，必须先修正；本轮无法继续修正时进入最终 checklist 的未完成项，不得宣称网站支付代码开发完成。仅缺少浏览器/UI 证据时记录“回跳页 UI 人工待验证”，不得宣称回跳页已验证，但不阻塞沙箱付款入口交付。该体验不新增业务写操作确认点，用户暂未付款不阻止后续代码校验。
@@ -415,7 +415,7 @@ Windows LEGACY/CODE_ONLY 的 `CONFIG_PATH` 必须是步骤 1/3 已校验的实
 以下两项按实际分支二选一，不得同时要求：
 
 - [INT.WEBPAY.RETURN_VERIFIED] 默认分支已确认实际 `return_url` 与项目路由一致，启动服务后 GET 访问通过，且已通过 Agent 浏览器/UI 验证取得页面正常渲染的证据；当前环境无法取得 UI 证据时只能记为人工待验证，不能满足本完成条件
-- [INT.WEBPAY.NO_RETURN_VERIFIED] 关闭分支已记录用户先前明确提出的不使用同步回跳，确认 SDK 请求未传 `return_url`，并完成异步通知处理代码、交易查询和商户订单查询页校验；缺少公网 HTTPS `notify_url` 时，已明确标记公网通知联调为人工待验证
+- [INT.WEBPAY.NO_RETURN_VERIFIED] 关闭分支已记录用户先前明确提出的不使用同步回跳，确认 SDK 请求未传 `return_url`，并完成异步通知处理代码、交易查询和商户订单查询页校验；缺少公网 HTTPS `notify_url` 时已保留上线前提醒；不使用通知时验证服务端可靠主动查单
 <!-- ALIPAY_AIPAY_PRODUCT:END -->
 
 <!-- ALIPAY_AIPAY_PRODUCT:aipay:START -->
@@ -550,6 +550,8 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message saf
 
 **自动执行规则**：步骤 7 完成后进入 `checklist` 阶段；最终收口阶段统一记录 `integration_summary`，输出唯一 `ALIPAY_AIPAY_INTERNAL:CHECKLIST_SCOPE_RECEIPT=<receipt>`，并在本 bundle 末尾直接附带当前产品适用清单。该 scope receipt 仅绑定当前产品、路径与快照，防止错配或变更后沿用旧结论，不证明检查已执行。不得再单独读取整份 `modules/checklist.md`。默认只执行代码阅读、最终 runner 内固定 implementation audit、配置后置校验、语法/静态检查，以及无需安装依赖、联网或监听端口的已有定向测试，并复用步骤 5、步骤 6 已取得的校验证据，不增加“是否需要校验”的用户确认。
 
+**禁止循环与定向复检**：首次覆盖全部适用项，并复用本轮已有且仍有效的证据。局部修复后严禁重新运行全部测试、全部 checklist 动作或无关端到端联调；只复检修复项及有直接依赖、接口、配置或安全影响的关联项，先明确受影响范围，其余未受影响项沿用原证据。每个问题自动修复后最多一次定向复检；仍失败、结果无变化、缺少新证据或受环境阻断时立即停止该问题的重复检测，保留失败／待验证结果并进入最终收口，不以换命令、重载阶段、刷新 scope、重新进入 flow 或主 Agent 要求继续来重置次数。局部复检新发现的问题直接列入本轮结果，不开启无限修复链；后续只有用户明确要求继续处理时再按实际缺口推进。重新取得 scope 只绑定修改后的快照，不代表必须重测所有项目；最终 runner 的固定只读 implementation audit 仍按原契约执行，不等于授权全量测试。
+
 **执行边界**：默认禁止安装依赖或浏览器、切换运行时版本、启动长期服务、申请网络/端口权限、执行截图或 UI 自动化，也不得重复步骤 6 已完成的端到端测试。遇到 `EPERM`、网络受限、缺少浏览器等环境限制时，将对应项标记为“人工待验证”并停止扩展排查；不得据此推断代码或运行时兼容问题。只有用户明确要求继续扩展验证时，才展示拟执行动作并按原确认规则处理。
 
 步骤 3 至步骤 7 的必要依据、配置摘要、代码修复、网站回跳或按量付费联调在本轮无法继续时，跳过所有依赖该失败事实的后续动作，但仍进入本步骤：把未满足条件和被跳过动作按实际证据标记为失败或人工待验证，并使用同一 `integration.checklist.result` 收口。不得为了生成结果重新执行已阻断的外部动作。该 runner 只能在当前产品匹配且未收口的 `integration_only|full_process` active run 内执行；telemetry 开启时缺少或不匹配 run 会直接停止，禁止完成 checklist 后静默丢失 `integration.complete_coding`。`full_process` 中，只有沙箱为 `CREATE_PENDING|VERIFY_PENDING` 且代码实现与不依赖沙箱的安全检查均通过、或沙箱为 `READY` 且仅剩非阻塞人工待验证项时，才在输出标准“部分通过”结果后继续 onboarding；存在其他代码、安全或必要依据失败时仍停在代码开发。
@@ -563,19 +565,20 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message saf
 
 **验收阶段边界**：本轮代码开发按沙箱集成验收；checklist 第七节中尚未开通产品或尚未取得、切换生产实值的检查，记为当前阶段不适用并保留上线前待办，不计入失败项或人工待验证项，不单独阻止 Onboarding。仍须检查生产配置加载边界、环境隔离和所有适用代码/安全控制；已发现的实现缺陷、泄露或环境混用仍是阻断缺口。不得为完成本轮检查索取生产私钥、提前改用生产配置或宣称生产就绪。
 
-**校验完整性要求**：内部必须覆盖当前 bundle 中适用于目标产品的密钥与安全、异步通知、接口覆盖、支付结果处理、按量付费专项、退款、上线前和结果输出章节，不得只检查上方三个摘要项。通过时默认对客只输出通过结论和下一步；部分通过或未通过时只输出实际未完成项、人工待验证项和下一步。步骤 5/6 已展示的沙箱配置、联调或付款体验结论不在 checklist 结果中重复。通过项与不适用项无需逐行展开，用户要求明细时再输出完整逐项结果。精简输出不得导致任何适用校验被跳过。
+**校验完整性要求**：内部必须覆盖当前 bundle 中适用于目标产品的密钥与安全、异步通知、接口覆盖、支付结果处理、按量付费专项、退款、上线前和结果输出章节，不得只检查上方三个摘要项。checklist 校验结果段落：通过时只输出通过结论和下一步；完整接入部分通过或未通过时只输出实际未完成项、人工待验证项和下一步；仅代码开发不展示“未完成项”“人工待验证”独立标签，将实际失败问题及下一步放在【当前状态】，需核实事项只在上线关键点内列一次；仅代码开发另由同一 renderer 追加下述最终摘要。联调或付款体验结论不重复展开；仅网页收款在仅代码开发的最终 checklist 上线关键点前展示步骤 5 已交付摘要中的三项买家信息，完整接入则留到 Onboarding 最终总收口；按量付费与 APP 支付最终 summary 不展示沙箱配置。通过项与不适用项无需逐行展开，用户要求明细时再输出完整逐项结果。精简输出不得导致任何适用校验被跳过。
 
-先汇总 checklist 证据；本轮可修复时先修复、重检，不渲染中间结果。项目快照变化会使旧 `CHECKLIST_SCOPE_RECEIPT` 失效，必须重新加载本阶段并重跑受影响检查。
+先汇总 checklist 证据；本轮可修复时按上述有限修复预算处理，只定向复检受影响项，不渲染中间结果。项目快照变化会使旧 `CHECKLIST_SCOPE_RECEIPT` 失效，必须重新加载本阶段并重跑受影响检查。
 
 项目不再变化且准备生成最终结论时，按 `aipay=AIPAY`、`webpay=WEBPAY`、`apppay=APPPAY` 得到 `PRODUCT_VARIANT`。下方唯一 runner 会重算项目快照、校验 scope，并执行固定 implementation audit；审计只读非测试生产源码，检查核心接口标记和登记的高置信度危险模式，不替代完整 checklist，也不接受 Agent 审计 receipt。
 
-若审计发现问题且命令未传 `--finalize-audit-findings true`，stdout 为空，stderr 只接受唯一 `ALIPAY_AIPAY_INTERNAL:CHECKLIST_AUDIT={state:"REPAIR_REQUIRED",findings:[...]}`。本轮可修复时先修复，重新加载 checklist 阶段取得新 scope，再用更新后的实际证据重跑同一结论命令，禁止渲染中间结果。无法修复时向同一命令追加 `--finalize-audit-findings true`，runner 将 findings 合入“未通过”并收口；该内部重跑不新增用户操作点。`full_process` 必须停在 Integration。
+若审计发现问题且命令未传 `--finalize-audit-findings true`，stdout 为空，stderr 只接受唯一 `ALIPAY_AIPAY_INTERNAL:CHECKLIST_AUDIT={state:"REPAIR_REQUIRED",findings:[...]}`。本轮仍有修复预算时先修复，只定向复检受影响项，重新加载 checklist 阶段取得新 scope，再用更新后的实际证据执行同一结论命令，禁止渲染中间结果。预算耗尽、无进展或无法修复时向同一命令追加 `--finalize-audit-findings true`，runner 将 findings 合入“未通过”并收口；该内部重跑不新增用户操作点。`full_process` 必须停在 Integration。
 
 对客结论统一使用 `integration.checklist.result`；整体结论、失败/部分通过项和人工待验证项必须来自最终一轮 checklist 实际证据。最终渲染成功时必须产生唯一 `ALIPAY_AIPAY_INTERNAL:CUSTOMER_MESSAGE_DELIVERY_REQUIRED=integration.checklist.result`；命令返回后的下一动作先将 stdout 原文独立送达，不得以工具面板或自写总结替代。首次调用前先按以下完整契约确定参数，禁止改枚举：
 
 - `variant` 映射 `aipay=AIPAY`、`webpay=WEBPAY`、`apppay=APPPAY`；`overallResult` 只允许“通过、部分通过、未通过”。
-- `failedItems`/`manualItems` 必须是含下一步的受控单行值，无项目传“无”。`sandboxConfigState` 只允许 `READY|CREATE_PENDING|VERIFY_PENDING`；除沙箱配置及其直接依赖外存在代码、安全或必要依据缺口时 `blockingDefectState=PRESENT`，否则 `NONE`。待配置时 `failedItems` 必须列出沙箱配置及依赖动作未完成；恢复口令只由步骤 1/3 已发送的 `sandbox.configuration.pending` 正文提供。
+- `failedItems`/`manualItems` 必须是含下一步的受控单行值，无项目传“无”。先按证据分类：单纯尚无公网 `notify_url` 属于通用上线提醒，用户尚未自愿完成沙箱付款属于可选体验，两者不得进入 `failedItems`、`manualItems` 或影响完成判定的待办；付款入口及完整指引仍须按步骤 6 交付。实际 UI／已选通知链路证据缺口进入 `manualItems` 并保留部分通过，代码／安全缺陷进入 `failedItems` 并按原门禁处理。不得为每个项目固定添加 UI 或通知幂等待验证项；不得仅因沙箱摘要未展示而改变分类。renderer 拒绝把上述通用提醒、可选体验作为缺口的旧输入；遇到分类错误只修正结果参数，不重新执行已完成检查。`sandboxConfigState` 只允许 `READY|CREATE_PENDING|VERIFY_PENDING`；除沙箱配置及其直接依赖外存在代码、安全或必要依据缺口时 `blockingDefectState=PRESENT`，否则 `NONE`。待配置时 `failedItems` 必须列出沙箱配置及依赖动作未完成；恢复口令只由步骤 1/3 已发送的 `sandbox.configuration.pending` 正文提供。
 - `executionMode`：`integration_only` 固定“仅代码开发”，`nextFlowReminder` 固定“正式上线前还需完成支付产品-产品开通。”。`full_process` 固定“完整接入”：`READY` 且“通过”时提醒“代码开发校验通过后将自动进入支付产品-产品开通；未通过时停留在代码开发。”；沙箱待配置且 `blockingDefectState=NONE` 时提醒“沙箱配置尚未完成，但不阻塞本轮继续支付产品-产品开通；完成配置后再进行沙箱测试。”；`READY`、`failedItems=无` 且仅有人工待验证项时提醒“代码开发自动校验已完成，仍有人工待验证项；本轮继续产品开通。”，并把 `manualItems` 原样带入 Onboarding Step 6。其他阻断结果停在 Integration。
+- 上述 `nextFlowReminder` 仍按代码校验事实传入；Windows `CODE_ONLY` 且 `executionMode=完整接入` 时，renderer 在原有校验后统一使用消息目录的 `windowsCodeOnlyReminder` 替换对客后续提示。无论代码通过、沙箱待配置、仅人工待验证或阻塞失败，都不得承诺本轮继续开通；本轮停在代码开发，工具恢复后按 `../normal/windows-environment.md` 重新执行原根意图的 `windows-entry`，取得唯一 `READY` 后才可恢复开通。该显示覆盖不改变代码结果、沙箱状态、失败项或现有门禁。
 - 仅 `AIPAY` 传 `sandboxResult`：步骤 6 端到端联调通过为“AI 按量付费沙箱服务端联调通过”，否则为“AI 按量付费沙箱服务端联调未通过”。仅 `WEBPAY` 传 `webpayExperienceResult`，按步骤 6 证据从三个登记值中选择：已提供入口指引且待用户实际付款、未提供完整入口指引、或用户已完成一笔沙箱付款且结果有核验证据。`APPPAY` 不传这两个参数。
 
 必须从本 flow 所在目录执行当前产品对应单行 runner；runner stdout 是唯一对客正文，必须把 stdout 原文作为当前回复正文发给用户：
@@ -587,7 +590,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message che
 <!-- ALIPAY_AIPAY_PRODUCT:END -->
 <!-- ALIPAY_AIPAY_PRODUCT:webpay:START -->
 ```bash
-node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message checklist-result --variant WEBPAY --project-path "$PROJECT_PATH" --scope-receipt "$CHECKLIST_SCOPE_RECEIPT" --overall-result "$OVERALL_RESULT" --failed-items "$FAILED_ITEMS" --manual-items "$MANUAL_ITEMS" --webpay-experience-result "$WEBPAY_EXPERIENCE_RESULT" --sandbox-config-state "$SANDBOX_CONFIG_STATE" --blocking-defect-state "$BLOCKING_DEFECT_STATE" --execution-mode "$EXECUTION_MODE" --next-flow-reminder "$NEXT_FLOW_REMINDER" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message checklist-result --variant WEBPAY --project-path "$PROJECT_PATH" --scope-receipt "$CHECKLIST_SCOPE_RECEIPT" --overall-result "$OVERALL_RESULT" --failed-items "$FAILED_ITEMS" --manual-items "$MANUAL_ITEMS" --webpay-experience-result "$WEBPAY_EXPERIENCE_RESULT" --sandbox-config-state "$SANDBOX_CONFIG_STATE" --blocking-defect-state "$BLOCKING_DEFECT_STATE" --execution-mode "$EXECUTION_MODE" --next-flow-reminder "$NEXT_FLOW_REMINDER" [--sandbox-summary "$SANDBOX_SUMMARY"] --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
 ```
 <!-- ALIPAY_AIPAY_PRODUCT:END -->
 <!-- ALIPAY_AIPAY_PRODUCT:apppay:START -->
@@ -600,11 +603,13 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message che
 
 同一次代码开发流程只渲染一次最终 checklist 结果；renderer stdout 是本次默认收口的唯一对客正文，禁止在前后追加风险说明、通过项摘要、执行说明、衔接提醒或第二份待办。
 
+最终摘要：仅代码开发时，runner 在 checklist 结论后统一输出【当前状态】、符合条件时的【沙箱测试配置】、【上线前有以下关键点】和【提示】。仅网页收款在 `sandboxConfigState=READY` 且步骤 5 的配置后置校验与摘要交付成功、当前实际配置未变化时，传 `--sandbox-summary "$SANDBOX_SUMMARY"`；没有有效原摘要时省略该参数，不读文件、不重建沙箱、不编造字段。最终回放遇到原摘要缺失、过期、格式异常或校验失败时，只省略【沙箱测试配置】，严禁阻塞其余 summary 对客正文；首次配置校验和实际业务门禁保持不变。该区块仅保留沙箱买家测试账号、沙箱买家登录密码、沙箱买家支付密码三项，密码明文展示（含 Windows），不展示产品、配置路径、appId 或密钥行，不表示付款测试通过。按量付费与 APP 支付不得传此参数，不展示该区块。完整接入的中间 checklist 禁止传该参数、禁止提前重复上线清单，原摘要保留给 Onboarding Step 6。传参使用宿主进程参数数组或安全引用，不把多行正文嵌入手写 Shell/JSON。
+
 这些产品专属字段只用于 renderer 校验最终结论，不在 checklist 对客结果中重复展示。APP 支付未来沙箱测试对客引导的维护 TODO 只保留在消息目录对应变体，不得渲染给用户；补充时必须同步本 flow、`modules/checklist.md` 和测试。
 
 **完成语义**：只有步骤 1-8 的适用完成条件均满足且 `sandboxConfigState=READY` 后，才可声明支付产品-代码开发完成。沙箱待配置但代码实现与其余检查通过时只能输出“部分通过”，不得改写为完成；存在其他未通过项时输出“未通过”；若配置已就绪且仅剩无法自动验证项，输出“部分通过”并登记人工待验证项，不得改写为完成或生产就绪。
 
-完成结论必须逐项来自本轮实际检查：项目和代码项重新扫描目标目录；Unix/macOS/Linux 或 Windows READY 只有 `sandboxConfigState=READY` 时才重新执行严格的 `sandbox_config.sh verify`，待配置时直接复用本轮脚本终态并标记相关项未完成，不得在 checklist 中再次创建或复核；Windows LEGACY/CODE_ONLY 只有 `READY` 时重新检查项目实际读取的本地配置、密钥格式和版本控制保护，`VERIFY_PENDING` 时直接标记配置及依赖动作未完成；按量付费联调只接受本轮 `run --auto-complete --require-payment-validation` 的实际成功；用户确认项只接受当前摘要后的回复。任何一项缺失、失败或无法执行都标记为失败或人工待验证，不得由 Agent 自填 `PASS`。
+完成结论必须逐项来自本轮实际检查：首次覆盖时检查项目和代码；局部修复后的检查与下述配置验证仅在相关证据受影响时重新执行，未受影响的有效证据沿用；Unix/macOS/Linux 或 Windows READY 只有 `sandboxConfigState=READY` 时才重新执行严格的 `sandbox_config.sh verify`，待配置时直接复用本轮脚本终态并标记相关项未完成，不得在 checklist 中再次创建或复核；Windows LEGACY/CODE_ONLY 只有 `READY` 时重新检查项目实际读取的本地配置、密钥格式和版本控制保护，`VERIFY_PENDING` 时直接标记配置及依赖动作未完成；按量付费联调只接受本轮 `run --auto-complete --require-payment-validation` 的实际成功；用户确认项只接受当前摘要后的回复。任何一项缺失、失败或无法执行都标记为失败或人工待验证，不得由 Agent 自填 `PASS`。
 
 **沙箱结论边界**：步骤 8 的代码与配置校验不得把步骤 3 的字段完整性、网站支付的付款指引或 APP 支付跳过步骤 6 改写为“沙箱测试通过”。只有按量付费步骤 6 已取得完整端到端成功证据时，最终摘要才可复用该测试结论。
 
@@ -619,6 +624,6 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message che
 ## 代码开发完成确认
 
 - `integration_only`：仅由 `integration.checklist.result` 输出未通过项、人工待验证项和产品开通提醒，不追加第二份话术。
-- `full_process`：全部适用步骤通过后进入 `references/onboarding/flow.md`；仅沙箱待配置，或沙箱 `READY` 且仅剩非阻塞人工待验证项时，以“部分通过”继续并保留未完成事实。其他代码、安全或依据缺口停在 Integration，不提前执行 Onboarding。
+- `full_process`：Windows `CODE_ONLY` 始终先停在产品开通前，环境恢复并复检取得唯一 `READY` 后才按原完成条件衔接。其他环境下，全部适用步骤通过后进入 `references/onboarding/flow.md`；仅沙箱待配置，或沙箱 `READY` 且仅剩非阻塞人工待验证项时，以“部分通过”继续并保留未完成事实。其他代码、安全或依据缺口停在 Integration，不提前执行 Onboarding。
 - 未通过时不得宣称完成；沙箱状态不得被产品开通结果覆盖。
 <!-- ALIPAY_AIPAY_FLOW:INTEGRATION_CHECKLIST:END -->

package/skill-pre/references/integration/modules/checklist.md

@@ -26,8 +26,8 @@
 
 先区分两种验收层级，再判断是否通过：
 
-- **本地正式验收 / 本地生产参数验收模式**：允许暂时没有可公网访问的 HTTPS `notify_url`。这一层必须检查“通知处理代码是否已实现”和“支付结果是否可通过主动查询兜底确认”；公网可访问性标记为“人工待验证”，不作为阻断本地正式验收的单一条件。
-- **真实生产上线**：必须具备可公网访问的 HTTPS `notify_url`，并完成验签、关键字段校验、幂等、成功响应 `success` 和补偿查询。未满足时不得判定生产就绪。
+- **本地开发 / 沙箱集成**：通知处理代码和主动查询仍须实现；仅尚未部署公网 HTTPS `notify_url` 属于上线前提醒，不计入本轮失败或人工待验证项。通知代码或查询链路的实际缺陷仍须修复。
+- **真实生产上线**：可使用异步通知加补偿查询，或省略 `notify_url` 并由服务端可靠主动查单。使用通知时验证公网 HTTPS 地址、验签、关键字段、幂等和 `success`；不使用时验证后台查单、响应验签、订单/金额/状态/归属校验、幂等交付、重试及未决订单恢复，用户关闭页面后也能继续。所选链路未验证时不得判定生产就绪。
 
 | 校验项 | 校验要求 | 说明 |
 |----------|----------|----------|
@@ -38,7 +38,7 @@
 | 响应值 | 商户侧处理成功后需返回字符串 `success` | 否则支付宝会重试通知 |
 | URL 格式 | notify_url 不能包含空格和 HTML 标签 | 否则可能导致通知失败 |
 | 重定向 | notify_url 不能重定向 | 重定向会导致支付宝收不到 success |
-| 外网可访问 | 真实生产上线时，notify_url 必须外网可访问；本地生产参数验收模式下标记为人工待验证 | 需确保支付宝服务器可访问；本地 `localhost`、局域网地址或 TLS 未就绪域名不阻塞本地正式验收 |
+| 外网可访问 | 使用通知时，notify_url 必须可公网访问；不使用通知时本项不适用 | 使用通知时确保支付宝服务器可访问；仅尚未部署公网地址保留上线前提醒，不误记为本轮人工待验证 |
 
 <!-- ALIPAY_AIPAY_CHECKLIST_PRODUCTS:aipay,webpay,apppay -->
 ## 三、适用接口覆盖校验
@@ -135,7 +135,7 @@
 > - ➖ 不适用：当前集成场景不涉及此项
 > - 🟡 人工待验证：当前环境无法自动取得充分证据
 
-先按当前证据逐项判断；本轮可修复时先修复、重检，不渲染中间结果。项目稳定后按 `../flow.md` 执行唯一 `checklist-result`，由 runner 在同一次最终调用中校验 scope 并对同一项目快照执行固定 implementation audit。审计失败是阻断缺口，不能被 Agent 自报结论覆盖；可修复时先返回结构化 findings，项目变化后重新加载 checklist 阶段取得新 scope。
+首次按当前证据覆盖全部适用项；本轮可修复时只在 `../flow.md` 步骤 8 的有限预算内修复、定向复检，不渲染中间结果。严禁循环检测；局部修复后只检查修复项及直接受影响项，未受影响且证据仍有效的项目不重复执行，严禁重新运行全量测试。定向复检仍失败或没有新进展时按实际未解决项收口，不以刷新快照或 scope 重置预算。项目稳定后按 `../flow.md` 执行唯一 `checklist-result`，由 runner 在同一次最终调用中校验 scope 并对同一项目快照执行固定 implementation audit。审计失败是阻断缺口，不能被 Agent 自报结论覆盖；可修复时先返回结构化 findings，项目变化后重新加载 checklist 阶段取得新 scope。
 
 最终 action、完整参数和失败转移只以 `../flow.md` 步骤 8 为准，本模块不复制命令。runner 只接受最终一轮实际证据：Unix/macOS/Linux 或 Windows READY 的 `sandboxConfigState` 复用脚本终态，Windows LEGACY/CODE_ONLY 复用步骤 1/3 的 `READY|VERIFY_PENDING`；待配置时不重跑或读取配置，并把配置及依赖动作列为未完成。
 
@@ -144,13 +144,15 @@
 | 产品 | checklist 内部校验事实 | 实际待办来源 |
 |---|---|---|
 | `AIPAY` | 通过必须绑定本轮 AI 按量付费服务端联调成功；只有完整 402、沙箱收银、Payment-Proof 重试和资源交付证据才能称沙箱测试通过 | 失败/部分通过项、人工待验证项、联调恢复动作 |
-| `WEBPAY` | 未提供浏览器付款入口和完整指引时不得通过；公网 HTTPS `notify_url` 未联调只能称本地验收完成，不能称生产就绪 | 失败/部分通过项、人工待验证项、待用户体验事项 |
+| `WEBPAY` | 未提供浏览器付款入口和完整指引时不得通过；仅未配置 `notify_url` 不判为失败；生产就绪需按所选通知或可靠主动查单链路验证 | 失败/部分通过项、实际人工待验证项；可选付款体验不计入缺口 |
 | `APPPAY` | 当前没有沙箱付款验证结论，不据此生成通过或失败，也不临场补充沙箱付款步骤 | 失败/部分通过项、人工待验证项 |
 
-`failedItems`、`manualItems` 必须包含确定下一步，无对应项时传“无”。`overallResult=通过` 要求两者为“无”、`sandboxConfigState=READY`、`blockingDefectState=NONE`；“部分通过”至少有一类缺口；“未通过”必须列出失败项。`blockingDefectState` 只表示沙箱配置及其直接依赖以外的代码、安全或必要依据缺口；单纯 UI、浏览器或公网联调待验证只进入 `manualItems`。`full_process` 仅在沙箱待配置且无其他阻断，或 `READY` 且只剩非阻塞人工项时继续 Onboarding。
+`failedItems`、`manualItems` 必须包含确定下一步，无对应项时传“无”。生成结果前完成分类：普通上线提醒（包括仅未部署公网 `notify_url`）和可选沙箱付款体验不得混入这两个字段或影响完成判定的待办；它们沿用已有上线说明／付款指引。真实 UI、已选通知链路的证据缺口才进入 `manualItems`，并在最终上线关键点逐项可见；已确认的实现缺陷进入 `failedItems`。不固定增加待验证事项，不在 summary 末端隐藏实际缺口；可选沙箱配置区块有无不参与完成判定。`overallResult=通过` 要求两者为“无”、`sandboxConfigState=READY`、`blockingDefectState=NONE`；“部分通过”至少有一类缺口；“未通过”必须列出失败项。`blockingDefectState` 只表示沙箱配置及其直接依赖以外的代码、安全或必要依据缺口；单纯 UI、浏览器或已选通知链路实际联调待验证只进入 `manualItems`；仅未部署公网地址不计入其中。`full_process` 仅在沙箱待配置且无其他阻断，或 `READY` 且只剩非阻塞人工项时继续 Onboarding。
 
 内部保留适用项依据；明细按实际证据输出，不维护第二份模板。同一次代码开发只渲染一次；renderer stdout 是默认收口的唯一对客正文，前后不得追加摘要、风险或待办。
 
+Windows `CODE_ONLY` 的环境门禁优先于上述 `full_process` 衔接条件：代码校验结果和待办仍按实际证据保留，但本轮停止在代码开发，不能进入 Onboarding。后续提示由 renderer 使用消息目录的环境恢复提示，不承诺立即继续产品开通；恢复工具并取得环境 `READY` 后才按原条件衔接。沙箱配置 `READY` 不能代替环境 `READY`。
+
 ---
 
 > 📖 本文档内容整理自支付宝开放平台官方文档，如有更新请以官方文档为准。

package/skill-pre/references/integration/modules/code-examples/csharp/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -15,7 +15,7 @@ var request = new AlipayTradePagePayRequest();
 var notifyUrl = Environment.GetEnvironmentVariable("ALIPAY_NOTIFY_URL");
 if (!string.IsNullOrWhiteSpace(notifyUrl))
 {
-    request.SetNotifyUrl(notifyUrl.Trim());  // 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
+    request.SetNotifyUrl(notifyUrl.Trim());  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
 }
 request.SetReturnUrl("https://your-domain.com/return");  // 默认传入并替换为已验证结果页；仅用户明确关闭同步回跳时省略
 

package/skill-pre/references/integration/modules/code-examples/csharp/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -23,7 +23,7 @@ namespace SdkDemoTest
             var notifyUrl = Environment.GetEnvironmentVariable("ALIPAY_NOTIFY_URL");
             if (!string.IsNullOrWhiteSpace(notifyUrl))
             {
-                request.SetNotifyUrl(notifyUrl.Trim());  // 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
+                request.SetNotifyUrl(notifyUrl.Trim());  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
             }
             AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
             

package/skill-pre/references/integration/modules/code-examples/java/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -22,7 +22,7 @@ public class AlipayTradePagePay {
         AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
         String notifyUrl = System.getenv("ALIPAY_NOTIFY_URL");
         if (notifyUrl != null && !notifyUrl.isBlank()) {
-            request.setNotifyUrl(notifyUrl.trim());  // 真实生产或公网联调时传入；本地没有公网 HTTPS notifyUrl 时不要调用 setNotifyUrl(null/空字符串/占位 URL)
+            request.setNotifyUrl(notifyUrl.trim());  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notifyUrl 时不要调用 setNotifyUrl(null/空字符串/占位 URL)
         }
         request.setReturnUrl("https://your-domain.com/return");  // 默认传入并替换为已验证结果页；仅用户明确关闭同步回跳时省略
 

package/skill-pre/references/integration/modules/code-examples/java/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -31,7 +31,7 @@ public class AlipayTradeAppPay {
         AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
         String notifyUrl = System.getenv("ALIPAY_NOTIFY_URL");
         if (notifyUrl != null && !notifyUrl.isBlank()) {
-            request.setNotifyUrl(notifyUrl.trim());  // 真实生产或公网联调时传入；本地没有公网 HTTPS notifyUrl 时不要调用 setNotifyUrl(null/空字符串/占位 URL)
+            request.setNotifyUrl(notifyUrl.trim());  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notifyUrl 时不要调用 setNotifyUrl(null/空字符串/占位 URL)
         }
         AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
         

package/skill-pre/references/integration/modules/code-examples/nodejs/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -17,7 +17,7 @@ const alipaySdk = new AlipaySdk({
 
 // ⚠️ 网站支付必须使用 pageExec() 方法，不能使用 exec()
 // ⚠️ pageExec() 第二个参数必须传 'POST'
-// ⚠️ notifyUrl 在真实生产或公网联调时传入；本地生产参数验收模式可临时不传，但仍需实现通知处理代码
+// ⚠️ notifyUrl 可选；生产也可省略，但服务端必须可靠主动查单，仍需实现通知处理代码
 // ⚠️ 本地没有公网 HTTPS notifyUrl 时，直接省略 notifyUrl，不要向 SDK 传 undefined、空字符串或占位 URL
 // ⚠️ returnUrl 默认传入，仅在用户明确关闭同步回跳时省略
 const notifyUrl = (process.env.ALIPAY_NOTIFY_URL || "").trim();

package/skill-pre/references/integration/modules/code-examples/nodejs/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -13,7 +13,7 @@ const alipaySdk = new AlipaySdk({
   appAuthToken: "<-- 请填写应用授权令牌 -->",
 });
 
-// 真实生产或公网联调时传入 notifyUrl；本地没有公网 HTTPS notifyUrl 时直接省略，不要向 SDK 传 undefined、空字符串或占位 URL。
+// 使用异步通知时传入 notifyUrl；生产也可省略并由服务端可靠主动查单。没有公网 HTTPS notifyUrl 时直接省略，不要向 SDK 传 undefined、空字符串或占位 URL。
 const notifyUrl = (process.env.ALIPAY_NOTIFY_URL || "").trim();
 const requestOptions = {
   bizContent: {

package/skill-pre/references/integration/modules/code-examples/php/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -22,7 +22,7 @@ $aop->signType = 'RSA2';
 $request = new AlipayTradePagePayRequest();
 $notifyUrl = trim(getenv('ALIPAY_NOTIFY_URL') ?: '');
 if ($notifyUrl !== '') {
-    $request->setNotifyUrl($notifyUrl);  // 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
+    $request->setNotifyUrl($notifyUrl);  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
 }
 $request->setReturnUrl('https://your-domain.com/return');  // 默认传入并替换为已验证结果页；仅用户明确关闭同步回跳时省略
 

package/skill-pre/references/integration/modules/code-examples/php/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -16,7 +16,7 @@ $alipayClient = new AopClient(getAlipayConfig());
 $request = new AlipayTradeAppPayRequest();
 $notifyUrl = trim(getenv('ALIPAY_NOTIFY_URL') ?: '');
 if ($notifyUrl !== '') {
-    $request->setNotifyUrl($notifyUrl);  // 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
+    $request->setNotifyUrl($notifyUrl);  // 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 null、空字符串或占位 URL
 }
 $model = array();
 

package/skill-pre/references/integration/modules/code-examples/python/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -23,7 +23,7 @@ client = DefaultAlipayClient(alipay_client_config=config)
 request = AlipayTradePagePayRequest()
 notify_url = os.getenv("ALIPAY_NOTIFY_URL", "").strip()
 if notify_url:
-    request.notify_url = notify_url  # 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 None、空字符串或占位 URL
+    request.notify_url = notify_url  # 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 None、空字符串或占位 URL
 request.return_url = "https://your-domain.com/return"  # 默认传入并替换为已验证结果页；仅用户明确关闭同步回跳时省略
 
 model = AlipayTradePagePayModel()

package/skill-pre/references/integration/modules/code-examples/python/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -24,7 +24,7 @@ client = DefaultAlipayClient(alipay_client_config=config)
 request = AlipayTradeAppPayRequest()
 notify_url = os.getenv("ALIPAY_NOTIFY_URL", "").strip()
 if notify_url:
-    request.notify_url = notify_url  # 真实生产或公网联调时传入；本地没有公网 HTTPS notify_url 时不要传 None、空字符串或占位 URL
+    request.notify_url = notify_url  # 使用异步通知时传入；未配置时由服务端可靠主动查单。没有公网 HTTPS notify_url 时不要传 None、空字符串或占位 URL
 model = AlipayTradeAppPayModel()
 
 model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"

package/skill-pre/references/integration/modules/interface-contract/apppay-interface-contract.md

@@ -27,7 +27,7 @@ AI 移动应用收款必须覆盖：`alipay.trade.app.pay`、交易查询、退
 | 字段 | 要求 |
 | --- | --- |
 | `method` | 固定 `alipay.trade.app.pay` |
-| `notify_url` | 生产或公网联调时传入；本地生产参数验收模式可临时不传，但通知处理代码必须存在 |
+| `notify_url` | 可选，生产也可省略；使用通知时传入商家公网 HTTPS 地址，不使用时由服务端可靠主动查单；通知处理代码仍须实现 |
 
 业务参数：
 

package/skill-pre/references/integration/modules/interface-contract/notify-url-contract.md

@@ -19,7 +19,7 @@ sourceUrl:
 
 `notify_url` 是商家服务端接收支付宝 POST 表单通知的地址，不是前端页面地址，也不是支付宝生成的 URL。
 
-本地正式验收或本地生产参数验收时，若暂时没有公网 HTTPS 通知地址，可以不传 `notify_url`，但仍必须实现通知处理代码并用交易查询兜底。不要向 SDK 传 `undefined`、`null`、空字符串或占位 URL；没有可用地址时应直接省略该字段或不调用对应 setter。真实生产或公网联调时必须传入可公网访问的 HTTPS `notify_url`，地址不能包含多余字符或发生重定向。
+通知处理与交易查询接口必须同时实现。`notify_url` 是可选参数；当前商家没有配置该地址时，下单省略该字段并由服务端交易查询兜底，不会仅因缺少该地址而报错。生产也允许省略。未配置时不触发该地址的异步通知，必须由商家服务端通过 `alipay.trade.query` 主动确认支付结果，校验订单、金额、支付状态及归属，幂等更新订单；即使用户关闭页面，仍须继续处理查询重试和未决订单。如使用异步通知，配置商家已部署、支付宝服务端可公网访问的 HTTPS 地址并完成验签、关键字段校验、幂等、`success` 回写和补偿查询。不能只因没有公网通知地址阻止流程或判定不能上线；通知处理代码仍须实现，实际代码或支付结果确认链路缺陷仍是阻断项。 没有可用地址时省略该字段，不向 SDK 传 `undefined`、`null`、空字符串或占位 URL；使用通知时地址不得包含多余字符或发生重定向。
 
 ## 必须实现的处理链路
 
@@ -50,10 +50,11 @@ sourceUrl:
 
 ## 验收分层
 
-- 本地正式验收 / 本地生产参数验收模式：允许暂时没有公网 HTTPS `notify_url`，但通知处理代码、验签、业务字段校验、持久化幂等和主动查询兜底必须存在；公网通知联调标记为人工待验证。没有可用通知地址时省略 `notify_url`，不要向 SDK 传 `undefined`、`null`、空字符串或占位 URL。
-- 真实生产上线：必须配置公网 HTTPS `notify_url`，完成支付宝服务器可访问联调、验签、关键字段校验、幂等处理、返回 `success` 和补偿查询。
+- 本地开发 / 沙箱集成：通知处理代码、验签、关键字段校验、持久化幂等和主动查询必须实现。仅尚未部署公网通知地址属于上线前方案选择与验证提醒，不计入本轮失败或人工待验证项；实际通知代码缺陷仍须修复。
+- 真实生产上线，使用通知：配置公网 HTTPS `notify_url`，验证支付宝服务器可访问、验签、关键字段校验、幂等处理、返回 `success` 和补偿查询。
+- 真实生产上线，不使用通知：下单省略 `notify_url`，验证服务端主动查单、查询响应验签和订单/金额/状态/归属校验、幂等交付、后台重试和未决订单恢复。不得把浏览器关闭或一次查询未成功当作付款失败。
 
-没有完成真实生产上线层时，不得表述为生产就绪或正式上线完成。
+生产配置及所选支付结果确认链路尚未验证时，不得表述为生产就绪或正式上线完成。仅缺少 `notify_url` 不是不能上线的依据。
 
 ## 本地示例索引
 

package/skill-pre/references/integration/modules/interface-contract/webpay-interface-contract.md

@@ -24,7 +24,7 @@ AI 网页应用收款必须覆盖：`alipay.trade.page.pay`、交易查询、退
 | 字段 | 要求 |
 | --- | --- |
 | `method` | 固定 `alipay.trade.page.pay` |
-| `notify_url` | 生产或公网联调时传入；本地生产参数验收模式可临时不传，但通知处理代码必须存在 |
+| `notify_url` | 可选，生产也可省略；使用通知时传入商家公网 HTTPS 地址，不使用时由服务端可靠主动查单；通知处理代码仍须实现 |
 | `return_url` | 用户未明确关闭同步回跳时默认传入，且对应当前项目实际 GET 路由 |
 
 业务参数：

package/skill-pre/references/integration/modules/interface-guide.md

@@ -58,4 +58,4 @@ AI 网页应用收款和 AI 移动应用收款必须读取当前语言目录下
 | 关闭交易 | `./code-examples/<语言>/1-通用接口/统一收单交易关闭接口代码示例.md` |
 | 异步通知 | `./code-examples/<语言>/1-通用接口/异步通知处理代码示例.md` |
 
-本地未上线时，可按 `../flow.md` 的“本地生产参数验收模式”先完成本地结果确认链路验证；正式上线前仍必须补齐公网 HTTPS `notify_url`、验签、幂等、关键字段校验、`success` 回写和补偿查询。用户明确要求对账时再读取官方对账单下载文档作为 fallback；当前默认 checklist 不包含对账单下载。
+本地未上线时，可按 `../flow.md` 的“本地生产参数验收模式”先完成本地结果确认链路验证；生产可选择异步通知加补偿查询，或省略 `notify_url` 并由服务端可靠主动查单；通知处理代码仍须实现。上线前按所选链路验证验签、订单与金额及状态归属校验、持久化幂等、重试和未决订单恢复；仅没有公网通知地址不判为失败。用户明确要求对账时再读取官方对账单下载文档作为 fallback；当前默认 checklist 不包含对账单下载。

package/skill-pre/references/integration/modules/sandbox/sandbox-setup-guide.md

@@ -14,7 +14,7 @@
 ### 1.2 Windows LEGACY/CODE_ONLY 用户注意事项
 Windows READY 通过兼容层执行 flow 登记的快速沙箱；下述手工分支适用于 Windows LEGACY/CODE_ONLY；CODE_ONLY 只放行代码开发，不代表站点开通选择。Windows 沙箱项目配置不要求精确 NTFS ACL 白名单，配置是否可用仍由字段校验、实际项目加载路径和防误提交检查决定。
 
-Windows LEGACY/CODE_ONLY 普通代码开发或完整接入请求未明确要求当前配置沙箱且未主动提供资料时，记录 `sandboxConfigState=VERIFY_PENDING` 并继续代码实现，不展示资料收集消息。用户主动提供本轮目标项目的完整有效手工沙箱资料时，直接校验并写入项目实际使用的本地沙箱配置，记录沙箱 `READY`，无需再次展示资料收集消息。只有用户明确要求现在配置或恢复 Windows LEGACY/CODE_ONLY 沙箱时，才使用 `../../../normal/json/customer-messages.json` 的既有 `sandbox.windows.manual_setup`，引导用户前往支付宝 AI 付站点的“选择产品 → 一站式接入 → 技术集成”页面获取当前沙箱的 APPID、公私钥和账号信息。主动提供或本轮消息后提供的资料均须校验；部分或错误时不使用无效字段、不记 `READY`，只补问实际缺失或错误字段。沙箱 `READY` 只证明配置就绪，不改变 `CODE_ONLY` 环境分流；测试按自身实际依赖执行，不调用快速沙箱，Skill 内产品开通仍须环境 `READY`。不得要求用户自行配置、理解 `sandbox_config.sh`、执行 Bash 或手工拼接 Skill 的规范化 JSON。该资料输入例外只适用于沙箱，生产环境应用私钥和密码禁止提供给 Agent；Agent 不得在回复、摘要或普通日志中复述收到的值。
+Windows LEGACY/CODE_ONLY 普通代码开发或完整接入请求未明确要求当前配置沙箱且未主动提供资料时，记录 `sandboxConfigState=VERIFY_PENDING` 并继续代码实现，不展示资料收集消息。用户主动提供本轮目标项目的完整有效手工沙箱资料时，直接校验并写入项目实际使用的本地沙箱配置，记录沙箱 `READY`，无需再次展示资料收集消息。只有用户明确要求现在配置或恢复 Windows LEGACY/CODE_ONLY 沙箱时，才使用 `../../../normal/json/customer-messages.json` 的既有 `sandbox.windows.manual_setup`，引导用户前往支付宝 AI 付站点的“选择产品 → 一站式接入 → 技术集成”页面获取当前沙箱的 APPID、公私钥和账号信息。主动提供或本轮消息后提供的资料均须校验；部分或错误时不使用无效字段、不记 `READY`，只补问实际缺失或错误字段。沙箱 `READY` 只证明配置就绪，不改变 `CODE_ONLY` 环境分流；测试按自身实际依赖执行，不调用快速沙箱，Skill 内产品开通仍须环境 `READY`。不得要求用户自行配置、理解 `sandbox_config.sh`、执行 Bash 或手工拼接 Skill 的规范化 JSON。该资料输入例外只适用于沙箱，生产环境应用私钥和密码禁止提供给 Agent；除网页收款在登记摘要中展示已校验沙箱买家账号及两个密码外，Agent 不得在回复、摘要或普通日志中复述收到的值。
 
 ```bash
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message windows-sandbox-setup --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
@@ -67,7 +67,7 @@ Windows LEGACY/CODE_ONLY 手工沙箱：
 2. 用户明确要求配置且尚未提供资料时，才使用标准消息一次收集当前沙箱应用的 APPID、支付宝公钥、应用公钥、与已确认语言匹配的应用私钥和沙箱账号信息；缺失或校验失败时只补问对应字段。
 3. 用户主动提供或本轮标准消息后提供的资料均按第 4 节校验；完整有效时由 Agent 写入目标项目实际使用的本地沙箱配置并记录沙箱 `READY`，已有完整有效资料时不重复索取。部分或错误时不使用无效字段、不记 `READY`，只补问实际缺失或错误字段。不要求采用快速沙箱 `data` 的嵌套结构，不把值复制到源码或普通日志。
 4. 检查沙箱配置未被 Git 跟踪，并已有适用于实际路径的版本控制忽略保护；不因项目目录继承额外 Windows ACL 权限而阻断沙箱配置。
-5. 只有 `READY` 时才输出第 5 节规定的摘要和 Windows LEGACY/CODE_ONLY 提醒并从实际本机配置映射到 SDK；Agent 不得在回复或摘要中复述用户提供的沙箱密钥和密码，生产环境应用私钥和密码禁止提供给 Agent。
+5. 只有 `READY` 时才输出第 5 节规定的摘要和 Windows LEGACY/CODE_ONLY 提醒并从实际本机配置映射到 SDK；仅网页收款登记摘要可展示已校验沙箱买家密码，其他沙箱密钥和密码不得在回复或摘要中复述，生产环境应用私钥和密码禁止提供给 Agent。
 
 Unix/macOS/Linux 或 Windows READY 快速沙箱的流程准备必须使用 integration flow 登记的 `sandbox_config.sh ensure` 入口：配置缺失时脚本内部创建，已存在时脚本内部复核；步骤 3 仅在首次准备为 `READY` 时执行 `reverify`，待配置时直接继续代码开发；代码开发完成且配置仍为 `READY` 后才使用 `summary` 展示摘要。`ensure|reverify` 会把既定重试耗尽转换为受控 `CREATE_PENDING|VERIFY_PENDING`，直接渲染统一消息并返回终态标记；Agent 不得直接选择创建分支、重复检查文件存在性或权限、读取字段结构、拼接沙箱 JSON、另写解析逻辑或自制摘要表。Windows LEGACY/CODE_ONLY 手工申领分支检查目标项目实际读取的本地配置，不把平台字段擅自改造成快速沙箱返回结构。
 
@@ -141,9 +141,11 @@ Unix/macOS/Linux 或 Windows READY 创建阶段把实际本机配置路径和 `F
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message windows-sandbox-summary --product-name "$PRODUCT_NAME" --config-path "$CONFIG_PATH" --environment-rows "$ENVIRONMENT_ROWS" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
 ```
 
-`environmentRows` 的具体值严禁编造、猜测、补全，禁止使用示例值、占位值或历史对话值替代本轮已校验配置。Unix/macOS/Linux 或 Windows READY 必须由登记脚本直接读取同一配置并生成四行，Agent 不得手填或改写；Windows LEGACY/CODE_ONLY 的应用 ID 和买家测试账号必须取自步骤 1/3 已校验的同一本机配置，两个密码行的固定保存提示仅在实际确认密码已写入该文件后使用。任一必需字段缺失、为空、配置无法读取或来源无法确认时，停止摘要展示并按既有配置失败分支处理，禁止为凑齐四行补值。
+`environmentRows` 的具体值严禁编造、猜测、补全，禁止使用示例值、占位值或历史对话值替代本轮已校验配置。Unix/macOS/Linux 或 Windows READY 必须由登记脚本直接读取同一配置并生成四行，Agent 不得手填或改写；Windows LEGACY/CODE_ONLY 的字段必须取自步骤 1/3 已校验的同一本机配置；网页收款展示已校验沙箱买家密码明文，其他产品两个密码行仅在确认密码已写入文件后使用固定保存提示。任一必需字段缺失、为空、配置无法读取或来源无法确认时，停止摘要展示并按既有配置失败分支处理，禁止为凑齐四行补值。
 
-摘要动态行固定依次为“沙箱支付宝应用ID（appID）”“沙箱买家测试账号”“沙箱买家登录密码”“沙箱买家支付密码”。Unix/macOS/Linux 与 Windows READY 都从已校验快速沙箱配置的 `appIds[0].appId`、`sandboxAccounts.user.email`、`sandboxAccounts.user.logonPassword`、`sandboxAccounts.user.payPassword` 取值；Windows LEGACY/CODE_ONLY 手工沙箱只展示前两项实际值，两个密码行固定提示“已写入本地配置文件，默认不在对话中展开”。不得追加 pid、商家或买家 userId、sandboxId；手工沙箱不得将密码原文传入 renderer。以上例外不得扩展到生产环境账号、私钥或密码。
+摘要动态行固定依次为“沙箱支付宝应用ID（appID）”“沙箱买家测试账号”“沙箱买家登录密码”“沙箱买家支付密码”。Unix/macOS/Linux 与 Windows READY 都从已校验快速沙箱配置的 `appIds[0].appId`、`sandboxAccounts.user.email`、`sandboxAccounts.user.logonPassword`、`sandboxAccounts.user.payPassword` 取值；Windows LEGACY/CODE_ONLY 手工沙箱前两项展示实际值；网页收款两个密码行展示已校验的沙箱买家密码明文，其他产品固定提示“已写入本地配置文件，默认不在对话中展开”，不得传入密码原文。不得追加 pid、商家或买家 userId、sandboxId。以上例外不得扩展到生产环境账号、私钥或密码。
+
+上述为开发阶段摘要；最终 summary 仅网页收款保留【沙箱测试配置】，只输出沙箱买家测试账号、登录密码及支付密码三项，两个密码明文展示（含 Windows），不展示配置路径、appId 或密钥行；按量付费与 APP 支付不展示该区块。
 
 renderer 固定输出唯一摘要表、密钥字段已落盘提示和“配置不等于测试通过”的边界。禁止另写字段核对表、独立校验结论，或把表名、前后提示改成“沙箱环境校验通过”“沙箱测试通过”“沙箱环境测试通过”。
 
@@ -159,10 +161,10 @@ renderer 固定输出唯一摘要表、密钥字段已落盘提示和“配置
 |---|---|---|
 | Unix/macOS/Linux 与 Windows READY 快速沙箱摘要 | `sandbox_config.sh summary` 实际渲染的应用 `appId`、买家 `email/logonPassword/payPassword`、配置文件目录 | `appPrivateKey`、`appPrivatePkcsKey`、`alipayPublicKey`、`appPublicKey`、原始 `.alipay-sandbox.json`、完整 MCP 响应 |
 | Unix/macOS/Linux 与 Windows READY 网站支付付款体验 | 已校验的沙箱买家登录账号、登录密码、支付密码，以及实际支付页面地址和启动命令 | 商家密码、任何公钥/私钥原文、完整支付表单、签名串 |
-| Windows LEGACY/CODE_ONLY 手工沙箱 | 配置文件目录、实际沙箱应用 ID 和买家登录账号、两个密码的本机保存提示、官方控制台获取与本机配置完成提示 | 用户提供的应用私钥、支付宝公钥、应用公钥、沙箱账号密码原文 |
+| Windows LEGACY/CODE_ONLY 手工沙箱 | 配置文件目录、实际沙箱应用 ID 和买家登录账号；网页收款登记摘要可展示已校验买家密码，其他产品只显示两个密码的本机保存提示 | 应用私钥、支付宝公钥、应用公钥；非网页收款摘要中的沙箱密码原文 |
 | 按量付费自动联调 | 受控结论、付款链接和沙箱买家可选体验入口 | `Payment-Proof`、`Payment-Validation` 原文、完整收银请求、临时产物路径中的敏感内容 |
 
-仅 Unix/macOS/Linux 与 Windows READY 的 `sandboxCredential` 类型变量可以承载快速沙箱买家登录密码和支付密码；该例外不适用于 Windows LEGACY/CODE_ONLY 手工沙箱或生产账号、生产密码、应用私钥、公钥、token、签名串或 Payment-Proof。
+仅登记的 `sandboxCredential`、沙箱摘要表格及其受控最终摘要变量可以承载已校验沙箱买家登录密码和支付密码，含 Windows 网页收款手工沙箱；该例外不适用于生产账号、生产密码、应用私钥、公钥、token、签名串或 Payment-Proof。
 
 ### 5.5 网站支付沙箱付款提示（代码生成后、集成收尾前）
 
@@ -183,7 +185,7 @@ renderer 固定输出唯一摘要表、密钥字段已落盘提示和“配置
 - **默认分支**：“付款后确认浏览器自动返回商户结果页，页面可正常展示并通过服务端查询呈现订单状态。”
 - **关闭分支**：“付款后不会自动返回商户网站；请手动返回商户订单查询页并刷新或查询订单状态。”
 
-两个分支都必须继续提醒：前台页面或同步回跳参数不是支付成功依据，最终结果以验签通过的异步通知或交易查询结果为准。异步通知只有在 `notify_url` 可被支付宝服务器公网访问时才能联调；当前仅有本地或局域网地址时，将该项标记为人工待验证，并明确当前结论属于“本地正式验收 / 本地生产参数验收模式”，不是生产上线完成。
+两个分支都必须继续提醒：前台页面或同步回跳参数不是支付成功依据，最终结果以验签通过的异步通知或交易查询结果为准。异步通知只有在 `notify_url` 可被支付宝服务器公网访问时才能联调；当前仅有本地或局域网地址时保留上线前提醒，不单独记为本轮人工待验证。生产可省略 `notify_url`，但必须验证服务端可靠主动查单、持久化幂等及后台重试；当前本地验收不等于生产上线完成。
 
 **下载渠道红线：**
 - 严禁声称 iOS 支持安装沙箱版支付宝。
@@ -200,7 +202,7 @@ renderer 固定输出唯一摘要表、密钥字段已落盘提示和“配置
 2. 禁止用占位符或示例假数据冒充真实返回值。
 3. 禁止假设“工具返回的应该都有”而跳过逐项校验。
 4. 禁止字段不完整时使用当前配置、写入正式 `.alipay-sandbox.json`、执行配置后置校验或沙箱测试；允许继续不读取沙箱字段的代码实现，最终必须标记沙箱配置未完成。
-5. Windows LEGACY/CODE_ONLY 只允许用户在标准资料收集消息后提供当前沙箱密钥和账号信息，Agent 不得在回复、摘要或日志中复述；Unix/macOS/Linux 或 Windows READY 只允许按登记消息展示已校验的快速沙箱买家密码。禁止展示生产环境应用私钥、账号密码或把任何密钥长字段整段刷屏输出。
+5. Windows LEGACY/CODE_ONLY 只允许用户在标准资料收集消息后提供当前沙箱密钥和账号信息，仅网页收款登记摘要可展示已校验沙箱买家密码，其他原文不得在回复、摘要或日志中复述；Unix/macOS/Linux 或 Windows READY 只允许按登记消息展示已校验的快速沙箱买家密码。禁止展示生产环境应用私钥、账号密码或把任何密钥长字段整段刷屏输出。
 6. 禁止继续使用已被 Git 跟踪的沙箱敏感配置。Unix/macOS/Linux 或 Windows READY 快速沙箱还必须具备 `/.alipay-sandbox.json` 精确忽略规则；Windows LEGACY/CODE_ONLY 必须具备适用于实际本机敏感配置路径的忽略保护。
 
 ### 6.2 快速沙箱重复创建边界

package/skill-pre/references/normal/integration-worker.md

@@ -56,7 +56,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" flow integration develo
 
 Integration Worker 不执行 Onboarding、self-update、`telemetry start-run`、产品/项目重新决策或原 flow 之外的沙箱调用和诊断。不得用 Worker 自报代替原 flow 要求的实际脚本终态和校验证据。
 
-遇到阻塞时，先判断是否能在当前授权和工具范围内自行解决；能解决就继续处理并验证，不能解决才返回 STOP。不得将单次失败或尚未定位原因视为无法继续。恢复仍遵守原 flow 的权限、失败分支和重试边界；有新证据或可验证的修复方向时继续，无新进展时停止重复尝试并如实说明，不伪造通过。STOP 的 `remaining_actions` 须简短列明实际错误、已尝试的恢复及所需外部条件；尚未确认的原因明确标为未知，不返回源码、完整日志或敏感值。
+遇到阻塞时，先判断是否能在当前授权和工具范围内自行解决；能解决就继续处理并验证，不能解决才返回 STOP。不得将单次失败或尚未定位原因视为无法继续。恢复仍遵守原 flow 的权限、失败分支和重试边界；checklist 必须遵守原 flow 的有限修复和定向复检预算，禁止局部修复后全量测试，主 Agent 的核实／继续请求不得重置该预算；有新证据或可验证的修复方向时继续，无新进展时停止重复尝试并如实说明，不伪造通过。STOP 的 `remaining_actions` 须简短列明实际错误、已尝试的恢复及所需外部条件；尚未确认的原因明确标为未知，不返回源码、完整日志或敏感值。
 
 原 flow 要求对客送达的登记 runner/script stdout 都要进入交接对象。`integration.start.confirm` 已由主 Agent 在 Worker 转移前按唯一 marker 独立交付；Worker 从步骤 3 开始，以 flow、消息目录和 runner 契约为准收集后续对客 stdout，其中 `sandbox.configuration.pending`、`sandbox.environment.summary`、`integration.safety.closeout` 和 `integration.checklist.result` 必须各自带唯一 `CUSTOMER_MESSAGE_DELIVERY_REQUIRED=<messageId>` marker，缺失、重复或对应正文为空时按交接失败处理；按发生顺序剔除 `ALIPAY_AIPAY_INTERNAL:` 行后保存到 `customer_messages`。过程 stdout、分析、命令和日志不得进入交接对象。登记正文不改写、不总结；空正文不加入。沙箱账号只允许存在于原始登记正文中，不得拆出、复述或进入其他字段。返回结果只依据最终 checklist 的实际证据；只有原 flow 允许衔接时 `next_phase=ONBOARDING`，其他情况为 `STOP`。
 
@@ -83,7 +83,7 @@ Integration Worker 不执行 Onboarding、self-update、`telemetry start-run`、
 - 沙箱 `READY` 且只剩原 flow 允许的非阻塞人工项：`部分完成，人工待验证`、`ONBOARDING`；
 - 其他代码、安全、必要依据或协议缺口：`未通过`、`STOP`。
 
-上述七个字段都由 Integration Worker 根据原 flow 的实际结果生成。`protocol` 必须精确为 `INTEGRATION_WORKER_V1`，返回对象只允许包含这七个字段；telemetry 输入不得回传。`sandbox_config_state` 必须复用输入后按步骤 3 实际复核得到的终态，不接受 `null` 或字符串 `"null"`。`manual_verification_items` 和 `remaining_actions` 只保留最终 checklist 已证实的短项；STOP 时 `remaining_actions` 另保留上文要求的脱敏阻塞事实，没有时传空数组。禁止返回项目路径、语言、框架、changed files、依赖列表、源码、收据、绝对路径、配置字段或 Worker 分析。Agent 对每次返回做结构校验，不自行解释、修复、补充或改写结果；仅允许下文规定的同 Worker 核实。结构合法的 STOP 若缺少阻塞依据，或仍存在授权范围内未尝试的恢复方向，在对客送达前最多要求同一 Worker 核实并继续一次；只指出返回中的证据缺口，不读取项目、不创建新 Worker、不接手 Integration。Worker 从当前实际状态继续，不重做已成功动作，仍按原 flow 修复、重检并返回同一七字段对象。宿主不支持继续同一 Worker，或再次返回 STOP 时，不循环追问，如实保留未解决项。最终结果校验通过后，按数组顺序把 `customer_messages` 每一项原文作为可见消息送达，不加旁白；然后丢弃该数组。`next_phase=ONBOARDING` 时只把产品、`integration_result`、`sandbox_config_state`、`manual_verification_items` 和 `remaining_actions` 带入独立 Onboarding；不读取项目、不复查 Worker、不重跑 Integration。`protocol`、`customer_messages` 和 `next_phase` 不带入 Onboarding。最终 `next_phase=STOP` 时在送达登记正文后停止，不进入 Onboarding。
+上述七个字段都由 Integration Worker 根据原 flow 的实际结果生成。`protocol` 必须精确为 `INTEGRATION_WORKER_V1`，返回对象只允许包含这七个字段；telemetry 输入不得回传。`sandbox_config_state` 必须复用输入后按步骤 3 实际复核得到的终态，不接受 `null` 或字符串 `"null"`。`manual_verification_items` 和 `remaining_actions` 只保留最终 checklist 已分类的实际缺口和下一步；普通上线提醒与可选沙箱体验不进入这两个字段，不影响 `integration_result`，原样复用最终证据，不在交接或收口重新分类；STOP 时 `remaining_actions` 另保留上文要求的脱敏阻塞事实，没有时传空数组。禁止返回项目路径、语言、框架、changed files、依赖列表、源码、收据、绝对路径、配置字段或 Worker 分析。Agent 对每次返回做结构校验，不自行解释、修复、补充或改写结果；仅允许下文规定的同 Worker 核实。结构合法的 STOP 若缺少阻塞依据，或仍存在授权范围内未尝试的恢复方向，在对客送达前最多要求同一 Worker 核实并继续一次；只指出返回中的证据缺口，不读取项目、不创建新 Worker、不接手 Integration。Worker 从当前实际状态继续，不重做已成功动作，仍按原 flow 修复、重检并返回同一七字段对象。宿主不支持继续同一 Worker，或再次返回 STOP 时，不循环追问，如实保留未解决项。最终结果校验通过后，按数组顺序把 `customer_messages` 每一项原文作为可见消息送达，不加旁白；仅当产品为 AI 网页应用收款、最终沙箱 READY 且配置后置校验通过时，保留其中已交付的 `sandbox.environment.summary` 完整原始正文为当前会话 `SANDBOX_SUMMARY`，用于 Onboarding 最终收口只展示三项买家信息（账号及两个明文密码）；按量付费与 APP 支付不保留此变量；不摘取或另存账号、密码和密钥，不重新读项目。其余正文随后丢弃。`next_phase=ONBOARDING` 时只把产品、`integration_result`、`sandbox_config_state`、`manual_verification_items` 和 `remaining_actions` 带入独立 Onboarding；原 `SANDBOX_SUMMARY` 仅作为登记正文传给最终 closeout 的 `--sandbox-summary`，不新增协议字段；不读取项目、不复查 Worker、不重跑 Integration。`protocol`、`customer_messages` 和 `next_phase` 不带入 Onboarding。最终 `next_phase=STOP` 时在送达登记正文后停止，不进入 Onboarding。
 
 `next_phase=ONBOARDING` 时，送达登记正文后立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" flow onboarding entry --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"` 并继续流程，不得仅宣布下一步就结束当前轮。