Reference: multi-agent collaboration & external ACP integration customization (PR #2139)
- 主要语言
- Rust
- 星标
- 2.3k
- 派生
- 231
- 平均合并
- 2 小时 49 分钟
- 30 天内合并 PR
- 589
描述
## Overview
This issue accompanies PR #2139, which is a **reference submission** rather than a request for a blind merge. It presents a complete, final-state snapshot of customizations built on BitFun's latest \main\, focusing on **multi-agent collaboration** and **connecting BitFun to external AI agents** through the ACP protocol.
## Motivation
BitFun already supports single-agent coding workflows well. This work explores two extensions that we believe are valuable directions for the project:
1. **External agent integration via ACP** — letting BitFun drive real external agent processes (CodeBuddy, Claude Code, OpenCode, etc.) as first-class sessions.
2. **Structured multi-agent collaboration** — a three-branch (decision / execution / review) coordination model with quality gates, giving large agent runs auditability and determinism.
## What the PR contains
- A **370-file final-state code snapshot** relative to upstream \main\ (no intermediate steps, no scratch files, no internal records).
- **CUSTOMIZATIONS.md**, an academic-style report: Abstract, Introduction, Related Work, Design (Three-Branch Separation-of-Powers coordination model), Implementation 1-8, Evaluation, Conclusion & Future Work, References.
## Domains covered
1. ACP channel (session-level direct connection to external ACP agents)
2. SessionControl / SessionMessage tools (create, talk to, compact, delete sessions)
3. Warden guard system (governance: repeated-failure detection, challenges, violation records)
4. RBAC subagent roles (role templates controlling subagent tool access)
5. Engine & context injection (per-round runtime facts, once-per-generation user context)
6. Legion / Task / Plan toolchain (orchestration topology, task dual lifecycle, plan tools)
7. CodeBuddy provider adapter (OpenAI-compatible cloud API adapter)
8. Web UI (flow-chat display, legion pages, model switching)
## How to review
- The PR is intentionally large (370 files) because the purpose is to present the **final state of a coherent effort** for reference.
- Maintainers may review as a whole, cherry-pick per domain, or ask to split into smaller PRs.
- Every file reference in CUSTOMIZATIONS.md was cross-checked against the final state (13/13 verified); no proprietary or internal information is included (17-pattern scan clean).
## Notes
- AI-assisted: this PR was prepared with AI assistance; the snapshot is the final state of the customization workspace.
- Testing: the snapshot compiles as part of the customization workspace; focused verification was done at workspace level.
- Related fork issue: 1688mengdie/BitFun#191
贡献指南
调研方向
从 PR #2139 以及其中引用的 CUSTOMIZATIONS.md 报告开始,然后检查列出的 ACP、SessionControl、Warden、RBAC、Legion、provider 和 Web UI 区域。该 payload 描述的是一个包含 370 个文件的参考快照,而不是范围明确的变更;要视为完成,需要由 maintainer 决定是整体审查、按 domain 进行 cherry-pick,还是要求提交更小的 PR。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- rust
- 领域
- ai-infra-agents, desktop
- Issue 类型
- 功能
- 难度
- 5/5
- 预计耗时
- 一周以上
- 活跃度
- 停滞
- 描述清晰度
- 需要澄清
- 新手友好度
- 15/100