@alipay/alipay-aipay 1.2.2 → 1.4.9

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

@@ -10,22 +10,20 @@
 
 签约模块负责产品签约流程，包括签约状态查询和签约申请提交。
 
-本模块采用 `ar-sign.apply` **外部直调 / 静态参数模式**：由 `scripts/ar_sign_apply.sh` 基于当前已确认的产品类型、MCC 和资料字段直接构造 `businessProperty` 后提交申请。它不走 `previewFormView` 动态 schema 收集循环，因此只覆盖本文档明确列出的字段和产品。
+本模块采用 `ar-sign.apply` **脚本封装 / 静态参数模式**：由 `scripts/ar_sign_apply.sh` 基于当前已确认的产品类型、MCC 和资料字段直接构造 `businessProperty` 后提交申请，只覆盖本文档和脚本已经验证的字段与产品。
 
 **使用条件：** Step 3.1 始终使用本模块的签约状态查询规则；只有查询结果为 `NOT_SIGNED` 时，才使用本模块的签约申请提交规则。`SIGNED_EFFECTIVE`、`SIGN_SUBMITTED`、查询失败或其他状态均禁止提交签约申请。
 
 ---
 
-## MCP能力
+## 当前主流程 MCP 能力
 
-| MCP Server | 方法 | 用途 |
-|------------|------|------|
-| `ar-sign` | `apply` | 提交签约申请（主流程使用） |
-| `ar-query` | `queryArInfosBySalesProd` | 按前台产品码查询合约状态 |
-| `ar-query` | `queryArInfosByBackProd` | 按后台产品码查询合约状态 |
-| `ar-order-query` | `queryBizOrder` | 按订单号查询签约订单 |
+| MCP 方法 | 用途 | 固定入口 |
+|------------|------|----------|
+| `ar-sign.apply` | 提交签约申请 | `scripts/ar_sign_apply.sh` |
+| `ar-query.queryArInfosBySalesProd` | 按当前产品码查询合约状态 | `scripts/query_sign_status.sh`、`scripts/auth.sh` |
 
-> **注意：** 通过 `scripts/ar_sign_apply.sh` 提交签约申请。
+> 本表只记录当前主流程脚本实际使用的方法。只能执行固定脚本入口，不得根据方法名自行构造 MCP 调用。
 
 ---
 
@@ -33,7 +31,7 @@
 
 ### 查询命令
 
-执行 `scripts/query_sign_status.sh --sales-code <当前产品码> --product-type <aipay|webpay|apppay>`。
+默认执行 `scripts/query_sign_status.sh --sales-code <当前产品码> --product-type <aipay|webpay|apppay>`。若本轮成功的 `auth.sh` 已对完全相同请求取得合法 `resultObj.arInfoList`，它会通过共享 `sign_status_parser.sh` 输出带 `ALIPAY_AIPAY_INTERNAL:` 前缀的 `AUTH_SIGN_QUERY_REUSABLE=true`、`SIGN_STATUS` 和产品匹配的 `FLOW:*`；仅三者唯一且一致时可直接复用。标记缺失、冲突或结构无法证明时仍执行本命令。所有状态标记只用于分支判断，禁止对客。
 
 ### 状态判断规则
 
@@ -47,35 +45,35 @@
 
 ### 判断逻辑
 
-`scripts/query_sign_status.sh` 自动完成以下状态判断并输出状态信号（`SIGN_STATUS=...`）与分支信号（`FLOW:PC_WEB_NOT_SIGNED` 等）。`SIGNED_EFFECTIVE` 与 `SIGN_SUBMITTED` 的后续 FLOW 保持一致，均不重复提交签约，继续应用发布/服务注册。
+`scripts/query_sign_status.sh` 自动完成以下状态判断，并输出带 `ALIPAY_AIPAY_INTERNAL:` 前缀的状态信号（`SIGN_STATUS=...`）与分支信号（`FLOW:PC_WEB_NOT_SIGNED` 等）；成功时 stdout 为空，Agent 直接转移，不补写话术。`SIGNED_EFFECTIVE` 与 `SIGN_SUBMITTED` 的后续 FLOW 保持一致，均不重复提交签约，继续应用发布/服务注册。
 
 ### 产品×状态分支处理表
 
 | 签约状态 | 产品类型 | FLOW 信号 | 后续流程 |
 |----------|----------|-----------|----------|
