Skip to content

v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@tonyzhu tonyzhu released this 03 Sep 14:25
· 30 commits to main since this release
v0.1.0
b825a1d

Agent Helm Chrome Extension v0.1.0

中文

安装 wrapper 存放在 Extension repo 的 raw main；Release 只承载版本化 Extension/Installer 产物和 manifest。

Chrome → Installer → Agent Helm

  • Chrome Extension: 0.1.0
  • Agent Helm Installer: 0.1.0（必须与 Extension 版本一致）
  • Agent Helm pin: 0.1.4
  • Windows support: win32-x64

Terminal 一键安装使用 Extension repo 的稳定 raw wrapper。

macOS / Linux：

# 最新 Extension Release
curl -fsSL https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.sh | sh

# 指定 Extension 版本
curl -fsSL https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.sh | sh -s -- 0.1.0

Windows x64：

# 最新 Extension Release
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.ps1)))

# 指定 Extension 版本
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.ps1))) -Version 0.1.0

wrapper 从所选 Extension Release 的 manifest 读取固定 Agent Helm pin，完成 Node/Agent Helm、Native Messaging bridge、Extension zip 下载与校验，最后只剩 Chrome 中一次 Load unpacked。Windows Native Messaging 使用当前用户的 HKCU 注册，不要求管理员权限。

如果只安装 Chrome Extension，而本地还没有 Agent Helm，Extension 会显示 Download Installer。只有用户点击后才申请可选 downloads 权限：macOS 下载本 Release 的 Agent-Helm-Installer-0.1.0.pkg，Windows x64 下载 Agent-Helm-Installer-0.1.0-win32-x64.cmd。

macOS 手工下载和 Extension 下载使用相同 PKG bytes；generic PKG 默认注册正式 Extension ID，文件名中的 --chrome-<id> 仅作为显式 override。Windows 手工下载和 Extension 下载使用同一个 CMD asset bytes；CMD 直接调用稳定 install.ps1，因此 Runtime / Node、Agent Helm、Native Messaging bridge 与 Terminal 安装使用同一套实现。

测试说明：macOS 安装与发布流程已完成真机验证；Windows x64 已通过自动化与模拟验证，但目前仍缺少足够的 Windows 真机测试。

如遇到安装或运行问题，欢迎通过 GitHub Issue 反馈。
权限要求： Extension 固定权限为 alarms、nativeMessaging、notifications、sidePanel、storage，host permission 仅 https://chatgpt.com/*；downloads 仅在用户点击下载 Installer 时请求。未签名 macOS PKG 可能需要 System Settings → Privacy & Security → Open Anyway；macOS Installer 也可能要求管理员授权。

English

The install wrappers live on raw main in the Extension repository; Releases carry only versioned Extension/Installer artifacts and manifests.

Chrome → Installer → Agent Helm

  • Chrome Extension: 0.1.0
  • Agent Helm Installer: 0.1.0 (must equal the Extension version)
  • Agent Helm pin: 0.1.4
  • Windows support: win32-x64

Terminal-first installation uses stable raw wrappers from the Extension repository.

macOS / Linux:

# Latest Extension Release
curl -fsSL https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.sh | sh

# Specific Extension version
curl -fsSL https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.sh | sh -s -- 0.1.0

Windows x64:

# Latest Extension Release
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.ps1)))

# Specific Extension version
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/agent-helm-extensions/main/install-chrome.ps1))) -Version 0.1.0

The wrapper reads the fixed Agent Helm pin from the selected Extension Release manifest, handles Node/Agent Helm, Native Messaging bridge registration, and verified Extension zip download, then leaves only one Chrome Load unpacked action. Windows Native Messaging is registered under the current user's HKCU and does not require administrator access.

If only the Chrome Extension is installed and Agent Helm is missing, the Extension shows Download Installer. The optional downloads permission is requested only after the user clicks. macOS downloads Agent-Helm-Installer-0.1.0.pkg; Windows x64 downloads Agent-Helm-Installer-0.1.0-win32-x64.cmd.

Manual and Extension-triggered downloads use the same bytes for each platform. The generic macOS PKG registers the official Extension ID by default, while a local filename containing --chrome-<id> is only an explicit override. The Windows CMD calls the stable install.ps1, so Runtime / Node, Agent Helm, and Native Messaging bridge stages are shared with the Terminal installation path.

Testing note: the macOS installation and release flow has been validated on real hardware. Windows x64 is covered by automated and simulated verification, but has not yet received sufficient real-device testing.

If you run into installation or runtime issues, please report them through GitHub Issues.
Permissions: required permissions are alarms, nativeMessaging, notifications, sidePanel, and storage; the only host permission is https://chatgpt.com/*; downloads is optional and requested only for user-initiated Installer download. An unsigned macOS PKG may require System Settings → Privacy & Security → Open Anyway, and macOS Installer may require administrator authorization.

Assets 6
Loading