C# 后端集成 CodeBuddy CLI 实战指南
💡
原文中文，约10700字，阅读约需26分钟。
📝
内容提要
本文介绍了如何在 C# 后端项目中集成 CodeBuddy CLI，恢复其 Agent Communication Protocol (ACP) 能力。通过分层架构设计，提升了代码的可维护性和扩展性，支持多种 AI 编程助手的灵活切换。核心实现包括 Provider 契约层、工厂层和基础设施层，采用 JSON-RPC 进行进程间通信，支持流式和非流式调用。
🎯
关键要点
- 本文介绍了如何在 C# 后端项目中集成 CodeBuddy CLI，恢复其 Agent Communication Protocol (ACP) 能力。
- HagiCode 是一个开源的 AI 代码助手项目，支持多种 AI Provider 和跨平台运行。
- 采用分层架构设计，提升了代码的可维护性和扩展性，支持多种 AI 编程助手的灵活切换。
- 核心实现包括 Provider 契约层、工厂层和基础设施层，采用 JSON-RPC 进行进程间通信。
- Provider 契约层定义了 AIProviderType 枚举，实现字符串与枚举的双向映射。
- Provider 工厂层负责根据配置创建对应的 Provider 实例，使用 .NET 的依赖注入机制。
- Provider 实现层实现了 CodebuddyCliProvider，提供流式和非流式调用方式。
- ACP 基础设施层处理所有的协议细节，包括进程管理、消息序列化、响应解析等。
- CodeBuddy 使用 Stdio 方式与外部进程通信，支持 JSON-RPC 消息交换。
- 在实现过程中遇到会话泄漏、环境变量传递、超时配置等问题，并提出解决方案。
- 通过依赖注入实现灵活的配置和扩展，提供流式和非流式两种调用方式。
- 总结了 C# 后端集成 CodeBuddy CLI 的完整方案，适用于添加新的 AI Provider。
❓
延伸问答
如何在 C# 后端项目中集成 CodeBuddy CLI？
通过分层架构设计，使用 Provider 契约层、工厂层和基础设施层，采用 JSON-RPC 进行进程间通信来集成 CodeBuddy CLI。
HagiCode 项目是什么？
HagiCode 是一个开源的 AI 代码助手项目，支持多种 AI Provider 和跨平台运行。
CodeBuddy CLI 的通信机制是什么？
CodeBuddy 使用 Stdio 方式与外部进程通信，支持 JSON-RPC 消息交换。
在集成过程中遇到了哪些问题？
遇到会话泄漏、环境变量传递、超时配置等问题，并提出了解决方案。
如何实现流式和非流式调用？
通过 CodebuddyCliProvider 实现 IAIProvider 接口，提供 ExecuteAsync（非流式）和 StreamAsync（流式）两种调用方式。
为什么采用分层架构设计？
分层架构设计使得代码职责分明，后期维护更加方便，便于更换通信方式而不影响上层业务代码。
➡️
