@alipay/alipay-aipay 1.6.1-beta.2 → 1.6.1-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.6.1-beta.2",
+  "version": "1.6.1-beta.3",
   "description": "支付宝 AI 付 Skill 安装包 - 优先安装 Agent Skill，并在 macOS/Linux 后台准备用户级 CLI 工具",
   "type": "module",
   "bin": {

package/skill/VERSION

@@ -1 +1 @@
-1.6.1-beta.2
+1.6.1-beta.3

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

@@ -10,7 +10,7 @@ import { fileURLToPath } from 'node:url';
 
 import { isWindowsPlatform } from './platform_compat.mjs';
 import { renderMessage } from './render_customer_message.mjs';
-import { emitTerminalMetric } from './telemetry.mjs';
+import { emitTerminalMetric, terminalMetricContextFromArgs } from './telemetry.mjs';
 
 const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const inspectorPath = path.join(scriptDir, 'project_route_inspector.sh');
@@ -1231,7 +1231,7 @@ function runProductClarify() {
 function runProductUnsupported(args) {
   return renderMessage('product.unsupported', 'DEFAULT', {
     productName: required(args, 'product-name')
-  });
+  }, terminalMetricContextFromArgs(args));
 }
 
 function runWindowsSandboxSetup() {
@@ -1357,7 +1357,7 @@ async function runChecklistResult(args) {
   }
   const rendered = renderMessage('integration.checklist.result', variant, input);
   if (input.executionMode === '仅代码开发') {
-    emitTerminalMetric({ rootIntent: 'integration_only', productType: variant });
+    emitTerminalMetric({ rootIntent: 'integration_only', productType: variant, ...terminalMetricContextFromArgs(args) });
   }
   return rendered;
 }

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

@@ -6,7 +6,12 @@ import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { isWindowsPlatform } from './platform_compat.mjs';
 import { buildWindowsOnboardingRedirectUrl, loadMccRecords, renderMessage } from './render_customer_message.mjs';