-| `NOT_SIGNED` | 网站支付 | `FLOW:PC_WEB_NOT_SIGNED` | 进入 Step 4 一次性资料与资源决策（3张网站截图 + 应用决策/条件资料）→ Step 5 签约 + 应用发布 |
-| `NOT_SIGNED` | APP支付 | `FLOW:APP_NOT_SIGNED` | 进入 Step 4 一次性资料与资源决策（APP名称 + 3张APP界面截图 + 应用决策/条件资料）→ Step 5 签约 + 应用发布 |
-| `NOT_SIGNED` | 按量付费 | `FLOW:AI_PAY_NOT_SIGNED` | Step 4 无需收集页面图片，但一次完成服务/应用决策和条件资料；再进入 Step 5.1 签约 |
+| `NOT_SIGNED` | 网站支付 | `FLOW:PC_WEB_NOT_SIGNED` | 签约类别收集3张网站截图；应用类别按自身候选独立决策，两个分支分别推进 |
+| `NOT_SIGNED` | APP 支付 | `FLOW:APP_NOT_SIGNED` | 签约类别收集 APP 名称和 3 张 APP 界面截图；应用类别按自身候选独立决策，两个分支分别推进 |
+| `NOT_SIGNED` | 按量付费 | `FLOW:AI_PAY_NOT_SIGNED` | 签约无需页面图片；签约、服务和应用分别满足自身条件后独立推进 |
 | `SIGNED_EFFECTIVE` | 网站支付 | `FLOW:PC_WEB_SIGNED` | Step 4 完成应用决策后，跳过签约提交并执行应用发布 |
-| `SIGNED_EFFECTIVE` | APP支付 | `FLOW:APP_SIGNED` | Step 4 完成应用决策后，跳过签约提交并执行应用发布 |
+| `SIGNED_EFFECTIVE` | APP 支付 | `FLOW:APP_SIGNED` | Step 4 完成应用决策后，跳过签约提交并执行应用发布 |
 | `SIGNED_EFFECTIVE` | 按量付费 | `FLOW:AI_PAY_SIGNED` | Step 4 完成服务/应用决策后，跳过签约提交并执行服务注册 + 应用发布 |
 | `SIGN_SUBMITTED` | 网站支付 | `FLOW:PC_WEB_SIGNED` | Step 4 完成应用决策后，跳过重复签约提交并执行应用发布 |
-| `SIGN_SUBMITTED` | APP支付 | `FLOW:APP_SIGNED` | Step 4 完成应用决策后，跳过重复签约提交并执行应用发布 |
+| `SIGN_SUBMITTED` | APP 支付 | `FLOW:APP_SIGNED` | Step 4 完成应用决策后，跳过重复签约提交并执行应用发布 |
 | `SIGN_SUBMITTED` | 按量付费 | `FLOW:AI_PAY_SIGNED` | Step 4 完成服务/应用决策后，跳过重复签约提交并执行服务注册 + 应用发布 |
 
 **⚠️ 按量付费无需签约材料：**
 ```
-✅ 网站支付未签约：需先采集 3 张网站截图，再进入 Step 5 签约
-✅ APP支付未签约：需先采集 APP 名称和 3 张APP界面截图，再进入 Step 5 签约
-✅ 按量付费 未签约：Step 4 无需签约页面图片，但前置完成服务/应用决策和条件资料；Step 5 仍先提交签约
-✅ 按量付费在 Step 4 基于已查询的服务候选，一次收集新建/修改分支的完整五项服务资料；Step 5.2 才执行写操作
+✅ 网站支付未签约：签约类别一次收集 3 张网站截图
+✅ APP 支付未签约：签约类别一次收集 APP 名称和 3 张 APP 界面截图
+✅ 按量付费未签约：签约分支无需页面图片，不阻塞服务/应用分支的独立准备和执行
+✅ 按量付费在服务类别基于已查询候选，一次收集新建/修改分支的完整五项服务资料；Step 5.2 才执行写操作
 ```
 
-**按量付费签约后的必要后续动作：**
+**按量付费完整产品开通的独立分支：**
 ```
 ✅ 未签约且提交成功：继续服务市场注册 + 应用发布
 ✅ 已签约：跳过签约提交，继续服务市场注册 + 应用发布
-❌ 禁止：只完成产品签约就宣称按量付费入驻完成
+❌ 禁止：只完成产品签约就宣称按量付费产品开通完成
 ❌ 禁止：已签约状态下重复提交签约申请
 ```
 
@@ -85,7 +83,7 @@
 
 ## 签约提交
 
