@alipay/alipay-aipay 1.7.2 → 1.7.4

package/README.md

@@ -15,21 +15,3 @@ npx -y @alipay/alipay-aipay@latest install --channel pre
 ```
 
 两份 Skill 可并存：正式版安装到 Agent 的 `skills/alipay-aipay/`，预发版安装到 `skills/alipay-aipay-pre/`。预发版使用独立名称 `alipay-aipay-pre`，在对话中明确点名或选择预发版使用。`--target` 的 Agent 目标选择规则不变。
-
-```bash
-# 只更新或卸载预发版；省略 --channel pre 则只操作正式版
-npx -y @alipay/alipay-aipay@latest update --channel pre
-npx -y @alipay/alipay-aipay@latest uninstall --channel pre
-```
-
-安装记录、自更新和卸载按渠道隔离；`--target all` 也只操作所选渠道。两份 Skill 共用系统环境中的 alipay-cli 和 jq，卸载 Skill 不卸载这些工具。
-
-## 维护与发布
-
-- `skill/` 是正式版源目录，`skill-pre/` 是可独立修改的预发版源目录，构建不会互相覆盖。
-- `package.json.version` 是 npm 分发包版本；`alipayAipayChannels.stable/pre` 分别对应两份 Skill 的 `VERSION`。安装器保留所选 Skill 的版本，不用包版本覆盖。
-- 每次发布提升 npm 包版本；只修改预发内容时，只提升预发 Skill 版本和相应元数据。正式版自更新发现自身版本未变时不下载安装。
-- 两份常规 Skill 自更新器都查询 npm `latest`，只比较自己的渠道版本，并从查询所得精确 npm 包版本中安装对应目录。元数据缺失、非法或为测试版本时保留本地，不切换渠道。
-- 正式版版本从 `1.7.0` 按 `1.7.1`、`1.7.2` 递增；预发版从 `1.7.0-pre` 按 `1.7.1-pre`、`1.7.2-pre` 递增。npm 包版本自此次拆分起独立维护。
-- 旧版 updater 首次升级前仍按 npm 包版本触发一次正式版迁移。正式版 VERSION 可保持 `1.7.0`；旧更新器可能在文件已迁移后返回内部 `VERIFY_FAILED`，启动器会继续读取当前可用入口，不阻塞业务。后续使用新渠道规则。
-- 本次预发版先复制正式版业务能力，后续定制直接修改 `skill-pre/`。对客消息、业务契约和发布校验仍遵循 `AGENTS.md`。

package/dist/commands/install.js

@@ -29,7 +29,8 @@ export async function installCommand(cwd, options = {}) {
     const { skillName: SKILL_NAME, displayName } = getChannelConfig(channel);
     const SKILLS = [{ name: SKILL_NAME, displayName }];
     const target = options.target ?? 'all';
-    const skipTools = options.skipTools ?? false;
+    const deferWindowsTools = process.platform === 'win32' && !options.skipTools;
+    const skipTools = (options.skipTools ?? false) || deferWindowsTools;
     const jqRequired = isJqRequiredPlatform();
     const jqPreparationSupported = resolveManagedJqAsset() !== null;
     const installPlan = resolveInstallPlan(cwd, target, channel);
@@ -38,7 +39,9 @@ export async function installCommand(cwd, options = {}) {
     const targetDirLabels = contexts.map((ctx) => ctx.targetDirLabel);
     const targetSkillDirs = contexts.map((ctx) => path.join(ctx.targetDir, SKILL_NAME));
     console.log(chalk.cyan.bold(`\n🚀 @alipay/alipay-aipay ${channel} v${version}\n`));
-    console.log(chalk.gray('优先安装 Skill 文件；alipay-cli 和用户级 jq 可在后台准备，不调用系统包管理器\n'));
+    console.log(chalk.gray(deferWindowsTools
+        ? '优先安装 Skill 文件；Windows 工具在 Skill 启动时按对应渠道检查\n'
+        : '优先安装 Skill 文件；alipay-cli 和用户级 jq 可在后台准备，不调用系统包管理器\n'));
     console.log(chalk.gray(`安装目标: ${targetSkillDirs.join(', ')}`));
     console.log(chalk.gray(`${describeTargetSelection(os.homedir(), target, targetDirLabels, primaryTargetDir, SKILL_NAME)}\n`));
     // ========== 阶段 1: 环境检查 ==========
@@ -47,7 +50,9 @@ export async function installCommand(cwd, options = {}) {
     if (skipTools) {
         console.log(chalk.cyan('📋 环境检查'));
         console.log(chalk.gray('─'.repeat(40)));
-        console.log(chalk.gray('  ○ 已按 --skip-tools 跳过 alipay-cli、jq 检查与安装'));
+        console.log(chalk.gray(deferWindowsTools
+            ? '  ○ Windows 工具由 Skill 启动时按对应渠道检查'
+            : '  ○ 已按 --skip-tools 跳过 alipay-cli、jq 检查与安装'));
     }
     else {
         console.log(chalk.cyan('📋 环境检查'));
@@ -157,7 +162,7 @@ export async function installCommand(cwd, options = {}) {
             }
             console.log('');
         }
-        printSummary(alipayCliOk, jqOk, true, version, installedSkillDirs, skipTools, jqRequired, jqPreparationSupported, backgroundPreparation);
+        printSummary(alipayCliOk, jqOk, true, version, installedSkillDirs, skipTools, deferWindowsTools, jqRequired, jqPreparationSupported, backgroundPreparation);
     }
     catch (error) {
         spinner.fail(chalk.red('Skill 文件安装失败'));
@@ -216,21 +221,23 @@ function startBackgroundToolPreparation(withJq) {
 /**
  * 打印安装总结
  */
-function printSummary(alipayCliOk, jqOk, skillInstalled, version, targetSkillDirs, toolsSkipped, jqRequired, jqPreparationSupported, backgroundPreparation) {
+function printSummary(alipayCliOk, jqOk, skillInstalled, version, targetSkillDirs, toolsSkipped, toolsDeferredToSkill, jqRequired, jqPreparationSupported, backgroundPreparation) {
     console.log(chalk.cyan.bold('📋 安装总结'));
     console.log(chalk.gray('─'.repeat(40)));
-    console.log(`  alipay-cli:   ${toolsSkipped ? chalk.gray('○ 已跳过') : alipayCliOk ? chalk.green('✓ 已就绪') : backgroundPreparation.alipayCli ? chalk.yellow('⏳ 后台准备中') : chalk.red('✗ 未就绪')}`);
-    const jqStatus = toolsSkipped
-        ? chalk.gray('○ 已跳过')
-        : jqOk
-            ? chalk.green('✓ 已就绪')
-            : backgroundPreparation.jq
-                ? chalk.yellow('⏳ 用户目录后台准备中')
-                : !jqRequired
-                    ? chalk.gray('○ Windows 当前路径无需')
-                    : jqPreparationSupported
-                        ? chalk.gray('○ 后台任务未启动')
-                        : chalk.gray('○ 当前架构不支持自动准备');
+    console.log(`  alipay-cli:   ${toolsDeferredToSkill ? chalk.gray('○ 由 Skill 启动时检查') : toolsSkipped ? chalk.gray('○ 已跳过') : alipayCliOk ? chalk.green('✓ 已就绪') : backgroundPreparation.alipayCli ? chalk.yellow('⏳ 后台准备中') : chalk.red('✗ 未就绪')}`);
+    const jqStatus = toolsDeferredToSkill
+        ? chalk.gray('○ 由 Skill 按需检查')
+        : toolsSkipped
+            ? chalk.gray('○ 已跳过')
+            : jqOk
+                ? chalk.green('✓ 已就绪')
+                : backgroundPreparation.jq
+                    ? chalk.yellow('⏳ 用户目录后台准备中')
+                    : !jqRequired
+                        ? chalk.gray('○ Windows 当前路径无需')
+                        : jqPreparationSupported
+                            ? chalk.gray('○ 后台任务未启动')
+                            : chalk.gray('○ 当前架构不支持自动准备');
     console.log(`  jq:           ${jqStatus}`);
     console.log(`  Skill 文件:   ${skillInstalled ? chalk.green('✓ 已安装') : chalk.gray('○ 未安装')}`);
     console.log(`  版本:         ${version}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alipay/alipay-aipay",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "支付宝 AI 付接入 Skill 安装包 - 优先安装 Agent Skill，并在 macOS/Linux 后台准备用户级 CLI 工具",
   "type": "module",
   "bin": {
@@ -55,7 +55,7 @@
     "typescript": "^5.3.3"
   },
   "alipayAipayChannels": {
-    "stable": "1.7.0",
-    "pre": "1.7.1-pre"
+    "stable": "1.7.1",
+    "pre": "1.7.3-pre"
   }
 }

