Add Go SDK

Author: iFurySt

README.md

@@ -5,6 +5,7 @@
 [![Release](https://img.shields.io/github/v/release/iFurySt/open-codex-browser-use)](https://github.com/iFurySt/open-codex-browser-use/releases)
 [![npm SDK](https://img.shields.io/npm/v/open-browser-use-sdk?label=npm%20SDK)](https://www.npmjs.com/package/open-browser-use-sdk)
 [![PyPI SDK](https://img.shields.io/pypi/v/open-browser-use-sdk?label=PyPI%20SDK)](https://pypi.org/project/open-browser-use-sdk/)
+[![Go SDK](https://pkg.go.dev/badge/github.com/ifuryst/open-browser-use/packages/open-browser-use-go.svg)](https://pkg.go.dev/github.com/ifuryst/open-browser-use/packages/open-browser-use-go)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iFurySt/open-codex-browser-use)
 
 ---
@@ -18,7 +19,7 @@ capability recently shipped in Codex.app. For the story behind it, see the
 [Browser Use Deep Dive](https://www.ifuryst.com/en/blog/2026/open-browser-use/).
 
 Under the hood, it pairs a browser extension with the `open-browser-use` CLI.
-You can integrate it through the JavaScript SDK, the Python SDK, or the CLI.
+You can integrate it through the JavaScript SDK, Python SDK, Go SDK, or the CLI.
 
 https://github.com/user-attachments/assets/bcfba878-f6a8-44b9-b84b-29c7e0285687
 
@@ -71,10 +72,14 @@ npm install open-browser-use-sdk
 
 # Python
 pip install open-browser-use-sdk
+
+# Go
+go get github.com/ifuryst/open-browser-use/packages/open-browser-use-go
 ```
 
 The SDK package name is `open-browser-use-sdk` on both npm and PyPI. Python
-code imports it as `open_browser_use`.
+code imports it as `open_browser_use`; Go code imports the SDK package as
+`obu`.
 
 #### Skill
 

README.zh-CN.md

@@ -5,14 +5,15 @@
 [![Release](https://img.shields.io/github/v/release/iFurySt/open-codex-browser-use)](https://github.com/iFurySt/open-codex-browser-use/releases)
 [![npm SDK](https://img.shields.io/npm/v/open-browser-use-sdk?label=npm%20SDK)](https://www.npmjs.com/package/open-browser-use-sdk)
 [![PyPI SDK](https://img.shields.io/pypi/v/open-browser-use-sdk?label=PyPI%20SDK)](https://pypi.org/project/open-browser-use-sdk/)
+[![Go SDK](https://pkg.go.dev/badge/github.com/ifuryst/open-browser-use/packages/open-browser-use-go.svg)](https://pkg.go.dev/github.com/ifuryst/open-browser-use/packages/open-browser-use-go)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/iFurySt/open-codex-browser-use)
 
 ---
 
 > [!TIP]
 > 对 Computer Use 感兴趣的话，可以看看 [open-computer-use](https://github.com/iFurySt/open-codex-computer-use)。
 
-`open-browser-use` 是平台中立的浏览器操作方案，也是Codex.app最新发布的Chrome Browser Use的开源替代方案。背后的故事可以看这篇[Browser Use详解](https://www.ifuryst.com/blog/2026/open-browser-use/)文章。 技术方案采用的是浏览器插件和open-browser-use cli结合，可通过JS/PYTHON SDK或CLI的方式接入。
+`open-browser-use` 是平台中立的浏览器操作方案，也是Codex.app最新发布的Chrome Browser Use的开源替代方案。背后的故事可以看这篇[Browser Use详解](https://www.ifuryst.com/blog/2026/open-browser-use/)文章。 技术方案采用的是浏览器插件和open-browser-use cli结合，可通过 JS/Python/Go SDK 或 CLI 的方式接入。
 
 https://github.com/user-attachments/assets/bcfba878-f6a8-44b9-b84b-29c7e0285687
 
@@ -59,10 +60,13 @@ npm install open-browser-use-sdk
 
 # Python
 pip install open-browser-use-sdk
+
+# Go
+go get github.com/ifuryst/open-browser-use/packages/open-browser-use-go
 ```
 
 SDK 在 npm 和 PyPI 上统一叫 `open-browser-use-sdk`。Python 代码里的 import
-模块名保持 `open_browser_use`。
+模块名保持 `open_browser_use`；Go 代码通常把 SDK import 为 `obu`。
 
 #### Skill
 

docs/ARCHITECTURE.md

@@ -36,6 +36,9 @@ debugger、history 和 tab groups。
   名为 `open-browser-use-sdk`。
 - `packages/open-browser-use-python/`：Python SDK，PyPI distribution 名为
   `open-browser-use-sdk`，import 模块名为 `open_browser_use`。
+- `packages/open-browser-use-go/`：Go SDK，Go import path 为
+  `github.com/ifuryst/open-browser-use/packages/open-browser-use-go`，package
+  name 为 `obu`。
 - `skills/open-browser-use/`：面向 AI Agent 的 Open Browser Use skill，说明
   如何安装、验证和使用浏览器插件、CLI、SDK 与 Browser Use 风格协议。
 - `packages/`：其他跨应用复用的库、契约和共享能力。
@@ -171,15 +174,17 @@ dot；hyphen 版本 `com.ifuryst.open-computer-use.extension` 会被
   暴露给 SDK；agent-facing Browser Use command rewrite 还覆盖 DOM CUA、media
   download、element info/screenshot、locator bulk reads、generic tab export 和
   clipboard commands。
-- JS 和 Python SDK：直接连接 Unix socket 发送 Browser Use JSON-RPC。
+- JS、Python 和 Go SDK：直接连接 Unix socket 发送 Browser Use JSON-RPC。
   JS SDK 支持订阅 native socket 上的 JSON-RPC notification；Python SDK 会在
-  同步 request loop 中分发并跳过 notification，避免 CDP event 插队破坏响应读取。
-  两个 SDK 都在原子 client 之外提供高层 browser/tab API，可直接使用
+  同步 request loop 中分发并跳过 notification，避免 CDP event 插队破坏响应读取；
+  Go SDK 同样在同步 request loop 中分发 notification，并可自动读取 active
+  socket registry。三个 SDK 都在原子 client 之外提供高层 browser/tab API，可直接使用
   `tab.goto`、`tab.waitForLoadState`/`tab.wait_for_load_state` 和
   `tab.playwright.domSnapshot`/`tab.playwright.dom_snapshot` 这类 Browser Use
   风格封装；Python SDK 还提供 `title`、`url`、`wait_for_timeout` 和
-  `locator(...).inner_text(...)` 等适合 Jupyter/Python REPL 编排的薄封装。
-  两个 SDK 同时提供核心 Browser Use method wrappers、download/clipboard
+  `locator(...).inner_text(...)` 等适合 Jupyter/Python REPL 编排的薄封装，Go SDK
+  提供对应的 `Title`、`URL`、`WaitForTimeout` 和 `Locator(...).InnerText(...)`
+  helper。三个 SDK 同时提供核心 Browser Use method wrappers、download/clipboard
   convenience wrappers，也保留 unrestricted `request`。
 
 当前 SDK 不内置 Codex 风格的站点限制、turn policy 或二次确认。上层应用

docs/QUALITY_SCORE.md

@@ -13,9 +13,9 @@
 
 | 区域 | 评分 | 原因 | 下一步 |
 | --- | --- | --- | --- |
-| 产品面 | B | Chrome extension、Go native host/CLI、JS SDK、Python SDK、file chooser、Chrome Web Store 发布链路、SDK registry 发布链路和真实 Chrome smoke 记录已成形。 | 补首轮用户安装说明和更多失败场景验收。 |
+| 产品面 | B | Chrome extension、Go native host/CLI、JS SDK、Python SDK、Go SDK、file chooser、Chrome Web Store 发布链路、SDK registry 发布链路和真实 Chrome smoke 记录已成形。 | 补首轮用户安装说明和更多失败场景验收。 |
 | 架构文档 | B | Chrome route completed plan、架构、安全、发布和 reference 文档已覆盖主要边界。 | 把 extension-host runtime 的状态机和错误恢复策略补成单独文档。 |
 | 插件 UI | B | MV3 popup、icons、content cursor 和基础打包校验已具备。 | 补 popup 截图 smoke 和权限状态展示验收。 |
-| 测试 | B | `make ci` 覆盖 docs/repo hygiene、action pinning、extension 打包、脚本语法、Go 测试、SDK/协议测试、Python SDK smoke 和 fake native host/extension peer relay 测试。 | 补真实 Chrome 自动化 smoke 和 popup 截图 smoke。 |
+| 测试 | B | `make ci` 覆盖 docs/repo hygiene、action pinning、extension 打包、脚本语法、Go 测试、JS/Python/Go SDK 协议测试、Python SDK smoke 和 fake native host/extension peer relay 测试。 | 补真实 Chrome 自动化 smoke 和 popup 截图 smoke。 |
 | 可观测性 | C | native host 和 extension 已有基础错误传播，但跨 Native Messaging、Unix socket 和 SDK 的关联日志仍不足。 | 增加 request id、事件分层日志和可脱敏 debug trace。 |
 | 安全 | C | Chrome route 明确不内置上层站点策略，manifest origin 限制和本地 socket 文件权限已有默认约束。 | 补 socket token/peer 授权、失败路径安全测试和安装权限审计说明。 |

docs/histories/2026-05/20260510-1339-go-sdk.md

@@ -0,0 +1,38 @@
+## [2026-05-10 13:39] | Task: Add Go SDK
+
+### 🤖 Execution Context
+
+- **Agent ID**: `Codex`
+- **Base Model**: `GPT-5`
+- **Runtime**: `Codex CLI`
+
+### 📥 User Query
+
+> JS/Python SDK 已经有了，增加 Go SDK；校验后提交、推送、发版，并用本地 Go 拉取验证能否成功使用 OBU。
+
+### 🛠 Changes Overview
+
+**Scope:** Go SDK, docs, release notes
+
+**Key Actions:**
+
+- **Go SDK**: 新增 `packages/open-browser-use-go`，提供 native frame socket client、active socket discovery、Browser Use method wrappers、CDP helpers 和 browser/tab helper。
+- **Tests**: 新增 fake Unix socket 测试，覆盖 frame encode、request round trip、notification dispatch、高层 tab flow、download/clipboard wrappers。
+- **Docs**: 同步 README、架构、skill SDK reference、质量评分和功能发布记录。
+
+### 🧠 Design Intent (Why)
+
+Go SDK 直接复用仓库现有 Go module 和 native socket 协议，避免引入额外发布系统；用户可以通过 Go module tag 拉取，并用 `obu.ConnectActive` 直接连接当前 Chrome native host 写入的 active socket registry。
+
+### 📁 Files Modified
+
+- `packages/open-browser-use-go/client.go`
+- `packages/open-browser-use-go/browser.go`
+- `packages/open-browser-use-go/client_test.go`
+- `packages/open-browser-use-go/README.md`
+- `README.md`
+- `README.zh-CN.md`
+- `docs/ARCHITECTURE.md`
+- `docs/QUALITY_SCORE.md`
+- `docs/releases/feature-release-notes.md`
+- `skills/open-browser-use/references/sdk-and-protocol.md`

docs/releases/feature-release-notes.md

@@ -4,6 +4,7 @@
 
 | 日期 | 功能域 | 用户价值 | 变更摘要 |
 | --- | --- | --- | --- |
+| 2026-05-10 | Go SDK | Go 用户可以直接通过 Go module 接入 Open Browser Use，不必绕 JS/Python SDK 或 shell CLI。 | 新增 `packages/open-browser-use-go`，覆盖 active socket discovery、Browser Use JSON-RPC wrappers、CDP helpers、browser/tab/playwright-like helper、download/clipboard wrappers 和 fake socket 协议测试。 |
 | 2026-05-10 | Deliverable Group Emoji | Chrome tab group 中的 Open Browser Use 交付组不再因为使用过新的 emoji 而显示成 `[?]`，保留绿色分组和清晰的完成标记。 | 发布 `0.1.26` patch 版本，将 shared deliverable group、skill display name 和文档统一改为兼容性更好的 `✅ Open Browser Use`。 |
 | 2026-05-10 | Skill Session Hygiene | Agent 使用 Open Browser Use 时会被引导为每个任务或会话使用唯一 session id，并按更严格的 cleanup 规则默认清理无用标签页，减少跨任务复用旧 tab group 的风险。 | 发布 `0.1.25` patch 版本，更新 bundled skill 的 CLI、MCP、SDK 示例，明确不要依赖 fallback `obu-cli` session，补充官方 Chrome skill 0.1.7 参考快照，并收紧 deliverable、handoff、finalize 语义。 |
 | 2026-05-10 | Skill SDK Guidance | Agent 用户通过 bundled skill 使用 SDK 时，可以直接复制当前 npm/PyPI 发布包的安装和 JS/Python 示例，不会再看到旧 scoped npm 包名或混淆的 client/browser 变量。 | 发布 `0.1.24` patch 版本，补强 `skills/open-browser-use` 的 SDK reference，新增 JS `connectOpenBrowserUse` 高层示例，保留低层 `OpenBrowserUseClient` 示例，并统一说明 `open-browser-use-sdk` distribution 与 Python `open_browser_use` import。 |

packages/open-browser-use-go/README.md

@@ -0,0 +1,71 @@
+# Open Browser Use Go SDK
+
+Go client for controlling a real Chrome profile through Open Browser Use. The
+package keeps the low-level JSON-RPC/CDP surface available and also provides
+higher-level browser/tab helpers for common agent workflows.
+
+## Installation
+
+```sh
+go get github.com/ifuryst/open-browser-use/packages/open-browser-use-go
+```
+
+The SDK expects the `open-browser-use` CLI and Chrome extension to already be
+installed and connected:
+
+```sh
+open-browser-use ping
+open-browser-use info
+```
+
+## Usage
+
+```go
+package main
+
+import (
+	"fmt"
+	"log"
+	"time"
+
+	obu "github.com/ifuryst/open-browser-use/packages/open-browser-use-go"
+)
+
+func main() {
+	browser, err := obu.ConnectActive(obu.Options{
+		SessionID: "go-sdk-example",
+		Timeout:   20 * time.Second,
+	})
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer browser.Close()
+
+	defer browser.Client.FinalizeTabs(nil)
+
+	if _, err := browser.Client.NameSession("Go SDK example - OBU"); err != nil {
+		log.Fatal(err)
+	}
+
+	tab, err := browser.NewTab()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	if _, err := tab.Goto("https://example.com", obu.GotoOptions{
+		WaitUntil: obu.LoadStateDOMContentLoaded,
+		Timeout:   15 * time.Second,
+	}); err != nil {
+		log.Fatal(err)
+	}
+
+	title, err := tab.Title()
+	if err != nil {
+		log.Fatal(err)
+	}
+	fmt.Println(title)
+}
+```
+
+Use `Client.Request(method, params)` when you need an unrestricted Browser Use
+JSON-RPC call, or `Client.ExecuteCDP` / `Browser.CDP.Call` for raw CDP commands.