Release v0.1.16

Author: iFurySt

README.md

@@ -50,18 +50,17 @@ While the Chrome Web Store item is pending review, use the latest GitHub
 Release zip as an unpacked extension instead:
 
 ```bash
-open-browser-use setup release
+open-browser-use setup beta
 ```
 
-`setup release` downloads the latest
+`setup beta` downloads the latest
 `open-browser-use-chrome-extension-*.zip` from
 [GitHub Releases](https://github.com/iFurySt/open-codex-browser-use/releases)
 and unpacks it under Application Support. It pins a stable unpacked extension
 id, registers the native host for that id, opens `chrome://extensions/`, and
 reveals a keyed manual-install ZIP in Finder or the system file manager. Enable
 Developer mode, then drag that ZIP file into the Chrome extensions page to
-install it manually with the same id. The alias `open-browser-use setup offline`
-is also available for this non-Web-Store path.
+install it manually with the same id.
 
 If you only need to repair the native messaging host registration, run:
 

README.zh-CN.md

@@ -47,17 +47,16 @@ Chrome Web Store 条目还在审核时，可以改用最新 GitHub Release zip
 unpacked extension 方式安装：
 
 ```bash
-open-browser-use setup release
+open-browser-use setup beta
 ```
 
-`setup release` 会从
+`setup beta` 会从
 [GitHub Releases](https://github.com/iFurySt/open-codex-browser-use/releases)
 下载最新的 `open-browser-use-chrome-extension-*.zip`，展开到 Application
 Support，写入稳定 unpacked extension id，并用该 id 注册 native host，然后打开
 `chrome://extensions/`，同时在 Finder 或系统文件管理器中定位已写入稳定 key 的
 手动安装 ZIP。打开 Developer mode 后，把这个 ZIP 拖到 Chrome 扩展页面即可用同
 一个 id 手动安装。
-`open-browser-use setup offline` 也作为这个非商店安装路径的别名可用。
 
 如果只需要修复 native messaging host 注册，运行：
 

apps/chrome-extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Open Browser Use",
   "description": "Open Browser Use Chrome automation extension.",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "icons": {
     "16": "icons/icon-16.png",
     "32": "icons/icon-32.png",

cmd/open-browser-use/main.go

@@ -24,10 +24,10 @@ import (
 	"github.com/spf13/cobra"
 )
 
-const version = "0.1.15"
+const version = "0.1.16"
 const defaultChromeExtensionID = "bgjoihaepiejlfjinojjfgokghnodnhd"
 const chromeWebStoreUpdateURL = "https://clients2.google.com/service/update2/crx"
-const offlineExtensionPublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnBLT95WWVnHYH0pOBRH/eP+BWtlKVmLE/RHkERUTI2+PGDSQrbWVabmTw4CZ3yhjko04dijSX2Az8cnp65xh23Dh5mP5TCtiP9LexRFJokd8EsyeFdtKamMYr0hF1ZUc1/8ZpLnetAU65ZMB9VzHQBqpJWeUwuIvecgfRtGklDgJMjnvcq5J6pttZrzWrI/2B0BNufwsTQfEt7qLtDFPHXmUdtZfQbc2EfYFvkXLDAXicYviiocedrsAGIKUxpyQegobhUFL+tNLOuXKBpZlLFQn3xgm5CyGZwN6bueiV/S7reigVTKAMQ8BX0eacT22e8r0UzjsjkugeHOIonIvtQIDAQAB"
+const betaExtensionPublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnBLT95WWVnHYH0pOBRH/eP+BWtlKVmLE/RHkERUTI2+PGDSQrbWVabmTw4CZ3yhjko04dijSX2Az8cnp65xh23Dh5mP5TCtiP9LexRFJokd8EsyeFdtKamMYr0hF1ZUc1/8ZpLnetAU65ZMB9VzHQBqpJWeUwuIvecgfRtGklDgJMjnvcq5J6pttZrzWrI/2B0BNufwsTQfEt7qLtDFPHXmUdtZfQbc2EfYFvkXLDAXicYviiocedrsAGIKUxpyQegobhUFL+tNLOuXKBpZlLFQn3xgm5CyGZwN6bueiV/S7reigVTKAMQ8BX0eacT22e8r0UzjsjkugeHOIonIvtQIDAQAB"
 
 func main() {
 	if err := run(os.Args[1:]); err != nil {
@@ -135,20 +135,19 @@ func newSetupCommand() *cobra.Command {
 	cmd.Flags().StringVar(&extensionID, "extension-id", defaultChromeExtensionID, "Chrome extension id for allowed_origins")
 	cmd.Flags().StringVar(&binaryPath, "path", "", "native host binary target for the stable host link")
 	cmd.Flags().StringVar(&externalExtensionOutput, "external-extension-output", "", "Chrome external extension JSON output path")
-	cmd.AddCommand(newSetupReleaseCommand())
+	cmd.AddCommand(newSetupBetaCommand())
 	return cmd
 }
 
-func newSetupReleaseCommand() *cobra.Command {
+func newSetupBetaCommand() *cobra.Command {
 	extensionID := defaultChromeExtensionID
 	var binaryPath string
 	var zipPath string
 	var noOpen bool
 	cmd := &cobra.Command{
-		Use:     "release",
-		Aliases: []string{"offline"},
-		Short:   "Register the native host and prepare the latest release extension",
-		Args:    cobra.NoArgs,
+		Use:   "beta",
+		Short: "Register the native host and prepare the beta extension package",
+		Args:  cobra.NoArgs,
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			resolvedZIPPath := zipPath
 			if resolvedZIPPath == "" {
@@ -192,8 +191,8 @@ func newSetupReleaseCommand() *cobra.Command {
 				}
 			}
 			status := detectBrowserExtension(host.DefaultSocketDir, 700*time.Millisecond)
-			status.InstallCommand = "open-browser-use setup offline"
-			status.UpgradeCommand = "open-browser-use setup offline"
+			status.InstallCommand = "open-browser-use setup beta"
+			status.UpgradeCommand = "open-browser-use setup beta"
 			return renderManualSetupResult(cmd.OutOrStdout(), manualSetupResult{
 				NativeManifestPath: manifestPath,
 				ExtensionID:        effectiveExtensionID,
@@ -340,7 +339,7 @@ func renderStartupStatus(writer io.Writer) error {
 	fmt.Fprintln(writer, "Next steps:")
 	if status.needsInstall() {
 		fmt.Fprintf(writer, "  1. Install the browser extension: %s\n", status.InstallCommand)
-		fmt.Fprintln(writer, "     If the Chrome Web Store item is unavailable, use: open-browser-use setup offline")
+		fmt.Fprintln(writer, "     If the Chrome Web Store item is unavailable, use: open-browser-use setup beta")
 		fmt.Fprintln(writer, "  2. Restart Chrome if it asks you to enable the extension.")
 		fmt.Fprintln(writer, "  3. Verify the connection: open-browser-use info")
 		return nil
@@ -452,8 +451,8 @@ type detectedExtension struct {
 
 func detectInstalledChromeExtension() (detectedExtension, bool) {
 	candidates := []string{defaultChromeExtensionID}
-	if offlineID, err := extensionIDFromPublicKey(offlineExtensionPublicKey); err == nil && offlineID != defaultChromeExtensionID {
-		candidates = append(candidates, offlineID)
+	if betaID, err := extensionIDFromPublicKey(betaExtensionPublicKey); err == nil && betaID != defaultChromeExtensionID {
+		candidates = append(candidates, betaID)
 	}
 	var best detectedExtension
 	for _, extensionID := range candidates {
@@ -1390,7 +1389,7 @@ func pinUnpackedExtensionKey(manifestPath string) (string, error) {
 	}
 	key, _ := manifest["key"].(string)
 	if strings.TrimSpace(key) == "" {
-		key = offlineExtensionPublicKey
+		key = betaExtensionPublicKey
 		manifest["key"] = key
 		updated, err := json.MarshalIndent(manifest, "", "  ")
 		if err != nil {

cmd/open-browser-use/main_test.go

@@ -240,7 +240,7 @@ func TestCobraSetupWritesNativeAndExternalManifests(t *testing.T) {
 	}
 }
 
-func TestCobraSetupOfflineAliasUsesProvidedZIP(t *testing.T) {
+func TestCobraSetupBetaUsesProvidedZIP(t *testing.T) {
 	if runtime.GOOS == "windows" {
 		t.Skip("stable native host link is not implemented on windows")
 	}
@@ -251,7 +251,7 @@ func TestCobraSetupOfflineAliasUsesProvidedZIP(t *testing.T) {
 		t.Fatal(err)
 	}
 	zipPath := filepath.Join(t.TempDir(), "open-browser-use-chrome-extension.zip")
-	expectedExtensionID, err := extensionIDFromPublicKey(offlineExtensionPublicKey)
+	expectedExtensionID, err := extensionIDFromPublicKey(betaExtensionPublicKey)
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -262,23 +262,23 @@ func TestCobraSetupOfflineAliasUsesProvidedZIP(t *testing.T) {
 	cmd := newRootCommand()
 	var output bytes.Buffer
 	cmd.SetOut(&output)
-	cmd.SetArgs([]string{"setup", "offline", "--path", targetPath, "--zip", zipPath, "--no-open"})
+	cmd.SetArgs([]string{"setup", "beta", "--path", targetPath, "--zip", zipPath, "--no-open"})
 	if err := cmd.Execute(); err != nil {
 		t.Fatal(err)
 	}
 	manualZIPPath := manualInstallZIPPath(zipPath)
 	got := output.String()
 	if !strings.Contains(got, "ZIP:") || !strings.Contains(got, manualZIPPath) {
-		t.Fatalf("expected setup offline output to mention manual ZIP path, got %q", got)
+		t.Fatalf("expected setup beta output to mention manual ZIP path, got %q", got)
 	}
 	if strings.Contains(got, "ZIP: "+zipPath) {
-		t.Fatalf("expected setup offline output to avoid the raw release ZIP path, got %q", got)
+		t.Fatalf("expected setup beta output to avoid the raw release ZIP path, got %q", got)
 	}
 	if !strings.Contains(got, "Extension id: "+expectedExtensionID) {
-		t.Fatalf("expected setup offline output to mention unpacked extension id, got %q", got)
+		t.Fatalf("expected setup beta output to mention unpacked extension id, got %q", got)
 	}
 	if !strings.Contains(got, "Drag the ZIP file into the Chrome extensions page") {
-		t.Fatalf("expected setup offline output to mention manual ZIP drag install, got %q", got)
+		t.Fatalf("expected setup beta output to mention manual ZIP drag install, got %q", got)
 	}
 	manifestPath := filepath.Join(home, "Library/Application Support/Google/Chrome/NativeMessagingHosts", host.NativeHostName+".json")
 	if runtime.GOOS == "linux" {
@@ -299,14 +299,14 @@ func TestCobraSetupOfflineAliasUsesProvidedZIP(t *testing.T) {
 	if err != nil {
 		t.Fatal(err)
 	}
-	if !strings.Contains(string(unpackedManifest), offlineExtensionPublicKey) {
+	if !strings.Contains(string(unpackedManifest), betaExtensionPublicKey) {
 		t.Fatalf("expected unpacked manifest to include stable key, got %s", unpackedManifest)
 	}
 	manualManifest, err := readManifestFromZIP(manualZIPPath)
 	if err != nil {
 		t.Fatal(err)
 	}
-	if !strings.Contains(string(manualManifest), offlineExtensionPublicKey) {
+	if !strings.Contains(string(manualManifest), betaExtensionPublicKey) {
 		t.Fatalf("expected manual ZIP manifest to include stable key, got %s", manualManifest)
 	}
 }

docs/ARCHITECTURE.md

@@ -94,23 +94,22 @@ dot；hyphen 版本 `com.ifuryst.open-computer-use.extension` 会被
   注册，再写入 Chrome External Extensions JSON，让 Chrome 从 Web Store
   安装正式扩展。macOS/Windows 仍需要用户在 Chrome 中确认启用扩展；Linux
   的 External Extensions 写入默认使用 Chrome 官方系统路径，可能需要更高权限。
-- `open-browser-use setup release`：审核期或非 Web Store 路径，注册 native
+- `open-browser-use setup beta`：审核期或非 Web Store 路径，注册 native
   host 后从 GitHub Releases 下载最新
   `open-browser-use-chrome-extension-*.zip`，展开为 unpacked extension，写入稳定
   public key 生成固定 extension id，用该 id 注册 native host allowed origin，再
   从 keyed unpacked 目录生成手动安装 ZIP，并打开 `chrome://extensions/` 和
-  Finder/文件管理器，引导用户把这个 ZIP 拖到扩展页面手动安装；
-  `setup offline` 是这个 release 路径的别名。
+  Finder/文件管理器，引导用户把这个 ZIP 拖到扩展页面手动安装。
 - manifest 的 `path` 默认统一写入稳定 native host link：
   macOS 为
   `~/Library/Application Support/OpenBrowserUse/native-host/open-browser-use`，
   Linux 为 `~/.local/share/open-browser-use/native-host/open-browser-use`。
   `install-manifest --path` 表示这个稳定 link 指向的真实二进制 target。
 - npm 包 `open-browser-use` 是 CLI 二进制分发入口，安装后提供
-  `open-browser-use` 和 `obu`；`postinstall` 只提示用户运行显式
-  `open-browser-use setup`。
+  `open-browser-use` 和 `obu`；Chrome Web Store 上架前，`postinstall` 只提示
+  用户运行显式 `open-browser-use setup beta`。
 - Homebrew formula 安装后提供 `open-browser-use` 和 `obu`，并在
-  caveats 中提示用户运行显式 `open-browser-use setup`。
+  caveats 中提示用户运行显式 `open-browser-use setup beta`。
 - CLI 命令层使用 Cobra 实现；Chrome native messaging
   `chrome-extension://...` origin 参数启动时会绕过 Cobra，直接进入 host mode。
   这依赖 Chrome Native Messaging 的标准启动形状：MV3 service worker 调用

docs/CHROME_WEB_STORE_RELEASE.md

@@ -28,15 +28,14 @@ open-browser-use install-manifest
 Chrome Web Store 条目仍在审核时，用 GitHub Release zip 的 unpacked 路径：
 
 ```bash
-open-browser-use setup release
+open-browser-use setup beta
 ```
 
-`setup release` 会下载最新 release zip，展开到用户 Application Support 目录，
+`setup beta` 会下载最新 release zip，展开到用户 Application Support 目录，
 给 unpacked manifest 写入稳定 public key，注册 native host allowed origin，并打开
 `chrome://extensions/`，同时在 Finder 或系统文件管理器中定位已写入稳定 key 的
 手动安装 ZIP。用户需要打开 Developer mode，把这个 ZIP 拖到 Chrome 扩展页面完
 成手动安装。
-`setup offline` 是同一路径的别名，但它仍会联网访问 GitHub Release。
 
 `install-manifest` 会把 manifest 的 `path` 写成稳定 native host link：
 `~/Library/Application Support/OpenBrowserUse/native-host/open-browser-use`，并
@@ -67,16 +66,16 @@ dist/chrome-extension/package-manifest.json
 dist/chrome-extension/crx-manifest.json
 ```
 
-`.zip` 是 Chrome Web Store 上传包，也是 `setup release` 下载并展开的审核期安装包。
+`.zip` 是 Chrome Web Store 上传包，也是 `setup beta` 下载并展开的审核期安装包。
 `.crx` 会保留在 GitHub Release 里用于制品归档、Chromium/企业策略/自托管更新等
 场景；Chrome Stable 对非 Web Store CRX 会报 `CRX_REQUIRED_PROOF_MISSING`，
 不要把它作为普通用户安装入口。
 
-`setup release` 默认会用 CLI 内置的 unpacked public key 计算 extension id；如果需要
+`setup beta` 默认会用 CLI 内置的 unpacked public key 计算 extension id；如果需要
 手工覆盖 native host allowed origin，可以运行：
 
 ```bash
-open-browser-use setup release --extension-id <extensionId>
+open-browser-use setup beta --extension-id <extensionId>
 ```
 
 ## GitHub Release

docs/SECURITY.md

@@ -26,7 +26,7 @@
   `allowed_origins` 限制可启动 extension 来源。
 - `open-browser-use setup` 会写入 Chrome External Extensions JSON，让 Chrome
   从 Chrome Web Store 安装正式扩展；用户仍需要接受 Chrome 的扩展启用提示。
-  `setup release` 只用于审核期或非商店路径，会下载 GitHub Release zip，展开为
+  `setup beta` 只用于审核期或非商店路径，会下载 GitHub Release zip，展开为
   unpacked extension，写入稳定 key 后重新生成手动安装 ZIP，并要求用户在 Chrome
   扩展页显式拖入该 ZIP 完成手动安装。
 - MV3 extension 使用 `chrome.debugger`、`tabs`、`tabGroups`、`history` 和

docs/histories/2026-05/20260509-1808-beta-setup-command.md

@@ -0,0 +1,46 @@
+## [2026-05-09 18:08] | Task: rename manual setup command to beta
+
+### 🤖 Execution Context
+
+- **Agent ID**: `Codex`
+- **Base Model**: `GPT-5`
+- **Runtime**: `Codex CLI`
+
+### 📥 User Query
+
+> 安装后不要再提示 `open-browser-use setup release`；干掉 `setup release`，
+> 只保留 `setup` 和 `setup beta`（原来的 offline 路径），安装提示改成：
+> `执行以下命令安装： open-browser-use setup beta`。
+
+### 🛠 Changes Overview
+
+**Scope:** Go CLI, npm CLI package, Homebrew formula renderer, docs, skill references, version metadata.
+
+**Key Actions:**
+
+- **[CLI]**: 将手动安装入口从 `setup release/offline` 改为 `setup beta`，并让状态输出中的备用安装命令指向 `open-browser-use setup beta`。
+- **[Install Guidance]**: 将 npm `postinstall` 和 Homebrew caveats 缩短为只提示执行 `open-browser-use setup beta`。
+- **[Docs]**: 同步 README、架构、安全、Chrome Web Store 发布和 skill 安装/排障文档，并记录 `0.1.16` 用户可感知变更。
+
+### 🧠 Design Intent (Why)
+
+Chrome Web Store 条目上架前，用户真正需要的是一条稳定的审核期安装路径。
+把 `release` 和 `offline` 两个名字收口为 `beta`，可以降低安装后提示的分叉和误解；
+后续商店上架后再把默认提示切回正式 `setup` 路径。
+
+### 📁 Files Modified
+
+- `cmd/open-browser-use/main.go`
+- `cmd/open-browser-use/main_test.go`
+- `packages/open-browser-use-cli/cli/postinstall.js`
+- `scripts/render-homebrew-formula.sh`
+- `README.md`
+- `README.zh-CN.md`
+- `packages/open-browser-use-cli/README.md`
+- `docs/ARCHITECTURE.md`
+- `docs/SECURITY.md`
+- `docs/CHROME_WEB_STORE_RELEASE.md`
+- `docs/releases/feature-release-notes.md`
+- `skills/open-browser-use/references/installation.md`
+- `skills/open-browser-use/references/troubleshooting.md`
+- version metadata under `apps/`, `cmd/`, and `packages/`

docs/releases/feature-release-notes.md

@@ -4,6 +4,8 @@
 
 | 日期 | 功能域 | 用户价值 | 变更摘要 |
 | --- | --- | --- | --- |
+| 2026-05-09 | Tab Group Naming | Agent 浏览器任务组和交付组的命名更清楚，当前任务保留在 `<short task> - OBU` 组，最终交付统一移动到 `🫪 Open Browser Use`。 | 发布 `0.1.16` patch 版本，默认 session group 改为 `Task - OBU`，deliverable group 改为 `🫪 Open Browser Use`，并补齐 legacy group title 迁移和 skill 指南。 |
+| 2026-05-09 | Beta Setup Guidance | Chrome Web Store 上架前，安装后的下一步只引导用户走 keyed manual-install ZIP 路径，避免 `setup release` / `setup offline` 两套名字造成混淆。 | 发布 `0.1.16` patch 版本，移除 `open-browser-use setup release/offline` 用户入口，保留 `open-browser-use setup` 和 `open-browser-use setup beta`，并把 npm postinstall、Homebrew caveats、README、架构、安全和 skill 文档同步到 `setup beta`。 |
 | 2026-05-09 | SDK High-Level Browser API | JS/Python SDK 用户可以保留底层 JSON-RPC/CDP 原子调用，同时用 browser/tab/playwright-like helper 编排常见浏览器自动化流程。 | 发布 `0.1.15` patch 版本，新增 JS `connectOpenBrowserUse` 与 Python `connect_open_browser_use` 高层 browser/tab API；覆盖 `goto`、load-state wait、DOM snapshot 和 Python notification 插队读取。 |
 | 2026-05-09 | Homebrew Setup Guidance | Homebrew 安装后的提示文案和当前审核期手动安装路径一致，用户会被引导生成 keyed manual-install ZIP，而不是旧的 Load unpacked 表述。 | 发布 `0.1.14` patch 版本，同步 Homebrew formula caveat 模板，并把 CLI、扩展、SDK 和 npm CLI 包版本提升到 `0.1.14`。 |
 | 2026-05-09 | Guided Manual Install | 审核期手动安装不会因为 release ZIP 缺少稳定 key 而生成错误 extension id，native host allowed origin 与浏览器实际安装 id 保持一致。 | 发布 `0.1.13` patch 版本，`setup release/offline` 会从已写入稳定 key 的 unpacked 目录重新生成 `*-manual.zip`，并只定位这个 keyed ZIP 给用户拖入安装。 |