package/skill/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 
 # 支付宝 AI 付接入 Skill 启动器
 
-本文件只负责在加载业务规则前确定本轮实际使用的 Skill 版本，并刷新本机 `alipay-cli`。禁止在完成下列启动协议前读取 `references/runtime-entry.md`、任一 flow、模块、消息目录或业务脚本。
+本文件只负责在加载业务规则前确定本轮实际使用的 Skill 版本、完成 Windows 渠道选择，并刷新本机 `alipay-cli`。禁止在完成下列启动协议前读取 `references/runtime-entry.md`、任一 flow、模块或业务脚本；Windows 渠道提示仅由下述固定 runtime 入口读取消息目录。
 
 ## 前置启动协议
 
@@ -30,7 +30,29 @@ stderr 只允许出现以下一个内部终态；不得向用户展示 marker
 
 `UPDATED` 后先废弃旧 loaded 事实，禁止继续读取更新前版本的任何业务文档，后续命令使用新版同一 `SKILL_DIR`；其他终态继续当前可用版本，其他终态同样不再读取本启动器或 `self-update.md` 补充规则。
 
-版本确定后，若当前上下文没有与规范化 `SKILL_DIR`、合法 `VERSION` 绑定的 `ALIPAY_AIPAY_CLI_REFRESHED=true`，必须刷新一次 `alipay-cli`；不得因自更新已检查而跳过。仅唯一终态 `READY` 可在当前对话上下文记录该成功事实、路径和版本，不写缓存或业务状态；三者仍可用且一致时，后续根触发、确认、补材料、候选选择、恢复、中断继续和 Full Process 衔接均不重复刷新。
+版本确定后、首次 CLI 刷新及任何业务入口之前，若当前对话没有绑定该正式版规范化路径的 `ALIPAY_AIPAY_CHANNEL_OFFER_RESOLVED=true`，先执行一次：
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" channel-offer show
+```
+
+非 Windows 只返回唯一 `ALIPAY_AIPAY_INTERNAL:CHANNEL_OFFER=SKIPPED`，不展示正文，记录已处理并继续。Windows 返回唯一 `WAITING` 时，必须先将 stdout 原文作为独立可见消息送达并等待用户回复；在该回复前不得刷新 CLI、加载业务入口、创建遥测 run 或安装内测版。同一对话后续根触发不重复展示。用户本轮原始请求已明确要求安装使用内测版时，该意图可作为当前提示的回复直接判定，无需再索取一次“确认”；其他情况只使用提示送达后的用户原始回复。判断仅使用：
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" channel-offer decide --reply "<USER_REPLY>"
+```
+
+仅唯一 `ALIPAY_AIPAY_INTERNAL:CHANNEL_OFFER=PRE` 可进入内测安装；`STABLE` 表示继续本正式版，记录已处理并按下文刷新 CLI。`UNDECIDED` 表示用户在提问或表达不确定，先回答或澄清，仍等待明确选择；不能把业务催促、泛泛的“继续/OK/1”或通用 `reply confirm` 当作内测授权。任一错误或 marker 不唯一时停止渠道切换，禁止安装。用户以后明确提出切换时，可重新进行这一选择，不受已处理事实限制。
+
+`PRE` 后先执行固定只读预检，确认 npm latest 的预发渠道已包含 Windows 改造版；本地当前工作区或尚未发布的版本不能代替线上事实：
+
+```text
+node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" channel-offer available
+```
+
+仅唯一 `ALIPAY_AIPAY_INTERNAL:CHANNEL_OFFER=AVAILABLE` 才在 Windows PowerShell 或 CMD 执行 `npx.cmd -y @alipay/alipay-aipay@latest install --channel pre`。`UNAVAILABLE|CHECK_FAILED` 时说明线上内测版尚不可核实或尚未包含 Windows 能力，保留正式版并停在当前选择，不安装旧内测版；用户可明确要求继续正式版。安装退出码为 0 后，必须从安装器报告的当前 Agent 目标目录核验 `alipay-aipay-pre/SKILL.md`、`VERSION` 和 `references/runtime-entry.md` 均为普通文件，渠道为 `pre`、版本不低于 `1.7.3-pre`，且该目录确实可由当前 Agent 加载；不能从旧预发版路径或当前正式版目录推定安装成功。核验成功后废弃正式版入口及刷新事实，使用实际预发版规范化绝对路径重新读取其 `SKILL.md` 并按预发版启动协议继续原任务。安装失败或核验失败时保持正式版，不宣称切换成功，也不进入预发业务流程。此选择发生在正式版 telemetry 启动前，不为渠道提示或预发安装创建正式版 run。
+
+仅确定继续正式版后，若当前上下文没有与规范化 `SKILL_DIR`、合法 `VERSION` 绑定的 `ALIPAY_AIPAY_CLI_REFRESHED=true`，必须刷新一次 `alipay-cli`；不得因自更新已检查而跳过。仅唯一终态 `READY` 可在当前对话上下文记录该成功事实、路径和版本，不写缓存或业务状态；三者仍可用且一致时，后续根触发、确认、补材料、候选选择、恢复、中断继续和 Full Process 衔接均不重复刷新。
 
 ```text
 node "<SKILL_DIR>/references/normal/scripts/runtime.mjs" env refresh-alipay-cli

package/skill/VERSION

@@ -1 +1 @@
-1.7.0
+1.7.1