-**执行 `scripts/ar_sign_apply.sh` 提交签约申请。脚本通过 `error_handler.sh` 间接初始化 `DEV_TOOL_NAME`；产品码和类目编码优先通过 `--sales-code`、`--mcc-code` 显式传入。**
+**执行 `scripts/ar_sign_apply.sh` 提交签约申请。脚本通过 `error_handler.sh` 间接初始化 `DEV_TOOL_NAME`、`PLATFORM` 和当前 `run_id` 对应的 `PLATFORM_ID`；产品码和类目编码优先通过 `--sales-code`、`--mcc-code` 显式传入。签约状态为 `NOT_SIGNED` 且当前产品全部签约材料完整并校验通过后直接执行，不再增加回复 `1`；材料缺失或校验失败时继续使用 flow 登记的材料提示并禁止提交。**
 
 ```bash
 # 按量付费
@@ -94,20 +92,13 @@ bash scripts/ar_sign_apply.sh --product aipay --sales-code "I1080300001000160457
 # 网站支付
 bash scripts/ar_sign_apply.sh --product webpay --sales-code "I1080300001000041203" --mcc-code "<mccCode>" --picurl1 <imageRef1> --picurl2 <imageRef2> --picurl3 <imageRef3>
 
-# APP支付
+# APP 支付
 bash scripts/ar_sign_apply.sh --product apppay --sales-code "I1080300001000041313" --mcc-code "<mccCode>" --app-name "<APP名称>" --picurl1 <imageRef1> --picurl2 <imageRef2> --picurl3 <imageRef3>
 ```
 
-### 与动态表单签约流程的边界
+### 静态签约契约边界
 
-| 项目 | 当前 onboarding 签约 | 动态表单签约流程 |
-|------|----------------------|------------------------|
-| 调用模式 | 外部直调 `ar-sign.apply` | 默认先 `previewFormView`，再按动态 schema 收集并 apply |
-| 字段来源 | 本文档静态定义的三类产品字段 | `previewFormView` 返回的 `artisanPage` schema |
-| 覆盖产品 | 按量付费、网站支付、APP支付 | 由产品推荐和 schema 决定 |
-| 风险边界 | 后端新增/调整字段时，需同步更新本文档和脚本 | schema 变化会在 preview 流程中动态体现 |
-
-> 如果后端签约字段发生变化，或当前静态字段提交被 `checkedError` 拒绝，应以 `previewFormView` 返回 schema 为准补齐字段，禁止在本模块中凭经验新增未确认字段。
+当前 onboarding 只使用下方三个产品的固定字段和 `scripts/ar_sign_apply.sh` 已验证的提交结构。后端字段变化、字段校验失败或当前脚本无法处理时，必须停止受影响的签约分支并如实说明，不得凭经验增加字段、改写 payload 或尝试当前脚本未使用的方法。维护者取得实际返回或官方资料后，必须同步更新脚本、本文档、flow 和契约测试，才能恢复该分支。
 
 ### 网站支付签约 JSON（有截图）
 
@@ -134,7 +125,7 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 }
 ```
 
-### APP支付签约 JSON（有 APP 名称和截图）
+### APP 支付签约 JSON（有 APP 名称和截图）
 
 ```json
 {
@@ -159,7 +150,7 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 }
 ```
 
-> APP支付本次固定按 `appStatus=OFFLINE` 提交，不传 `appDownloadUrl`。
+> APP 支付本次固定按 `appStatus=OFFLINE` 提交，不传 `appDownloadUrl`。
 
 ### 按量付费签约 JSON（无截图）
 
@@ -185,12 +176,12 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 | 变量 | 来源 | 说明 |
 |------|------|------|
 | `bizRequestNo` | 主技能生成 | UUID，每次签约提交前通过 `python3 -c "import uuid; print(uuid.uuid4())"` 生成，**禁止省略** |
-| `mccCode` | Step 2 方案规划 | 运行时变量，格式 `Axxxx_Bxxxx`，不持久化到状态文件 |
+| `mccCode` | Step 2 方案规划 | 运行时变量，格式 `Axxxx_Bxxxx` |
 | `channelCode` | 固定值 | `"B_SK_SH_RPC"` |
 | `orderType` | 固定值 | `"NEW_SIGN"` |
-| `screenshot` | Step 4 一次性资料与资源决策 | **仅未签约的网站支付/APP支付需要**（3个上传后的图片引用值），按量付费无需此项 |
-| `appName` | Step 4 一次性资料与资源决策 | **仅未签约的 APP支付需要**；脚本参数仍为 `--app-name`，提交到 MCP 时映射为 `nativeAppDTO.name` |
-| `appStatus` | 固定值 | **仅APP支付需要**，本次固定为 `OFFLINE` |
+| `screenshot` | Step 4 签约材料类别 | **仅未签约的网站支付/APP 支付需要**（3个上传后的图片引用值），按量付费无需此项 |
+| `appName` | Step 4 签约材料类别 | **仅未签约的 APP 支付需要**；脚本参数仍为 `--app-name`，提交到 MCP 时映射为 `nativeAppDTO.name` |
+| `appStatus` | 固定值 | **仅 APP 支付需要**，本次固定为 `OFFLINE` |
 
 ### 按量付费接入产物映射
 
@@ -206,15 +197,17 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 ### ⛔ 截图字段规则
 
 ```
