@alipay/alipay-aipay 1.5.2-beta → 1.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.5.2-beta",
+  "version": "1.5.2",
   "description": "支付宝 AI 付 Skill 安装包 - 安装 Agent Skill，并检测/后台准备 alipay-cli；jq 可通过 --with-jq 尝试准备",
   "type": "module",
   "bin": {
@@ -14,8 +14,9 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test": "node scripts/run-tests.mjs",
     "test:windows-integration": "node --test test/windows-integration-contract.test.mjs test/integration-message-runner.test.mjs test/alipay-cli-env.test.mjs",
-    "prepublishOnly": "node scripts/validate-maintenance-alignment.mjs --release && node scripts/validate-process-optimization.mjs && npm run build"
+    "prepublishOnly": "npm test && node scripts/validate-maintenance-alignment.mjs --release && node scripts/validate-process-optimization.mjs && npm run build"
   },
   "keywords": [
     "alipay",

package/skill/VERSION

@@ -1 +1 @@
-1.5.2-beta
+1.5.2

package/skill/references/integration/flow.md

@@ -185,7 +185,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message win
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message start-confirm --product-type "$PRODUCT_TYPE" --product-name "$PRODUCT_NAME" --project-path "$PROJECT_PATH" --project-selection "$PROJECT_SELECTION" --language "$SERVER_LANGUAGE" --framework "$FRAMEWORK"
 ```
 
-runner 失败时不得展示手写方案或进入步骤 3。成功时必须同时取得唯一 `ALIPAY_AIPAY_INTERNAL:PROJECT_CONFIRM_RECEIPT=<receipt>`；缺失、重复或不可解析都视为失败。stdout 是步骤 2 唯一对客消息；Agent 必须把 stdout 原文作为非阻塞消息发给用户，不能用命令面板里的 stdout、折叠输出或“已渲染/已展示”说明替代。禁止添加 `<...>` 标签、“已输出完整方案”“服务声明已打印”、重复摘要或任何前后缀。发送后不停止、不等待回复，立即执行统一 runtime 的 `flow integration development --product-type "$PRODUCT_TYPE" --project-confirm-receipt "$PROJECT_CONFIRM_RECEIPT"`。loader 返回 `PROJECT_CONFIRMATION=VALID` 才能进入步骤 3；返回 `STALE` 时 stdout 已重新渲染当前标准方案并给出新 receipt，必须原文发送后使用新 receipt 立即重试一次；连续变化说明项目事实不稳定，停在步骤 2 核对，不要求用户输入确认口令。
+runner 失败时不得展示手写方案或进入步骤 3。成功时必须同时取得唯一 `ALIPAY_AIPAY_INTERNAL:PROJECT_CONFIRM_RECEIPT=<receipt>`；缺失、重复或不可解析都视为失败。stdout 是步骤 2 唯一对客消息；Agent 必须把 stdout 原文作为非阻塞消息发给用户，不能用命令面板里的 stdout、折叠输出或“已渲染/已展示”说明替代。禁止添加 `<...>` 标签、“已输出完整方案”“服务声明已打印”、重复摘要或任何前后缀。发送后不停止、不等待回复，立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" flow integration development --product-type "$PRODUCT_TYPE" --project-confirm-receipt "$PROJECT_CONFIRM_RECEIPT"`。loader 返回 `PROJECT_CONFIRMATION=VALID` 才能进入步骤 3；返回 `STALE` 时 stdout 已重新渲染当前标准方案并给出新 receipt，必须原文发送后使用新 receipt 立即重试一次；连续变化说明项目事实不稳定，停在步骤 2 核对，不要求用户输入确认口令。
 
 - `full_process`：`../normal/full-process-routing.md` 已使用同一个 `integration.start.confirm`，在同一方案中绑定检查器产生的项目来源、代码状态和其他产品，以及产品、项目路径、语言/框架和服务声明；消息送达后已经直接通过 receipt 进入本步骤，禁止再次渲染或要求确认。该消息不展示步骤清单，也不缩减执行范围；后续仍必须按当前产品完成本 flow 的全部适用接口、完成条件和 checklist。任一方案字段变化时必须返回完整接入 router 重新扫描、渲染并自动校验新的单条方案。该方案仍禁止提前展示 MCC、授权范围、产品开通材料或 onboarding 待办。
 

package/skill/references/integration/modules/sandbox/alipay-sandbox-tool.md

@@ -39,7 +39,7 @@ alipay-cli mcp call alipay-anonymous-sandbox.createAnonymousSandbox \
 | 变量 | 来源 | 取值规则 |
 |------|------|----------|
 | `PLATFORM` | AI 编程工具识别结果 | 参考通用脚本 `../../../normal/scripts/detect_dev_tool.sh` 识别当前工具后使用其输出值；缺失时使用 `unknown`。例如 Codex 环境检测结果为 `codex` |
-| `PLATFORM_ID` | 当前流程 `run_id` | 由 `sandbox_config.sh` 通过 `common.sh` 从当前 telemetry run 读取；若宿主提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，新建 run 时 `run_id` 与该项目 ID 一致；缺失时不阻断沙箱创建 |
+| `PLATFORM_ID` | 当前流程 `run_id` | 由 `sandbox_config.sh` 通过 `common.sh` 从当前流程 run context 读取，遥测开启或关闭都不影响该值；若宿主提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，新建 run 时优先以该项目 ID 为 `run_id`；缺失时不阻断沙箱创建 |
 | `PRODUCT` | 不再传入 | 该 MCP 方法当前不需要产品上下文；不得把产品名写入 `--data` 或 CLI 环境变量 |
 
 **Codex 环境示例：**

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

@@ -166,7 +166,7 @@ source ~/.bashrc  # Linux/bash
 
 > ⚠️ **强制规范：检测结果仅供内部使用，禁止向用户输出！**
 
-AI 编程工具检测使用通用脚本 `scripts/detect_dev_tool.sh`。shell 脚本通过 `scripts/common.sh` 提供的 `init_alipay_cli_context` 初始化 `DEV_TOOL_NAME`、`PLATFORM` 和 `PLATFORM_ID`；其中 `PLATFORM_ID` 取当前 telemetry `run_id`，用于把同一流程的 Skill 时间戳事件和 alipay-cli 上报关联起来。Onboarding 在产品确认后还通过同一公共脚本把 `aipay|webpay|apppay` 严格映射为 CLI 环境变量 `PRODUCT=AIPAY|WEBPAY|APPPAY`，所有环境检查、登录、查询、写入和文件上传调用都必须携带当前值；该字段不进入 MCP 请求 JSON。Integration 的产品确定前环境检查和快速沙箱仍不传 `PRODUCT`。若宿主环境提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，telemetry 新建 run 时直接使用该项目 ID 作为 `run_id`，脚本也会将同一值作为 `PLATFORM_ID`。文档示例或非 shell 流程可直接参考 `detect_dev_tool.sh` 的输出。
+AI 编程工具检测使用通用脚本 `scripts/detect_dev_tool.sh`。shell 脚本通过 `scripts/common.sh` 提供的 `init_alipay_cli_context` 初始化 `DEV_TOOL_NAME`、`PLATFORM` 和 `PLATFORM_ID`；其中 `PLATFORM_ID` 取当前流程 `run_id`，用于关联同一流程，遥测开启或关闭都不影响该值。Onboarding 在产品确认后还通过同一公共脚本把 `aipay|webpay|apppay` 严格映射为 CLI 环境变量 `PRODUCT=AIPAY|WEBPAY|APPPAY`，所有环境检查、登录、查询、写入和文件上传调用都必须携带当前值；该字段不进入 MCP 请求 JSON。Integration 的产品确定前环境检查和快速沙箱仍不传 `PRODUCT`。若宿主环境提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，新建 run 时优先使用该项目 ID 作为 `run_id`，脚本也会将同一值作为 `PLATFORM_ID`。文档示例或非 shell 流程可直接参考 `detect_dev_tool.sh` 的输出。
 
 ```
 ❌ 禁止：向用户输出"环境检查完成，检测到您正在使用 Claude Code 环境"等检测结果

package/skill/references/normal/full-process-routing.md

@@ -68,7 +68,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" integration-message sta
 
 上面命令失败时不得展示手写确认或进入子流程。成功时必须同时保存唯一 `ALIPAY_AIPAY_INTERNAL:PROJECT_CONFIRM_RECEIPT=<receipt>`；缺失、重复或不可解析视为失败。参数必须是当前确定值，禁止直接拼用户输入。runner 校验产品 variant 并固定服务声明；实际范围仍取当前 Integration flow 和 checklist。
 
-分流、展示和交接事实必须来自 runner 内同一次 `scan` 对象；禁止用描述、Agent 自报或历史分类代替。`evidence` 仅内部校验，不进 renderer；Onboarding Step 1 前禁止传/猜 `mccCode`。方案同时满足 `INT.START.PLAN_DELIVERED` 与 `INT.SERVICE_STATEMENT.DELIVERED` 后，执行统一 runtime 的 `flow integration development --product-type "$PRODUCT_TYPE" --project-confirm-receipt "$PROJECT_CONFIRM_RECEIPT"`。只有内部 `PROJECT_CONFIRMATION=VALID` 才进入步骤 3；`STALE` 时 loader stdout 已重新渲染当前标准方案，必须原文发送并用新 receipt 立即重试一次，连续变化则停止核对。loader 在原位置记录兼容 stage 和预开发阅读 stage，禁止手工执行 telemetry；receipt 有效时禁止再次渲染 `integration.start.confirm`。
+分流、展示和交接事实必须来自 runner 内同一次 `scan` 对象；禁止用描述、Agent 自报或历史分类代替。`evidence` 仅内部校验，不进 renderer；Onboarding Step 1 前禁止传/猜 `mccCode`。方案同时满足 `INT.START.PLAN_DELIVERED` 与 `INT.SERVICE_STATEMENT.DELIVERED` 后，执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" flow integration development --product-type "$PRODUCT_TYPE" --project-confirm-receipt "$PROJECT_CONFIRM_RECEIPT"`。只有内部 `PROJECT_CONFIRMATION=VALID` 才进入步骤 3；`STALE` 时 loader stdout 已重新渲染当前标准方案，必须原文发送并用新 receipt 立即重试一次，连续变化则停止核对。loader 在原位置记录兼容 stage 和预开发阅读 stage，禁止手工执行 telemetry；receipt 有效时禁止再次渲染 `integration.start.confirm`。
 
 合法组合必须确定产品、路径/来源、代码状态、语言/框架、服务声明和顺序；发现其他产品时保留。零散信息、`新建` 选择、未选候选或新项目未准备均不能替代完整机器校验。方案送达并通过 receipt 校验后仍完整执行 Integration 和 checklist。
 

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

@@ -449,7 +449,7 @@ export function emitStageMetricAsync(stage, context = {}, env = process.env) {
 export function emitMessageMetric(messageId, variantName, variables = {}, context = {}) {
   try {
     const event = messageMetricEvent(messageId, variantName, variables, context);
-    if (event?.stage === 'run.terminal' && telemetryEnabled()) updateExistingRunStateFromEvent(event);
+    if (event?.stage === 'run.terminal') updateExistingRunStateFromEvent(event);
     return emitMetricEvent(event, { stream: null });
   } catch {
     return false;
@@ -458,7 +458,6 @@ export function emitMessageMetric(messageId, variantName, variables = {}, contex
 
 export function emitTerminalMetric(context = {}) {
   try {
-    if (!telemetryEnabled()) return false;
     const event = stageMetricEvent('run.terminal', context);
     if (!event) return false;
     updateExistingRunStateFromEvent(event);
@@ -1251,6 +1250,32 @@ function emitTelemetryError(error) {
 export async function runTelemetryCli(argv = process.argv) {
   try {
     const { command, args } = parseCliArgs(argv);
+    if (command === 'start-run') {
+      assertCliArgs(args, new Set(['root-intent', 'product-type', 'run-id']), 0);
+      const state = createOrReuseRunState(args);
+      if (!writeRunState(state) && telemetryEnabled(process.env)) {
+        recordLocalTelemetryFailure('LOCAL_RUN_STATE_WRITE_FAILED', 'failed to write local telemetry run state');
+      }
+      if (telemetryEnabled(process.env)) {
+        const event = stageMetricEvent('run.intent_detected', {
+          runId: state.run_id,
+          rootIntent: state.root_intent,
+          productType: state.product_type
+        });
+        emitMetricEvent(event);
+      }
+      return 0;
+    }
+    if (command === 'current-run-id') {
+      assertCliArgs(args, new Set(), 0);
+      const state = canReadImplicitRunState(process.env) ? readRunState(process.env) : null;
+      if (state?.run_id) {
+        process.stderr.write(`${internalPrefix}RUN_ID=${state.run_id}\n`);
+      } else {
+        process.stderr.write(`${internalPrefix}RUN_ID_MISSING=true\n`);
+      }
+      return 0;
+    }
     if (command === 'upload-status' && args._.length === 0) {
       assertCliArgs(args, new Set(), 0);
       const status = readUploadStatus(process.env) || { schema_ver: 1, status: 'unknown' };
@@ -1280,30 +1305,6 @@ export async function runTelemetryCli(argv = process.argv) {
       return 0;
     }
     if (!telemetryEnabled(process.env)) return 0;
-    if (command === 'start-run') {
-      assertCliArgs(args, new Set(['root-intent', 'product-type', 'run-id']), 0);
-      const state = createOrReuseRunState(args);
-      if (!writeRunState(state)) {
-        recordLocalTelemetryFailure('LOCAL_RUN_STATE_WRITE_FAILED', 'failed to write local telemetry run state');
-      }
-      const event = stageMetricEvent('run.intent_detected', {
-        runId: state.run_id,
-        rootIntent: state.root_intent,
-        productType: state.product_type
-      });
-      emitMetricEvent(event);
-      return 0;
-    }
-    if (command === 'current-run-id') {
-      assertCliArgs(args, new Set(), 0);
-      const state = canReadImplicitRunState(process.env) ? readRunState(process.env) : null;
-      if (state?.run_id) {
-        process.stderr.write(`${internalPrefix}RUN_ID=${state.run_id}\n`);
-      } else {
-        process.stderr.write(`${internalPrefix}RUN_ID_MISSING=true\n`);
-      }
-      return 0;
-    }
     if (command !== 'stage' || args._.length !== 1) {
       emitTelemetryError(new Error('invalid telemetry arguments'));
       return 0;

package/skill/references/normal/telemetry.md

@@ -5,17 +5,17 @@
 ## 运行契约
 
 - 固定 stage 枚举、Yuyan 字段和低敏维度以 `scripts/telemetry.mjs` 的 `approvedStages`、事件构造器和测试为准。
-- `start-run` 创建或复用 `run_id`；动作 runner/script 使用异步子进程记录 stage。缺少 run、遥测关闭、落盘失败、网络失败和非 2xx 都不得改变业务 stdout、退出语义或 flow 转移。
+- `start-run` 始终创建或复用当前流程 `run_id`；该私有 run context 是 alipay-cli `PLATFORM_ID` 和终态生命周期的运行事实，不依赖事件采集开关。动作 runner/script 在遥测开启时使用异步子进程记录 stage。缺少 run、遥测关闭、落盘失败、网络失败和非 2xx 都不得改变业务 stdout、退出语义或 flow 转移。
 - 前台只写用户系统临时目录下带 `alipay-aipay` 标识的私有 outbox，并启动后台补传；collector 返回 HTTP 2xx 后才删除记录。维护/测试进程不复用默认 run state，默认不远端上传。
-- `PLATFORM_ID` 必须等于当前 `run_id`；模型维度只读 `AIPAY_MODEL`，禁止读取用户项目通用 `MODEL` 推断。
+- `PLATFORM_ID` 必须等于当前流程 `run_id`，遥测开关不得令其缺失或改变；模型维度只读 `AIPAY_MODEL`，禁止读取用户项目通用 `MODEL` 推断。
 - 遥测内部行统一使用 `ALIPAY_AIPAY_INTERNAL:` 前缀，禁止对客。
 
 ## Run 生命周期
 
 - 根入口用 `root_intent + product_type` 判定复用或新建；组合不变时不按经过时长失效，`UNKNOWN` 补全为明确产品仍复用同一 `run_id`。只有明确换产品、切换根意图或已有 run 终态才重建；用户只说“重新开始/重新走流程/作废本轮流程”但组合没有变化时继续复用。
-- 若宿主提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，新建 run 直接使用该项目 ID。当前宿主项目 ID 与已有状态不兼容时静默跳过不兼容事件且不改写 run state。
+- 若宿主提供 `COZE_PROJECT_ID`、`MEOO_PROJECT_ID`，或 `MIAODA` 环境下的 `VITE_APP_ID`/`PLATFORM_ID`，新建 run 优先使用该项目 ID，不得被显式 run ID 或本地生成值覆盖。当前宿主项目 ID 与已有状态不兼容时静默跳过不兼容事件且不改写 run state。
 - `integration_only` 由 checklist 最终消息终止；`full_process` 的 Integration 收口不终止，和 `onboarding_only` 一样由 Onboarding closeout 终止。
-- 查看当前主键只使用 `current-run-id`，不得为查看而新建 run。业务脚本继续继承 `PLATFORM_ID=<run_id>`；Agent 不手写环境变量前缀或改写 MCP payload。
+- 查看当前主键只使用 `current-run-id`，不得为查看而新建 run。关闭遥测只停止 `METRIC_EVENT`、outbox、上传和 flush，不停止 run context 的创建、读取与终态记账；业务脚本继续继承 `PLATFORM_ID=<run_id>`。Agent 不手写环境变量前缀或改写 MCP payload。
 
 ## 诊断与补传
 

package/skill/references/runtime-entry.md

@@ -46,9 +46,9 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" render <messageId> --va
 
 `onboarding_only` 或 `full_process` 衔接 Onboarding 时先执行 flow 登记的 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" onboarding-message platform-entry`：Windows 只发送登记引导并停止 Skill 内产品开通；非 Windows stdout 为空并继续。门禁早于产品/MCC、方案和环境检查，不手写或重复。
 
-识别根意图后立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry start-run --root-intent <integration_only|onboarding_only|full_process>`；产品已唯一确定时追加 `--product-type <aipay|webpay|apppay>`。命令记录 `run.intent_detected` 并创建/复用 `run_id`：同一意图和产品继续复用，`UNKNOWN` 补全产品仍复用同一 `run_id`；明确换产品、换根意图或既有 run 已终态才重建，宿主项目 ID 可固定为 `run_id`。业务 stage 只由登记 runner/script 异步记录。
+识别根意图后立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry start-run --root-intent <integration_only|onboarding_only|full_process>`；产品已唯一确定时追加 `--product-type <aipay|webpay|apppay>`。命令创建/复用当前流程 `run_id`，并在遥测开启时记录 `run.intent_detected`：同一意图和产品继续复用，`UNKNOWN` 补全产品仍复用同一 `run_id`；明确换产品、换根意图或既有 run 已终态才重建。第三方平台项目 ID 仍优先固定为 `run_id`，不得被显式 run ID 或本地生成值覆盖。业务 stage 只由登记 runner/script 异步记录。
 
-遥测默认开启，`ALIPAY_AIPAY_TELEMETRY=0|false|off|no` 可关闭；落盘/网络/上传/flush 失败静默，不改变业务、消息或确认，stdout 为空且 stderr 内部行不对客。`integration_only` 由 checklist 终态结束 run，其他意图由 Onboarding closeout 结束。脚本以 `run_id` 为 `PLATFORM_ID`，Agent 不手写环境前缀或改 MCP payload；维护诊断、outbox、上传和 flush 细节只在 `normal/telemetry.md` 按需读取。
+遥测默认开启，`ALIPAY_AIPAY_TELEMETRY=0|false|off|no` 可关闭 `METRIC_EVENT`、outbox、上传和 flush；私有流程 run context 仍用于 `PLATFORM_ID` 和终态生命周期。落盘/网络/上传/flush 失败静默，不改变业务、消息或确认，stdout 为空且 stderr 内部行不对客。`integration_only` 由 checklist 终态结束 run，其他意图由 Onboarding closeout 结束。脚本始终以当前流程 `run_id` 为 `PLATFORM_ID`，Agent 不手写环境前缀或改 MCP payload；维护诊断、outbox、上传和 flush 细节只在 `normal/telemetry.md` 按需读取。
 
 三种入口均只在无法从已有产品名称或业务描述可靠确定唯一产品时执行 flow 登记的 `product-clarify` runner；不得推定或手写澄清。产品明确但 MCC 尚无检索输入时使用 `mcc-clarify`；已有经营描述后统一使用 `mcc-resolve-plan`，不得拆回 `mcc-search + mcc-candidates` 或为方案展示再拼 renderer 输入。