从 TypeScript 到 C#：Codex SDK 的跨语言移植实践
内容提要
本文记录了将 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 的架构设计，再逐个模块转化，最后进行完整测试。
延伸问答
将 TypeScript Codex SDK 移植到 C# 的主要原因是什么？
主要原因是 HagiCode 项目需要在纯 .NET 环境中使用 Codex SDK，而不想引入 Node.js 运行时。
在移植过程中，保持 API 一致性有多重要？
保持 API 一致性比实现细节的一致性更重要，因为用户更关心接口的易用性。
C# SDK 在进程管理上与 TypeScript SDK 有什么主要区别？
C# SDK 需要手动管理进程的生命周期，而 TypeScript SDK 使用 Node.js 的自动管理机制。
类型系统转化在移植中面临哪些挑战？
TypeScript 的类型系统比 C# 更灵活，需要找到合适的映射方式来实现相同的功能。
在事件解析方面，C# SDK 是如何处理的？
C# SDK 使用 System.Text.Json.JsonDocument 来解析事件，而 TypeScript SDK 使用 JSON.parse()。
移植过程中有哪些注意事项？
注意事项包括进程管理、错误处理、资源清理和环境变量的配置等。
