从 TypeScript 到 C#：Codex SDK 的跨语言移植实践
💡
原文中文，约6900字，阅读约需17分钟。
📝
内容提要
本文记录了将 TypeScript Codex SDK 移植到 C# 的过程，重点讨论了架构设计、类型系统转换、事件解析和进程管理等关键点，并强调了保持 API 一致性的重要性，以满足 HagiCode 项目在 .NET 环境中的需求。
🎯
关键要点
- 本文记录了将 TypeScript Codex SDK 移植到 C# 的过程。
- 移植过程中重点讨论了架构设计、类型系统转换、事件解析和进程管理等关键点。
- 强调保持 API 一致性的重要性，以满足 HagiCode 项目在 .NET 环境中的需求。
- HagiCode 是一个开源的 AI 代码助手项目，涉及多种组件的维护。
- TypeScript SDK 的核心架构包括入口类、执行器和对话线程等。
- C# SDK 保持相同的架构层次，但在实现细节上进行了适配。
- 类型系统转化是基础工作，TypeScript 的类型系统比 C# 更灵活。
- 事件解析是 SDK 的核心，TypeScript 使用 JSON.parse()，C# 使用 System.Text.Json.JsonDocument。
- 进程管理是两个 SDK 差异最大的地方，C# 需要手动管理进程的生命周期。
- 配置序列化的逻辑必须保持一致，以确保两个 SDK 中的行为相同。
- 项目结构清晰，基本使用方式与 TypeScript SDK 保持一致。
- 在实现过程中总结了进程管理、错误处理、资源清理和环境变量等注意事项。
- 总结强调保持 API 一致性比实现细节一致性更重要，用户关心接口易用性。
- 建议在跨语言移植工作中，先理解原 SDK 的架构设计，再逐个模块转化，最后进行完整测试。
➡️
