diff --git a/workbuddy-plugin/CHANGELOG.md b/workbuddy-plugin/CHANGELOG.md index c8b33dd..3e5e287 100644 --- a/workbuddy-plugin/CHANGELOG.md +++ b/workbuddy-plugin/CHANGELOG.md @@ -1,3 +1,8 @@ +## 0.4.1 + +- Recognize receipt-owned HTTP MCP installations during upgrades to the public stdio runtime. +- Preserve unknown or edited MCP entries and provide explicit backup/edit/retry instructions. + # OpenGUI for WorkBuddy 0.4.0 public testing - Publish the task home, workbench, account/model selection, takeover, content review, and report runtime as a distinct plugin version. diff --git a/workbuddy-plugin/INSTALL.md b/workbuddy-plugin/INSTALL.md index 72563a9..b737e69 100644 --- a/workbuddy-plugin/INSTALL.md +++ b/workbuddy-plugin/INSTALL.md @@ -1,6 +1,6 @@ # Install OpenGUI into WorkBuddy -This guide installs the published OpenGUI 0.4.0 WorkBuddy connector on macOS. It uses the [official public-testing release](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.0); no source checkout, system Node installation, full backend deployment, or DSH installation is needed. +This guide installs the published OpenGUI 0.4.1 WorkBuddy connector on macOS. It uses the [official public-testing release](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1); no source checkout, system Node installation, full backend deployment, or DSH installation is needed. > [!IMPORTANT] > **Restart WorkBuddy once after installation.** Finish other tasks, **fully quit with ⌘Q**, then reopen WorkBuddy before authorizing the Skill and connector. Closing its window is not enough. @@ -15,7 +15,7 @@ curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-pl Alternatively, [download install.sh](https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh) and run `bash /actual/path/install.sh`. Installation runs on the Mac; restart WorkBuddy once afterward, then authorize OpenGUI and verify the connection. -The repository entry and its pinned installer/authorization guide are published together. They install the refreshed public-testing 0.4.0 runtime. This maintainer-requested replacement updates the release assets and their adjacent SHA-256 sidecars; previously downloaded files have different checksums. The [manual installation guide](resources/OpenGUI-安装指南.html) remains available as an alternative. +The repository entry and its pinned installer/authorization guide are published together. They install the refreshed public-testing 0.4.1 runtime. This release uses new versioned assets and adjacent SHA-256 sidecars; earlier releases remain unchanged. The [manual installation guide](resources/OpenGUI-安装指南.html) remains available as an alternative. The entry downloads the installer and a self-contained [authorization guide](resources/OpenGUI-授权指南.html), verifies their SHA-256 pins, and runs installation without a Terminal confirmation or Finder step. After successful configuration it opens the guide in the default browser and prints `AUTHORIZATION_GUIDE` and `INSTALLATION_RESULT` paths. WorkBuddy can display that same HTML if browser opening is unavailable. Browser failure does not mean installation failed; do not reinstall just to reopen the instructions. @@ -79,7 +79,7 @@ If Skill or connector authorization remains incomplete, reopen the authorization ## MCP missing after installation -The published 0.4.0 installer can write configuration while newer WorkBuddy versions are running, but that does not establish live reload. A local WorkBuddy 5.7.6 comparison found that neither external in-place writing nor atomic replacement updated the custom MCP list. Saving the same configuration through WorkBuddy's built-in MCP editor updated the list without restarting. See the [local verification record](docs/mcp-config-reload-verification.zh-CN.md). +The published 0.4.1 installer can write configuration while newer WorkBuddy versions are running, but that does not establish live reload. A local WorkBuddy 5.7.6 comparison found that neither external in-place writing nor atomic replacement updated the custom MCP list. Saving the same configuration through WorkBuddy's built-in MCP editor updated the list without restarting. See the [local verification record](docs/mcp-config-reload-verification.zh-CN.md). The standard installation flow requires one restart: finish other tasks, fully quit WorkBuddy with Command-Q, reopen it, then continue Skill authorization and MCP trust. If OpenGUI is still missing after that, open **Experts · Skills · Connectors → Connectors → Custom connectors → Add MCP** and check for the `opengui` entry in the expected configuration file. If it is absent, inspect the installer receipt and configuration path. The built-in editor's **Save** action is a verified manual refresh option; it is not the default onboarding step. If configuration is already loaded but a connection fails, inspect the actual error before restarting again. diff --git a/workbuddy-plugin/README.md b/workbuddy-plugin/README.md index ef9d1d3..4601e47 100644 --- a/workbuddy-plugin/README.md +++ b/workbuddy-plugin/README.md @@ -1,4 +1,4 @@ -# OpenGUI for WorkBuddy 0.4.0 +# OpenGUI for WorkBuddy 0.4.1 [中文说明](README.zh-CN.md). macOS public-testing candidate, protocol 8. Marketplace approval and the remaining real-device gates are separate. @@ -43,7 +43,7 @@ The complete steps and download link are in the [root README](../README.md#use-o Use the supplied installer and matching archive with adjacent SHA-256 sidecars: ```sh -bash scripts/install-macos.command --archive /absolute/path/opengui-mcp-0.4.0.tgz +bash scripts/install-macos.command --archive /absolute/path/opengui-mcp-0.4.1.tgz ``` The installer prepares private Node, verifies the package and scrcpy resources, and only then changes this host's configuration. After installation, restart WorkBuddy once to load the new MCP configuration, review external Hook changes in `/hooks`, and confirm the installed Skill in `/skills`. diff --git a/workbuddy-plugin/README.zh-CN.md b/workbuddy-plugin/README.zh-CN.md index baad80f..b9263a9 100644 --- a/workbuddy-plugin/README.zh-CN.md +++ b/workbuddy-plugin/README.zh-CN.md @@ -1,4 +1,4 @@ -# OpenGUI for WorkBuddy 0.4.0 候选版 +# OpenGUI for WorkBuddy 0.4.1 候选版 新任务默认手机操作／插件内推理预算各 1000 次；可在执行前声明 1–10000 次，旧任务恢复不扩大原上限。2／3 次只用于特定回归测试，不是产品默认值。用户明确约定总操作次数时，在首次观察／动作前向 `opengui_open_session` 传 `executionBudget: {operationLimit?, inferenceLimit?}`（1–10000）。观察和动作共用操作上限；推理上限只统计插件内调用，不能统计宿主模型调用。须核对工具返回的硬上限；目标／结束条件中的部分阿拉伯数字中文／英文总次数句式也会收紧上限，其他表述需用结构化字段声明。初始预算、已用次数随原任务恢复，模型不能调大或重置。工作台和报告展示实际限制；追加仍须原工作台用户授权。 @@ -44,7 +44,7 @@ WorkBuddy 使用内置 present_files，传入 URL 与当前工作目录。国内 核对安装器及归档旁的 SHA-256 文件，结束旧任务、关闭旧展示后运行： ```sh -bash scripts/install-macos.command --archive /绝对路径/opengui-mcp-0.4.0.tgz +bash scripts/install-macos.command --archive /绝对路径/opengui-mcp-0.4.1.tgz ``` 安装器自动准备独立 Node 与 scrcpy 资源，缓存完整时复用；准备失败保留旧配置，并输出恢复步骤。安装完成后重启一次 WorkBuddy，使新 MCP 配置加载生效；外部 Hook 变更在 `/hooks` 中审查应用，并在 `/skills` 中确认 `opengui`。可用 --check 做只读预检，用 --app 指定国内或海外应用。 diff --git a/workbuddy-plugin/connector/connector-meta.json b/workbuddy-plugin/connector/connector-meta.json index eb17918..acee726 100644 --- a/workbuddy-plugin/connector/connector-meta.json +++ b/workbuddy-plugin/connector/connector-meta.json @@ -7,7 +7,7 @@ "description_en": "Let WorkBuddy operate a locally connected Android phone or emulator for GUI testing and reviewed comment operations, with a live workbench for the screen, task plan and run trace.", "source": "opengui", "type": "mcp", - "version": "0.4.0", + "version": "0.4.1", "minWorkbuddyVersion": "5.5.3", "examples_zh": [ "@opengui", diff --git a/workbuddy-plugin/connector/mcp.json b/workbuddy-plugin/connector/mcp.json index f3fa269..742335c 100644 --- a/workbuddy-plugin/connector/mcp.json +++ b/workbuddy-plugin/connector/mcp.json @@ -6,7 +6,7 @@ "args": [ "--yes", "--prefer-offline", - "--package=https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.0/opengui-mcp-0.4.0.tgz", + "--package=https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.1/opengui-mcp-0.4.1.tgz", "opengui-mcp" ], "runtime": { "type": "node", "version": "^22.19.0 || >=24" }, diff --git a/workbuddy-plugin/connector/skills/control/SKILL.md b/workbuddy-plugin/connector/skills/control/SKILL.md index 86c0806..8b84b58 100644 --- a/workbuddy-plugin/connector/skills/control/SKILL.md +++ b/workbuddy-plugin/connector/skills/control/SKILL.md @@ -6,7 +6,7 @@ description: Complete authorized Android tasks and supported macOS iOS simulator description_zh: 根据真实截图完成用户指定的 Android 手机任务和已支持的 macOS iOS 模拟器测试，自动恢复、核验结果并释放控制锁。 description_en: Complete authorized Android tasks and supported iOS simulator tests through a screenshot-action loop, local displays, bounded recovery and automatic task cleanup. category: productivity -version: 0.4.0 +version: 0.4.1 author: OpenGUI --- diff --git a/workbuddy-plugin/connector/skills/control/installation.html b/workbuddy-plugin/connector/skills/control/installation.html index 6918577..083bb00 100644 --- a/workbuddy-plugin/connector/skills/control/installation.html +++ b/workbuddy-plugin/connector/skills/control/installation.html @@ -40,7 +40,7 @@

安装 OpenGUI

- 下载 macOS 安装包 + 下载 macOS 安装包

适用于 Apple 芯片和 Intel Mac · 下载后解压