-import { currentRunContext, emitStageMetricAsync, emitTerminalMetric } from './telemetry.mjs';
+import {
+  currentRunContext,
+  emitStageMetricAsync,
+  emitTerminalMetric,
+  terminalMetricContextFromArgs
+} from './telemetry.mjs';
 
 const internalPrefix = 'ALIPAY_AIPAY_INTERNAL:';
 const productTypes = {
@@ -120,6 +125,10 @@ function required(args, name) {
   return value;
 }
 
+function optional(args, name) {
+  return typeof args[name] === 'string' && args[name].length > 0 ? args[name] : undefined;
+}
+
 function productFor(args) {
   const productType = required(args, 'product-type');
   const mapping = productTypes[productType];
@@ -140,7 +149,7 @@ async function readStdin() {
   return input.trim() ? JSON.parse(input) : {};
 }
 
-function runPlatformEntry() {
+function runPlatformEntry(args = {}) {
   if (!isWindowsPlatform()) return '';
   const runContext = currentRunContext();
   if (!runContext || runContext.terminal || !['onboarding_only', 'full_process'].includes(runContext.root_intent)) {
@@ -148,12 +157,7 @@ function runPlatformEntry() {
   }
   return renderMessage('onboarding.windows.redirect', 'DEFAULT', {
     officialUrl: buildWindowsOnboardingRedirectUrl(runContext.run_id)
-  });
-}
-
-function optional(args, name) {
-  const value = args[name];
-  return typeof value === 'string' && value.length > 0 ? value : undefined;
+  }, terminalMetricContextFromArgs(args));
 }
 
 function parseJsonArg(args, name, label) {
@@ -174,7 +178,7 @@ function runEnterpriseUnsupported(args) {
   if (!['ONBOARDING_ONLY', 'FULL_PROCESS'].includes(variant)) {
     throw new Error('variant 非法，仅支持 ONBOARDING_ONLY、FULL_PROCESS');
   }
-  return renderMessage('onboarding.enterprise.unsupported', variant, {});
+  return renderMessage('onboarding.enterprise.unsupported', variant, {}, terminalMetricContextFromArgs(args));
 }
 
 async function runMccClarify(args) {
@@ -747,7 +751,7 @@ function closeoutInputFromArgs(args) {
 async function runCloseout(args) {
   const variables = closeoutInputFromArgs(args);
   const rendered = renderMessage('process.partial_result', 'DEFAULT', variables);
-  emitTerminalMetric({ productName: variables.productName });
+  emitTerminalMetric({ productName: variables.productName, ...terminalMetricContextFromArgs(args) });
   return rendered;
 }
 
@@ -826,7 +830,7 @@ function runApplicationResult(args) {
 export async function runOnboardingMessageCli(argv = process.argv) {
   const { command, args } = parseArgs(argv);
   if (command === 'platform-entry') {
-    const message = runPlatformEntry();
+    const message = runPlatformEntry(args);
     if (message) console.log(message);
     return;
   }

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

@@ -126,6 +126,12 @@ function assertEnumOption(options, name, allowedValues, { required = true } = {}
   return value;
 }
 
+function appendOptionalTerminalCountOptions(targetArgs, options) {
+  for (const name of ['user-input-count-total', 'user-input-count-after-flow-start', 'flow-start-observed']) {
+    if (Object.prototype.hasOwnProperty.call(options, name)) targetArgs.push(`--${name}`, requiredOption(options, name));
+  }
+}
+
 async function startTelemetryRun(rootIntent, productType) {
   const telemetryArgs = ['start-run', '--root-intent', rootIntent];
   if (productType) telemetryArgs.push('--product-type', productType);
@@ -145,12 +151,20 @@ async function runIntegrationBootstrap(args) {
 
 async function runOnboardingBootstrap(args) {
   const options = parseRuntimeArgs(args);
-  assertOnlyOptions(options, ['root-intent', 'product-type']);
+  assertOnlyOptions(options, [
+    'root-intent',
+    'product-type',
+    'user-input-count-total',
+    'user-input-count-after-flow-start',
+    'flow-start-observed'
+  ]);
   const rootIntent = assertEnumOption(options, 'root-intent', ['onboarding_only']);
   const productType = assertEnumOption(options, 'product-type', ['aipay', 'webpay', 'apppay'], { required: false });
   await startTelemetryRun(rootIntent, productType);
   const { runOnboardingMessageCli } = await import('./onboarding_message_runner.mjs');
-  await runOnboardingMessageCli(cliArgv(['platform-entry']));
+  const platformEntryArgs = ['platform-entry'];
+  appendOptionalTerminalCountOptions(platformEntryArgs, options);
+  await runOnboardingMessageCli(cliArgv(platformEntryArgs));
   const { isWindowsPlatform } = await import('./platform_compat.mjs');
   if (isWindowsPlatform()) return;
   const { runFlowCli } = await import('./flow_loader.mjs');

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

@@ -375,6 +375,51 @@ function productTypeFrom({ ruleProductType, variantName, variables = {}, context
   return 'UNKNOWN';
 }
 
+function parseNonNegativeInteger(value) {
+  if (typeof value === 'number') return Number.isSafeInteger(value) && value >= 0 ? value : null;
+  if (typeof value !== 'string' || !/^(?:0|[1-9]\d*)$/.test(value)) return null;
+  const parsed = Number(value);
+  return Number.isSafeInteger(parsed) ? parsed : null;
+}
+
+function parseBooleanFlag(value) {
+  if (typeof value === 'boolean') return value;
+  if (typeof value !== 'string') return null;
+  const normalized = normalizeSwitch(value);
+  if (normalized === 'true' || normalized === '1') return true;
+  if (normalized === 'false' || normalized === '0') return false;
+  return null;
+}
+
+function terminalExtInfoFromPayload(payload = {}) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return '';
+  const total = parseNonNegativeInteger(payload.userInputCountTotal ?? payload.user_input_count_total);
+  const afterFlowStart = parseNonNegativeInteger(
+    payload.userInputCountAfterFlowStart ?? payload.user_input_count_after_flow_start
+  );
+  const flowStartObserved = parseBooleanFlag(payload.flowStartObserved ?? payload.flow_start_observed);
+  if (total === null || afterFlowStart === null || flowStartObserved === null) return '';
+  if (afterFlowStart > total) return '';
+  if (!flowStartObserved && afterFlowStart !== 0) return '';
+  return JSON.stringify({
+    user_input_count_total: total,
+    user_input_count_after_flow_start: afterFlowStart,
+    flow_start_observed: flowStartObserved
+  });
+}
+
+function terminalExtInfoFromEvent(event) {
+  if (event?.stage !== 'run.terminal') return '';
+  if (typeof event.ext_info === 'string') {
+    try {
+      return terminalExtInfoFromPayload(JSON.parse(event.ext_info));
+    } catch {
+      return '';
+    }
+  }
+  return terminalExtInfoFromPayload(event?.ext_info);
+}
+
 export function stageMetricEvent(stage, context = {}, nowMs = Date.now(), env = process.env) {
   const rule = stageRules.get(stage);
   if (!rule) return null;
@@ -398,6 +443,10 @@ export function stageMetricEvent(stage, context = {}, nowMs = Date.now(), env =
   if (!canonicalProductTypes.has(event.product_type)) event.product_type = 'UNKNOWN';
   const rootIntent = rootIntentFrom(context, env);
   if (rootIntent) event.root_intent = rootIntent;
+  if (event.stage === 'run.terminal') {
+    const extInfo = terminalExtInfoFromPayload(context);
+    if (extInfo) event.ext_info = extInfo;
+  }
   return event;
 }
 
@@ -508,12 +557,25 @@ function parseCliArgs(argv) {
   return { command, args };
 }
 
+export function terminalMetricContextFromArgs(args) {
+  const optional = (name) => {
+    const value = args[name];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+  };
+  return {
+    userInputCountTotal: optional('user-input-count-total'),
+    userInputCountAfterFlowStart: optional('user-input-count-after-flow-start'),
+    flowStartObserved: optional('flow-start-observed')
+  };
+}
+
 function contextFromCliArgs(args) {
   return {
     runId: args['run-id'],
     rootIntent: args['root-intent'],
     productType: args['product-type'],
-    productName: args['product-name']
+    productName: args['product-name'],
+    ...terminalMetricContextFromArgs(args)
   };
 }
 
@@ -762,19 +824,22 @@ function monitorEnv(env = process.env) {
 export function buildSyncLogReport(event, env = process.env) {
   if (!event) return null;
   const skillVersion = skillVersionFromDisk();
+  const item = {
+    code: syncLogCode,
+    msg: syncLogMsg,
+    d1: normalizeOS(),
+    d2: platformFromEnv(env),
+    d3: modelFromEnv(env),
+    d4: skillVersion,
+    d5: event.product_type || 'UNKNOWN',
+    c1: event.run_id,
+    c2: event.stage,
+    c3: event.timestamp
+  };
+  const terminalExtInfo = terminalExtInfoFromEvent(event);
+  if (terminalExtInfo) item.c4 = terminalExtInfo;
   return {
-    item: {
-      code: syncLogCode,
-      msg: syncLogMsg,
-      d1: normalizeOS(),
-      d2: platformFromEnv(env),
-      d3: modelFromEnv(env),
-      d4: skillVersion,
-      d5: event.product_type || 'UNKNOWN',
-      c1: event.run_id,
-      c2: event.stage,
-      c3: event.timestamp
-    },
+    item,
     options: {
       Env: monitorEnv(env),
       SprintID: skillVersion,
@@ -1332,7 +1397,16 @@ export async function runTelemetryCli(argv = process.argv) {
       emitTelemetryError(new Error('invalid telemetry arguments'));
       return 0;
     }
-    assertCliArgs(args, new Set(['run-id', 'root-intent', 'product-type', 'product-name', 'timestamp-ms']), 1);
+    assertCliArgs(args, new Set([
+      'run-id',
+      'root-intent',
+      'product-type',
+      'product-name',
+      'timestamp-ms',
+      'user-input-count-total',
+      'user-input-count-after-flow-start',
+      'flow-start-observed'
+    ]), 1);
     const event = stageMetricEvent(args._[0], contextFromCliArgs(args), timestampFromCliArgs(args));
     if (event) updateExistingRunStateFromEvent(event);
     emitMetricEvent(event);

package/skill/references/normal/self-update.md

@@ -1,27 +1,13 @@
 # Skill 启动器自更新契约
 
-`SKILL.md` 是最小启动器。首次使用 `alipay-aipay` 时，必须在读取入口、flow、模块、消息目录或业务脚本前检查一次版本：解析根目录为规范化绝对路径 `<SKILL_DIR>`，在当前对话记录 `ALIPAY_AIPAY_SELF_UPDATE_CHECKED=true`，后续确认、恢复、中断或 Full Process 衔接均不重查。该事实不落盘、不跨对话，也不是业务进度。执行：
+首次使用 `alipay-aipay` 时，必须在读取入口、flow、模块、消息目录或业务脚本前检查一次版本，并记录 `ALIPAY_AIPAY_SELF_UPDATE_CHECKED=true`：
 
 ```text
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" self-update check --skill-dir "<SKILL_DIR>"
 ```
 
-`<SKILL_DIR>` 必须是当前这份包含 updater 的 Skill 规范化绝对路径，不得换成启动目录、项目目录、Home、npm 源码根或其他副本。命令不得改成变量赋值、命令替换、相对路径或特定 shell 语法；`VERSION` 或 `references/runtime-entry.md` 缺失不改变该绑定，由检查器进入精确修复。
+`<SKILL_DIR>` 必须是当前这份包含 updater 的 Skill 规范化绝对路径，不得换成启动目录、项目目录、Home、npm 源码根或其他副本。命令不得改成变量赋值、命令替换、相对路径或特定 shell 语法；不透传 npm/npx 原始输出。
 
-stderr 必须恰有一个下列 `SELF_UPDATE:*` 内部终态；不对客，不透传 npm/npx 原始输出。
+唯一 stderr 终态：`SELF_UPDATE:CURRENT=<合法 SemVer>`、`SELF_UPDATE:UPDATED=<合法 SemVer>`、`SELF_UPDATE:RETRY_WITH_NETWORK`、`SELF_UPDATE:SKIPPED_NETWORK_RESTRICTED`、`SELF_UPDATE:CHECK_FAILED`、`SELF_UPDATE:INSTALL_FAILED`、`SELF_UPDATE:VERIFY_FAILED`。
 
-| marker | 含义与动作 |
-|---|---|
-| `SELF_UPDATE:CURRENT=<合法 SemVer>` | 当前版本不低于 npm latest；读取当前入口。 |
-| `SELF_UPDATE:UPDATED=<合法 SemVer>` | 已达目标版本；停止读旧版，读取同一根目录的新版入口。 |
-| `SELF_UPDATE:RETRY_WITH_NETWORK` | registry 查询或安装网络失败；取权后原样重试一次。 |
-| `SELF_UPDATE:SKIPPED_NETWORK_RESTRICTED` | 宿主显式标记联网受限，跳过 npm 查询并读当前入口。 |
-| `SELF_UPDATE:CHECK_FAILED` | 当前目录绑定、入口参数、npm 结果解析或本地包管理器检查失败；读取仍可用的当前入口。 |
-| `SELF_UPDATE:INSTALL_FAILED` | 安装失败或超时且未验证到目标版本；读当前入口。 |
-| `SELF_UPDATE:VERIFY_FAILED` | 安装返回成功但版本未达标或仍不合法；读当前入口。 |
-
-- 所有结果保留一次性事实。仅 `RETRY_WITH_NETWORK` 可取权后原样重试一次；拒绝、不支持或再次返回时读当前入口。`UPDATED` 使用原子替换后的新版，其余使用当前可用版。marker 缺失、重复或不唯一也读当前入口，不得称最新或更新成功。
-- 每次检查只查询一次 npm latest（最多 5 秒）。本地 `VERSION` 合法且不低于 latest 时直接 `CURRENT`；`VERSION` 缺失、非法、落后或业务入口缺失时，只运行一次查询所得精确版本的隐藏安装入口（最多 60 秒），原子覆盖当前 Skill 目录并重读 `VERSION`，达标才输出 `UPDATED`。
-- 自更新不调用公开 `install --target all`，不读取普通 Agent 批量目标，也不通过分隔列表传递路径。用户显式执行 `npx -y @alipay/alipay-aipay@latest install` 时仍按既有规则安装到 Home 下全部已存在的 `.agents/.codex/.claude` 根目录；均不存在时回退 `~/.agents/skills`。
-- npm/npx 超时会终止同一次调用的进程树，再按本次私有事务恢复完整新版本或原当前目录并清理 staging/backup；进程树结束前不返回 marker，也不允许网络恢复重试。
-- 失败 fail-open 且对客静默。上述一次网络恢复外，不重查、取权、用 `sudo`、要求用户操作或写更新状态；版本确定后才初始化遥测、平台门禁和业务流程。
+`UPDATED` 使用原子替换后的新版，其余使用当前可用版；marker 缺失、重复或不唯一时读当前入口，不得称最新或更新成功。`UPDATED` 后停止读旧版，读取同一根目录的新版入口；仅 `RETRY_WITH_NETWORK` 可取权后原样重试一次，拒绝、不支持或再次返回时读当前入口。上述一次网络恢复外，不重查、取权、用 `sudo`、要求用户操作或写更新状态。每次只查一次 npm latest；`VERSION` 缺失、非法、落后或业务入口缺失时只安装精确版本一次。不调用公开 `install --target all`；超时会终止同一次调用的进程树并恢复清理。

package/skill/references/normal/telemetry.md

@@ -1,27 +1,6 @@
-# 遥测维护参考
-
-本文件只供维护、测试和故障排查按需读取；业务运行默认只执行 `runtime-entry.md` 与动作 runner/script 登记的入口。
-
-## 运行契约
-
-- 固定 stage 枚举、Yuyan 字段和低敏维度以 `scripts/telemetry.mjs` 的 `approvedStages`、事件构造器和测试为准。
-- `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，默认不远端上传。
-- Benchmark 只能使用 `ALIPAY_AIPAY_TELEMETRY_CAPTURE_ONLY=1` 把 stage 写入每个样本的隔离 outbox；该模式不调度 uploader，`telemetryUploadEnabled`、`flushOutbox` 和权限补传判定均固定禁用远端上传。这些记录只用于当前本地性能样本，不得进入生产补传队列。
-- `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，不得被显式 run ID 或本地生成值覆盖。当前宿主项目 ID 与已有状态不兼容时静默跳过不兼容事件且不改写 run state。
-- `integration_only` 由 checklist 最终消息终止；`full_process` 的 Integration 收口不终止。`onboarding_only|full_process` 由 Onboarding closeout、企业账号不支持或 Windows 站点引导消息终止。
-- 查看当前主键只使用 `current-run-id`，不得为查看而新建 run。关闭遥测只停止 `METRIC_EVENT`、outbox、上传和 flush，不停止 run context 的创建、读取与终态记账；业务脚本继续继承 `PLATFORM_ID=<run_id>`。Agent 不手写环境变量前缀或改写 MCP payload。
-
-## 诊断与补传
-
-`node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry upload-status` 只读取内部诊断状态。网络类失败且 outbox 有积压时，先执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry permissioned-flush-needed`；只有内部事实为 `PERMISSIONED_FLUSH_NEEDED=true` 时才申请一次可复用联网权限运行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry flush-outbox`。同一 Agent 会话只请求一次；已取得权限后可在后续阶段旁路触发同一异步命令。`flush-outbox` 只启动后台补传并立即返回；用户拒绝、后台失败或非 2xx 都保留 outbox 并继续业务。collector HTTP 结果、失败或待重试结果不得作为业务转移或完成条件。
-
-## 修改要求
-
-修改 stage、run 生命周期、outbox 或上传逻辑时，必须覆盖遥测关闭、缺少 run、写盘失败、无网络、非 2xx、并发 claim、终态 run 和 `PLATFORM_ID` 继承测试。不得把实现细节复制回 `runtime-entry.md` 或两个主 flow。
+- stage、Yuyan 字段和低敏维度以 `scripts/telemetry.mjs` 与测试为准。遥测关闭、缺少 run、落盘/网络/上传失败或非 2xx 不得改变业务 stdout、退出语义或 flow 转移；内部行用 `ALIPAY_AIPAY_INTERNAL:`。
+- `start-run` 创建或复用当前 `run_id`；业务脚本继承 `PLATFORM_ID=<run_id>`，Agent 不手写环境变量前缀或改 MCP payload。outbox 只写用户系统临时目录，collector HTTP 2xx 后才删。维护/测试进程不复用默认 run state，默认不远端上传。Benchmark 只能用 `ALIPAY_AIPAY_TELEMETRY_CAPTURE_ONLY=1` 写样本隔离 outbox；该模式不调度 uploader，`telemetryUploadEnabled`、`flushOutbox` 和权限补传判定禁用远端上传。
+- 根入口用 `root_intent + product_type` 判定复用或新建；组合不变时不按时长失效，`UNKNOWN` 补全为明确产品仍复用同一 `run_id`。只有明确换产品、切换根意图或已有 run 终态才重建；用户只说“重新开始/重新走流程/作废本轮流程”但组合未变时继续复用。`COZE_PROJECT_ID`、`MEOO_PROJECT_ID`、`MIAODA` 下的 `VITE_APP_ID`/`PLATFORM_ID` 优先作为新 run ID。
+- `integration_only` 由 checklist 最终消息终止；`full_process` 的 Integration 收口不终止。`onboarding_only|full_process` 由 Onboarding closeout、企业账号不支持或 Windows 站点引导消息终止。查看主键只用 `current-run-id`，不得为查看而新建 run。
+- Agent 在当前上下文计数：`user_input_count_total` 从触发当前 `run_id` 的用户消息开始；`user_input_count_after_flow_start` 从进入 `integration.user_confirmed` 或 `onboarding.user_confirmed` 后的下一条用户消息开始；`flow_start_observed` 表示已进入正式 flow start，`full_process` 不因进入 Onboarding 重置。只计用户发给 Agent 的消息；用户直接 kill 且没有执行 `run.terminal` 时不补报。终态命令只追加 `--user-input-count-total`、`--user-input-count-after-flow-start`、`--flow-start-observed`；不得新增工具调用、确认点、stage 或独立上报。`run.terminal` 的 Yuyan `c4` 字段名为 `ext_info`，三项合法时写 minified JSON；非法、缺失、`after_flow_start > total` 或 `flow_start_observed=false` 但 after-flow 非 0 时省略 `c4`。
+- `telemetry upload-status` 只读内部诊断。网络类失败且 outbox 有积压时，先执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry permissioned-flush-needed`；只有内部事实为 `PERMISSIONED_FLUSH_NEEDED=true` 时才申请一次可复用联网权限运行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry flush-outbox`，同一 Agent 会话只请求一次。`flush-outbox` 只启动后台补传并立即返回；用户拒绝、后台失败或非 2xx 都保留 outbox 并继续业务。collector HTTP 结果、失败或待重试结果不得作为业务转移或完成条件。

package/skill/references/runtime-entry.md

@@ -48,7 +48,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" render <messageId> --va
 
 `full_process` 识别根意图后立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry start-run --root-intent full_process`；产品已唯一确定时追加 `--product-type <aipay|webpay|apppay>`。`integration_only` 和 `onboarding_only` 已由上表各自 bootstrap 包含同一次 `start-run`，不得重复执行本条 telemetry。命令创建/复用当前流程 `run_id`，并在遥测开启时记录 `run.intent_detected`：同一意图和产品继续复用，`UNKNOWN` 补全产品仍复用同一 `run_id`；明确换产品、换根意图或既有 run 已终态才重建。第三方平台项目 ID 仍优先固定为 `run_id`，不得被显式 run ID 或本地生成值覆盖。业务 stage 只由登记 runner/script 异步记录。
 
-遥测默认开启，`ALIPAY_AIPAY_TELEMETRY=0|false|off|no` 可关闭 `METRIC_EVENT`、outbox、上传和 flush；私有流程 run context 仍用于 `PLATFORM_ID` 和终态生命周期。落盘/网络/上传/flush 失败静默，不改变业务、消息或确认，stdout 为空且 stderr 内部行不对客。`integration_only` 由 checklist 终结；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 终结；Onboarding 由 closeout 或登记的提前终止消息终结。Agent 按 `normal/telemetry.md` 维护本轮用户输入计数，并只在终态命令追加可选参数，不新增工具调用、确认点或独立上报。脚本始终以当前流程 `run_id` 为 `PLATFORM_ID`，Agent 不手写环境前缀或改 MCP payload；维护诊断、outbox、上传和 flush 细节只在 `normal/telemetry.md` 按需读取。
 
 三种入口均只在无法从已有产品名称或业务描述可靠确定唯一产品时执行 flow 登记的 `product-clarify` runner；不得推定或手写澄清。产品明确但 MCC 尚无检索输入时使用 `mcc-clarify`；已有经营描述后先按 Onboarding flow 读取一次当前 `<SKILL_DIR>/references/onboarding/modules/mcc-reference.md` 做 Agent 语义候选，再统一调用 `mcc-resolve-plan` 由 runner 复核、合并和渲染；用户直接提供当前表内完整 MCC 编码时可跳过 Agent 泛化并由 runner 精确校验。不得拆回 `mcc-search + mcc-candidates`、先旧检索失败后临时猜测，或为方案展示再拼 renderer 输入。