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
4 changes: 2 additions & 2 deletions README.ja-JP.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ OpenGUI は実際の Android アプリ UI を読み取り、次のステップ
macOSでは、固定バージョンのインストーラーSkillをCodexに実行させる方法が最短です。Node.js 22.19以降または24以降が必要で、互換性のあるDSHバージョンは自動的にインストールされます。次の内容を1つのプロンプトとして送信します:

```text
Install and run the OpenGUI installer Skill from https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.5/deepseek-harness-plugin/skills/opengui-coremate-install for my DSH web profile. Only ask me for phone-side authorization and model credentials.
Install and run the OpenGUI installer Skill from https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.7/deepseek-harness-plugin/skills/opengui-coremate-install for my DSH web profile. Proceed autonomously, and only pause when I need to authorize or select a phone, add or select a DSH workspace, or provide fallback visual-model credentials.
```

Skillは公開ReleaseのパッケージとチェックサムをダウンロードしてSHA-256を検証し、OpenGUIプラグインだけをインストールします。必要な場合はDSHを起動して開き、既存のプラグインと設定は保持します。DSHがすでに起動していた場合は、一度再起動するとプラグインが読み込まれます。LinuxまたはWindowsでは、[手動パッケージガイド](./deepseek-harness-plugin/README.md#1-download-the-release-package)を使用してください。
Expand All @@ -52,7 +52,7 @@ Skillは公開Releaseのパッケージとチェックサムをダウンロー
@OpenGUI Open Settings and report the Android version
```

このプラグインは、OpenGUIバックエンド一式を必要とせず、DSHにスマートフォンとブラウザの操作機能を追加します。[ユースケース](./deepseek-harness-plugin/docs/use-cases.md)を確認するか、[v0.1.5リリースパッケージ](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.5)をダウンロードできます。
このプラグインは、OpenGUIバックエンド一式を必要とせず、DSHにスマートフォンとブラウザの操作機能を追加します。[ユースケース](./deepseek-harness-plugin/docs/use-cases.md)を確認するか、[v0.1.7リリースパッケージ](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7)をダウンロードできます。

主なユースケース:

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ OpenGUI reads a real Android app UI, plans the next step, takes mobile actions,
The shortest path on macOS is to let Codex run the pinned installer Skill. It requires Node.js 22.19+ or 24+ and installs the compatible DSH version automatically. Paste this as one prompt:

```text
Install and run the OpenGUI installer Skill from https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.5/deepseek-harness-plugin/skills/opengui-coremate-install for my DSH web profile. Only ask me for phone-side authorization and model credentials.
Install and run the OpenGUI installer Skill from https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.7/deepseek-harness-plugin/skills/opengui-coremate-install for my DSH web profile. Proceed autonomously, and only pause when I need to authorize or select a phone, add or select a DSH workspace, or provide fallback visual-model credentials.
```

The Skill downloads the public release package and checksum, verifies SHA-256, installs only the OpenGUI plugin, starts DSH when needed, and opens DSH. It preserves unrelated DSH plugins and settings. If DSH was already running, restart it once to load the plugin. For Linux or Windows, use the [manual package guide](./deepseek-harness-plugin/README.md#1-download-the-release-package).
Expand All @@ -53,7 +53,7 @@ After installation, add or select a DSH workspace, connect and select an authori
@OpenGUI Open Settings and report the Android version
```

The plugin adds phone and browser operation to DSH without requiring the full OpenGUI backend stack. See more [use cases](./deepseek-harness-plugin/docs/use-cases.md) or download the [v0.1.5 release package](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.5).
The plugin adds phone and browser operation to DSH without requiring the full OpenGUI backend stack. See more [use cases](./deepseek-harness-plugin/docs/use-cases.md) or download the [v0.1.7 release package](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7).

Good fits include:

Expand Down
4 changes: 2 additions & 2 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ OpenGUI 会读取真实 Android App 界面,规划下一步操作,执行移
macOS 上最短的路径,是让 Codex 运行固定版本的安装 Skill。环境需要 Node.js 22.19+ 或 24+,兼容的 DSH 版本会自动安装。把下面整段作为一条消息发给 Codex:

```text
请安装并运行这个 OpenGUI 安装 Skill:https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.5/deepseek-harness-plugin/skills/opengui-coremate-install,把插件安装到我的 DSH web profile。只在需要手机端授权或模型凭据时询问我。
请安装并运行这个 OpenGUI 安装 Skill:https://github.com/Core-Mate/OpenGUI/tree/dsh-coremate-mobile-v0.1.7/deepseek-harness-plugin/skills/opengui-coremate-install,把插件安装到我的 DSH web profile。请自主完成安装,仅在需要我授权或选择手机、添加或选择 DSH workspace,或者提供备用视觉模型凭据时暂停并询问我。
```

Skill 会下载公开 Release 的插件包和校验文件,验证 SHA-256,只安装 OpenGUI 插件,在需要时启动并打开 DSH,同时保留其他 DSH 插件和设置。如果 DSH 原本正在运行,重启一次即可加载插件。Linux 或 Windows 用户可按[手动安装说明](./deepseek-harness-plugin/README.zh.md#1-下载发布包)操作。
Expand All @@ -52,7 +52,7 @@ Skill 会下载公开 Release 的插件包和校验文件,验证 SHA-256,只
@OpenGUI 打开设置并报告 Android 版本
```

插件可以直接为 DSH 增加手机与浏览器操作能力,不需要部署完整的 OpenGUI 后端。你还可以查看更多[使用场景](./deepseek-harness-plugin/docs/use-cases.zh.md),或下载 [v0.1.5 安装包](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.5)。
插件可以直接为 DSH 增加手机与浏览器操作能力,不需要部署完整的 OpenGUI 后端。你还可以查看更多[使用场景](./deepseek-harness-plugin/docs/use-cases.zh.md),或下载 [v0.1.7 安装包](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7)。

适合的使用场景包括:

Expand Down
2 changes: 1 addition & 1 deletion deepseek-harness-plugin/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "opengui",
"version": "0.1.6",
"version": "0.1.7",
"description": "Control one to four local Android phones through bounded screenshots and allowlisted actions from Codex or DeepSeek Harness.",
"author": {
"name": "Core Mate",
Expand Down
18 changes: 9 additions & 9 deletions deepseek-harness-plugin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,35 +50,35 @@ The examples use the `web` profile and the default `$DSH_HOME=~/.dsh`. Substitut

### macOS: install with the Codex Skill

Ask Codex to install the repository skill from [`deepseek-harness-plugin/skills/opengui-coremate-install`](./skills/opengui-coremate-install), then invoke `$opengui-coremate-install`. The Skill downloads and verifies the pinned `v0.1.6` package from the public OpenGUI Release, preserves the rest of the `web` profile, and installs a per-user LaunchAgent so DSH returns after a crash or login. GitHub login is not required.
Ask Codex to install the repository skill from [`deepseek-harness-plugin/skills/opengui-coremate-install`](./skills/opengui-coremate-install), then invoke `$opengui-coremate-install`. The Skill downloads and verifies the pinned `v0.1.7` package from the public OpenGUI Release, preserves the rest of the `web` profile, and installs a per-user LaunchAgent so DSH returns after a crash or login. GitHub login is not required.

If port 3080 belongs to an OpenGUI-managed DSH, the installer safely reloads that LaunchAgent. It never terminates an unowned DSH process; in that case the new LaunchAgent takes over after the next login. The manual package flow below remains available on every supported host.

### 1. Download the release package

Download these files from the [public OpenGUI Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.6):
Download these files from the [public OpenGUI Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7):

- `dsh-coremate-mobile-0.1.6.tgz`
- `dsh-coremate-mobile-0.1.6.tgz.sha256`
- `dsh-coremate-mobile-0.1.7.tgz`
- `dsh-coremate-mobile-0.1.7.tgz.sha256`

Do not extract the `.tgz`, and do not use GitHub's automatically generated source archives.

From the directory containing both files, verify the package:

```sh
# Linux
sha256sum -c dsh-coremate-mobile-0.1.6.tgz.sha256
sha256sum -c dsh-coremate-mobile-0.1.7.tgz.sha256

# macOS
shasum -a 256 -c dsh-coremate-mobile-0.1.6.tgz.sha256
shasum -a 256 -c dsh-coremate-mobile-0.1.7.tgz.sha256
```

On Windows PowerShell, run `Get-FileHash .\dsh-coremate-mobile-0.1.6.tgz -Algorithm SHA256` and `Get-Content .\dsh-coremate-mobile-0.1.6.tgz.sha256`, then confirm that the displayed hashes match.
On Windows PowerShell, run `Get-FileHash .\dsh-coremate-mobile-0.1.7.tgz -Algorithm SHA256` and `Get-Content .\dsh-coremate-mobile-0.1.7.tgz.sha256`, then confirm that the displayed hashes match.

### 2. Install into a Harness profile

```sh
dsh plugin --profile web add /absolute/path/dsh-coremate-mobile-0.1.6.tgz
dsh plugin --profile web add /absolute/path/dsh-coremate-mobile-0.1.7.tgz
```

If you run the official CLI through `npx`, replace `dsh` in the commands with:
Expand Down Expand Up @@ -259,7 +259,7 @@ This is an advanced option: a profile patch replaces the target row's entire `co
Production installations should use the prebuilt release package above. For development, clone the public OpenGUI release tag and install the plugin directory:

```sh
git clone --branch dsh-coremate-mobile-v0.1.6 --depth 1 https://github.com/Core-Mate/OpenGUI.git
git clone --branch dsh-coremate-mobile-v0.1.7 --depth 1 https://github.com/Core-Mate/OpenGUI.git
cd OpenGUI/deepseek-harness-plugin
dsh plugin --profile web add "$(pwd)"
```
Expand Down
18 changes: 9 additions & 9 deletions deepseek-harness-plugin/README.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,35 +52,35 @@ codex plugin add opengui@opengui-local

### macOS:通过 Codex Skill 安装

让 Codex 从仓库的 [`deepseek-harness-plugin/skills/opengui-coremate-install`](./skills/opengui-coremate-install) 安装 Skill,然后调用 `$opengui-coremate-install`。Skill 会从 OpenGUI 的公开 Release 下载并校验固定的 `v0.1.6` 安装包,保留 `web` profile 中的其他配置,并安装用户级 LaunchAgent,让 DSH 在异常退出或重新登录后自动恢复;不要求登录 GitHub。
让 Codex 从仓库的 [`deepseek-harness-plugin/skills/opengui-coremate-install`](./skills/opengui-coremate-install) 安装 Skill,然后调用 `$opengui-coremate-install`。Skill 会从 OpenGUI 的公开 Release 下载并校验固定的 `v0.1.7` 安装包,保留 `web` profile 中的其他配置,并安装用户级 LaunchAgent,让 DSH 在异常退出或重新登录后自动恢复;不要求登录 GitHub。

如果 3080 端口属于 OpenGUI 管理的 DSH,安装器会安全更新并重启对应 LaunchAgent;如果属于其他 DSH 进程,安装器绝不会强制终止它,新 LaunchAgent 会在下次登录后接管。下面的手动安装方式仍适用于所有受支持的系统。

### 1. 下载发布包

从 [OpenGUI 公开 Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.6) 下载:
从 [OpenGUI 公开 Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7) 下载:

- `dsh-coremate-mobile-0.1.6.tgz`
- `dsh-coremate-mobile-0.1.6.tgz.sha256`
- `dsh-coremate-mobile-0.1.7.tgz`
- `dsh-coremate-mobile-0.1.7.tgz.sha256`

不要解压 `.tgz`,也不要下载 GitHub 自动生成的 Source code 压缩包。

在两个文件所在目录校验安装包:

```sh
# Linux
sha256sum -c dsh-coremate-mobile-0.1.6.tgz.sha256
sha256sum -c dsh-coremate-mobile-0.1.7.tgz.sha256

# macOS
shasum -a 256 -c dsh-coremate-mobile-0.1.6.tgz.sha256
shasum -a 256 -c dsh-coremate-mobile-0.1.7.tgz.sha256
```

Windows PowerShell 可分别执行 `Get-FileHash .\dsh-coremate-mobile-0.1.6.tgz -Algorithm SHA256` 和 `Get-Content .\dsh-coremate-mobile-0.1.6.tgz.sha256`,确认两者显示的哈希一致。
Windows PowerShell 可分别执行 `Get-FileHash .\dsh-coremate-mobile-0.1.7.tgz -Algorithm SHA256` 和 `Get-Content .\dsh-coremate-mobile-0.1.7.tgz.sha256`,确认两者显示的哈希一致。

### 2. 安装到 Harness profile

```sh
dsh plugin --profile web add /绝对路径/dsh-coremate-mobile-0.1.6.tgz
dsh plugin --profile web add /绝对路径/dsh-coremate-mobile-0.1.7.tgz
```

如果使用 `npx` 启动官方 CLI,可将命令中的 `dsh` 替换为:
Expand Down Expand Up @@ -261,7 +261,7 @@ OpenGUI 任务运行时,输入框右侧会出现方形“停止 OpenGUI 操作
生产环境应使用上面的预构建 Release 包。开发时可以 checkout OpenGUI 的公开 Release tag,再安装插件目录:

```sh
git clone --branch dsh-coremate-mobile-v0.1.6 --depth 1 https://github.com/Core-Mate/OpenGUI.git
git clone --branch dsh-coremate-mobile-v0.1.7 --depth 1 https://github.com/Core-Mate/OpenGUI.git
cd OpenGUI/deepseek-harness-plugin
dsh plugin --profile web add "$(pwd)"
```
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "opengui",
"version": "0.1.6",
"version": "0.1.7",
"description": "Guide Codex through safe local Android control with OpenGUI's packaged CLI and bounded observation workflow.",
"author": {
"name": "Core Mate",
Expand Down
8 changes: 4 additions & 4 deletions deepseek-harness-plugin/docs/install-for-beginners.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

## 目前能不能直接安装?

可以。从 [OpenGUI 的公开 Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.6) 打开插件版本,在 Assets 中下载 `dsh-coremate-mobile-0.1.6.tgz`。
可以。从 [OpenGUI 的公开 Release](https://github.com/Core-Mate/OpenGUI/releases/tag/dsh-coremate-mobile-v0.1.7) 打开插件版本,在 Assets 中下载 `dsh-coremate-mobile-0.1.7.tgz`。

下载后不要解压。不要下载 “Source code (zip)” 或 “Source code (tar.gz)”;它们是 GitHub 自动生成的源码压缩包,不是普通用户安装包。

Expand All @@ -13,7 +13,7 @@
开始前确认以下事项:

1. 电脑已经能启动官方 DeepSeek Harness;当前已验证版本为 `0.1.0-rc.7`。
2. 已下载 `dsh-coremate-mobile-0.1.6.tgz`,并且没有解压。
2. 已下载 `dsh-coremate-mobile-0.1.7.tgz`,并且没有解压。
3. 电脑能访问公开的 GitHub Releases;不需要登录 GitHub。
4. Node.js 版本为 `22.19.x`,或 `24` 及以上。如果 `node --version` 不在这个范围,请先切换到受支持版本。
5. Harness 当前对话里已选择一个模型。该模型最好支持图片输入和工具调用;如果不兼容,OpenGUI 会在第一次真实任务时引导配置专用视觉模型。
Expand Down Expand Up @@ -42,9 +42,9 @@ npx @deepseek-ai/dsh@0.1.0-rc.7 --help
npx @deepseek-ai/dsh@0.1.0-rc.7 plugin --profile web add
```

找到下载好的 `dsh-coremate-mobile-0.1.6.tgz`,用鼠标把它拖进终端窗口,终端会自动填入文件路径,然后按回车。
找到下载好的 `dsh-coremate-mobile-0.1.7.tgz`,用鼠标把它拖进终端窗口,终端会自动填入文件路径,然后按回车。

看到 `dsh-coremate-mobile 0.1.6` 和安装完成信息,表示插件文件已经加入 Harness。此时还没有证明插件能够启动;第五步会进行实际装载验证。
看到 `dsh-coremate-mobile 0.1.7` 和安装完成信息,表示插件文件已经加入 Harness。此时还没有证明插件能够启动;第五步会进行实际装载验证。

### 如果出现 `ERR_PNPM_IGNORED_BUILDS`

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# OpenGUI 0.1.6 Plugin Release Notes
# OpenGUI 0.1.7 Plugin Release Notes

- Adds a Codex plugin manifest, repo marketplace entry, and `opengui:control` Skill beside the existing DeepSeek Harness plugin.
- Adds seven local stdio MCP interfaces and the equivalent persistent local CLI transport.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ pnpm dsh plugin --profile web add ../Deepseek-ai
插件迁入 OpenGUI monorepo 后,不应把仓库根目录当作插件包直接交给 DSH。开发验证应固定插件 release tag,checkout 后安装其中的 `deepseek-harness-plugin` 目录:

```sh
git clone --branch dsh-coremate-mobile-v0.1.6 --depth 1 \
git clone --branch dsh-coremate-mobile-v0.1.7 --depth 1 \
https://github.com/Core-Mate/OpenGUI.git
cd OpenGUI/deepseek-harness-plugin
pnpm build
Expand Down
2 changes: 1 addition & 1 deletion deepseek-harness-plugin/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "dsh-coremate-mobile",
"version": "0.1.6",
"version": "0.1.7",
"description": "Dual-host OpenGUI plugin for DeepSeek Harness and Codex Android control",
"repository": {
"type": "git",
Expand Down
4 changes: 2 additions & 2 deletions deepseek-harness-plugin/scripts/validate-codex-plugin.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ const publicPlugin = await json('codex-public/.codex-plugin/plugin.json')
const mcp = await json('.mcp.json')
const marketplace = await json('../.agents/plugins/marketplace.json')

if (pkg.version !== '0.1.6' || plugin.version !== pkg.version || publicPlugin.version !== pkg.version) {
throw new Error('package, Codex, and public Skills-only versions must all be 0.1.6')
if (pkg.version !== '0.1.7' || plugin.version !== pkg.version || publicPlugin.version !== pkg.version) {
throw new Error('package, Codex, and public Skills-only versions must all be 0.1.7')
}
if (pkg.name !== 'dsh-coremate-mobile' || plugin.name !== 'opengui' || publicPlugin.name !== 'opengui') {
throw new Error('internal package identity or public OpenGUI identity changed unexpectedly')
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
name: opengui-coremate-install
description: Install the pinned OpenGUI v0.1.6 release into a DeepSeek Harness web profile on macOS. Use when the user asks to download, install, update, open, or verify OpenGUI for DSH.
description: Install the pinned OpenGUI v0.1.7 release into a DeepSeek Harness web profile on macOS. Use when the user asks to download, install, update, open, or verify OpenGUI for DSH.
---

# Install OpenGUI

Install and verify the signed-off `v0.1.6` release without replacing unrelated DSH plugins or settings.
Install and verify the signed-off `v0.1.7` release without replacing unrelated DSH plugins or settings.

## Run the installer

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
interface:
display_name: "OpenGUI Installer"
short_description: "Install verified OpenGUI v0.1.6 into DSH on macOS"
short_description: "Install verified OpenGUI v0.1.7 into DSH on macOS"
icon_small: "./assets/opengui-mark.svg"
icon_large: "./assets/opengui-wordmark.svg"
brand_color: "#F1BF1F"
default_prompt: "Use $opengui-coremate-install to download, verify, install, and open OpenGUI v0.1.6 for my DSH web profile."
default_prompt: "Use $opengui-coremate-install to download, verify, install, and open OpenGUI v0.1.7 for my DSH web profile."
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail

release_version="0.1.6"
release_version="0.1.7"
dsh_version="0.1.0-rc.7"
profile="web"
port="${COREMATE_INSTALL_PORT_OVERRIDE:-3080}"
Expand Down
2 changes: 1 addition & 1 deletion deepseek-harness-plugin/tests/codex-plugin.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ describe('Codex plugin package', () => {
const [pkg, plugin, publicPlugin] = await Promise.all([
json('package.json'), json('.codex-plugin/plugin.json'), json('codex-public/.codex-plugin/plugin.json'),
])
expect([pkg.version, plugin.version, publicPlugin.version]).toEqual(['0.1.6', '0.1.6', '0.1.6'])
expect([pkg.version, plugin.version, publicPlugin.version]).toEqual(['0.1.7', '0.1.7', '0.1.7'])
expect(pkg.name).toBe('dsh-coremate-mobile')
expect(plugin).toMatchObject({ name: 'opengui', skills: './skills/', mcpServers: './.mcp.json' })
expect(publicPlugin).toMatchObject({ name: 'opengui', skills: './skills/' })
Expand Down
Loading
Loading