从 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# 的主要原因是什么？
主要原因是为了在纯 .NET 环境中使用 Codex，而不想引入 Node.js 运行时。
在移植过程中，如何处理类型系统的转换？
TypeScript 的类型系统比 C# 更灵活，需找到合适的映射方式，如使用 C# 的 record 实现不可变数据结构。
C# SDK 在事件解析方面与 TypeScript SDK 有何不同？
C# 使用 System.Text.Json.JsonDocument 进行事件解析，而 TypeScript 使用 JSON.parse()。
进程管理在 C# SDK 中是如何实现的？
C# 需要手动管理进程的生命周期，包括使用 CancellationToken 进行取消操作。
保持 API 一致性在移植过程中有多重要？
保持 API 一致性比实现细节的一致性更重要，因为用户更关心接口的易用性。
在跨语言移植中，有哪些建议可以遵循？
建议先理解原 SDK 的架构设计，再逐个模块转化，最后进行完整测试以确保行为一致。
