Octane0411/open-vibe-island

Open Island – AI 编码助手的原生 macOS 控制面板

是什么 – Open Island 是一款免费、开源的 macOS 应用，常驻于屏幕缺口（或菜单栏顶部中央），实时显示你在终端或 IDE 中运行的 AI 编码助手的状态。你可以查看哪个助手正在活跃，批准权限提示，查看使用统计，并通过点击直接跳回该助手正在交互的原始终端或 IDE 窗口，整个过程无需中断你的工作流。

为何重要 – 许多开发者使用 Claude Code、Codex、Cursor、Gemini‑CLI 等工具从命令行生成代码。现有的商业产品为这些助手打包了 UI，但它们是闭源的，需要账户，且通常在云端运行。Open Island 提供了同样的便利性，但完全本地化，无任何遥测数据，让你完全掌控软件栈。

---

主要功能（详见 README）

功能	你能获得什么
缺口 / 顶部栏叠加层	一个极小的面板，常驻于 Mac 的缺口或菜单栏，编码时始终可见。
多助手支持	支持 13 个助手（Claude Code、Codex、Cursor、Gemini‑CLI、Grok Build、Kimi CLI、OpenCode、Pi、Oh My Pi、Qoder、Qwen Code、Factory、CodeBuddy）。
多终端与 IDE 支持	可检测并跳回 15+ 个终端/IDE（Terminal.app、iTerm2、WezTerm、Ghostty、tmux、Zellij、VS Code、JetBrains IDEs、Warp 等）。
实时会话发现	读取本地转录文件并监控进程，自动列出活跃的助手会话。
权限处理	显示助手发出的权限请求通知，你可直接在叠加层中批准或拒绝。
使用情况仪表板	显示支持的助手（如 Claude Code、Codex）的近期使用时段（5小时 / 7天）。
钩子式集成	每个助手的钩子系统调用一个小型 CLI（OpenIslandHooks），它通过 Unix 套接字将 JSON 事件转发给应用。
无需全屏更新	通过 Sparkle 自动更新；DMG 已签名并经过公证。
国际化	UI 支持英文和简体中文。
开源且本地优先	GPL‑v3 许可证，无远程服务器，无遥测数据。

---

工作原理（高层架构）

1. 助手发出钩子 – 当 AI 编码助手启动会话、接收提示、使用工具等时，会将 JSON 负载写入 stdout。
2. OpenIslandHooks CLI – 钩子命令运行一个小型 Swift CLI，读取 JSON 并通过 Unix 套接字将事件转发给正在运行的应用。
3. 应用内的桥接服务器 – 接收负载，更新内部会话模型，并刷新 UI。
4. 叠加层 UI – 显示会话列表、状态，并允许点击跳回原始终端/IDE。
5. 跳回 – 应用使用相应机制（iTerm2 使用 AppleScript，VS Code 使用 CLI code -r，Warp 使用 SQLite 查找等）将正确的窗格置顶。

架构分为四个 Swift 包目标：

• OpenIslandApp – SwiftUI/AppKit UI。
• OpenIslandCore – 共享模型、IPC、会话持久化。
• OpenIslandHooks – 由助手调用的 CLI。
• OpenIslandSetup – 用于在各助手配置文件中安装/移除钩子条目的辅助工具。

---

快速上手

方法	步骤
下载（DMG）	从 Releases 页面获取最新版本，打开 DMG（已公证），将应用拖入 /Applications。
Homebrew	brew install --cask open-island – 后续升级使用 brew upgrade --cask open-island。
从源码构建	```bash
git clone https://github.com/Octane0411/open-vibe-island.git
cd open-vibe-island
open Package.swift # 在 Xcode 中打开，点击 Run

首次启动时，应用会扫描正在运行的助手，安装必要的钩子文件（你可在设置窗口中管理），并开始显示实时会话。

---

### 适合谁使用？
- 一天大部分时间在终端中工作并使用 AI 编码助手的开发者。
- 希望获得**本地化、保护隐私**的 UI 而非付费云服务的任何人。
- 使用任何支持的助手或终端的用户——README 中列出了完整的兼容性表格。

---

### 社区与贡献
- **Discord** – 活跃聊天，用于支持、功能建议和快速帮助。
- **WeChat** – 为中文用户提供了二维码。
- 欢迎贡献；详见 `CONTRIBUTING.md` 指南。项目采用标准 Swift 包结构，添加新助手或终端非常简单。

---

### 快速参考清单
- ✅ 开源（GPL‑v3）——可 fork 或修改。
- ✅ 无服务器，无遥测——完全在你的 Mac 上运行。
- ✅ 原生 SwiftUI/AppKit——无 Electron 开销。
- ✅ 支持 13 个主要 AI 编码助手和 15+ 个终端/IDE。
- ✅ 通过 Sparkle 自动更新。
- ✅ 国际化（EN/zh‑CN）。

---

**总结** – Open Island 是一款真正的开源 macOS 伴侣应用，为开发者提供轻量、始终可见的 AI 编码助手仪表板，保持工作流本地化、快速，并完全由用户掌控。