Paca-AI/paca

Paca – AI 原生、自托管的项目管理

它是什么 – Paca 是一个开源、可通过 Docker 或 Kubernetes 部署的项目管理平台，将 AI 代理视为 Scrum 团队的一流成员。人类和代理共享同一个 Scrumban 看板，可以分配到冲刺（sprint）、领取任务、共同撰写 BDD 规格和设计文档，并通过应用内聊天进行交互。

为什么重要 – 大多数现有工具（Jira、ClickUp、Monday、Trello）仅将 AI 作为外围聊天机器人添加。Paca 将 AI 直接嵌入工作流程，让代理能够处理任务、执行自动化，并实时更新工作区。核心是轻量级的；其他一切（自定义工作流、UI 小部件、AI 特定逻辑）都通过沙箱插件系统添加。

核心概念

• MCP 服务器 – 一个 Model Context Protocol 服务器（@paca-ai/paca-mcp），将工作区（项目、任务、文档、成员等）暴露给任何 MCP 兼容的代理（Claude、Gemini、自定义代理）。无需自定义 API 工作。
• 插件 – 后端插件编译为 WebAssembly（WASM），并在基于能力的沙箱中运行；前端插件是普通的 JS 包。插件可以添加路由、数据模型、UI 页面或新的自动化节点。
• P‑A‑C‑A 循环 – 平台强制执行经典的 Plan → Act → Check → Adapt 循环，AI 代理参与每个阶段。
• 基于角色的 IAM – 模仿 AWS IAM 的 JSON 策略控制对任何资源（项目、任务、冲刺、文档、环境、代理等）的访问。
• 静态环境 – 长期存在的容器，在对话之间保留文件和进程，可通过浏览器内终端、SSH 或端口转发访问。
• 事件驱动自动化 – 可视化 n8n 风格的图形构建器（触发器 → 条件 → 动作），内置调度、Webhook、AI 分派和 API 调用节点；插件可以贡献额外节点。

主要功能

• 统一的 Scrumban 看板，人类和 AI 代理并排显示。
• 应用内 AI 聊天，用于自然语言任务/史诗创建、文档编写和冲刺规划。
• BDD（Gherkin）编辑器，由代理共同撰写。
• 系统设计文档（SDD），与看板保持同步。
• WASM 沙箱插件市场（一键安装）。
• 通过 Socket.IO 实时更新。
• OpenHands 驱动的代理在隔离容器中运行。
• 浏览器扩展，用于注释预览页面并将评论转换为任务。
• 基于角色的 IAM，支持 JSON 策略和条件。
• Jev AI 集成，用于自动路由、自动填写和自动分配任务。
• 通过本地桥接器支持任何 Agent Client Protocol（ACP）CLI（Claude Code、Gemini CLI 等）。

安装

1. Docker Compose（单节点） – 运行提供的单行命令：

   curl -fsSL https://github.com/Paca-AI/paca/releases/latest/download/install.sh | bash
   

   该脚本会交互式询问秘密（JWT、数据库密码、加密密钥），并启动整个堆栈（Postgres、Redis、Caddy、Paca 服务）。对于 CI/自动化，设置 PACA_YES=1 并通过环境变量提供所有值。
2. Kubernetes – 安装官方 Helm chart：

   kubectl create namespace paca
   helm install paca oci://ghcr.io/paca-ai/charts/paca -n paca -f my-values.yaml
   

   Chart 需要 publicUrl 和秘密值（jwtSecret、adminPassword、encryptionKey 等） – 不提供默认值。
3. 升级 – 从最新版本下载 upgrade.sh 脚本，并在包含 docker-compose.yml 的目录中运行（或使用 Helm upgrade）。

扩展 Paca

• 后端插件 – 使用任何可编译为 WASM 的语言（Go、Rust、AssemblyScript）。将 .wasm 文件放在 plugins/backend/ 下，并通过 UI Marketplace 或 scripts/install-local-plugin.sh 安装。
• 前端插件 – 标准 JS/TS 包，放在 plugins/frontend/ 下，可以添加页面、看板小部件或自定义设置面板。
• MCP 客户端 – 任何实现 Model Context Protocol 的代理都可以指向 MCP 服务器（http://<host>:8080），并获得对工作区的结构化读取/写入访问。

文档与社区

• 架构概览：docs/architecture/overview.md
• 角色与策略指南：docs/guides/roles-and-policies.md
• 环境管理：docs/ai-agent/environment-management.md
• 插件开发：请参阅 plugins/ 文件夹和 Marketplace UI。
• 欢迎通过 CONTRIBUTING.md 指南贡献；项目采用 Apache‑2.0 许可。

结论 – Paca 是商业 PM 工具的完全开源、自托管替代方案，将 AI 代理置于与人类队友平等的地位，提供插件优先、IAM 保护且 Kubernetes 就绪的平台，适用于现代、AI 增强的软件团队。