diff --git a/README.ja-JP.md b/README.ja-JP.md index b1b8fb7..20a3277 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -56,7 +56,7 @@ OpenGUI は実際の画面を読み取り、自然言語の指示でスマート ## WorkBuddyへのインストール -**macOS(Apple Silicon / Intel)、WorkBuddy 5.5.3 以降**に対応しています。現在の公開版は [0.4.1 公開テスト版](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1)です。中国国内版と国際版は、同じ OpenGUI パッケージとバージョンを使用します。カスタム MCP としてインストールでき、コネクターマーケットへの掲載を待つ必要はありません。 +**macOS(Apple Silicon / Intel)、WorkBuddy 5.5.3 以降**に対応しています。現在の公開版は [0.4.2 公開テスト版](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2)です。中国国内版と国際版は、同じ OpenGUI パッケージとバージョンを使用します。カスタム MCP としてインストールでき、コネクターマーケットへの掲載を待つ必要はありません。 OpenGUI と WorkBuddy のアカウントは別です。OpenGUI の SMS ログインには現在も**中国本土の電話番号**が必要です。国際版 WorkBuddy に Google/GitHub でログインしても、OpenGUI には自動ログインされません。 @@ -70,20 +70,20 @@ macOS の Terminal で、使用する WorkBuddy のエディションに対応 **中国国内版 — WorkBuddy.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn ``` **国際版 — WorkBuddy AI.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official ``` インストール先のアプリを明示するため、両方のエディションがあっても対象を取り違えません。アプリの保存先や名前が異なる場合は、`--app` の後のパスを実際のものに置き換えてください。スクリプトは必要なファイルをダウンロードして検証し、ランタイムと OpenGUI を設定します。 中国国内版のコマンドは Node と npm の依存関係を npmmirror から取得し、失敗時は公式ソースへ切り替えます。国際版のコマンドは公式ソースを使います。中国国内版でも公式ソースを使う場合は、`--download-source cn` を `--download-source official` に変更してください。この設定は今回のインストールにのみ適用されます。動画コンポーネントは別途 GitHub から取得します。[ダウンロード元の選択](workbuddy-plugin/INSTALL.md#download-sources)も参照してください。 -[install.sh を個別にダウンロード](https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh)し、`bash /実際のパス/install.sh` に上記と同じ `--app` と `--download-source` の引数を付けて実行することもできます。 +[install.sh を個別にダウンロード](https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh)し、`bash /実際のパス/install.sh` に上記と同じ `--app` と `--download-source` の引数を付けて実行することもできます。 国際版のアカウント制限は[国際版のインストール説明](workbuddy-plugin/INSTALL.md#international-workbuddy)、認証と接続確認の詳細は[GitHub からのインストール手順(中国語)](workbuddy-plugin/docs/install-from-github.zh-CN.md)を参照してください。 @@ -124,7 +124,7 @@ OpenGUI が見つからない場合は「自定义连接器」の MCP サービ /opengui 【アプリ/画面】の【機能や操作フロー】をテストし、特に【確認する点】を確認してください。問題があれば手順とスクリーンショットを記録し、【終了条件】に達したら停止してください。 ``` -**表示言語(未公開)**:中国語/英語の切り替え、WorkBuddy の表示言語への追従、エミュレーター選択 UI の改善はテスト中です。公開ソースと 0.4.1 パッケージにはまだ含まれていません。言語切り替えは UI が対象で、タスクの説明、TODO の内容、確認用の下書きは原文を保持します。 +**表示言語(0.4.2)**:中国語/英語の切り替え、WorkBuddy の表示言語への追従、エミュレーター選択 UI の改善に対応しました。言語切り替えは UI が対象で、タスクの説明、TODO の内容、確認用の下書きは原文を保持します。 ## DeepSeek HarnessでOpenGUIを使う diff --git a/README.md b/README.md index 45fecca..8396355 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ After installation and authorization, enter these instructions in the correspond ## Use OpenGUI in WorkBuddy -Supported on **macOS (Apple Silicon / Intel) with WorkBuddy 5.5.3 or later**. The current public release is [0.4.1, a public-testing prerelease](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1). China and international WorkBuddy use the same OpenGUI package and version. Custom MCP installation is available without a connector marketplace listing. +Supported on **macOS (Apple Silicon / Intel) with WorkBuddy 5.5.3 or later**. The current public release is [0.4.2, a public-testing prerelease](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2). China and international WorkBuddy use the same OpenGUI package and version. Custom MCP installation is available without a connector marketplace listing. OpenGUI and WorkBuddy accounts are separate. OpenGUI SMS sign-in currently requires a **mainland-China phone number**; signing into international WorkBuddy with Google/GitHub does not sign you into OpenGUI. @@ -71,20 +71,20 @@ Open macOS Terminal and run the command for your WorkBuddy edition. If you use b **China edition — WorkBuddy.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn ``` **International edition — WorkBuddy AI.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official ``` These commands explicitly select the target application, so having both editions installed will not cause OpenGUI to be installed into the wrong one. If your application is elsewhere or has been renamed, replace the path after `--app` with its actual path. The script downloads and verifies the installation files, prepares the runtime, and configures OpenGUI. The China command uses npmmirror for Node and npm dependencies with official fallback; the international command uses official sources. To use official sources with China WorkBuddy, change `--download-source cn` to `--download-source official`. This setting applies only to this installation. Video assets use GitHub separately; an npm mirror does not accelerate them. See [download source options](workbuddy-plugin/INSTALL.md#download-sources) for a custom video mirror. -You can also [download install.sh separately](https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh) and run `bash /actual/path/install.sh` with the same `--app` and `--download-source` arguments shown above. +You can also [download install.sh separately](https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh) and run `bash /actual/path/install.sh` with the same `--app` and `--download-source` arguments shown above. See [international installation and account limitations](workbuddy-plugin/INSTALL.md#international-workbuddy), or the [GitHub installation flow (Chinese)](workbuddy-plugin/docs/install-from-github.zh-CN.md) for a copyable WorkBuddy prompt, native authorization and connection verification. @@ -127,7 +127,7 @@ Try it: Vibe Testing /opengui Help me test [feature or workflow] in [app/page], focusing on [issues to check]. If you find any problems, record the steps and screenshots. Stop when [end condition] is reached. ``` -**UI language (not yet released)**: Chinese/English switching, following WorkBuddy’s display language, and emulator-picker improvements are being tested. They are not yet included in the public source or 0.4.1 package. The language option translates interface labels; task descriptions, TODO content, and review drafts retain their original text. +**UI language (0.4.2)**: Chinese/English switching, following WorkBuddy’s display language, and emulator-picker improvements are included. The language option translates interface labels; task descriptions, TODO content, and review drafts retain their original text. ## Use OpenGUI in DeepSeek Harness diff --git a/README.zh-CN.md b/README.zh-CN.md index 017a74b..6b0dab3 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -56,7 +56,7 @@ OpenGUI 让 AI 根据真实屏幕截图理解 App,用自然语言完成手机 ## WorkBuddy 安装 -支持 **macOS(Apple 芯片 / Intel)和 WorkBuddy 5.5.3 及以上版本**。当前公开版本为 [0.4.1 公测预发布版](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1),国内版和国际版使用同一个 OpenGUI 安装包和版本号。通过自定义 MCP 安装,无需等待连接器市场上架。 +支持 **macOS(Apple 芯片 / Intel)和 WorkBuddy 5.5.3 及以上版本**。当前公开版本为 [0.4.2 公测预发布版](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2),国内版和国际版使用同一个 OpenGUI 安装包和版本号。通过自定义 MCP 安装,无需等待连接器市场上架。 OpenGUI 账号与 WorkBuddy 账号独立,当前 OpenGUI 短信登录仍需要**中国大陆手机号**;国际版 WorkBuddy 的 Google/GitHub 登录不会自动登录 OpenGUI。 @@ -70,20 +70,20 @@ OpenGUI 账号与 WorkBuddy 账号独立,当前 OpenGUI 短信登录仍需要* **国内版 — WorkBuddy.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn ``` **国际版 — WorkBuddy AI.app** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official ``` 上述命令明确指定目标应用,两版同时安装时也不会装错。如果应用不在默认位置或已重命名,请将 `--app` 后的路径替换为实际应用路径。脚本会下载安装文件并校验、准备运行环境,然后配置 OpenGUI。 国内版命令使用 npmmirror 下载 Node 和 npm 依赖,失败时回退官方源;国际版命令使用官方源。国内版需要使用官方源时,将 `--download-source cn` 改为 `--download-source official`。下载源设置只影响本次安装。视频组件来自 GitHub,换 npm 源不会加速它;有自己的视频镜像时,可加 `--video-mirror https://镜像地址/归档目录`,详见[下载源选项](workbuddy-plugin/INSTALL.md#download-sources)。 -也可以[单独下载安装脚本(install.sh)](https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh),保存后使用 `bash /实际路径/install.sh`,并附上对应命令中的 `--app` 和 `--download-source` 参数。 +也可以[单独下载安装脚本(install.sh)](https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh),保存后使用 `bash /实际路径/install.sh`,并附上对应命令中的 `--app` 和 `--download-source` 参数。 国际版现有账号限制见[国际版安装说明](workbuddy-plugin/INSTALL.md#international-workbuddy)。可复制的 WorkBuddy 安装提示词、授权和验证步骤见[从 GitHub 安装 OpenGUI](workbuddy-plugin/docs/install-from-github.zh-CN.md)。 @@ -126,7 +126,7 @@ cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/mai /opengui 帮我测试【应用/页面】的【功能或操作流程】,重点检查【关注的问题】。如果发现异常,记录操作步骤和截图,当做到【结束条件】就停。 ``` -**界面语言(尚未发布)**:中英文切换、默认跟随 WorkBuddy 语言和模拟器下拉框改进正在测试,尚未合入公开源码或 0.4.1 安装包。后续语言选项只翻译界面,任务描述、TODO 内容和审核草稿保留原文。 +**界面语言(0.4.2)**:已支持中英文切换、默认跟随 WorkBuddy 语言,并改进了模拟器下拉框。语言选项只翻译界面,任务描述、TODO 内容和审核草稿保留原文。 ## 在 DeepSeek Harness 中使用 OpenGUI diff --git a/workbuddy-plugin/CHANGELOG.md b/workbuddy-plugin/CHANGELOG.md index 3e5e287..c5a5198 100644 --- a/workbuddy-plugin/CHANGELOG.md +++ b/workbuddy-plugin/CHANGELOG.md @@ -1,4 +1,16 @@ -## 0.4.1 +# OpenGUI for WorkBuddy 0.4.2 public testing + +- Pin the curl entry, installer and authorization guide to immutable assets of the versioned release; the connector Skill references the versioned command and validation rejects branch or `latest` URLs. +- Add Chinese and English workbench UI with an accessible language selector, WorkBuddy display-language defaults, local preference persistence and synchronization across tabs. +- Follow each host's display-language changes independently even through a shared broker; retain Chinese/English overrides and fall back to the browser language when host metadata is unavailable. +- Switch UI language in place while preserving task text, review drafts, skip reasons, device streams and control state; clarify mainland-China SMS sign-in in both languages. +- Replace the native emulator dropdown with a keyboard-accessible picker in both device selection surfaces; wrap long names, bound the menu to the available space and adapt the start button to narrow panels in both languages. + +- Select China or international WorkBuddy explicitly with `--edition cn|international`, retaining existing automatic discovery and product-specific configuration paths. +- Default international WorkBuddy AI downloads to official Node/npm sources while preserving explicit source overrides. +- Verify both current WorkBuddy bundle identities with the isolated native-host MCP directory check; document the separate mainland-China account and marketplace requirements. + +# OpenGUI for WorkBuddy 0.4.1 public testing - 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. diff --git a/workbuddy-plugin/INSTALL.md b/workbuddy-plugin/INSTALL.md index 1ce8a39..baa780b 100644 --- a/workbuddy-plugin/INSTALL.md +++ b/workbuddy-plugin/INSTALL.md @@ -1,11 +1,11 @@ # Install OpenGUI into WorkBuddy -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. +This guide installs the published OpenGUI 0.4.2 WorkBuddy connector on macOS. It uses the [official public-testing release](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2); 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. -For copyable WorkBuddy chat prompts and the full Chinese flow, see [install from GitHub](docs/install-from-github.zh-CN.md). China and international WorkBuddy use the same OpenGUI 0.4.1 package and version. +For copyable WorkBuddy chat prompts and the full Chinese flow, see [install from GitHub](docs/install-from-github.zh-CN.md). China and international WorkBuddy use the same OpenGUI 0.4.2 package and version. ## Download and run the installer @@ -14,18 +14,18 @@ The complete download, authorization and first-task instructions are in the [roo **China edition — WorkBuddy.app:** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy.app" --download-source cn ``` **International edition — WorkBuddy AI.app:** ```sh -cd "$HOME" && curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official +cd "$HOME" && curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --app "/Applications/WorkBuddy AI.app" --download-source official ``` -Install separately if you use both editions. Replace the application path if it has been moved or renamed. Alternatively, [download install.sh](https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh) and run `bash /actual/path/install.sh` with the same `--app` and `--download-source` arguments. Restart the selected WorkBuddy once afterward, then authorize OpenGUI and verify the connection. +Install separately if you use both editions. Replace the application path if it has been moved or renamed. Alternatively, [download install.sh](https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh) and run `bash /actual/path/install.sh` with the same `--app` and `--download-source` arguments. Restart the selected 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.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, installer and authorization guide are immutable assets of the 0.4.2 release, so the reviewed command and the files users run stay identical. They install the public-testing 0.4.2 runtime with 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. @@ -41,7 +41,7 @@ Choose official Node.js and npm sources for one installation: bash /actual/path/install.sh --download-source official ``` -For the streamed entry, use `curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash -s -- --download-source official`. `--download-source cn` selects the default explicitly. `OPENGUI_DOWNLOAD_SOURCE=cn|official` also sets the default; command-line arguments take priority. +For the streamed entry, use `curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash -s -- --download-source official`. `--download-source cn` selects the default explicitly. `OPENGUI_DOWNLOAD_SOURCE=cn|official` also sets the default; command-line arguments take priority. The roughly 13 MB video component is a scrcpy release archive hosted on GitHub. It is separate from Node.js and npm; changing the npm registry does not accelerate it. GitHub bootstrap files and OpenGUI release packages also retain their official URLs. @@ -65,11 +65,11 @@ Automatic discovery recognizes `com.workbuddy.workbuddy`, `com.workbuddy.workbud ## International WorkBuddy -Custom MCP installation does not require a marketplace listing. Select **WorkBuddy AI.app** with `--app` and use `--download-source official`, as shown above. The OpenGUI 0.4.1 installer supports `--app`. +Custom MCP installation does not require a marketplace listing. Select **WorkBuddy AI.app** with `--app` and use `--download-source official`, as shown above. The OpenGUI 0.4.2 installer supports `--app`. The installer reads the selected application’s product metadata. Current international builds use `~/.workbuddy-ai` for MCP, Skill and Hook configuration; China builds use their own configuration root, normally `~/.workbuddy`. OpenGUI keeps shared private runtime/account/device state under `~/.workbuddy/opengui`, with separate installation receipts for each configuration root. Do not operate the same phone through both hosts concurrently. -OpenGUI’s SMS account is separate from WorkBuddy’s Google/GitHub account. OpenGUI currently requires a mainland-China phone number. Chinese/English switching and following WorkBuddy’s display language are being tested and are not yet included in the public source or 0.4.1 package. +OpenGUI’s SMS account is separate from WorkBuddy’s Google/GitHub account. OpenGUI currently requires a mainland-China phone number. The workbench UI supports Chinese/English and follows WorkBuddy’s display language by default. In international WorkBuddy AI, authorize and enable OpenGUI under **Experts · Skills · Connectors → Skills**. Then open **Connectors → Custom connectors**, find `opengui`, click **Trust**, and enable it. The user completes both authorizations. An update may trigger another Trust prompt when the runtime path changes. The [official MCP guide](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/MCP-Guide) also covers custom servers. @@ -102,7 +102,7 @@ If Skill or connector authorization remains incomplete, reopen the authorization ## MCP missing after installation -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 published 0.4.2 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 91e0f20..2fa89c7 100644 --- a/workbuddy-plugin/README.md +++ b/workbuddy-plugin/README.md @@ -1,6 +1,6 @@ -# OpenGUI for WorkBuddy 0.4.1 +# OpenGUI for WorkBuddy 0.4.2 -[中文说明](README.zh-CN.md). The current public release is [0.4.1, a public-testing prerelease](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1) for macOS, protocol 8. China and international WorkBuddy use the same OpenGUI package and version. Custom MCP installation does not require marketplace publication; real-device acceptance remains a separate check. +[中文说明](README.zh-CN.md). The current public release is [0.4.2, a public-testing prerelease](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2) for macOS, protocol 8. China and international WorkBuddy use the same OpenGUI package and version. Custom MCP installation does not require marketplace publication; real-device acceptance remains a separate check. See the [root installation steps](../README.md#use-opengui-in-workbuddy) for edition-specific commands, or the [GitHub installation flow (Chinese)](docs/install-from-github.zh-CN.md) to install from a WorkBuddy chat. OpenGUI has a separate SMS account that currently requires a mainland-China phone number. @@ -21,7 +21,7 @@ After first display authorization, video failure or page closure does not cancel ## Workbench -**UI language update — not yet released:** Chinese/English switching, following WorkBuddy’s display language, and an improved emulator picker are being tested and are not yet in the public source or 0.4.1 package. The planned default is **Follow WorkBuddy**, with manual **中文 / English** overrides and a browser-language fallback when the host setting is unavailable. Interface labels will change; task descriptions, TODO content, phone content, review drafts and recorded results will retain their original text. +**UI language (0.4.2):** Chinese/English switching, following WorkBuddy’s display language, and an improved emulator picker are included. The default is **Follow WorkBuddy**, with manual **中文 / English** overrides and a browser-language fallback when the host setting is unavailable. Only interface labels change; task descriptions, TODO content, phone content, review drafts and recorded results retain their original text. An exhausted blocked run can receive a human-confirmed finite continuation budget in its original workbench: 1–100 additional phone operations and plugin inference calls. The grant starts no work, retains the task ID and earlier result, and rejects stale/duplicate revisions. Copy its continuation prompt into the current chat, recover the same resumeTaskId, and establish fresh original-phone display and observation. This does not extend comment quantity/deadline endpoints, change task scope/model, clear unknown sends, or resume completed/cancelled/stopped tasks. Follow-mode host model calls remain unmeasured. @@ -47,7 +47,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 --app "/Applications/WorkBuddy AI.app" --download-source official --archive /absolute/path/opengui-mcp-0.4.1.tgz +bash scripts/install-macos.command --app "/Applications/WorkBuddy AI.app" --download-source official --archive /absolute/path/opengui-mcp-0.4.2.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 6005836..6f97817 100644 --- a/workbuddy-plugin/README.zh-CN.md +++ b/workbuddy-plugin/README.zh-CN.md @@ -1,6 +1,6 @@ -# OpenGUI for WorkBuddy 0.4.1 公测预发布版 +# OpenGUI for WorkBuddy 0.4.2 公测预发布版 -国内版和国际版 WorkBuddy 使用同一个 [OpenGUI 0.4.1 安装包](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.1)和版本号,通过自定义 MCP 安装,无需等待市场上架。两版安装命令见[根 README](../README.zh-CN.md#workbuddy-安装),WorkBuddy 聊天安装提示词和授权验证见[从 GitHub 安装](docs/install-from-github.zh-CN.md)。 +国内版和国际版 WorkBuddy 使用同一个 [OpenGUI 0.4.2 安装包](https://github.com/Core-Mate/OpenGUI/releases/tag/opengui-workbuddy-v0.4.2)和版本号,通过自定义 MCP 安装,无需等待市场上架。两版安装命令见[根 README](../README.zh-CN.md#workbuddy-安装),WorkBuddy 聊天安装提示词和授权验证见[从 GitHub 安装](docs/install-from-github.zh-CN.md)。 OpenGUI 账号与 WorkBuddy 账号独立,当前 OpenGUI 短信登录仍需中国大陆手机号;国际版 WorkBuddy 的 Google/GitHub 登录不会自动登录 OpenGUI。 @@ -24,7 +24,7 @@ WorkBuddy 使用内置 present_files,传入 URL 与当前工作目录。国内 ## 手机任务工作台 -**界面语言更新(尚未发布)**:中英文切换、默认跟随 WorkBuddy 语言和模拟器下拉框改进正在测试,尚未合入公开源码或 0.4.1 安装包。计划默认提供“跟随 WorkBuddy”,支持手动选择“中文 / English”,读取不到宿主设置时回退到浏览器语言。语言选项只翻译界面控件,任务描述、TODO 内容、手机内容、审核草稿和已记录结果保留原文。 +**界面语言(0.4.2)**:已支持中英文切换、默认跟随 WorkBuddy 语言,并改进了模拟器下拉框。默认选项为“跟随 WorkBuddy”,支持手动选择“中文 / English”,读取不到宿主设置时回退到浏览器语言。语言选项只翻译界面控件,任务描述、TODO 内容、手机内容、审核草稿和已记录结果保留原文。 看板按 `docs/preview.html` 原型布局:顶部设备 / 模型选择器(仅提供跟随 WorkBuddy)与接管操作,画面上方环境状态与连接帮助,等比例视频,下方任务步骤、任务报告和「本次运行」双轨时间线(模型 / 设备)及可展开的步骤记录,另有场景示例与连接帮助弹窗。正常 MCP 任务只绑定一台 Android 真机、Android 模拟器或已支持的 macOS iOS 模拟器;旧底层展示接口保留兼容。无设备时保留目标并展示接入指引,不准备视频或摆空手机框;可复用登录账号仍可用的上次选择,否则多台设备或失效偏好通过图形单选确认,无偏好时可选择唯一可用设备。选择器显示厂商型号、系统版本、尾号与连接方式,确认后等待新首帧。等待时保留宿主任务;看板不能自行唤醒结束的宿主回合。裸 mention 使用无目标的 opengui_open_guide。切换设备需先结束原任务。iOS 真机不支持,云手机尚未接入。执行模型固定跟随当前 WorkBuddy 对话,不读取线上模型配置。 @@ -50,7 +50,7 @@ WorkBuddy 使用内置 present_files,传入 URL 与当前工作目录。国内 核对安装器及归档旁的 SHA-256 文件,结束旧任务、关闭旧展示后运行: ```sh -bash scripts/install-macos.command --app "/Applications/WorkBuddy.app" --download-source cn --archive /绝对路径/opengui-mcp-0.4.1.tgz +bash scripts/install-macos.command --app "/Applications/WorkBuddy.app" --download-source cn --archive /绝对路径/opengui-mcp-0.4.2.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 acee726..f0f27ad 100644 --- a/workbuddy-plugin/connector/connector-meta.json +++ b/workbuddy-plugin/connector/connector-meta.json @@ -2,21 +2,19 @@ "name": "OpenGUI", "name_zh": "OpenGUI 手机助手", "name_en": "OpenGUI Android Assistant", - "description": "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.", - "description_zh": "连接手机,在右侧确认任务后开始。支持真实截图操作、App 测试和发布内容审核;执行进度自动更新,结束后生成报告。", - "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.", + "description": "Automate your phone for everyday tasks, app testing, content operations, chat and more. Say what you need, and let it take action. After initial setup and authorization, just plug in your phone and go. Leave repetitive tasks to AI, take back your time, and unleash your imagination.", + "description_zh": "自动操作你的手机,处理日常事务、测试 App、运营、聊天……说出你的需求,它来动手。 首次安装并授权后,即插即用。把繁琐操作交给 AI,把时间留给自己,释放你的想象力。", + "description_en": "Automate your phone for everyday tasks, app testing, content operations, chat and more. Say what you need, and let it take action. After initial setup and authorization, just plug in your phone and go. Leave repetitive tasks to AI, take back your time, and unleash your imagination.", "source": "opengui", "type": "mcp", - "version": "0.4.1", + "version": "0.4.2", "minWorkbuddyVersion": "5.5.3", "examples_zh": [ - "@opengui", - "@opengui 打开手机设置,再返回桌面,确认回到桌面后结束。", - "@opengui 帮我测试【应用/页面】的【功能】,输入【测试数据】,预期【结果】,做到【停止位置】就停。" + "/opengui 在小红书App中搜索“美食”,帮我获取前3篇贴子的内容整理给我。", + "/opengui 帮我打开微信App,查看有哪些未读的好友或群消息,告诉我好友/群的名字和未读条数。" ], "examples_en": [ - "@opengui", - "@opengui Open phone Settings, then return to the home screen. Verify the home screen and finish.", - "@opengui Test [feature] in [app/page] using [test data], expect [result], and stop at [endpoint]." + "/opengui Search for “美食” in Xiaohongshu, retrieve the content of the first 3 posts, and organize it for me.", + "/opengui Open WeChat and check which friend or group conversations have unread messages. Tell me each friend/group name and its unread message count." ] } diff --git a/workbuddy-plugin/connector/mcp.json b/workbuddy-plugin/connector/mcp.json index 742335c..6606948 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.1/opengui-mcp-0.4.1.tgz", + "--package=https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/opengui-mcp-0.4.2.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 8b84b58..f9d0c45 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.1 +version: 0.4.2 author: OpenGUI --- @@ -18,7 +18,7 @@ For a pre-submit endpoint pass `stopBeforeSubmit: true` to `opengui_open_session ### Installation help and connection checks -For a user-requested installation or reinstallation, direct the user to run `curl -fsSL https://raw.githubusercontent.com/Core-Mate/OpenGUI/main/workbuddy-plugin/install.sh | bash` in macOS Terminal to download and execute the official installer. They may instead save that script and run it with bash using its actual local path. Do not execute installation from the WorkBuddy chat. The script verifies its inputs, configures the plugin, saves this attempt's receipt, and opens the authorization guide. The [OpenGUI installation guide](installation.html) is available for users who prefer manual installation. Do not invent an alternative download URL or bypass host/system security prompts. +For a user-requested installation or reinstallation, direct the user to run `curl -fsSL https://github.com/Core-Mate/OpenGUI/releases/download/opengui-workbuddy-v0.4.2/install.sh | bash` in macOS Terminal to download and execute the official installer pinned to this OpenGUI version. They may instead save that script and run it with bash using its actual local path. Do not execute installation from the WorkBuddy chat. The script verifies its inputs, configures the plugin, saves this attempt's receipt, and opens the authorization guide. The [OpenGUI installation guide](installation.html) is available for users who prefer manual installation. Do not invent an alternative download URL or bypass host/system security prompts. After `status=configuration_written`, display the returned `AUTHORIZATION_GUIDE` file in the host if the automatic browser open is unavailable. The bundled [OpenGUI authorization guide](authorization.html) has the same Skill and connector instructions. Do not start another installation because authorization or browser opening is pending. `opengui_open_guide` opens the task workbench, not installation instructions. diff --git a/workbuddy-plugin/connector/skills/control/installation.html b/workbuddy-plugin/connector/skills/control/installation.html index 083bb00..df7ba65 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 · 下载后解压