跳到主要内容

SDK 规划

SDK 在羽忆里是明确有价值的，但当前阶段它仍然处于设计优先、实现后置的状态。

为什么暂缓独立 SDK​

当前主线已经有：

  • CLI
  • MCP Server
  • Web Console

它们都依赖同一套 REST API。此时如果马上再独立抽一套公开 SDK，很容易和接入层内部共享调用逻辑重复建设。

因此更合理的顺序是：

  1. 先让 client-shared 收稳共享 HTTP client、类型定义和错误模型
  2. 等 API 契约稳定后，再决定是否抽成公开 SDK

SDK 未来应该提供什么​

  • 强类型客户端
  • 统一认证封装
  • 超时与重试能力
  • 错误码解析
  • 常见调用场景的便捷方法

推荐优先级​

如果要对外开放 SDK，建议优先：

  1. TypeScript SDK
  2. Python SDK

原因是当前接入层主线本身就在 TypeScript，先把 TS 侧能力沉淀稳定，后续再向其他语言扩展更自然。

当前阶段的建议​

如果你正在做业务系统集成，现阶段更推荐直接复用统一的 REST API 契约或 client-shared 内部共享调用层，而不是等待一个尚未稳定对外承诺的 SDK。