-✅ 网站支付未签约 → 需要 3 张网站截图（首页、商品页、支付页）
-✅ APP支付未签约 → 需要 APP 名称和 3 张APP界面截图（首页、商品页、支付页），签约状态固定按 OFFLINE 提交
+✅ 网站支付未签约 → 需要 3 张网站截图（首页、商品页、支付页；支付页是展示支付宝付款方式，等待用户去支付的页面）
+✅ APP 支付未签约 → 需要 APP 名称和 3 张 APP 界面截图（首页、商品页、支付页；支付页是展示支付宝付款方式，等待用户去支付的页面），签约状态固定按 OFFLINE 提交
 ✅ 按量付费 未签约 → 无需截图，直接签约
-✅ 网站支付/APP支付缺少支付页或支付能力 → 不提交签约；先进入/回到集成流程完成实现，再回来上传图片
-✅ 网站支付/APP支付页面和支付能力已存在、仅缺三张页面图片 → 保留在 onboarding Step 4 收集和上传，不进入集成流程
+✅ 网站支付/APP 支付缺少支付页或支付能力 → 不提交签约；签约分支保持待用户准备页面和截图，不自动切换流程
+✅ `onboarding_only` 中途发现缺少截图或支付页 → 只收口为签约材料待补充，并提醒仍需代码开发；不得修改项目、进入代码开发或声称签约失败
+✅ `full_process` 中途仍发现缺少支付页或支付能力 → 停止签约提交，回到本轮代码开发实际缺口；不得用产品开通流程补齐代码能力
+✅ 网站支付/APP 支付页面和支付能力已存在、仅缺三张页面图片 → 保留在 onboarding Step 4 收集和上传，不进入集成流程
 ❌ 禁止：按量付费 签约时传入 screenshot 字段
-❌ 禁止：网站支付/APP支付 签约时省略 screenshot 字段
+❌ 禁止：网站支付/APP 支付签约时省略 screenshot 字段
 ❌ 禁止：将“支付页”自行改口为“支付成功页”或要求用户提供文档未定义的页面
-❌ 禁止：APP支付签约 MCP payload 中使用 webAppDTO、appDTO、appName、appType、placeType=APP、placeType=ONLINE_WEBAPP、placeType=ONLINE_NATIVEAPP 或 appType=PC_WEB
+❌ 禁止：APP 支付签约 MCP payload 中使用 webAppDTO、appDTO、appName、appType、placeType=APP、placeType=ONLINE_WEBAPP、placeType=ONLINE_NATIVEAPP 或 appType=PC_WEB
 ```
 
 ### 截图字段规则
@@ -227,9 +220,9 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 
 ## 签约提交后非阻塞推进
 
-> ⚠️ **签约提交成功后，无需等待签约审核通过，应立即继续推进后续步骤。**
+> ⚠️ **签约提交成功后无需等待或轮询审核；服务和应用分支按各自条件独立推进。**
 
-签约申请提交后，后端会异步审核，`arStatus` 为 `"01"`（已提交待生效）。应用创建和服务注册不依赖签约审核通过，可以继续推进。为减少用户交互，应用/服务列表查询及分支资料采集可在签约提交前完成；当前流程仍先提交签约，成功后才执行服务或应用写操作。
+签约申请提交后，后端会异步审核，`arStatus` 为 `"01"`（已提交待生效）。应用创建和服务注册不依赖签约提交动作或签约审核结果；登录、scope、MCC 以及各分支自己的查询、材料、资源决策和适用确认满足后即可推进。调度器可以按 5.1、5.2、5.3 顺序调用，也可以并发，但不得把调用顺序描述成跨分支业务依赖。
 
 ### FLOW 信号
 
@@ -239,14 +232,15 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 |-----------|----------|----------|
 | `FLOW:AI_PAY_SIGN_CONTINUE` | 按量付费 | 立即继续 5.2 服务注册 + 5.3 应用发布 |
 | `FLOW:PC_WEB_SIGN_CONTINUE` | 网站支付 | 立即继续 5.3 应用发布 |
-| `FLOW:APP_SIGN_CONTINUE` | APP支付 | 立即继续 5.3 应用发布 |
+| `FLOW:APP_SIGN_CONTINUE` | APP 支付 | 立即继续 5.3 应用发布 |
 
 ### 处理原则
 
 ```
