@alipay/alipay-aipay 1.7.0 → 1.7.1

package/dist/utils/npm.js

@@ -1,38 +1,24 @@
 import semver from 'semver';
-import { getPackageVersion } from './config.js';
-import { execCommand } from './shell.js';
-const PACKAGE_NAME = '@alipay/alipay-aipay';
-/**
- * 从 npm registry 获取最新版本
- */
-export async function getLatestVersion() {
-    try {
-        const { stdout } = await execCommand(`npm view ${PACKAGE_NAME} version --json`, 10000);
-        const version = stdout.trim().replace(/"/g, '');
-        return semver.valid(version);
-    }
-    catch {
-        // 包可能还不存在，或者是网络问题
-        return null;
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { PACKAGE_ROOT } from './config.js';
+import { getSkillVersion, skillVersionKind } from './channels.js';
+const execFileAsync = promisify(execFile);
+export async function getLatestVersion(channel = 'stable') {
+    const args = ['view', '@alipay/alipay-aipay@latest', 'version', 'alipayAipayChannels', '--json'];
+    const { stdout } = await execFileAsync(process.platform === 'win32' ? process.env.ComSpec || 'cmd.exe' : 'npm', process.platform === 'win32' ? ['/d', '/s', '/c', `npm.cmd ${args.join(' ')}`] : args, { timeout: 10000, windowsHide: true });
+    const metadata = JSON.parse(stdout);
+    const version = metadata.alipayAipayChannels?.[channel];
+    if (!semver.valid(metadata.version) || skillVersionKind(version, channel) !== 'release') {
+        throw new Error(`npm latest 缺少有效的 ${channel} 渠道版本信息`);
     }
+    return version;
 }
-/**
- * 检查是否需要更新
- */
-export async function checkForUpdates() {
-    const current = getPackageVersion();
-    const latest = await getLatestVersion();
-    if (!latest) {
-        return {
-            current,
-            latest: current,
-            needsUpdate: false,
-        };
-    }
-    return {
-        current,
-        latest,
-        needsUpdate: semver.gt(latest, current),
-    };
+export async function checkForUpdates(channel = 'stable') {
+    const current = getSkillVersion(PACKAGE_ROOT, channel);
+    if (skillVersionKind(current, channel) === 'beta')
+        return { current, latest: current, needsUpdate: false };
+    const latest = await getLatestVersion(channel);
+    return { current, latest, needsUpdate: semver.gt(latest, current) };
 }
 //# sourceMappingURL=npm.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "支付宝 AI 付接入 Skill 安装包 - 优先安装 Agent Skill，并在 macOS/Linux 后台准备用户级 CLI 工具",
   "type": "module",
   "bin": {
@@ -8,8 +8,9 @@
   },
   "files": [
     "bin/",
-    "dist/",
-    "skill/"
+    "dist/**/*.js",
+    "skill/",
+    "skill-pre/"
   ],
   "scripts": {
     "build": "tsc",
@@ -52,5 +53,9 @@
     "@types/inquirer": "^9.0.7",
     "@types/semver": "^7.5.8",
     "typescript": "^5.3.3"
+  },
+  "alipayAipayChannels": {
+    "stable": "1.7.0",
+    "pre": "1.7.0-pre"
   }
 }

package/skill/SKILL.md

@@ -11,6 +11,8 @@ description: >-
 
 ## 前置启动协议
 
+本目录的 `references/normal/json/release-channel.json` 固定当前渠道；正式版为 `stable`，预发版为 `pre`。自更新只比较 npm latest 元数据中的本渠道 Skill 版本与本地 `VERSION`，不以 npm 包版本判断是否需要更新，不切换或扫描另一渠道。缺少合法渠道元数据时保留当前版本。 本地 beta 测试版本固定使用当前版本，不查询 npm、不自动升级或转正；常规版本只接收本渠道非 beta 版本。此判断由同一自更新命令完成，Agent 不自行判断或修改 VERSION。
+
 本次 Agent 对话首次使用 `alipay-aipay` 时，先把本文件所在目录解析为规范化绝对路径 `<SKILL_DIR>`，记录一次性事实 `ALIPAY_AIPAY_SELF_UPDATE_CHECKED=true`，再执行以下单条命令。`<SKILL_DIR>` 是执行时替换的路径占位符；禁止用 shell 变量赋值、命令替换或依赖特定 shell：
 
 ```text

package/skill/references/normal/json/release-channel.json

@@ -0,0 +1 @@
+{"channel":"stable"}

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

@@ -167,8 +167,13 @@ function parseArgs(argv) {
 function parseVersion(value) {
   const raw = value.trim().replace(/^v/u, '');
   const match = raw.match(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/u);
-  if (!match) return null;
-  return { raw, major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]), prerelease: match[4]?.split('.') || [] };
+  if (!match || raw.length > 256) return null;
+  const prerelease = match[4]?.split('.') || [];
+  const build = raw.includes('+') ? raw.split('+')[1].split('.') : [];
+  if (![match[1], match[2], match[3]].every((value) => Number.isSafeInteger(Number(value)))) return null;
+  if (prerelease.some((value) => !value || (/^\d+$/u.test(value) && value.length > 1 && value[0] === '0'))) return null;
+  if (build.some((value) => !value)) return null;
+  return { raw, major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]), prerelease };
 }
 
 function compareIdentifiers(left, right) {
@@ -195,6 +200,25 @@ function compareVersions(left, right) {
   return 0;
 }
 
+export function skillVersionKind(value, channel) {
+  if (typeof value !== 'string') return null;
+  const parsed = parseVersion(value);
+  if (!parsed) return null;
+  const suffix = parsed.prerelease.join('.');
+  if (suffix === (channel === 'pre' ? 'pre' : '')) return 'release';
+  const pattern = channel === 'pre' ? /^pre-beta(?:\d+|\.\d+)?$/u : /^beta(?:\d+|\.\d+)?$/u;
+  return pattern.test(suffix) ? 'beta' : null;
+}
+
+function readVersionFile(skillDir) {
+  try {
+    const file = path.join(skillDir, 'VERSION');
+    return isRegularFile(file) ? parseVersion(fs.readFileSync(file, 'utf8')) : null;
+  } catch {
+    return null;
+  }
+}
+
 function readLocalVersion(skillDir) {
   try {
     const versionFile = path.join(skillDir, 'VERSION');
@@ -225,26 +249,41 @@ function packageManagerFailureKind(result) {
   return 'check';
 }
 
-async function npmLatest() {
+function readChannel(skillDir) {
+  const source = fs.readFileSync(path.join(skillDir, 'SKILL.md'), 'utf8');
+  const declaredName = source.match(/^name:\s*(\S+)\s*$/m)?.[1];
+  const identity = declaredName === 'alipay-aipay-pre' ? 'pre' : 'stable';
+  const channelFile = path.join(skillDir, 'references', 'normal', 'json', 'release-channel.json');
+  if (!fs.existsSync(channelFile) && identity === 'stable') return 'stable';
+  if (!isRegularFile(channelFile)) throw new Error('invalid release channel');
+  const channel = JSON.parse(fs.readFileSync(channelFile, 'utf8')).channel;
+  if (!['stable', 'pre'].includes(channel) || channel !== identity) throw new Error('invalid release channel');
+  return channel;
+}
+
+async function npmLatest(channel) {
   if (selfUpdateNetworkRestricted()) return { ok: false, reason: 'skipped-network-restricted' };
   try {
-    const result = await spawnPackageManager('npm', ['view', '@alipay/alipay-aipay', 'version', '--json'], {
+    const result = await spawnPackageManager('npm', ['view', '@alipay/alipay-aipay@latest', 'version', 'alipayAipayChannels', '--json'], {
       timeout: npmQueryTimeoutMs,
     });
     if (result.status !== 0 || result.error) return { ok: false, reason: packageManagerFailureKind(result) };
     const decoded = JSON.parse(result.stdout);
-    const version = typeof decoded === 'string' ? parseVersion(decoded) : null;
-    return version ? { ok: true, version } : { ok: false, reason: 'check' };
+    const packageVersion = typeof decoded?.version === 'string' ? parseVersion(decoded.version) : null;
+    const value = decoded?.alipayAipayChannels?.[channel];
+    const version = typeof value === 'string' ? parseVersion(value) : null;
+    return packageVersion && version && skillVersionKind(version.raw, channel) === 'release' ? { ok: true, version, packageVersion } : { ok: false, reason: 'check' };
   } catch {
     return { ok: false, reason: 'check' };
   }
 }
 
-function transactionArtifacts(skillDir, transactionId) {
+function transactionArtifacts(skillDir, transactionId, channel) {
   const parent = path.dirname(skillDir);
+  const skillName = channel === 'pre' ? 'alipay-aipay-pre' : 'alipay-aipay';
   return {
-    staging: path.join(parent, `.alipay-aipay-install-${transactionId}`),
-    backup: path.join(parent, `.alipay-aipay-backup-${transactionId}`),
+    staging: path.join(parent, `.${skillName}-install-${transactionId}`),
+    backup: path.join(parent, `.${skillName}-backup-${transactionId}`),
   };
 }
 
@@ -252,8 +291,8 @@ function removeTransactionPath(target) {
   try { fs.rmSync(target, { recursive: true, force: true }); } catch {}
 }
 
-function reconcileInstallTransaction(skillDir, transactionId) {
-  const artifacts = transactionArtifacts(skillDir, transactionId);
+function reconcileInstallTransaction(skillDir, transactionId, channel) {
+  const artifacts = transactionArtifacts(skillDir, transactionId, channel);
   let current = readLocalVersion(skillDir);
   if (!current && isRecoverableSkillRoot(artifacts.backup)) {
     try {
@@ -267,14 +306,14 @@ function reconcileInstallTransaction(skillDir, transactionId) {
   return current;
 }
 
-async function installVersion(skillDir, version) {
+async function installVersion(skillDir, packageVersion, channel) {
   const transactionId = randomUUID();
   const timeout = installTimeoutBudget();
   let result;
   try {
     result = await spawnPackageManager(
       'npx',
-      ['-y', `@alipay/alipay-aipay@${version.raw}`, 'install-current'],
+      ['-y', `@alipay/alipay-aipay@${packageVersion.raw}`, 'install-current', '--channel', channel],
       {
         timeout,
         env: {
@@ -290,7 +329,7 @@ async function installVersion(skillDir, version) {
   return {
     ok: result.status === 0 && !result.error,
     reason: result.status === 0 && !result.error ? 'ok' : packageManagerFailureKind(result),
-    version: reconcileInstallTransaction(skillDir, transactionId),
+    version: reconcileInstallTransaction(skillDir, transactionId, channel),
   };
 }
 
@@ -301,8 +340,14 @@ function reportOutcome(outcome) {
 
 export async function runSelfUpdateCli(argv = process.argv) {
   const skillDir = parseArgs(argv);
+  const channel = readChannel(skillDir);
   const local = readLocalVersion(skillDir);
-  const checked = await npmLatest();
+  const installedVersion = readVersionFile(skillDir);
+  const kind = skillVersionKind(installedVersion?.raw, channel);
+  // A developer-installed beta is pinned, including when its entry is damaged.
+  if (kind === 'beta') return local ? { kind: 'CURRENT', version: local } : { kind: 'VERIFY_FAILED' };
+  if (installedVersion && !kind) return { kind: 'CHECK_FAILED' };
+  const checked = await npmLatest(channel);
   if (!checked.ok) {
     const current = readLocalVersion(skillDir);
     if (current && (!local || compareVersions(current, local) > 0)) return { kind: 'UPDATED', version: current };
@@ -314,9 +359,9 @@ export async function runSelfUpdateCli(argv = process.argv) {
   const latest = checked.version;
   if (local && compareVersions(local, latest) >= 0) return { kind: 'CURRENT', version: local };
 
-  const installed = await installVersion(skillDir, latest);
+  const installed = await installVersion(skillDir, checked.packageVersion, channel);
   const updated = installed.version || readLocalVersion(skillDir);
-  if (updated && compareVersions(updated, latest) >= 0) return { kind: 'UPDATED', version: updated };
+  if (updated && readChannel(skillDir) === channel && compareVersions(updated, latest) >= 0) return { kind: 'UPDATED', version: updated };
   if (installed.reason === 'network') return { kind: 'RETRY_WITH_NETWORK' };
   if (installed.reason === 'local') return { kind: 'CHECK_FAILED' };
   return { kind: installed.ok ? 'VERIFY_FAILED' : 'INSTALL_FAILED' };

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

@@ -2,4 +2,6 @@
 
 首次使用 `alipay-aipay` 前检查一次版本，记录 `ALIPAY_AIPAY_SELF_UPDATE_CHECKED=true`：`node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" self-update check --skill-dir "<SKILL_DIR>"`。`<SKILL_DIR>` 是当前包含 updater 的 Skill 规范化绝对路径，不得换成启动目录、项目目录、Home、npm 源码根或其他副本；命令不得改成变量赋值、命令替换、相对路径或特定 shell 语法；不透传 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`。`UPDATED` 用原子替换后的新版，其余用当前可用版；marker 异常读当前入口，不得称最新或更新成功；停止读旧版，读取同一根目录的新版入口。仅 `RETRY_WITH_NETWORK` 可取权后原样重试一次，拒绝、不支持或再次返回时读当前入口；一次网络恢复外，不重查、取权、用 `sudo`、要求用户操作或写更新状态。每次只查一次 npm latest；`VERSION` 缺失、非法、落后或业务入口缺失时只安装精确版本一次。不调用公开 `install --target all`；超时终止同一次调用的进程树并清理。
+唯一 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`。`UPDATED` 用原子替换后的新版，其余用当前可用版；marker 异常读当前入口，不得称最新或更新成功；停止读旧版，读取同一根目录的新版入口。仅 `RETRY_WITH_NETWORK` 可取权后原样重试一次，拒绝、不支持或再次返回时读当前入口；一次网络恢复外，不重查、取权、用 `sudo`、要求用户操作或写更新状态。每次只查一次 npm latest 的 `version` 和 `alipayAipayChannels`；只比较本渠道 Skill 版本，npm 包版本仅用于精确下载；`VERSION` 缺失、非法、落后或业务入口缺失时只从查询所得精确 npm 包版本安装当前渠道一次。渠道由当前目录的 `references/normal/json/release-channel.json` 与 Skill 名称共同校验；旧正式版缺少渠道文件时只兼容 `stable`，预发版禁止回退正式版。缺少或非法的远端渠道元数据返回 `CHECK_FAILED`，不得按 npm 包版本兜底。不调用公开 `install --target all`；超时终止同一次调用的进程树并清理。
+
+本地正式渠道的 `X.Y.Z-beta`、`X.Y.Z-betaN`（兼容 `-beta.N`）和预发渠道的 `X.Y.Z-pre-beta`、`X.Y.Z-pre-betaN` 均为固定测试版本。完整安装直接返回 `CURRENT` 且不查询 npm；业务入口损坏时返回 `VERIFY_FAILED`，仍不下载修复或转正。更换版本必须由测试人员显式执行 npm 安装器的 `install`，普通 `update` 同样不推进 beta。正常版本分别为 `X.Y.Z` 与 `X.Y.Z-pre`，远端对应渠道若为 beta 或名称不匹配，返回 `CHECK_FAILED`，不自动安装。beta 不参与版本排序，无自动追踪和自动转正。

package/skill-pre/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: alipay-aipay-pre
+description: >-
+  支付宝 AI 付接入 Skill 预发版。仅在用户明确选择预发版或点名 alipay-aipay-pre 时使用，支持 AI 按量付费、AI 网页应用收款、AI 移动应用收款的代码开发、产品开通和完整接入。普通支付宝接入请求使用正式版 alipay-aipay。
+---
+
+# 支付宝 AI 付接入 Skill 启动器
+
+本文件负责确定本轮实际使用的 Skill 版本，展示内测版使用说明并取得用户的服务/采集选择，再刷新本机 `alipay-cli`。禁止在完成下列启动协议前读取 `references/runtime-entry.md`、任一 flow、模块、消息目录或业务脚本。声明展示前和用户选择前不得采集、缓存或上传任何会话正文；不补采同意前的触发消息、声明或其他历史消息。
+
+## 前置启动协议
+
+本目录的 `references/normal/json/release-channel.json` 固定当前渠道；正式版为 `stable`，预发版为 `pre`。自更新只比较 npm latest 元数据中的本渠道 Skill 版本与本地 `VERSION`，不以 npm 包版本判断是否需要更新，不切换或扫描另一渠道。缺少合法渠道元数据时保留当前版本。 本地 beta 测试版本固定使用当前版本，不查询 npm、不自动升级或转正；常规版本只接收本渠道非 beta 版本。此判断由同一自更新命令完成，Agent 不自行判断或修改 VERSION。
+
+本次 Agent 对话首次使用 `alipay-aipay-pre` 时，先把本文件所在目录解析为规范化绝对路径 `<SKILL_DIR>`，记录一次性事实 `ALIPAY_AIPAY_PRE_SELF_UPDATE_CHECKED=true`，再执行以下单条命令。`<SKILL_DIR>` 是执行时替换的路径占位符；禁止用 shell 变量赋值、命令替换或依赖特定 shell：
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" self-update check --skill-dir "<SKILL_DIR>"
+```
+
+`SKILL_DIR` 必须绑定刚触发且正在执行本命令的 Skill 规范化绝对路径，不得换成 Agent 启动目录、用户项目目录、用户 Home、npm 包源码根或另一份 Skill 副本。`VERSION` 缺失/非法或 `references/runtime-entry.md` 缺失时由本命令尝试精确修复；命令失败或 marker 无法唯一解析时按 `SELF_UPDATE:CHECK_FAILED`。
+
+stderr 只允许出现以下一个内部终态；不得向用户展示 marker 或 npm/npx 原始输出：
+
+- `SELF_UPDATE:UPDATED=<合法 SemVer>`：当前 Skill 目录已原子切换到新版。
+- `SELF_UPDATE:CURRENT=<合法 SemVer>`：继续当前版本。
+- `SELF_UPDATE:RETRY_WITH_NETWORK`：registry 或安装阶段网络不可达；可申请联网后原样重试本命令一次。
+- `SELF_UPDATE:SKIPPED_NETWORK_RESTRICTED|CHECK_FAILED|INSTALL_FAILED|VERIFY_FAILED`：静默继续当前可用版本，不重试、不申请权限。
+
+`UPDATED` 后先废弃旧 loaded 事实，禁止继续读取更新前版本的任何业务文档，后续命令使用新版同一 `SKILL_DIR`；其他终态继续当前可用版本，其他终态同样不再读取本启动器或 `self-update.md` 补充规则。
+
+版本确定后、任何 CLI 刷新、会话解析或业务入口加载前，必须先执行以下固定声明动作；自更新检查是此前唯一允许的动作：
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" preview notice
+```
+
+命令必须成功、stdout 非空且只有一个 `ALIPAY_AIPAY_INTERNAL:CUSTOMER_MESSAGE_DELIVERY_REQUIRED=preview.notice`。下一 Agent 动作必须把 stdout 按原文完整作为独立可见消息发送给用户；禁止概括、改写、删减、只留工具面板、合并业务方案或在送达前继续工具调用。完整送达后记录当前对话中与规范化 Skill 路径绑定的 `ALIPAY_AIPAY_PRE_NOTICE_DELIVERED=true`，立即结束当前回合并等待用户确认；有效选择前禁止刷新 CLI、读取业务入口、识别根意图或执行任何业务动作。失败或 marker 缺失/重复时停止启动，不能跳过声明。首次加载、切换预发版，或声明已确认事实无法确认时必须重新展示并等待确认。声明送达和确认事实都不落盘。此声明只维护在当前预发版消息目录。
+
+收到声明后的首条用户回复时，先从宿主明确身份确定 `AGENT_PLATFORM`（无法确认时用 `unknown`），执行一次以下只读命令取得稳定 `SESSION_ID`；同一对话已有可靠的该值时直接复用，不重新生成。该身份同时用于采集选择、对话采集和后续业务命令，不使用另一份随机 `CONVERSATION_SESSION_ID`。
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry resolve-session --agent-platform "<AGENT_PLATFORM>"
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" preview consent --reply "<USER_REPLY>" --input-id "<USER_INPUT_ID>" --agent-platform "<AGENT_PLATFORM>" --session-id "<SESSION_ID>"
+```
+
+两条命令分别执行；`USER_REPLY` 为当前回复原文，`USER_INPUT_ID` 为当前宿主对话全程唯一的非内容型幂等键，同一回复重试复用，不同回复使用新键，不随业务 run 重置，不得借用此前业务确认。仅 `确认` 与 `仅使用服务`（允许首尾空白、句末句号/感叹号）是本声明的有效选择，不使用通用业务确认解析器；`1`、`OK`、`继续`、否定、疑问或含糊回复均为 `PREVIEW_DECISION=UNCONFIRMED`，继续等待用户选择。用户未回复或不愿继续时不执行后续业务。
+
+- `PREVIEW_DECISION=CONFIRMED` 或 `SERVICE_ONLY`：可记录与当前路径和版本绑定的 `ALIPAY_AIPAY_PRE_NOTICE_CONFIRMED=true` 并继续业务。此声明确认事实仍只保留当前对话上下文。
+- 仅 `CONVERSATION_CONSENT=GRANTED` 且没有本轮采集失败事实时，先读取 `references/normal/conversation-telemetry.md`，以本次同意回复为第一条消息执行其中的 `start-conversation`。不得补采此前内容。已 ACTIVE 时沿用 `CONVERSATION_ID`，不得重复初始化。
+- `CONVERSATION_CONSENT=DENIED|DISABLED|UNAVAILABLE`：当前对话停止传入会话正文，不调用采集或自动补建入口，业务照常继续；状态保存失败也按不采集处理，不宣称已保存选择。运行时的启动和消息入口还会校验持久化授权，未同意或已拒绝均不能采集。
+
+`仅使用服务` 的拒绝按宿主会话 hash 独立保存，不随业务 run 结束、再次引用 Skill 或自更新清除。用户之后明确要求重新同意采集时，重新展示本声明并等待新的 `确认` 回复，再执行同一 consent 命令；不得把普通业务确认当成重新授权。用户中途要求停止采集时，立即执行 `node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" telemetry opt-out --input-id "<USER_INPUT_ID>" --session-id "<SESSION_ID>"`（有 ID 时附加 `--conversation-id "<CONVERSATION_ID>"`），停止传入后续正文；只有 `CONVERSATION_CONSENT=DENIED` 才可宣称选择已保存，失败不阻断业务。
+
+同一对话中确认事实、路径和当前预发版本均未变化时，材料回复、恢复、再次引用和子流程衔接不重复展示声明。路径或版本变化、上下文压缩导致确认事实不可用时重新展示并等待选择，但不得清除原有采集拒绝状态。会话身份无法可靠恢复时重新展示声明并取得选择，绝不根据旧确认事实自动授权新的会话身份。
+
+版本确定后，若当前上下文没有与规范化 `SKILL_DIR`、合法 `VERSION` 绑定的 `ALIPAY_AIPAY_PRE_CLI_REFRESHED=true`，必须刷新一次 `alipay-cli`；不得因自更新已检查而跳过。仅唯一终态 `READY` 可在当前对话上下文记录该成功事实、路径和版本，不写缓存或业务状态；三者仍可用且一致时，后续根触发、确认、补材料、候选选择、恢复、中断继续和 Full Process 衔接均不重复刷新。
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" env refresh-alipay-cli
+```
+
+stderr 只允许一个 `ALIPAY_AIPAY_INTERNAL:ALIPAY_CLI_REFRESH=<READY|RETRY_WITH_NETWORK|RETRY_WITH_LOCAL_FS_PERMISSION|FAILED|VERIFY_FAILED>`，stdout 必须为空，安装器及版本输出不得对客。前两种重试终态分别只允许取得网络权限或 `~/.local/bin` 写权限后原样重试一次；其他终态静默继续，并以之后环境检查和业务脚本的实际 CLI 可用性为准。路径或版本变化、上下文压缩导致事实不可用、用户明确要求刷新，或环境检查证明 CLI 缺失/损坏时清除旧事实并按同一预算重试；非 `READY` 不得循环。
+
+完成本次所需刷新或命中成功事实后，只完整读取同一 `SKILL_DIR` 的 `references/runtime-entry.md`，在当前上下文记录 `ALIPAY_AIPAY_PRE_RUNTIME_ENTRY_LOADED=true` 和规范化路径，再按原请求路由。同一对话后续确认、补材料、候选选择、恢复、中断继续、重复触发和 Full Process 衔接，入口事实存在、路径未变且入口规则仍在时，跳过版本检查和入口重读。仅 `UPDATED`、路径变化或上下文压缩导致规则不可用时重读；事实不落盘。

package/skill-pre/VERSION

@@ -0,0 +1 @@
+1.7.0-pre