@alipay/alipay-aipay 1.6.9-beta → 1.6.9-beta2

package/package.json

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

package/skill/VERSION

@@ -1 +1 @@
-1.6.9-beta
+1.6.9-beta2

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

@@ -1,7 +1,16 @@
+const MAX_PLATFORM_LENGTH = 40;
+const ASCII_PLATFORM_RE = /^[a-z0-9.]{1,40}$/u;
+
 export function normalizeAgentPlatform(value) {
-  const normalized = String(value || '').trim().toLowerCase().replace(/[_\s-]/gu, '');
+  const normalizedInput = String(value || '').normalize('NFKC');
+  if (/\p{C}/u.test(normalizedInput)) return 'unknown';
+  const raw = normalizedInput.trim();
+  if (!raw || [...raw].length > MAX_PLATFORM_LENGTH || /[\\/:@?#%]/u.test(raw)) return 'unknown';
+
+  const normalized = raw.toLowerCase().replace(/[_\s-]/gu, '');
   if (normalized === 'claude') return 'claudecode';
-  return /^[a-z0-9.]{1,40}$/u.test(normalized) ? normalized : 'unknown';
+  if (ASCII_PLATFORM_RE.test(normalized)) return normalized;
+  return /[\p{L}\p{M}\p{N}]/u.test(raw) ? raw : 'unknown';
 }
 
 // Consume host context before dispatch so Node runners and Shell children share it.

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

@@ -162,22 +162,30 @@ emit_control_field() {
 }
 
 init_dev_tool_name() {
-  if [ -n "${DEV_TOOL_NAME:-}" ] && [ "$DEV_TOOL_NAME" != "unknown" ]; then
-    export DEV_TOOL_NAME
-    return
-  fi
-
+  local EXISTING_DEV_TOOL_NAME="${DEV_TOOL_NAME:-}"
+  local AGENT_PLATFORM="${ALIPAY_AIPAY_AGENT_PLATFORM:-}"
   local COMMON_DIR
   COMMON_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
   local DETECT_SCRIPT="${COMMON_DIR}/detect_dev_tool.sh"
+  local DETECTED_DEV_TOOL_NAME="unknown"
 
   if [ -f "$DETECT_SCRIPT" ]; then
     # shellcheck source=/dev/null
     source "$DETECT_SCRIPT"
-    DEV_TOOL_NAME="$(detect_dev_tool 2>/dev/null || echo unknown)"
+    if { [ -n "$AGENT_PLATFORM" ] && [ "$AGENT_PLATFORM" != "unknown" ]; } \
+      || { [ -z "$EXISTING_DEV_TOOL_NAME" ] || [ "$EXISTING_DEV_TOOL_NAME" = "unknown" ]; }; then
+      DETECTED_DEV_TOOL_NAME="$(detect_dev_tool 2>/dev/null || echo unknown)"
+    fi
   fi
 
-  export DEV_TOOL_NAME="${DEV_TOOL_NAME:-unknown}"
+  if [ -n "$DETECTED_DEV_TOOL_NAME" ] && [ "$DETECTED_DEV_TOOL_NAME" != "unknown" ]; then
+    DEV_TOOL_NAME="$DETECTED_DEV_TOOL_NAME"
+  elif [ -n "$EXISTING_DEV_TOOL_NAME" ] && [ "$EXISTING_DEV_TOOL_NAME" != "unknown" ]; then
+    DEV_TOOL_NAME="$EXISTING_DEV_TOOL_NAME"
+  else
+    DEV_TOOL_NAME="unknown"
+  fi
+  export DEV_TOOL_NAME
 }
 
 init_root_intent_context() {

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

@@ -28,6 +28,10 @@ detect_dev_tool() {
         echo "codex"
         return
     fi
+    if [ -n "$OPENCLAW_SESSION_ID" ] || [ -n "$OPENCLAW_AGENT_ID" ]; then
+        echo "openclaw"
+        return
+    fi
     if [ -n "$TRAE_BRAND_NAME" ]; then
         echo "traeSolo"
         return
@@ -40,9 +44,11 @@ detect_dev_tool() {
         echo "qoder"
         return
     fi
-    # The gateway supplies a normalized host identity from the Agent context.
-    if [[ "${ALIPAY_AIPAY_AGENT_PLATFORM:-}" =~ ^[a-z0-9.]{1,40}$ ]]; then
-        echo "$ALIPAY_AIPAY_AGENT_PLATFORM"
+    # The gateway supplies a validated, readable host identity from the Agent context.
+    local agent_platform="${ALIPAY_AIPAY_AGENT_PLATFORM:-}"
+    if [ -n "$agent_platform" ] && [ "$agent_platform" != "unknown" ] \
+        && [[ ! "$agent_platform" =~ [[:cntrl:]/\\:@?#%] ]]; then
+        echo "$agent_platform"
         return
     fi
     echo "unknown"

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

@@ -203,7 +203,8 @@ function shouldCloseRunAfterStage(event, state = {}) {
   return false;
 }
 
-const outboxRecordFields = new Set(['schema_ver', 'created_at', 'event']);
+const outboxV1RecordFields = new Set(['schema_ver', 'created_at', 'event']);
+const outboxV2RecordFields = new Set(['schema_ver', 'created_at', 'platform', 'event']);
 const metricEventFields = new Set([
   'schema_ver',
   'event_id',
@@ -509,8 +510,9 @@ function writeOutboxRecord(event, env = process.env) {
     const filename = outboxFilename(normalizedEvent);
     const finalPath = path.join(dir, filename);
     if (!writePrivateJson(finalPath, {
-      schema_ver: 1,
+      schema_ver: 2,
       created_at: Date.now(),
+      platform: platformFromEnv(env),
       event: normalizedEvent
     })) return '';
     pruneOutbox(env);
@@ -922,10 +924,6 @@ function normalizeOS(platform = process.platform) {
 }
 
 export function platformFromEnv(env = process.env) {
-  for (const key of ['ALIPAY_AIPAY_PLATFORM', 'AIPAY_AGENT_TYPE', 'DEV_TOOL_NAME', 'PLATFORM']) {
-    const platform = normalizePlatform(env[key]);
-    if (platform !== 'unknown') return platform;
-  }
   if (env.CLAUDE_CODE_SESSION_ID || env.CLAUDE_SESSION_ID || env.CLAUDECODE || env.CLAUDE_CODE_ENTRYPOINT) return 'claudecode';
   if (env.OPENCLAW_SESSION_ID || env.OPENCLAW_AGENT_ID) return 'openclaw';
   if (env.CURSOR_TRACE_ID || env.CURSOR_SESSION_ID || env.CURSOR_AGENT || env.CURSOR_LAYOUT) return 'cursor';
@@ -935,7 +933,13 @@ export function platformFromEnv(env = process.env) {
   if (env.CODEX_CI || env.CODEX_THREAD_ID || env.CODEX_SESSION_ID || env.CODEX_SANDBOX_NETWORK_DISABLED !== undefined) return 'codex';
   if (env.TRAE_BRAND_NAME) return 'traesolo';
   if (env.QODER_CLI) return 'qoder';
-  return normalizePlatform(env.ALIPAY_AIPAY_AGENT_PLATFORM);
+  const agentPlatform = normalizePlatform(env.ALIPAY_AIPAY_AGENT_PLATFORM);
+  if (agentPlatform !== 'unknown') return agentPlatform;
+  for (const key of ['ALIPAY_AIPAY_PLATFORM', 'AIPAY_AGENT_TYPE', 'DEV_TOOL_NAME', 'PLATFORM']) {
+    const platform = normalizePlatform(env[key]);
+    if (platform !== 'unknown') return platform;
+  }
+  return 'unknown';
 }
 
 function modelFromEnv(env = process.env) {
@@ -1092,7 +1096,7 @@ function normalizeMetricEvent(event) {
   return normalized;
 }
 
-export function buildSyncLogReport(event, env = process.env) {
+export function buildSyncLogReport(event, env = process.env, dimensions = {}) {
   const normalizedEvent = normalizeMetricEvent(event);
   if (!normalizedEvent) return null;
   const skillVersion = skillVersionFromEvent(normalizedEvent);
@@ -1100,7 +1104,9 @@ export function buildSyncLogReport(event, env = process.env) {
     code: syncLogCode,
     msg: syncLogMsg,
     d1: normalizeOS(),
-    d2: platformFromEnv(env),
+    d2: Object.prototype.hasOwnProperty.call(dimensions, 'platform')
+      ? normalizePlatform(dimensions.platform)
+      : platformFromEnv(env),
     d3: modelFromEnv(env),
     d4: skillVersion,
     d5: normalizedEvent.product_type || 'UNKNOWN',
@@ -1369,11 +1375,23 @@ function outboxTargetFilePending(file) {
 function readOutboxRecord(file) {
   try {
     const record = JSON.parse(fs.readFileSync(file, 'utf8'));
-    if (!hasOnlyFields(record, outboxRecordFields) || record.schema_ver !== 1) return null;
+    if (record?.schema_ver === 1) {
+      if (!hasOnlyFields(record, outboxV1RecordFields)) return null;
+    } else if (record?.schema_ver === 2) {
+      if (!hasOnlyFields(record, outboxV2RecordFields)) return null;
+      if (typeof record.platform !== 'string' || normalizePlatform(record.platform) !== record.platform) return null;
+    } else {
+      return null;
+    }
     if (!Number.isSafeInteger(record.created_at) || record.created_at <= 0) return null;
     const event = normalizeMetricEvent(record.event);
     if (!event) return null;
-    return { schema_ver: 1, created_at: record.created_at, event };
+    return {
+      schema_ver: record.schema_ver,
+      created_at: record.created_at,
+      ...(record.schema_ver === 2 ? { platform: record.platform } : {}),
+      event
+    };
   } catch {
     return null;
   }
@@ -1471,7 +1489,11 @@ export async function flushOutbox(env = process.env, {
       } catch {}
       continue;
     }
-    const report = buildSyncLogReport(record.event, env);
+    const report = buildSyncLogReport(
+      record.event,
+      env,
+      record.schema_ver === 2 ? { platform: record.platform } : {}
+    );
     if (!report) {
       result.invalid += 1;
       try {

package/skill/references/normal/telemetry.md

@@ -48,7 +48,7 @@ runtime 校验 active run、显式 `run_id`、clarify 已记录、stage 路线
 
 `c4/ext_info` 只允许 `user_input_after_clarify_intent`、`history_count`、`root_intent` 和 `progress_pct`。正式计数固定读取 event 生成锁内的 `counter_count`；不重复上传 `counter_count`。event 固定后，后续消息只影响后续 stage，不修改旧 event/c4。禁上传用户原文、input ID、文件名、路径、URL、密钥、账号、订单、截图、材料、授权信息、工具输出或堆栈原文。
 
-Yuyan 外层字段中的 `d1/d2/d3` 分别表示操作系统、宿主平台和模型。`d2` 先检查既有有效平台环境变量和自动识别信号，跳过 `unknown`/非法值；仍无法识别时使用 Agent 根据当前宿主身份随每条 runtime 命令传入的 `--agent-platform`（如 `WorkBuddy` 归一为 `workbuddy`），最后才为 `unknown`。gateway 将该上下文传给 Node 和 Shell 子进程，业务 CLI 的工具检测器也在自动识别失败时消费同一兜底，不写跨会话状态。模型只从显式模型上下文读取：优先 `ALIPAY_AIPAY_MODEL`，兼容 `AIPAY_MODEL`；runtime 将具体变体归一为 `gpt-5`、`gpt-4`、`claude`、`gemini`、`qwen`、`deepseek` 或 `llama` 等粗粒度家族。没有宿主模型字段或无法识别时使用 `unknown`，不得根据宿主平台名称臆测模型。Skill 脚本无法读取对话系统内部的模型上下文，宿主或 Agent 需要在调用 runtime 前提供该字段。
+Yuyan 外层字段中的 `d1/d2/d3` 分别表示操作系统、宿主平台和模型。`d2` 优先使用当前宿主的明确自动识别信号，仍无法识别时使用 Agent 根据当前宿主身份随每条 runtime 命令传入的 `--agent-platform`；继承的通用平台变量只作为末级兼容值，不得遮蔽当前宿主。所有来源都跳过 `unknown`/非法值。该兜底不使用宿主名称枚举或映射表：ASCII 名称按既有规则归一，合法 Unicode 名称保留可读原文，最后才为 `unknown`。stage 进入 outbox 时固定当时的 `d2`，后续延迟上传或从其他宿主 flush 不得改变原事件归因；旧版 outbox 记录没有该快照时才按当前环境兼容生成。gateway 将该上下文传给 Node 和 Shell 子进程，业务 CLI 的工具检测器也按同一优先级消费，不写跨会话状态。模型只从显式模型上下文读取：优先 `ALIPAY_AIPAY_MODEL`，兼容 `AIPAY_MODEL`；runtime 将具体变体归一为 `gpt-5`、`gpt-4`、`claude`、`gemini`、`qwen`、`deepseek` 或 `llama` 等粗粒度家族。没有宿主模型字段或无法识别时使用 `unknown`，不得根据宿主平台名称臆测模型。Skill 脚本无法读取对话系统内部的模型上下文，宿主或 Agent 需要在调用 runtime 前提供该字段。
 
 ## 进度与上传
 

package/skill/references/onboarding/flow.md

@@ -181,7 +181,7 @@ Step 1 的产品/MCC 唯一事实校验和方案送达、Step 2 的环境 READY
    ├─ AUTH_FLOW:RETRY_WITH_LOCAL_FS_PERMISSION → 取得 CLI 私有状态目录权限后原样重试本命令一次
    ├─ AUTH_FLOW:LOGOUT_STILL_LOGGED_IN → 自动 mismatch 的 logout 后置条件未成立，按第 4 项同名分支停止
    └─ AUTH_FLOW:FAILED / 初始 mismatch 输出不满足唯一空 stdout 契约 → 停止并按错误输出恢复，禁止进入 Step 3.1
-2. 仅 AUTH_FLOW:READY_TO_OPEN：独立送达 init stdout，再执行 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth open --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME" --mcc-context-receipt "$MCC_CONTEXT_RECEIPT" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT"。 --agent-platform "<AGENT_PLATFORM>"`OPENED` stdout 为空；`OPEN_FAILED|GUI_UNAVAILABLE|LINK_ONLY` 时，宿主有内置浏览器打开/导航能力则用它打开本次已校验、已交付的同一 `officialUrl` 一次，禁止搜索、改写、自动填写或代替扫码。无该能力或仍失败时，执行 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth manual-open 并独立送达 stdout。随后无需回复，执行 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth wait --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME" --mcc-context-receipt "$MCC_CONTEXT_RECEIPT" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>"
+2. 仅 AUTH_FLOW:READY_TO_OPEN：独立送达 init stdout，再执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth open --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME" --mcc-context-receipt "$MCC_CONTEXT_RECEIPT" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>"`。`OPENED` stdout 为空；`OPEN_FAILED|GUI_UNAVAILABLE|LINK_ONLY` 时，宿主有内置浏览器打开/导航能力则用它打开本次已校验、已交付的同一 `officialUrl` 一次，禁止搜索、改写、自动填写或代替扫码。无该能力或仍失败时，执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth manual-open --agent-platform "<AGENT_PLATFORM>"` 并独立送达 stdout。随后无需回复，执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" auth wait --scope "$SCOPE" --sales-code "$SALES_CODE" --mcc-code "$MCC_CODE" --product-name "$PRODUCT_NAME" --mcc-name "$MCC_NAME" --mcc-context-receipt "$MCC_CONTEXT_RECEIPT" --telemetry-run-id "$RUN_ID" --telemetry-history-count "$HISTORY_COUNT" --agent-platform "<AGENT_PLATFORM>"`
    ├─ open 返回 AUTH_FLOW:CONTEXT_MISMATCH → 不执行 wait；使用当前已确认的完整参数重新执行第 1 项
    ├─ open 返回 AUTH_FLOW:FAILED → 停止并按错误输出恢复，禁止执行 wait 或进入 Step 3.1
    ├─ AUTH_OPEN:OPENED|OPEN_FAILED|GUI_UNAVAILABLE|LINK_ONLY → 按上项完成宿主浏览器/手动提示降级后执行 wait；不影响已交付 URL

package/skill/references/runtime-entry.md

@@ -38,7 +38,7 @@ node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" render <messageId> --va
 
 首次路由前，Agent 在当前上下文自行回答“当前承载我的 Agent 工具叫什么”，从宿主明确身份、系统说明或当前工具上下文取得工具名称，记为 `AGENT_PLATFORM`（例如 `WorkBuddy`），不向用户提问、不把这段判断对客输出。不得把底层模型名称、项目名称、安装目录或用户举例当作当前宿主身份；无法确认时才使用 `unknown`。该事实仅保留当前对话，不写缓存；上下文丢失时重新判断。
 
-从首条 bootstrap/start-run 起，本文件及所有 flow 登记的每条 runtime 命令均追加 `--agent-platform "<AGENT_PLATFORM>"`，将占位符替换为当前工具名称（例如 `--agent-platform "WorkBuddy"`）；不使用环境变量前缀，不依赖前一次工具调用的进程环境。gateway 在业务参数解析前剥离此公共参数，规范化后传给当前进程及子进程。业务 CLI 的 `PLATFORM` 和遥测 Yuyan `d2` 各自优先沿用已有有效识别，只有识别不到时才采用此兜底；环境变量中的 `unknown` 或非法值不应提前终止遥测识别。工具名统一小写并去除空格、下划线和连字符，`WorkBuddy` 为 `workbuddy`；无法安全规范化仍为 `unknown`。该参数不改变业务确认、run_id、PLATFORM_ID 或模型字段。
+从首条 bootstrap/start-run 起，本文件及所有 flow 登记的每条 runtime 命令均追加 `--agent-platform "<AGENT_PLATFORM>"`，将占位符替换为当前工具名称；不使用环境变量前缀，不依赖前一次工具调用的进程环境。gateway 在业务参数解析前剥离此公共参数，规范化后传给当前进程及子进程。业务 CLI 的 `PLATFORM` 和遥测 Yuyan `d2` 优先使用当前宿主的明确自动识别信号，无法识别时采用本次命令的 Agent 宿名；继承的通用平台变量只能作为末级兼容值，不得遮蔽当前宿主。环境变量中的 `unknown` 或非法值不应提前终止遥测识别。该兜底不使用宿主名称枚举或映射表：纯 ASCII 名称统一小写并去除空格、下划线和连字符，合法 Unicode 名称保留可读原文；无法安全规范化仍为 `unknown`。该参数不改变业务确认、run_id、PLATFORM_ID 或模型字段。
 
 根 `SKILL.md` 启动器已经在读取本文件前确定本轮有效版本，并完成本对话所需的首次 `env refresh-alipay-cli` 或命中同路径、同版本的成功刷新事实。运行时禁止再次执行自更新、读取 `normal/self-update.md` 或切换其他副本；成功事实仍有效时不重复刷新 CLI，只按原始请求识别根意图并加载入口：