-✅ 签约提交成功 → 立即推进 5.2/5.3，无需等待签约审核
-✅ 按量付费：5.1 签约 → 5.2 服务注册 → 5.3 应用发布（串行推进）
-✅ 网站支付/APP支付：5.1 签约 → 5.3 应用发布（串行推进）
+✅ 签约提交成功 → 记录待生效，不轮询签约审核
+✅ 按量付费：签约、服务、应用按分支条件独立推进和记录结果
+✅ 网站支付/APP 支付：签约与应用按分支条件独立推进和记录结果
+✅ 任一分支失败不回滚或清除其他分支成功结果
 ❌ 禁止：签约提交后停住，等待签约审核通过再继续
 ❌ 禁止：轮询签约状态直到 arStatus变为"02"再继续
 ```
@@ -255,23 +249,25 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 
 ## 签约输出规范
 
-### 签约信息（含费率免责声明）
-
-当签约信息包含费率时，**必须附加免责声明**：
+签约查询或提交的对客结果固定使用 `../../normal/json/customer-messages.json` 的 `signing.operation.result`，只传实际状态、实际下一步以及接口确实返回的费率。接口返回费率时使用 `WITH_FEE` 变体，模板会在费率后紧跟固定账单免责声明；没有费率字段时使用 `WITHOUT_FEE`，禁止编造费率或自行补写另一份免责声明。必须执行：
 
-```markdown
-📋 签约信息：
-  • 签约状态：[状态]
-  • 费率：[费率值]
-
-> 由于支付宝可能会有阶段性的优惠活动，实际费率可能低于该页面费率，具体以相应费用账单为准。
+```bash
+MESSAGE_INPUT_JSON=$(jq -cn \
+  --arg actualStatus "$ACTUAL_STATUS" \
+  --arg feeDisplay "$FEE_DISPLAY" \
+  --arg nextAction "$NEXT_ACTION" \
+  '{actualStatus:$actualStatus,feeDisplay:$feeDisplay,nextAction:$nextAction}')
+printf '%s' "$MESSAGE_INPUT_JSON" \
+  | node ../../normal/scripts/render_customer_message.mjs signing.operation.result --variant WITH_FEE
+MESSAGE_INPUT_JSON=$(jq -cn \
+  --arg actualStatus "$ACTUAL_STATUS" \
+  --arg nextAction "$NEXT_ACTION" \
+  '{actualStatus:$actualStatus,nextAction:$nextAction}')
+printf '%s' "$MESSAGE_INPUT_JSON" \
+  | node ../../normal/scripts/render_customer_message.mjs signing.operation.result --variant WITHOUT_FEE
 ```
 
-**费率免责声明规则：**
-- ✅ 必须：在展示费率信息的同一区域，紧随费率信息之后添加免责声明
-- ✅ 必须：免责声明使用引用块格式（`>` 开头）突出显示
-- ❌ 禁止：单独展示费率信息而不附加免责声明
-- ℹ️ 如果签约信息中不包含费率字段，则无需添加免责声明
+待生效、失败或未知状态不得改写成签约已生效，也不得覆盖服务或应用分支的结果。
 
 ---
 
@@ -291,7 +287,7 @@ bash scripts/ar_sign_apply.sh --product apppay --sales-code "I108030000100004131
 | 场景 | 处理方式 |
 |------|----------|
 | errorCode 存在 | 展示 errorMessage，如有 bizTips 一并展示 |
-| needRetry=true | 告知用户可以重试 |
+| needRetry=true | 仍按业务错误处理；展示实际错误和 bizTips，不自动重试或立即询问“重试/退出”，业务条件修正后再重新执行受影响动作 |
 | checkedError | 提取校验错误信息，引导用户修正字段 |
 
 ### 授权信息不匹配错误