@honor-claw/yoyo 1.5.0-beta.2 → 1.5.1-alpha.1

package/dist/utils/version.mjs

@@ -1,7 +1,7 @@
 //#region src/utils/version.ts
 var e = null, t = null;
 function n() {
-	return e === null && (e = "1.5.0-beta.2".includes("beta") || "1.5.0-beta.2".includes("alpha")), !!e;
+	return e === null && (e = "1.5.1-alpha.1".includes("beta") || "1.5.1-alpha.1".includes("alpha")), !!e;
 }
 function r(e) {
 	if (!e) return 0;
@@ -10,7 +10,7 @@ function r(e) {
 }
 function i() {
 	if (t !== null) return t;
-	let [e, n, i] = "1.5.0-beta.2".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
+	let [e, n, i] = "1.5.1-alpha.1".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
 	return t = a * 1e6 + o * 1e3 + s, t;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "1.5.0-beta.2",
+  "version": "1.5.1-alpha.1",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",

package/skills/yoyo-update/SKILL.md

@@ -7,35 +7,23 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
 
 # YOYO 插件更新
 
-按照以下 6 步工作流完成 YOYO 插件的版本更新。
+严格按下面顺序执行。不要输出步骤名、命令、判断过程或额外解释；只输出本文写明的用户可见文案。所有输出使用中文。
 
-## 全局规则
+## 禁止事项
 
-- [MANDATORY] **更新成功后的重启是内部 best-effort 动作** — 只有在 `openclaw plugins update yoyo` 成功完成并确认插件版本已更新后，尝试触发一次 `openclaw gateway restart`
-- [MANDATORY] 除上述更新成功后的单次重启触发尝试外，不得执行 `openclaw gateway stop/start/restart` 或任何网关重启操作；更新失败、无需更新、精确版本停止、状态异常、无法确认版本等场景不得重启
-- [MANDATORY] 更新后的重启触发只能在当前这一次 yoyo-update 对话轮次中处理；若 OpenClaw 已自行重启、正在重启、命令无法触达网关、命令执行中断、或已经进入下一轮对话，则不得补偿重启，除非用户再次明确要求重启
-- [MANDATORY] **严禁卸载插件** — 不得执行 `openclaw plugins uninstall`，否则用户配置将丢失
-- [MANDATORY] 出错时仅汇总错误并给出建议，不得尝试自动修复（尤其是不得通过卸载重装来解决问题）
-- [MANDATORY] 所有面向用户的输出必须使用中文
-- [MANDATORY] 不支持精确版本号安装的插件自动升级；只要 `Spec` 是 `@honor-claw/yoyo@<semver>` 这类精确版本（含预发布版本，例如 `@honor-claw/yoyo@1.3.0-beta.8`），必须立即停止整个流程，不得查询 npm、不得进入更新摘要、不得执行 `openclaw plugins update yoyo`
-- [MANDATORY] 执行 `openclaw plugins update yoyo` 后不能假设网关一定会自动重启；检测到存在可更新版本后直接进入更新流程，不得向用户二次确认或输出重启风险说明
-- [MANDATORY] 更新后的最终判断必须以实际更新版本为准，不得只依赖步骤 2 查询到的目标版本
-- [MANDATORY] 本文件中的"步骤 1/2/3/4/5/6"、小节标题、处理规则、命令说明均为内部流程，不得原样输出给用户
-- [MANDATORY] 正常更新流程下，面向用户的输出必须严格使用本文指定的可见文案；不得额外输出"步骤1"、"步骤2"、"正在检查版本"、"我将执行"、命令说明、内部判断过程或自由发挥的状态描述
-- 所有命令在 Windows (bash) 和 Unix (bash) 环境下格式一致，无需区分平台
+- 不得执行 `openclaw plugins uninstall`。
+- 不得在失败、无需更新、精确版本、无法确认版本时重启网关。
+- 不得重试失败命令，不得自动修复配置，不得跨对话补偿执行重启。
 
-## 用户可见输出约束
+## 步骤 1：读取当前插件
 
-正常更新流程只允许输出以下几类内容：
+执行 `openclaw plugins info yoyo`。
 
-1. 步骤 3 中的更新摘要文案
-2. 步骤 4.1 的升级流程开头和阶段 1 进度
-3. 步骤 4.3 的阶段 2 进度
-4. 步骤 5 的插件更新完成文案，以及实际版本高于预检查目标版本时的追加说明
-
-除上述内容外，不得向用户展示内部步骤名称、命令执行计划、版本检查过程、字段解析过程、重启触发动作或监控输出。异常、无需更新、未更新、无法确认版本等停止流程场景，按对应规则输出简短结果即可，也不得展示内部步骤编号。
-
-检测到精确版本号时，必须使用以下文案并停止流程：
+- 未安装：输出 `未检测到 YOYO 插件，请先安装`，停止。
+- 命令失败：输出 `无法获取插件信息，请确认 OpenClaw 网关正在运行`，停止。
+- `Status` 不是 `loaded`：输出 `YOYO 插件状态异常：{状态或错误信息}`，停止。
+- 记录 `Version` 和 `Spec`。
+- 若 `Spec` 是精确版本号（如 `@honor-claw/yoyo@1.3.0-beta.8`），输出以下文案并停止：
 
 ```markdown
 当前 YOYO 插件使用精确版本号安装，自动升级流程已停止。
@@ -43,82 +31,20 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
 请修改 OpenClaw 配置文件，将 `plugins.installs.yoyo.spec` 从当前精确版本改为非精确版本规格（例如 `@honor-claw/yoyo@beta`、`@honor-claw/yoyo@alpha` 或 `@honor-claw/yoyo`），然后再重新发起升级。
 ```
 
-## 步骤 1：预检查
-
-执行以下命令获取当前插件信息：
-
-```bash
-openclaw plugins info yoyo
-```
-
-**输出字段说明**：
-
-| 字段           | 说明                         | 示例                             |
-| -------------- | ---------------------------- | -------------------------------- |
-| `Status`       | 插件加载状态                 | `loaded` / `error` / `not found` |
-| `Version`      | 当前已安装版本               | `1.3.0-beta.8`                   |
-| `Spec`         | 安装来源标识，含包名和渠道   | `@honor-claw/yoyo@beta`          |
-| `Install path` | 插件安装路径                 | `~/.openclaw/extensions/yoyo`    |
-
-**处理规则**：
-
-- 若插件未找到（输出为空或提示未安装）→ 告知用户"未检测到 YOYO 插件，请先安装"并停止
-- 若状态非 `loaded`（如 `error`）→ 告知用户插件状态异常并展示具体信息，停止流程
-- 若命令本身执行失败 → 告知用户"无法获取插件信息，请确认 OpenClaw 网关正在运行"并停止
-- 成功获取信息 → 提取 `Version` 和 `Spec` 字段值
-- 若 `Spec` 是精确版本号（如 `@honor-claw/yoyo@1.3.0-beta.8`）→ 输出精确版本停止文案并停止流程；不得查询 npm、不得展示更新摘要、不得执行 `openclaw plugins update yoyo`
-- 其他情况 → 进入步骤 2
-
-## 步骤 2：检查最新版本
-
-### 2.1 确定当前发布渠道
-
-根据步骤 1 中 `Spec` 字段判断当前发布渠道。判断时先提取 `@honor-claw/yoyo@` 后面的安装目标，再按以下规则处理：
-
-- 安装目标为 `alpha` → 渠道为 `alpha`
-- 安装目标为 `beta` → 渠道为 `beta`
-- 安装目标为 `latest` 或没有安装目标 → 渠道为 `latest`
-- `Spec` 包含精确版本号（如 `@honor-claw/yoyo@1.3.0-beta.8`）→ 输出精确版本停止文案并停止流程；不得查询 npm、不得展示更新摘要、不得执行 `openclaw plugins update yoyo`
-- `Spec` 包含其他未知标签 → 告知用户"当前 YOYO 插件安装来源无法识别，请自行更新插件或联系开发团队确认升级渠道"并停止流程
-
-### 2.2 查询最新版本
-
-执行以下命令获取所有发布渠道的最新版本：
-
-```bash
-npm view @honor-claw/yoyo dist-tags --json
-```
-
-从 JSON 输出中提取对应渠道的版本号。若 JSON 中不存在对应渠道，按当前渠道回退查询对应版本。示例输出：
-
-```json
-{
-  "latest": "1.2.0",
-  "beta": "1.3.0-beta.8",
-  "alpha": "1.4.0-alpha.3"
-}
-```
-
-若 `npm view @honor-claw/yoyo dist-tags --json` 命令失败，按当前渠道回退查询对应版本：
+## 步骤 2：确定目标版本
 
-```bash
-npm view @honor-claw/yoyo@{渠道名} version
-```
+从 `Spec` 判断渠道：`alpha`、`beta`、`latest` 或无标签（按 `latest`）。其他标签输出 `当前 YOYO 插件安装来源无法识别，请自行更新插件或联系开发团队确认升级渠道`，停止。
 
-其中 `latest` 渠道也可以使用 `npm view @honor-claw/yoyo version`。若回退命令仍失败，告知用户"无法获取 YOYO 插件最新版本，请稍后重试或自行更新插件"并停止流程。
+执行 `npm view @honor-claw/yoyo dist-tags --json`，取对应渠道版本。失败时回退执行 `npm view @honor-claw/yoyo@{渠道名} version`；`latest` 可用 `npm view @honor-claw/yoyo version`。仍失败则输出 `无法获取 YOYO 插件最新版本，请稍后重试或自行更新插件`，停止。
 
-### 2.3 版本对比
+用 semver 比较当前版本和目标版本：
 
-使用 semver 语义化版本规则，将目标版本（对应渠道最新版）与步骤 1 获取的当前版本进行对比：
+- 相同：输出 `当前已是最新版本（v{version}），无需更新`，停止。
+- 当前版本更高：输出 `当前版本（v{当前版本}）高于当前渠道目标版本（v{目标版本}），无需更新`，停止。
+- 无法比较：输出 `无法可靠比较当前版本与目标版本，请自行更新插件或联系开发团队确认`，停止。
+- 目标版本更高：继续步骤 3。
 
-- **版本相同** → 告知用户"当前已是最新版本（v{version}），无需更新"并停止流程
-- **当前版本高于目标版本** → 告知用户"当前版本（v{当前版本}）高于当前渠道目标版本（v{目标版本}），无需更新"并停止流程
-- **目标版本高于当前版本** → 记录当前版本和目标版本，进入步骤 3
-- **无法可靠比较版本** → 告知用户"无法可靠比较当前版本与目标版本，请自行更新插件或联系开发团队确认"并停止流程
-
-## 步骤 3：展示版本差异并进入更新
-
-向用户展示更新摘要，不输出重启说明，不等待用户确认，展示后直接进入步骤 4：
+## 步骤 3：输出更新摘要
 
 ```markdown
 🔄 YOYO 插件更新可用
@@ -130,9 +56,14 @@ npm view @honor-claw/yoyo@{渠道名} version
 
 ## 步骤 4：执行更新
 
-### 4.1 先通知用户进入升级流程
+执行 `openclaw plugins update yoyo`，使用足够超时时间。实时监控输出，只处理下面四个关键节点：
+
+- 看到 `Downloading @honor-claw/yoyo@`：立刻输出一次阶段 1 文案。
+- 看到 `Installing to`：立刻输出一次阶段 2 文案。
+- 看到 `Updated yoyo:`：捕获实际更新版本。
+- 看到 `Restart the gateway to load plugins`：视为更新命令成功，进入步骤 5。
 
-在执行更新命令前，必须先向用户输出升级流程开头和阶段 1 进度：
+阶段 1 文案：
 
 ```markdown
 正在执行升级流程：
@@ -141,74 +72,42 @@ npm view @honor-claw/yoyo@{渠道名} version
 状态：正在下载插件，请耐心等待...
 ```
 
-后续阶段进度不得重复输出"正在执行升级流程："标题。
-
-### 4.2 执行更新命令
-
-```bash
-openclaw plugins update yoyo
-```
-
-注意：该命令可能需要较长时间执行（下载和安装），请使用足够的超时时间。
-
-### 4.3 监控更新进度
-
-实时监控命令输出，根据不同阶段向用户报告进度：
-
-| 输出关键词                             | 向用户报告        | 内部处理                       |
-| -------------------------------------- | ----------------- | ------------------------------ |
-| `Downloading @honor-claw/yoyo@`        | 不输出            | 阶段 1 已在命令执行前输出      |
-| `Extracting`                           | 不输出            | 静默跟踪                       |
-| `Installing to`                        | 见下方阶段 2      | —                              |
-| `Installing plugin dependencies`       | 不输出            | 静默跟踪                       |
-| `Updated yoyo:`                        | 不输出            | 捕获实际更新版本               |
-| `Config overwrite:` / `Config backup:` | 不输出            | 记录配置备份路径               |
-| `Restart the gateway to load plugins`  | 不输出            | 更新命令成功的确认信号，进入步骤 5 |
-
-阶段 2 的进度通知必须使用以下文案：
+阶段 2 文案：
 
 ```markdown
 2. 正在更新插件
 状态：正在安装并配置新版本插件，请勿中断操作
 ```
 
-### 4.4 错误处理
-
-若命令执行过程中出现错误（非零退出码或输出中包含错误信息）：
-
-- 记录完整错误输出
-- 不尝试重试或替代方案
-- 直接进入步骤 5 的失败处理流程
+命令非零退出或明显报错时，进入失败处理。
 
-## 步骤 5：更新后处理
+## 步骤 5：校验并输出结果
 
-### 版本校验
+若步骤 4 失败，输出：
 
-仅在更新命令成功完成并出现成功信号时执行版本校验。若命令非零退出或已判定为更新失败，跳过版本校验并直接进入更新失败处理。
-
-优先从 `openclaw plugins update yoyo` 输出中的 `Updated yoyo:` 行提取实际更新版本。若命令执行成功但没有捕获到实际更新版本，可再次执行：
+```markdown
+❌ 插件更新失败
 
-```bash
-openclaw plugins info yoyo
+失败原因：{简要描述错误}
 ```
 
-从 `Version` 字段提取最终版本。若此时命令暂时失败，不要把它直接判定为更新失败；告知用户"插件更新命令已完成，但暂时无法确认最终版本，请稍后再次检查插件版本"。此时不得在后续对话中补偿重启，除非用户再次明确要求重启。
+网络错误补充 `请检查网络连接后重试`；权限错误补充 `请检查 OpenClaw 安装目录的读写权限`；其他错误补充 `请将错误信息反馈给开发团队，或稍后重试`。停止。
 
-将实际更新版本与步骤 1 的当前版本、步骤 2 的目标版本进行 semver 比较：
+若步骤 4 成功，优先使用 `Updated yoyo:` 的实际版本；没有捕获到时执行 `openclaw plugins info yoyo` 读取 `Version`。无法读取时输出 `插件更新命令已完成，但暂时无法确认最终版本，请稍后再次检查插件版本`，停止。
 
-- **实际版本等于当前版本** → 告知用户"插件版本未发生变化，需要稍后再次尝试更新"，不要让用户手动触发命令行
-- **实际版本高于目标版本** → 按更新成功处理，并额外提示"本次实际升级到 v{实际版本}，高于预检查获取的目标版本 v{目标版本}"
-- **实际版本等于目标版本** → 按更新成功处理
-- **实际版本高于当前版本但低于目标版本** → 告知用户"插件已升级到 v{实际版本}，但低于预检查目标版本 v{目标版本}，需要稍后再次尝试更新"，不要让用户手动触发命令行
-- **无法可靠比较实际版本** → 告知用户"插件更新命令已完成，但无法可靠确认最终版本，请稍后再次检查插件版本"
+比较实际版本：
 
-### 更新成功
+- 实际版本等于当前版本：输出 `插件版本未发生变化，需要稍后再次尝试更新`，停止。
+- 实际版本低于目标版本但高于当前版本：输出 `插件已升级到 v{实际版本}，但低于预检查目标版本 v{目标版本}，需要稍后再次尝试更新`，停止。
+- 无法比较：输出 `插件更新命令已完成，但无法可靠确认最终版本，请稍后再次检查插件版本`，停止。
+- 实际版本等于或高于目标版本：先输出成功文案，再继续步骤 6。
 
-向用户报告后进入步骤 6：
+成功文案：
 
 ```markdown
 3. 插件更新完成
 Claw 插件更新已完成
+网关即将自动重启，请稍候...
 ```
 
 若实际版本高于步骤 2 获取的目标版本，在成功文案后追加：
@@ -217,42 +116,14 @@ Claw 插件更新已完成
 说明：本次实际升级到 v{实际版本}，高于预检查获取的目标版本 v{目标版本}。
 ```
 
-**[MANDATORY] 不得在此步骤中询问用户是否重启。** 插件版本确认更新后，必须在当前对话轮次内继续执行步骤 6。
-
-### 更新失败
-
-向用户报告失败摘要：
-
-```
-❌ 插件更新失败
-
-失败原因：{简要描述错误}
-```
-
-并给出以下建议（根据实际错误类型选择）：
+## 步骤 6：延迟兜底重启
 
-- 网络错误（如 `ECONNREFUSED`、`ETIMEDOUT`）→ "请检查网络连接后重试"
-- 权限错误（如 `EACCES`、`EPERM`）→ "请检查 OpenClaw 安装目录的读写权限"
-- 版本冲突 / 依赖冲突 → "请将以下错误信息反馈给开发团队"
-- 其他未预期错误 → "请将错误信息反馈给开发团队，或稍后重试"
+这是内部步骤，不输出任何重启相关文案。
 
-**[MANDATORY] 不得尝试以下操作**：
-- 卸载后重装插件（配置会丢失）
-- 手动删除插件目录
-- 修改插件配置文件来绕过错误
-- 重启网关
-
-## 步骤 6：触发网关重启
-
-仅在步骤 5 已按更新成功处理时执行。本步骤是内部 best-effort 收尾动作，不得向用户输出任何重启相关文案。
+步骤 5 的成功文案输出后，等待 3 秒；如果这期间 OpenClaw 已自动重启或正在重启，停止。否则静默尝试一次：
 
 ```bash
 openclaw gateway restart
 ```
 
-**处理规则**：
-
-- 更新成功后尝试触发一次 `openclaw gateway restart`；这是为了覆盖少数未自动重启的情况，不改变用户可见成功文案
-- 若触发成功，即使 OpenClaw 因自身机制又重启了一次，也不需要关心，不额外输出、不验证、不补救
-- 若触发前或触发时发现 OpenClaw 已自行重启、正在重启、命令无法触达网关、连接中断或命令失败，视为 best-effort 已完成；不得重试、不得改用 `stop/start`、不得把更新成功改判为失败、不得输出重启失败提示
-- 若当前对话轮次已经结束、用户发起了新的请求、或此前因为任何原因没有执行重启命令 → 不得为了本次更新补偿执行 `openclaw gateway restart`，除非用户明确提出需要重启
+不关心命令是否导致第二次重启；不输出成功或失败；不重试；不改用 `stop/start`；不把重启失败当成更新失败。