Agent Collaboration Control Plane · 自托管 · Apache-2.0
ACCP：面向研发团队的 Agent 协作控制面
在浏览器中管理任务、项目资料、成果验收与工具审批；Agent 经 Bridge / MCP / Go SDK 领取任务、读取已发布上下文快照并提交成果。每项任务由人类负责人最终验收。ACCP 不提供模型推理——继续使用现有的 AI Coding 客户端。
git clone https://github.com/JavaWeh/ACCP.git
cd ACCP
node scripts/dev-env.mjs
docker compose --env-file .accp-local/compose.env up --build -d
docker compose --env-file .accp-local/compose.env --profile tools run --rm bootstrap当前适合受控试用与单企业私有部署评估。容量与生产验收边界见仓库交付计划与运维记录；本站不写未验证的用户数或性能数字。
背景
团队同时使用多个 AI Coding 客户端时，需求容易散在对话里，执行上下文容易漂移，交付物也缺少统一的验收与审计记录。ACCP 把责任、任务、共享上下文、成果与授权事实保存在控制面，连接人类成员与异构 AI Coding Client。详细设计见架构与治理文档。
- 责任 — 每项任务有人类负责人、执行代理、依赖和验收条件。
- 上下文 — 需求、接口和规范按版本发布；每次执行绑定固定快照。
- 成果 — 提交代码引用、文档或报告；核验后由负责人接受或退回。
- 授权 — 限定 Agent 项目权限与会话有效期；网关内高风险操作需独立审核。
功能
- 任务与待办 — 创建任务、指定负责人和验收条件；按状态、负责人、关键字筛选；工作台显示待验收、执行异常、待审批。
- 项目资料 — 发布需求、接口与规范版本；Agent 按本次执行快照读取，可引用前置任务成果。
- Agent 协作 — Bridge、MCP 或 Go SDK：领取任务、报告进展、提交成果，按依赖衔接。
- 成果验收 — 查看正文、Git 引用与来源链；核验 GitHub Commit / PR；逐项确认验收条件。
- 工具审批 — 为受控工具配置权限与策略；高风险操作需独立审核；可查结果与审计。
- 团队管理 — 项目创建/归档、成员与仓库登记、角色分配；停用成员并撤销其 Agent 会话。
- 运行维护 — 运行状态、事件失败、未知工具结果；脱敏诊断导出；备份与恢复工具。
Web 控制台支持简体中文、English、Русский；支持可分享任务链接与移动端布局。
一次协作如何完成
- 定义任务与验收条件（指定人类负责人）。
- 绑定已发布的项目资料（执行读快照，而非聊天上下文）。
- Agent 经 Bridge / MCP / SDK 领取并执行（会话与权限受限）。
- 提交成果与验证证据（正文、Git 引用、来源链）。
- 人类核验后接受或退回（Agent 不能自行标为最终完成）。
示例：订单查询 API
先发布接口约定，再创建实现与测试任务并设依赖；Agent 读快照并提交代码或报告；负责人按验收条件确认；高风险网关操作由另一审核人审批。任务、执行、资料版本、成果与审核记录保留为交付依据。
协作示例 → （中文）
快速开始
本机试用。依赖：Git、Docker、Docker Compose v2、Node.js（版本以仓库 README 为准）。
1. 克隆并启动
git clone https://github.com/JavaWeh/ACCP.git
cd ACCP
node scripts/dev-env.mjs
docker compose --env-file .accp-local/compose.env up --build -d
docker compose --env-file .accp-local/compose.env --profile tools run --rm bootstrap2. 登录演示项目
打开 http://127.0.0.1:8080/dev-login。账号见本机 .accp-local/dev-users.json。Alice：演示项目管理员；Bob：成员兼审核人。
3. 发布资料、建任务、接 Agent
在「项目资料」发布需求或规范；在「任务协作」创建任务并填验收条件；按接入说明登记客户端、创建受限会话并连接 Bridge。
可选 — node scripts/m2-smoke.mjs — 生成待人工验收的协议样例任务（不启动真实 AI 客户端）。
私有部署
目标形态：单企业、单机 Linux Docker Compose；企业 OIDC 登录。部署组件含 Web 控制台、Go API、Worker、PostgreSQL、NATS。需配置 HTTPS、身份服务、成员与仓库。OIDC 的 SPA client ID 与 API audience 须分开（示例 accp-web / accp-api）。生产镜像优先使用 GitHub Release 上 digest 固定 的 GHCR 镜像，不要用浮动 latest。
- 手册：production-deployment.md、operations.md
- 审批与完整审计覆盖经 ACCP 网关授权的操作；客户端用自有凭证直连外部系统不在该范围。
文档
| 需求 | 链接 |
|---|---|
| 控制台使用与常见错误 | web-console-guide.md |
| 权限、人工责任、审批 | governance.md |
| 架构与数据模型 | architecture.md data-model.md |
| 部署与运维 | production-deployment.md operations.md |
| Agent 接入 | m2-execution.md |
| 发行与升级 | Releases docs/releases/ |
| Issue / 贡献 | Issues CONTRIBUTING.md |
首发用 github.com/JavaWeh/ACCP/blob/main/docs/…；若上线 docs.accpkit.com，用构建期 base URL 替换。
范围与边界
不做
- 不提供模型推理；不以聊天历史作为编排数据库。
- 不是 Jenkins / GitHub Actions 类 CI/CD 产品；CI 至多是 MCP 网关可登记的工具类别之一。
- MVP 不含：多租户 SaaS、跨企业协作、计费、集中隔离 Runner、Kubernetes 编排、多区域容灾。
- 绕过网关的本地或直连操作，不保证受 ACCP 策略与完整审计约束。
当前可用范围
已实现任务、资料、执行、成果、审批、审计闭环，以及团队管理与运维工具，可用于受控试用。Claude Desktop 与 Codex 完成过单人双客户端样例验收；版本与限制见仓库验收记录。是否适合目标环境，请对照交付计划与运维验收记录。