Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions workbuddy-plugin/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
6 changes: 3 additions & 3 deletions workbuddy-plugin/INSTALL.md
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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.

Expand Down Expand Up @@ -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.

Expand Down
4 changes: 2 additions & 2 deletions workbuddy-plugin/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down Expand Up @@ -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`.
Expand Down
4 changes: 2 additions & 2 deletions workbuddy-plugin/README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -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)。观察和动作共用操作上限;推理上限只统计插件内调用,不能统计宿主模型调用。须核对工具返回的硬上限;目标/结束条件中的部分阿拉伯数字中文/英文总次数句式也会收紧上限,其他表述需用结构化字段声明。初始预算、已用次数随原任务恢复,模型不能调大或重置。工作台和报告展示实际限制;追加仍须原工作台用户授权。

Expand Down Expand Up @@ -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 指定国内或海外应用。
Expand Down
2 changes: 1 addition & 1 deletion workbuddy-plugin/connector/connector-meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 1 addition & 1 deletion workbuddy-plugin/connector/mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -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" },
Expand Down
2 changes: 1 addition & 1 deletion workbuddy-plugin/connector/skills/control/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down
Loading
Loading