Devin-AXIS/iPolloWork · 上手攻略

  • 仓库：Devin-AXIS/iPolloWork
  • 链接：https://github.com/Devin-AXIS/iPolloWork
  • 分类：AI Agent · 开发工具 · 编程助手
  • 作者：Tom
  • 更新：2026-07-19

这是什么

iPolloWork 是 Codex 和 Claude Code 的下一代源码开放替代品，定位是"不只是帮你写代码，而是真正完成工作"。

核心特点：

  • 不止编程：覆盖代码、办公文档、幻灯片、网站、设计、视频
  • 可视化工作区：AI 生成后还能像 PowerPoint 一样直接编辑文字、图片、颜色、布局
  • 本地优先：不需要云端账号，直接处理本地文件，支持 macOS/Windows/Linux
  • MCP 扩展：支持 Skills、插件、MCP 服务器、浏览器自动化
  • 源码可用（Source-Available，非 OSI 认可的开源）：允许个人免费使用，3 人及以上使用需书面授权

解决什么问题

Claude Code 和 Github Copilot workspace 这类产品，本质上还是"对话式生成"——AI 给你一段代码或一篇文章，你就只能接受或重新生成。问题是：

  • 代码生成后想改局部？ 得继续对话，有时比手写还慢
  • 不只是写代码，还要做 PPT/网站/视频？ 得切换到别的工具
  • 不想把代码上传到云端？ 很多场景数据不能离开本地

iPolloWork 的思路是：AI 负责生成，但你保留编辑权。生成结果直接在画布上改，像改幻灯片一样自然。同时打通代码、办公、设计、视频多个模态，不用来回切换工具。

快速安装

⚠️ 当前（2026-07）该仓库 还没有公开 Release 安装包，需要从源码构建。

前置依赖

# 1. Git
# https://git-scm.com/downloads

# 2. Node.js 22+
node --version  # 确认 >= 22

# 3. pnpm 11（通过 Corepack 启用）
corepack enable
pnpm --version  # 确认 >= 11

# 4. Bun 1.3.10+（构建 Orchestrator sidecar）
# https://bun.sh/docs/installation
bun --version

# 5. 平台特定工具
# macOS: xcode-select --install
# Windows: Visual Studio 2022 Build Tools (Desktop development with C++ + Windows SDK)
# Linux: 标准 Electron 构建环境（C/C++ 工具链、Python 3、pkg-config）

源码克隆与启动

# macOS / Linux
git clone https://github.com/Devin-AXIS/iPolloWork.git
cd iPolloWork
corepack enable
./ipollowork setup
./ipollowork dev

# Windows (PowerShell)
git clone https://github.com/Devin-AXIS/iPolloWork.git
cd iPolloWork
corepack enable
.\ipollowork.cmd setup
.\ipollowork.cmd dev

setup 安装锁定版本的 workspace 依赖，dev 准备 OpenCode 和 Orchestrator sidecar 并打开 Electron 桌面客户端。

常用命令

用途 macOS / Linux Windows
启动桌面客户端 ./ipollowork dev .\ipollowork.cmd dev
仅浏览器 UI ./ipollowork dev:ui .\ipollowork.cmd dev:ui
连接本地 Cloud ./ipollowork dev:cloud http://localhost:3100 .\ipollowork.cmd dev:cloud http://localhost:3100
类型检查 ./ipollowork check .\ipollowork.cmd check
生产构建（不生成安装包） ./ipollowork build .\ipollowork.cmd build
本地打包 ./ipollowork package .\ipollowork.cmd package

自行打包安装包

# 先检查，再打包
./ipollowork check
./ipollowork package

# 查看下一个版本号（不实际打包）
./ipollowork package --dry-run

# 打包产物位置
# apps/desktop/dist-electron/

打包产物： - macOS：.dmg、.zip、.app - Windows：NSIS .exe、win-unpacked/ - Linux：.AppImage、.tar.gz、linux-unpacked/

⚠️ 本地打包不会签名。macOS 未签名 app 会触发 Gatekeeper 告警，Windows 未签名 exe 触发 SmartScreen。这是开发测试包，不是正式发行版。

核心用法

代码工作流

# 启动后，AI 可以：
# 1. 理解代码仓库结构
# 2. 规划修改方案
# 3. 编写 / 修改代码
# 4. 运行工具（Terminal、Git、代码检查）
# 5. 展示结果，你直接在结果上编辑

办公与设计

iPolloWork 不只是代码助手，还可以：

  • 办公：调研、撰写文档、处理表格、制作幻灯片
  • 设计：生成网站/幻灯片/视觉素材，在画布上直接改文字、图片、颜色、字体、布局
  • 视频：在内置 Studio 生成和调整视觉画面，在时间线上剪辑

MCP 扩展（可选）

支持连接 MCP 服务器扩展工具能力，通过 Skills 和插件体系接入不同模型和工具集。具体配置方式见仓库文档。

本地优先架构

iPolloWork 桌面/UI ──> iPolloWork Server ──> OpenCode（AI 引擎）
       │
       └── 可选 ──> iPolloCloud（账号/团队功能）

# 不连接 Cloud 时，iPolloWork 完整本地运行
# iPolloWork 不修改 OpenCode，OpenCode 可独立升级

典型适用场景

场景 说明
想在本地跑 AI 编程助手 不依赖云端，数据不出本地
生成代码后还要反复改局部 可视化编辑，不用继续对话
编程 + PPT/文档 + 网站一起做 一个工具搞定多种内容
想接自己的 MCP 工具 支持 Skills、插件、MCP 服务器
给团队搭建私有 AI 开发环境 配合本地 Cloud 部署

坑与注意

  1. 目前无公开安装包：必须从源码构建，对非开发者有门槛。等 GitHub Releases 出现安装包后会方便很多。
  2. Source-Available 不是开源：LICENSE 规定 3 人及以上使用需书面授权，售卖/SaaS/商业分发也需授权，不是可以随意商用。
  3. Windows 开发有注意事项：开发构建不会自动注册 ipollowork:// 协议处理器，测试 Cloud 登录需要手动切换协议，具体见 Windows protocol switching。
  4. 依赖较重：Electron + Node.js + Bun + C++ 工具链，对机器性能有一定要求，不适合低配置设备。
  5. OpenCode sidecar 首次下载：桌面端第一次构建时会下载 OpenCode，需要网络连接和一点磁盘空间。
  6. 中文文档有限：主 README 有简体中文翻译，但部分子文档仍为英文。

与同类对比

维度 iPolloWork Claude Code GitHub Copilot Workspace
代码编辑方式 生成后可可视化编辑 对话重新生成 对话式
覆盖范围 代码+办公+设计+视频 代码为主 代码为主
本地优先 ✅ 完整本地 ❌ 云端 ❌ 云端
许可证 Source-Available 专有 专有
自托管 ✅ ❌ ❌
多模态输出 代码+画布+视频 文本代码 文本代码
安装门槛 高（需源码构建） 低（npm 安装） 低（浏览器）

一句话推荐结论

如果你需要本地运行的 AI 工作空间、生成结果后还想直接可视化编辑、且不怕折腾源码构建，这是目前最接近"完整 AI 工作台"愿景的开源替代方案；对普通用户，建议等官方发布安装包后再上手。

推荐指数：⭐⭐⭐⭐（工程价值）/ ⭐⭐⭐（易用性，目前门槛较高）
前置要求：Node.js 22+、Bun、pnpm，熟悉命令行和 Electron 构建
适合人群：开发者、研究者、想私有化部署 AI 工作流的团队
许可证：Source-Available，个人免费，3 人及以上使用需授权