使用说明
ACP检查员
⚠️ 积极发展 该项目正处于早期开发阶段。功能和文档正在积极构建中。关注此存储库以了解最新进展。
一个用于代理客户端协议（ACP）服务器和代理的可视化测试和调试工具，类似于 MCP检查员 用于模型上下文协议。
概述
ACP Inspector提供了一个开发人员友好的界面，用于测试、调试和检查代理客户端协议实现。无论您是构建ACP代理、将ACP集成到编辑器中，还是调试代理客户端通信，此工具都可以帮助您理解和验证协议流。
什么是代理客户端协议？
这 代理客户端协议（ACP） 是AI编码代理和代码编辑器之间通信的开放协议。ACP由Zed创建，可在不同编辑器和IDE之间实现可移植、可互操作的AI代理体验。
计划的功能
- 🔌 连接测试 –通过stdio和其他传输连接到ACP代理
- 🔍 会话管理 –初始化、验证和管理ACP会话
- 📨 消息检查器 –实时查看和分析JSON-RPC消息
- 🛠️ 交互式测试 –发送提示、批准权限和测试工具调用
- 📊 流量记录 –捕获、保存和回放ACP通信以进行调试
- ✅ 架构验证 验证是否符合ACP规范
- 🎨 基于Web的用户界面 –现代、基于浏览器的界面，便于访问
动机
虽然模型上下文协议具有出色的开发人员工具（MCP Inspector），但代理客户端协议生态系统目前缺乏一个全面的独立调试工具。该项目旨在通过使构建和测试ACP实现更容易来填补这一空白并加快ACP的采用。
路线图
第一阶段：核心基础设施（进行中）
- []设置项目结构
- []集成ACP TypeScript SDK
- []建立基本的stdio传输连接
- []创建代理服务器架构
第2阶段：基本检查器UI
- []基于React的Web用户界面
- []连接管理界面
- []消息日志查看器
- []会话状态显示
第三阶段：高级功能
- []交互式提示测试
- []工具调用模拟
- []流量捕获和回放
- []模式验证
- []支持其他传输
第4阶段：波兰语和文件
- []综合文件
- []使用示例
- []视频教程
- []性能优化
技术栈
- 前端：React、TypeScript
- 后端：Node.js、TypeScript
- ACP-SDK: @代理客户端协议/sdk
- 协议：基于stdio的JSON-RPC 2.0（最初）
贡献
欢迎投稿！这是一个社区驱动的项目，我们希望您能帮助我们建立最佳的ACP调试体验。
如何做出贡献：
- 🐛 报告错误和问题
- 💡 建议功能和改进
- 📖 改进文档
- 🔨 提交拉取请求
请注意，这个项目才刚刚开始。请稍后回来查看贡献指南和开发设置说明。
相关项目
社区
- 讨论：使用 GitHub讨论 问题和想法
- 问题：在中报告错误和功能请求 GitHub 问题
- 协议更新：关注 @zeddotdev ACP新闻
许可证
MIT许可证——见 许可证 详细信息文件
致谢
灵感来自优秀 MCP检查员 以及代理客户端协议社区的工作。特别感谢Zed团队创建和开源ACP。
状态: 🚧 早期发展| 寻找贡献者：是的| 首次发布：待定
⭐ 标记此存储库以跟踪开发进度！
