Muteki 如何兼容 8 种 Agent CLI：ACP/RPC 适配层、引擎注册表与提示桥源码完全解读

AI Agent多智能体Agent 编排网络安全渗透测试认证鉴权后端前端【免费下载链接】mutekiProject Muteki (無敵)开源 AI 驱动的进攻性安全框架基于多模型 AI Agent 蜂群架构实现自动化渗透测试与 CTF 求解。Open-source AI-powered offensive security harness for automated penetration testing.项目地址https://gitcode.com/FishCodeTech/muteki点击查看免费下载Muteki無敵是开源 AI 驱动的进攻性安全框架它像蜂群一样调度多个 AI Agent 完成自动化渗透测试与 CTF 求解。它最被低估的能力之一是兼容 8 种主流 Agent CLI——Claude、Codex、Cursor、Grok、Pi、OpenCode、Kimi、OMP让不同厂商的 Agent 引擎可以统一接入同一个调度体系。本文带你从源码层面看懂 Muteki 的兼容方案引擎注册表、ACP/RPC 适配层与提示桥Prompt Bridge分别解决了什么问题。上图是 Muteki 的“出战配置”页面每一枚 Worker 背后对应一种 Agent CLIClaude Code、Codex、Cursor、Pi、OMP……你可以在这里为它们绑定凭据、模型与并发上限。这 8 种引擎能力差异很大——有的支持结构化 SDK有的只暴露终端 stdin有的走 ACP 协议。Muteki 用三层架构把这些差异“抹平”了。一、先看全貌8 个引擎、6 种传输方式Muteki 把每个引擎的传输方式抽象为 6 种类型rpc、sdk、acp、http、httpws、cli定义在 descriptors.py 中。引擎默认结构化传输传输类型CLI 兜底Claudeclaude.sdkSDKcli.claudeCodexcodex.app_serverRPCcli.codexCursorcursor.sdkSDKcli.cursorGrokgrok.acpACPcli.grokPipi.rpc原生 JSONL RPCcli.piOpenCodeopencode.serverHTTPcli.opencodeKimikimi.acpACPcli.kimiOMPomp.acpACPcli.omp这些映射集中在 factory.py 的STRUCTURED_ADAPTER_ENGINES中Conversation对话场景走结构化传输Worker解题场景统一走 CLI——两套默认值刻意保持独立因为解题 Worker 需要更强的大规模并发稳定性。二、引擎注册表一切兼容性的入口要兼容一个引擎第一步是“登记”。Muteki 在产品级注册表 engine_registry.py 中声明了每个引擎的身份EngineDescriptorid、显示名、支持状态supported/temporarily_disabled、禁用原因canonical_engine_id()把cli.dsh、codex-sub-container这类历史/派生写法统一归一到标准引擎 idensure_engine_supported()对暂停支持的引擎抛出带稳定机器码的错误如engine_temporarily_unsupported而不是静默失败。一个值得一提的细节DeepSeek Harnessdsh目前处于“只登记、不可执行”状态——旧数据仍能正常渲染但任何新配置/执行入口都会被统一拒绝。这正是注册表“区分可识别”与“可执行”的价值所在。在 CLI 一侧cli_engines/registry.py 里的DRIVERS字典为每个引擎挂了一个具体的CliDriver实现如 ClaudeCodeDriver。所有 Driver 继承自 CliDriver 基类它统一处理二进制解析、--help预检secure prompt capability probe与流式输出解析子类只需描述“如何拼参数、如何读事件”。三、ACP/RPC 适配层把协议差异变成一行配置不同引擎的“对话协议”差异巨大。Muteki 的解法是共享传输层 协议适配基类1. 共享 stdio JSONL 传输rpc.pyrpc.py 是整个适配层的地基它只做三件事、不碰任何业务语义严格 LF 分帧只按\n切分 JSON 记录容忍行尾\r——避免按行读取器把 JSON 字符串内合法的U2028/U2029误当换行请求/响应关联出站消息分配单调递增id入站按is_response路由给等待方其余通知、事件流、Agent→Client 反向请求交给on_message回调反向请求应答ACP 的session/request_permission这类 Agent 反向请求通过respond写回结果。2. ACP 协议适配acp.pyacp.py 在传输层之上实现了完整的 Agent Client Protocol v1initialize能力协商、session/new/session/load/session/resume三种注入点、session/prompt流式正文以及审批request_permission。它的两大设计亮点replay 与 live 事件区分历史回放事件只进回放清单、不进入事件投影恢复会话时不会重复写历史消息能力硬门控initialize协商后不支持的能力一律不调用。最妙的是复用Grok 和 Cursor 各写一个 ACP Adapter 后RUNTIME-04 的Kimi ACP 与 OMP ACP 直接继承BaseAcpAdapter只覆盖 argv、认证选择与能力差异钩子——新增一个 ACP 引擎的成本降到“一份配置”。3. 适配基类与能力探测base.py所有结构化 Adapter 继承 BaseExternalAgentAdapter它统一实现实例身份adapter_id instance_id唯一定位一个 Runtime 实例registry.py能力探测probe缓存能力真相来自运行时探测而非按引擎 id 猜测交互矩阵interaction_matrix.py据此向用户展示 supported / limited / unsupported降级显式化结构化传输不可用时probe 报告里明确列出 degradations不静默关闭审批、会话恢复等能力。四、提示桥Prompt Bridge给“只会收 stdin”的引擎开一扇门有些引擎没有结构化传输可用Worker 又必须保证提示词原样、安全地送达。Muteki 的做法是为这些引擎各写一个极薄的“提示桥”脚本通过 stdin/stdout 与引擎原生协议对话桥脚本目标引擎方式pi_prompt_bridge.pyPi原生--mode rpcJSONLget_state取 session id再发promptnative_prompt_bridge.pyKimi复用KimiLocalServerAdapter走本地 server 的 stdinzcode_prompt_bridge.pyZCodeapp-server NDJSON 协议ASCII 转义防止 UTF-8 被管道切分以 Pi 为例桥进程启动pi --mode rpc先发送get_state拿到sessionId再把完整提示词作为一条prompt命令写入 stdin同时把引擎输出逐行透传给上层。桥还负责失败语义——get_state拿不到 session id、prompt返回success: false都会转为明确的错误信息。配套的 CliDriverAdapter 再把整个 CLI Driver 包装成与结构化 Adapter 同一接口的ExternalAgentAdapter上层调度代码完全感知不到“这个引擎没有 SDK”。五、想接入一个新引擎按图索骥即可通读源码后接入流程其实很清晰登记在 engine_registry.py 加一条EngineDescriptor实现传输有 ACP 的引擎继承BaseAcpAdapter有原生 RPC 的引擎复用StdioJsonlPeer纯终端的引擎写一个CliDriver 提示桥描述能力在 descriptors.py 声明AdapterDescriptor传输类型、能力基线、认证方式、模型发现注册映射在 factory.py 中登记 adapter id → engine 映射UI 与 Worker 配置自动生效。这正是 Muteki 兼容 8 种 Agent CLI 的核心哲学协议差异封装在传输层能力差异交给运行时探测历史差异用注册表兜住——上层调度永远只面对一套统一的 Agent 事件契约。如果你想继续深入可以从 muteki/external_agents/ 目录的factory.py入手顺着adapter_id找到每个引擎的完整实现。赞分享AI Agent多智能体Agent 编排网络安全渗透测试认证鉴权后端前端【免费下载链接】mutekiProject Muteki (無敵)开源 AI 驱动的进攻性安全框架基于多模型 AI Agent 蜂群架构实现自动化渗透测试与 CTF 求解。Open-source AI-powered offensive security harness for automated penetration testing.项目地址https://gitcode.com/FishCodeTech/muteki点击查看免费下载相关推荐omo-native 源码导读omo-ai 适配层如何用 Brand 注入与运行时策略把 senpi 引擎改造成 OmOomo native 源码导读omo ai 适配层如何用 Brand 注入与运行时策略把 senpi 引擎改造成 OmO 本文以仓库中 packages/om人工智能AI Agent代码智能体多智能体Agent 编排工具调用MCP 服务MCP ClientsAI 技能Agent 记忆GUI 自动化CLI开发工具skillgrade 源码架构深潜Agent 注册表、Grader 插件系统与评测执行引擎全解析skillgrade 源码架构深潜Agent 注册表、Grader 插件系统与评测执行引擎全解析 skillgrade 是一个为 Agent Skills 提pi-acp 架构全解一个适配器如何桥接 ACP JSON-RPC 与 pi RPC 两套协议完整指南pi acp 架构全解一个适配器如何桥接 ACP JSON RPC 与 pi RPC 两套协议完整指南 pi acp 是一个 ACP 适配器adapte上一篇群体智能预测上手MiroFish 一条命令的最短预测沙盘启动路径下一篇技术实践分享novel-downloader如何解决网络小说保存难题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考