@honor-claw/yoyo 1.5.1-beta.2 → 1.5.1-beta.4

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.1-beta.2".includes("beta") || "1.5.1-beta.2".includes("alpha")), !!e;
+	return e === null && (e = "1.5.1-beta.4".includes("beta") || "1.5.1-beta.4".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.1-beta.2".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
+	let [e, n, i] = "1.5.1-beta.4".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.1-beta.2",
+  "version": "1.5.1-beta.4",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",

package/skills/yoyo-update/SKILL.md

@@ -1,112 +1,50 @@
 ---
 name: yoyo-update
 description: >
-  更新 YOYO 插件到最新版本。当用户要求更新、升级 yoyo 插件，或检查 yoyo 插件版本更新时触发。
+  更新 YOYO 插件到最新版本。当用户说“升级 YOYO Claw 插件到最新版本”，或要求更新、升级 yoyo 插件，或检查 yoyo 插件版本更新时触发。
 metadata: { "openclaw": { "emoji": "🔄", "always": true } }
 ---
 
 # YOYO 插件更新
 
-按照以下 5 步工作流完成 YOYO 插件的版本更新。
+严格按下面顺序执行。不要输出步骤名、命令、判断过程或额外解释；只输出本文写明的用户可见文案。所有输出使用中文。
 
-## 全局规则
+## 禁止事项
 
-- [MANDATORY] **严禁在技能流程内重启网关** — 不得执行 `openclaw gateway stop/start/restart` 或任何网关重启操作
-- [MANDATORY] **严禁卸载插件** — 不得执行 `openclaw plugins uninstall`，否则用户配置将丢失
-- [MANDATORY] 出错时仅汇总错误并给出建议，不得尝试自动修复（尤其是不得通过卸载重装来解决问题）
-- [MANDATORY] 所有面向用户的输出必须使用中文
-- [MANDATORY] 不支持精确版本号安装的插件自动升级；检测到精确版本号时必须停止流程并提示用户自行更新插件
-- [MANDATORY] 执行 `openclaw plugins update yoyo` 会更新 `plugins.installs` 配置并触发网关自动重启；检测到存在可更新版本后直接进入更新流程，不得向用户二次确认或输出重启风险说明
-- [MANDATORY] 更新后的最终判断必须以实际更新版本为准，不得只依赖步骤 2 查询到的目标版本
-- [MANDATORY] 本文件中的"步骤 1/2/3/4/5"、小节标题、处理规则、命令说明均为内部流程，不得原样输出给用户
-- [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`），输出以下文案并停止：
 
-除上述内容外，不得向用户展示内部步骤名称、命令执行计划、版本检查过程、字段解析过程或监控输出。异常、无需更新、未更新、无法确认版本等停止流程场景，按对应规则输出简短结果即可，也不得展示内部步骤编号。
-
-## 步骤 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` 字段值，进入步骤 2
-
-## 步骤 2：检查最新版本
-
-### 2.1 确定当前发布渠道
-
-根据步骤 1 中 `Spec` 字段判断当前发布渠道。判断时先提取 `@honor-claw/yoyo@` 后面的安装目标，再按以下规则处理：
-
-- 安装目标为 `alpha` → 渠道为 `alpha`
-- 安装目标为 `beta` → 渠道为 `beta`
-- 安装目标为 `latest` 或没有安装目标 → 渠道为 `latest`
-- `Spec` 包含精确版本号（如 `@honor-claw/yoyo@1.3.0-beta.8`）→ 告知用户"当前 YOYO 插件使用精确版本号安装，自动升级流程暂不支持判断升级渠道。后续安装 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` 命令失败，按当前渠道回退查询对应版本：
+```markdown
+当前 YOYO 插件使用精确版本号安装，自动升级流程已停止。
 
-```bash
-npm view @honor-claw/yoyo@{渠道名} version
+请修改 OpenClaw 配置文件，将 `plugins.installs.yoyo.spec` 从当前精确版本改为非精确版本规格（例如 `@honor-claw/yoyo@beta`、`@honor-claw/yoyo@alpha` 或 `@honor-claw/yoyo`），然后再重新发起升级。
 ```
 
-其中 `latest` 渠道也可以使用 `npm view @honor-claw/yoyo version`。若回退命令仍失败，告知用户"无法获取 YOYO 插件最新版本，请稍后重试或自行更新插件"并停止流程。
+## 步骤 2：确定目标版本
 
-### 2.3 版本对比
+从 `Spec` 判断渠道：`alpha`、`beta`、`latest` 或无标签（按 `latest`）。其他标签输出 `当前 YOYO 插件安装来源无法识别，请自行更新插件或联系开发团队确认升级渠道`，停止。
 
-使用 semver 语义化版本规则，将目标版本（对应渠道最新版）与步骤 1 获取的当前版本进行对比：
+执行 `npm view @honor-claw/yoyo dist-tags --json`，取对应渠道版本。失败时回退执行 `npm view @honor-claw/yoyo@{渠道名} version`；`latest` 可用 `npm view @honor-claw/yoyo version`。仍失败则输出 `无法获取 YOYO 插件最新版本，请稍后重试或自行更新插件`，停止。
 
-- **版本相同** → 告知用户"当前已是最新版本（v{version}），无需更新"并停止流程
-- **当前版本高于目标版本** → 告知用户"当前版本（v{当前版本}）高于当前渠道目标版本（v{目标版本}），无需更新"并停止流程
-- **目标版本高于当前版本** → 记录当前版本和目标版本，进入步骤 3
-- **无法可靠比较版本** → 告知用户"无法可靠比较当前版本与目标版本，请自行更新插件或联系开发团队确认"并停止流程
+用 semver 比较当前版本和目标版本：
 
-## 步骤 3：展示版本差异并进入更新
+- 相同：输出 `当前已是最新版本（v{version}），无需更新`，停止。
+- 当前版本更高：输出 `当前版本（v{当前版本}）高于当前渠道目标版本（v{目标版本}），无需更新`，停止。
+- 无法比较：输出 `无法可靠比较当前版本与目标版本，请自行更新插件或联系开发团队确认`，停止。
+- 目标版本更高：继续步骤 3。
 
-向用户展示更新摘要，不输出重启说明，不等待用户确认，展示后直接进入步骤 4：
+## 步骤 3：输出更新摘要
 
 ```markdown
 🔄 YOYO 插件更新可用
@@ -118,9 +56,7 @@ npm view @honor-claw/yoyo@{渠道名} version
 
 ## 步骤 4：执行更新
 
-### 4.1 先通知用户进入升级流程
-
-在执行更新命令前，必须先向用户输出升级流程开头和阶段 1 进度：
+执行更新前先输出：
 
 ```markdown
 正在执行升级流程：
@@ -129,104 +65,57 @@ 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 的进度通知必须使用以下文案：
+执行 `openclaw plugins update yoyo`，使用足够超时时间。看到 `Installing to` 时只输出一次：
 
 ```markdown
 2. 正在更新插件
 状态：正在安装并配置新版本插件，请勿中断操作
 ```
 
-### 4.4 错误处理
-
-若命令执行过程中出现错误（非零退出码或输出中包含错误信息）：
-
-- 记录完整错误输出
-- 不尝试重试或替代方案
-- 直接进入步骤 5 的失败处理流程
+捕获 `Updated yoyo:` 行里的实际版本。命令非零退出或明显报错时，进入失败处理。
 
-## 步骤 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。
 
-向用户报告：
+成功文案：
 
 ```markdown
 3. 插件更新完成
 Claw 插件更新已完成
-网关即将自动重启，请稍候...
 ```
 
-若实际版本高于步骤 2 获取的目标版本，在成功文案后追加：
+若实际版本高于目标版本，追加：
 
 ```markdown
 说明：本次实际升级到 v{实际版本}，高于预检查获取的目标版本 v{目标版本}。
 ```
 
-**[MANDATORY] 不得在此步骤中询问用户是否重启。** `openclaw plugins update yoyo` 已通过配置变更触发网关自动重启。
-
-### 更新失败
+## 步骤 6：延迟兜底重启
 
-向用户报告失败摘要：
+这是内部步骤，不输出任何重启相关文案。
 
-```
-❌ 插件更新失败
+更新成功后等待 3 秒；如果这期间 OpenClaw 已自动重启或正在重启，停止。否则静默尝试一次：
 
-失败原因：{简要描述错误}
+```bash
+openclaw gateway restart
 ```
 
-并给出以下建议（根据实际错误类型选择）：
-
-- 网络错误（如 `ECONNREFUSED`、`ETIMEDOUT`）→ "请检查网络连接后重试"
-- 权限错误（如 `EACCES`、`EPERM`）→ "请检查 OpenClaw 安装目录的读写权限"
-- 版本冲突 / 依赖冲突 → "请将以下错误信息反馈给开发团队"
-- 其他未预期错误 → "请将错误信息反馈给开发团队，或稍后重试"
-
-**[MANDATORY] 不得尝试以下操作**：
-- 卸载后重装插件（配置会丢失）
-- 手动删除插件目录
-- 修改插件配置文件来绕过错误
-- 重启网关
+不关心命令是否导致第二次重启；不输出成功或失败；不重试；不改用 `stop/start`；不把重启失败当成更新失败。