@alipay/alipay-aipay 1.2.2 → 1.4.9

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

@@ -0,0 +1,179 @@
+{
+  "schemaVersion": 1,
+  "rules": [
+    {
+      "policyId": "P-MCP-CONTRACT-FROZEN",
+      "scope": "all",
+      "severity": "critical",
+      "text": "只执行当前 Skill 已验证脚本中的 MCP 方法、参数和解析；禁止推断、改名、替换或尝试近似方法。"
+    },
+    {
+      "policyId": "P-AUTH-BEFORE-ONBOARDING",
+      "scope": "onboarding",
+      "severity": "critical",
+      "text": "登录、scope 和 MCC 全部校验通过前，禁止执行任何 onboarding 查询或写操作。"
+    },
+    {
+      "policyId": "P-WRITE-CONFIRM",
+      "scope": "onboarding.write",
+      "severity": "critical",
+      "text": "签约材料完整且校验通过后直接执行签约提交，不再增加回复1；材料缺失或校验失败时继续使用受控材料提示，禁止提交。服务创建资料完整且校验通过后展示受控创建摘要并直接执行，不增加回复1；服务修改执行前必须展示当前会话、脱敏主体、产品、动作和目标摘要，并取得绑定当前摘要的明确确认。应用创建由用户针对当前应用候选列表明确选择新建来确认，候选重查未变化且条件字段齐备时不再追加回复1；用户提供应用公钥后生成确认页不重复确认，由用户在官方页面完成公钥确认；新建应用的公钥校验成功后直接提交应用审核，不再增加回复1。"
+    },
+    {
+      "policyId": "P-WRITE-UNKNOWN",
+      "scope": "onboarding.write",
+      "severity": "critical",
+      "text": "非幂等写操作结果不明时先用现有只读能力核验；无法确认时进入 UNKNOWN，禁止盲目重试。"
+    },
+    {
+      "policyId": "P-PARTIAL-RESULT",
+      "scope": "onboarding",
+      "severity": "critical",
+      "text": "签约、服务和应用分支独立记录结果，不回滚已成功动作，不用整体失败或整体成功覆盖部分结果。"
+    },
+    {
+      "policyId": "P-MATERIAL-CATEGORY",
+      "scope": "onboarding.materials",
+      "severity": "required",
+      "text": "每轮只展示一个材料类别，同类一次收齐；提前提供的后续材料直接接收并校验，之后不重复索取。"
+    },
+    {
+      "policyId": "P-KEY-NO-PRIVATE",
+      "scope": "onboarding.application",
+      "severity": "critical",
+      "text": "不得请求、读取、处理、保存或输出生产应用私钥；本轮不提供本地命令生成密钥能力。"
+    },
+    {
+      "policyId": "P-KEY-PUBLIC-USER",
+      "scope": "onboarding.application",
+      "severity": "critical",
+      "text": "应用公钥只能由用户自行生成并明确提供；缺少公钥时禁止调用 createKeyConfirmPage，不补全、不改写、不加 PEM 头尾。"
+    },
+    {
+      "policyId": "P-AUTH-URL",
+      "scope": "onboarding.authorization",
+      "severity": "critical",
+      "text": "授权链接只能由 auth.sh 在固定产品/MCC 上下文校验通过后构造；只允许 https://aipay.alipay.com/cli-auth、deviceCode/productCode/mccCode 和可选 platform，禁止其他域名、路径、参数、重复参数、fragment 或 verification_url。"
+    },
+    {
+      "policyId": "P-KEY-URL",
+      "scope": "onboarding.application",
+      "severity": "critical",
+      "text": "公钥确认只展示 createKeyConfirmPage 返回的 confirmPageUrl 裸 URL；禁止展示二维码链接和 alipays:// 深链。"
+    },
+    {
+      "policyId": "P-URL-AUTO-OPEN",
+      "scope": "official-url",
+      "severity": "critical",
+      "text": "授权页和公钥确认页在 URL 完整校验通过后默认调用受控 opener；失败、无 GUI 或宿主要求权限时保留同一裸 URL 和复制访问兜底。"
+    },
+    {
+      "policyId": "P-KEY-TOOL-DOWNLOAD",
+      "scope": "onboarding.application",
+      "severity": "critical",
+      "text": "缺少应用公钥时按当前操作系统自动下载官方密钥工具并输出实际安装包路径、安装引导和官方文档兜底；只下载，不安装、不启动、不生成密钥，失败或系统不支持时只输出官方文档手动下载引导。"
+    },
+    {
+      "policyId": "P-A2M-SANDBOX",
+      "scope": "integration.aipay",
+      "severity": "critical",
+      "text": "按量付费沙箱 serviceId 固定为 api_mock_service_id，SDK 使用沙箱网关；生产网关和真实 serviceId 只用于正式配置。"
+    },
+    {
+      "policyId": "P-A2M-SUCCESS",
+      "scope": "integration.aipay",
+      "severity": "critical",
+      "text": "自动联调只有在 HTTP 200、非空可归属资源、无明确业务失败且适用 Payment-Validation 有效时通过。"
+    },
+    {
+      "policyId": "P-SANDBOX-CREDENTIAL-EXCEPTION",
+      "scope": "integration.sandbox",
+      "severity": "critical",
+      "text": "Unix/macOS/Linux 只允许快速沙箱实际返回且已校验的买家登录/支付密码在沙箱摘要和付款体验中经 stdin 临时渲染。Windows 手工沙箱允许用户在 sandbox.windows.manual_setup 后提供当前沙箱应用的 APPID、支付宝公钥、应用公钥、与当前开发语言匹配的应用私钥和沙箱账号信息；Agent 只能将其用于已确认目标项目的受保护配置，不得在回复、摘要、普通日志或业务状态中复述或另存原文。两类例外均不得扩展到生产环境账号、应用私钥或密码。"
+    },
+    {
+      "policyId": "P-SENSITIVE-STATE",
+      "scope": "all",
+      "severity": "critical",
+      "text": "用户可以为当前应用设钥明确提供应用公钥，但该输入只用于本次 app.sh key/verify-key/verify-key-and-audit 调用；Agent 回复、对话摘要、普通日志、跨会话状态和宽权限临时文件禁止复述或保存公钥原文。除 P-SANDBOX-CREDENTIAL-EXCEPTION 明确允许的 Windows 手工沙箱当前资料输入外，私钥、token、Payment-Proof、签名串、完整支付表单和未脱敏 MCP 响应同样禁止进入这些位置。临时 URL 只有在 flow 明确登记、已由脚本或 renderer 完成白名单及当前上下文校验且当前动作必须对客展示时，才允许进入该动作的唯一对客正文；即使获准展示，也禁止进入对话摘要、普通日志、跨会话状态或宽权限临时文件。"
+    },
+    {
+      "policyId": "P-PROJECT-PROTECT",
+      "scope": "integration",
+      "severity": "critical",
+      "text": "不得清空、覆盖或删除用户既有项目；只在已确认目标路径和范围内做必要修改。"
+    },
+    {
+      "policyId": "P-CUSTOMER-OUTPUT-EXCLUSIVE",
+      "scope": "all",
+      "severity": "critical",
+      "text": "flow 指定 renderer 或托管脚本时，其 stdout 是该动作唯一对客正文；工具输出记录、折叠面板或日志不等于已对客发送，Agent 必须把 stdout 原文作为当前回复正文发给用户。禁止在前后添加执行说明、消息 ID、控制标记、摘要、转述或近似话术。阻塞消息发出后立即停止本轮并等待用户。"
+    },
+    {
+      "policyId": "P-ONBOARDING-CONTROL-CHANNEL",
+      "scope": "onboarding",
+      "severity": "critical",
+      "text": "Onboarding 登记脚本的内部事实行统一以 ALIPAY_AIPAY_INTERNAL: 开头；即使宿主合并 stdout/stderr，也必须整行剔除后再判断对客正文。内部行严禁对客；成功且剔除内部行后正文为空时直接转移，不补写话术。"
+    },
+    {
+      "policyId": "P-SCAN-PAGE-DELIVERY-BARRIER",
+      "scope": "onboarding",
+      "severity": "critical",
+      "text": "所有 `postRenderHintType=scanReturn` 的页面消息都是交付屏障，当前包括 `auth.page` 和 `application.key.page`。脚本产生页面 stdout 后，Agent 必须先把剔除内部事实后的 stdout 作为独立对客消息送达，再执行对应 opener 和后续有限轮询；不得把后续 `auth.pending`、`application.key.pending`、`process.partial_result` 或其他 stdout 合并在同一条对客回复中。该屏障不等待用户确认，不新增回复 `1` 或其他用户操作。"
+    },
+    {
+      "policyId": "P-DETERMINISTIC-HANDOFF",
+      "scope": "all",
+      "severity": "critical",
+      "text": "flow 已登记脚本或 renderer 时只执行动作发生位置的固定命令；退出码和登记终态标记满足后立即按 flow 转移，禁止追加 jq、cat、grep、curl 或临时脚本重复解析、复核或解释同一结果。失败只走登记恢复分支；项目代码实现和运行验证除外，但不得把沙箱配置或其他敏感文件打印到工具输出。"
+    }
+  ],
+  "officialUrls": {
+    "aipaySite": "https://aipay.alipay.com/",
+    "aipaySkillSite": "https://aipay.alipay.com/?from=alipay-aipay-skill",
+    "merchantPlatform": "https://b.alipay.com/page/portal/home",
+    "openPlatform": "https://open.alipay.com/",
+    "openPlatformHome": "https://open.alipay.com",
+    "technicalSupport": "https://opensupport.alipay.com/support/intelligent-services?form=payskill",
+    "keyToolManual": "https://opendocs.alipay.com/isv/02kipk",
+    "keyToolMac": "https://ideservice.alipay.com/ide/getPluginUrl.htm?clientType=assistant&platform=mac&channelType=WEB",
+    "keyToolWindows": "https://ideservice.alipay.com/ide/getPluginUrl.htm?clientType=assistant&platform=win&channelType=WEB",
+    "androidSandboxAlipay": "https://mdn.alipayobjects.com/sandboxsys/afts/img/_itHRrdOD9oAAAAAAAAAAAAADgSLAQBr/original",
+    "sandboxToolFallback": "https://open.alipay.com/develop/sandbox/tool",
+    "sandboxGateway": "https://openapi-sandbox.dl.alipaydev.com/gateway.do",
+    "productionGateway": "https://openapi.alipay.com/gateway.do",
+    "openPlatformPaySkill": "https://open.alipay.com?form=payskill",
+    "traditionalPaymentSkill": "https://github.com/alipay/ai/tree/main/skills"
+  },
+  "authorizationProducts": [
+    {
+      "productName": "按量付费",
+      "salesCode": "I1080300001000160457",
+      "scope": "app:all,machine_pay:write,agmnt:write"
+    },
+    {
+      "productName": "网站支付",
+      "salesCode": "I1080300001000041203",
+      "scope": "app:all,fast_instant_trade_pay:write"
+    },
+    {
+      "productName": "APP 支付",
+      "salesCode": "I1080300001000041313",
+      "scope": "app:all,auth_alipay_apppay:write"
+    }
+  ],
+  "temporaryUrlAllowlist": {
+    "authorization": {
+      "host": "aipay.alipay.com",
+      "path": "/cli-auth",
+      "requiredQueryParams": ["deviceCode", "productCode", "mccCode"],
+      "optionalQueryParams": ["platform"]
+    },
+    "publicKeyConfirmation": {
+      "host": "aipay.alipay.com",
+      "path": "/public-key-confirm",
+      "requiredQueryParams": ["keyConfirmToken"],
+      "optionalQueryParams": []
+    }
+  }
+}

