OpenCove：AI 智能体无限画布工作区

项目简介

OpenCove 是一个面向日常使用 AI 编程智能体的人群的空间化开发工作区。它不把工作藏在标签页、侧边栏和冗长的对话记录里，而是把 AI 智能体、终端、任务和笔记放在同一块无限 2D 画布上，让工作的完整状态始终可见。

典型使用场景：

• 并行运行多个 Claude Code 或 Codex 会话
• 把任务计划、笔记和终端输出保留在同一个共享工作区
• 切换项目时不丢失布局、上下文或执行历史

主要功能

• 无限空间画布：按自己的思路排列终端、笔记、任务和智能体会话。
• 为 CLI 智能体而生：针对 Claude Code、Codex 等终端原生智能体工作流优化。
• 上下文始终可见：规划、执行和结果放在一起，而不是埋在线性聊天记录中。
• 持久化工作区：重启后恢复视口、布局、终端输出和智能体状态。
• Space 存档：对工作区状态做快照，需要时跳回旧上下文。
• 富媒体与智能布局：粘贴图片、多选节点、设置标签颜色、快速整理凌乱的画板。
• 全局搜索与控制中心：搜索画布内容和终端输出，并在一处管理活跃会话。
• 工作区隔离：用目录和 git worktree 干净地分隔不同项目。
• 桌面式窗口管理（0.4.0）：窗口可折叠为紧凑的桌面图标并在重启后保持折叠状态；可点击画布工具栏创建窗口，或把创建按钮直接拖到目标位置。
• 文件夹浏览：以图标或树形视图浏览文件夹，通过面包屑导航，并把文件或文件夹拖到画布上成为窗口。
• 项目导航：通过紧凑侧栏切换项目、悬停展开项目、固定或隐藏 Space 与 Agent，并支持键盘快捷键切换项目。
• 插件与主题：可从本地文件夹或 Git 仓库安装独立插件，为画布添加窗口、命令、打包好的 Skill 和侧栏工具；主题也可独立安装，设置页提供实时预览。

安装与使用

下载桌面应用

OpenCove 0.3.0 及更新的稳定版可在 GitHub Releases 页面下载，支持 macOS、Windows 和 Linux。Nightly 预发布版用于早期测试，包含更新的改动，但可能不够稳定。

安装 opencove CLI

有两种受支持的方式：

• 在桌面应用中打开 Settings → Worker → CLI，点击 Install CLI。
• 不使用桌面应用时，使用包含独立运行时包（opencove-server-*）的 GitHub Release 及对应的安装脚本。

macOS / Linux 最新稳定版：

curl -fsSL https://github.com/DeadWaveWave/opencove/releases/latest/download/opencove-install.sh | sh

Windows（PowerShell）：

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod https://github.com/DeadWaveWave/opencove/releases/latest/download/opencove-install.ps1 | Invoke-Expression"

指定 nightly 或某个 tag 时，改用该 release 页面上的版本化脚本：

curl -fsSL https://github.com/DeadWaveWave/opencove/releases/download/v<version>/opencove-install-v<version>.sh | sh

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod https://github.com/DeadWaveWave/opencove/releases/download/v<version>/opencove-install-v<version>.ps1 | Invoke-Expression"

安装脚本会先用 release 的 SHA256SUMS.txt 校验下载的运行时，再解压。

无头服务器启动 Web UI

opencove worker start --hostname 0.0.0.0 --web-ui-password 'change-me'

该命令会打印 Web UI 地址，并为浏览器访问启用密码登录。

从源码构建

前置要求：Node.js >= 22.12.0、pnpm 9.6.0；建议全局安装 Claude Code 或 Codex 以体验完整的智能体工作流。

# 1. 克隆仓库
git clone https://github.com/DeadWaveWave/opencove.git
cd opencove

# 2. 安装依赖
pnpm install

# 3. 启动开发环境
pnpm dev

注意事项

• OpenCove 目前处于 Alpha 阶段，更适合愿意探索空间化 AI 工作流的早期用户和高级用户。
• 当前 macOS 构建未使用 Apple Developer ID 签名或公证。如果 Gatekeeper 阻止打开应用，可在终端执行：

xattr -dr com.apple.quarantine /Applications/OpenCove.app

• 内置的 Worker Web UI 属于实验性功能：默认仅监听 127.0.0.1；如需局域网访问，请开启 LAN Access 并设置 Web UI 密码；只要 Web UI 暴露在 localhost 之外，就应始终设置密码。局域网访问使用构建产物 out/renderer（无 HMR），修改 UI 后需先运行 pnpm build。
• 如果 releases/latest/download/opencove-install.sh 返回 404，说明最新稳定版尚未发布独立安装脚本，此时请改用桌面安装包，或等待包含这些资源的版本。

技术栈：Electron + React + TypeScript（electron-vite）、@xyflow/react 画布引擎、xterm.js 与 node-pty 终端运行时，测试使用 Vitest 和 Playwright。

---

本作品整理自 GitHub 开源项目 DeadWaveWave/opencove，原作者 @DeadWaveWave，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。