package/skill/references/normal/rejection-guide.md

@@ -1,16 +1,20 @@
 # 拒绝引导话术
 
 > 本文件定义当用户咨询本 Skill 不支持的支付产品时的标准引导话术。
+> 本文件位于 `references/normal/`，文中的 `scripts/...` 路径相对本目录。
 
 ---
 
 ## 标准拒绝引导
 
-当用户提及以下不支持的产品时，必须使用以下统一话术：
+当用户提及以下不支持的产品时，使用 `json/customer-messages.json` 的 `product.unsupported`，传入用户实际产品名。必须执行：
 
-> 抱歉，本 Skill 仅支持按量付费、网站支付、APP支付三种产品。
-> - 如需了解其他支付产品，请查阅 [支付宝开放平台在线文档](https://open.alipay.com?form=payskill)
-> - 如需集成传统支付产品（JSAPI、当面付、订单码、预授权、商家扣款等），可下载 [alipay-payment-integration Skill](https://github.com/alipay/ai/tree/main/skills) 进行接入
+```bash
+MESSAGE_INPUT_JSON=$(jq -cn --arg productName "$PRODUCT_NAME" '{productName:$productName}')
+printf '%s' "$MESSAGE_INPUT_JSON" | node scripts/render_customer_message.mjs product.unsupported --variant DEFAULT
+```
+
+支持范围、开放平台文档、传统支付集成 Skill 和商家平台链接只在消息目录维护；本文件不复制标准正文。
 
 ---
 
@@ -22,6 +26,7 @@
 | 商家扣款 | 使用标准引导 |
 | 订单码支付 | 使用标准引导 |
 | 当面付 | 使用标准引导 |
+| 付款码 | 使用标准引导 |
 | JSAPI支付 | 使用标准引导 |
 
 > “手机网站支付”“H5支付”只是用户对手机浏览器网页场景的叫法，在本 Skill 中统一归为**网站支付**，不作为独立产品处理，也不使用拒绝话术。
@@ -31,7 +36,7 @@
 ## 调用位置
 
 本话术在以下位置被引用：
-- `SKILL.md` → 意图识别 → 拒绝处理
+- `SKILL.md` → 支持范围
 - `../integration/modules/product-decision.md` → 不支持的产品
 
-**重要**：如需修改引导内容，**仅需修改本文件**，其他引用位置会自动生效。
+**重要**：如需修改对客文字或链接，只修改 `json/customer-messages.json` 与对应 `json/policy-rules.json` 官方 URL；本文件只维护适用语义。

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

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import process from 'node:process';
+
+import { checkCliEnvironment, isWindowsPlatform } from './platform_compat.mjs';
+
+function main() {
+  if (process.argv[2] !== 'check' || process.argv.length !== 3) {
+    console.error('用法: node alipay_cli_env.mjs check');
+    process.exitCode = 1;
+    return;
+  }
+
+  const windows = isWindowsPlatform();
+  const missing = checkCliEnvironment({
+    requireJq: !windows,
+    requireAlipayCli: !windows
+  });
+
+  if (missing.length === 0) {
+    console.log('CLI_ENV:READY');
+    return;
+  }
+
+  console.log('CLI_ENV:NEEDS_SETUP');
+  console.log(`CLI_ENV_MISSING=${missing.join(',')}`);
+}
+
+main();

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

@@ -0,0 +1,21 @@
+#!/bin/bash
+
+set -u
+
+if [ "${1:-}" != "check" ] || [ "$#" -ne 1 ]; then
+  echo "用法: bash alipay_cli_env.sh check" >&2
+  exit 1
+fi
+
+MISSING=()
+command -v node >/dev/null 2>&1 || MISSING+=("node")
+command -v jq >/dev/null 2>&1 || MISSING+=("jq")
+if ! command -v alipay-cli >/dev/null 2>&1 || ! alipay-cli version >/dev/null 2>&1; then
+  MISSING+=("alipay-cli")
+fi
+
+if [ "${#MISSING[@]}" -eq 0 ]; then
+  echo "CLI_ENV:READY"
+else
+  printf 'CLI_ENV:NEEDS_SETUP\nCLI_ENV_MISSING=%s\n' "$(IFS=,; echo "${MISSING[*]}")"
+fi

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

@@ -12,6 +12,24 @@ require_command() {
   fi
 }
 
+emit_control() {
+  printf 'ALIPAY_AIPAY_INTERNAL:%s\n' "$*" >&2
+}
+
+validate_control_value() {
+  local value="${1:-}"
+  [ -n "$value" ] || return 1
+  ! printf '%s' "$value" | LC_ALL=C grep -q '[[:cntrl:]]'
+}
+
+emit_control_field() {
+  local name="${1:-}"
+  local value="${2:-}"
+  [[ "$name" =~ ^[A-Z][A-Z0-9_]*$ ]] || return 1
+  validate_control_value "$value" || return 1
+  printf 'ALIPAY_AIPAY_INTERNAL:%s=%s\n' "$name" "$value" >&2
+}
+
 init_dev_tool_name() {
   if [ -n "${DEV_TOOL_NAME:-}" ] && [ "$DEV_TOOL_NAME" != "unknown" ]; then
     export DEV_TOOL_NAME
@@ -30,3 +48,72 @@ init_dev_tool_name() {
 
   export DEV_TOOL_NAME="${DEV_TOOL_NAME:-unknown}"
 }
+
+platform_project_id() {
+  local candidate
+
+  candidate="${COZE_PROJECT_ID:-${MEOO_PROJECT_ID:-}}"
+  if valid_platform_id "$candidate"; then
+    printf '%s' "$candidate"
+    return 0
+  fi
+
+  if [ -n "${MIAODA:-}" ]; then
+    candidate="${VITE_APP_ID:-${PLATFORM_ID:-}}"
+    if valid_platform_id "$candidate"; then
+      printf '%s' "$candidate"
+      return 0
+    fi
+  fi
+
+  return 1
+}
+
+valid_platform_id() {
+  local value="${1:-}"
+  [ -n "$value" ] || return 1
+  printf '%s' "$value" | LC_ALL=C grep -q '[^[:space:]]' || return 1
+  ! printf '%s' "$value" | LC_ALL=C grep -q '[[:cntrl:],^=]'
+}
+
+init_platform_id() {
+  local candidate marker COMMON_DIR TELEMETRY_SCRIPT
+
+  candidate="$(platform_project_id || true)"
+  if valid_platform_id "$candidate"; then
+    PLATFORM_ID="$candidate"
+    export PLATFORM_ID
+    return
+  fi
+
+  candidate="${ALIPAY_AIPAY_RUN_ID:-${ALIPAY_AIPAY_FLOW_RUN_ID:-}}"
+  if valid_platform_id "$candidate"; then
+    PLATFORM_ID="$candidate"
+    export PLATFORM_ID
+    return
+  fi
+
+  COMMON_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  TELEMETRY_SCRIPT="${COMMON_DIR}/telemetry.mjs"
+  if [ ! -f "$TELEMETRY_SCRIPT" ] || ! command -v node >/dev/null 2>&1; then
+    return
+  fi
+
+  marker="$(node "$TELEMETRY_SCRIPT" current-run-id 2>&1 >/dev/null || true)"
+  candidate="$(printf '%s\n' "$marker" | sed -n 's/^ALIPAY_AIPAY_INTERNAL:RUN_ID=//p' | head -n 1)"
+  if valid_platform_id "$candidate"; then
+    PLATFORM_ID="$candidate"
+    export PLATFORM_ID
+    return
+  fi
+
+  if valid_platform_id "${PLATFORM_ID:-}"; then
+    export PLATFORM_ID
+  fi
+}
+
+init_alipay_cli_context() {
+  init_dev_tool_name
+  init_platform_id
+  export PLATFORM="${DEV_TOOL_NAME:-unknown}"
+}

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

@@ -4,7 +4,7 @@
 # 功能描述: 智能识别 AI 编程工具，返回工具名称
 # 调用位置: 集成流程和签约流程的环境检查
 # 调用前置: 无
-# 返回值: coze | meoo | claudeCode | codex | traeSolo | cursor | qoder | unknown
+# 返回值: coze | meoo | miaoda | claudeCode | codex | traeSolo | cursor | qoder | unknown
 #=============================================================================
 
 detect_dev_tool() {
@@ -16,6 +16,10 @@ detect_dev_tool() {
         echo "meoo"
         return
     fi
+    if [ -n "$MIAODA" ]; then
+        echo "miaoda"
+        return
+    fi
     if [ -n "$CLAUDECODE" ] || [ -n "$CLAUDE_CODE_ENTRYPOINT" ]; then
         echo "claudeCode"
         return