SuperAPI AI 工具集

migrate-honcho-ts

编程与开发

查看项目

更新于 10-16 09:51

技能介绍

用途:本技能协助把 Honcho TypeScript SDK 代码从 @honcho-ai/sdk v1.6.0 迁移到 v2.1.1(Honcho 3.0.0+ 所需版本),适合升级依赖、修复升级后的破坏性变更,或报错信息涉及旧 API 时使用。

主要能力:覆盖多项破坏性变更。依赖层面移除 @honcho-ai/core,SDK 自带 HTTP 客户端;术语上 Observation 改为 Conclusion、Deriver 改为 Queue;方法改名包括 getConfig/setConfig 改为 getConfiguration/setConfiguration,getPeers/getSessions/getWorkspaces 改为 peers/sessions/workspaces,getDeriverStatus 改为 queueStatus,peer.workingRep() 改为 peer.representation(),session 的各类 get 前缀方法去掉 get 前缀;全库由 snake_case 改为 camelCase(如 peer_id→peerId、created_at→createdAt);流式改用 peer.chatStream() 替代 chat({ stream: true });Representation 类移除,representation() 现在返回字符串;updateMessage 移到 session 上;card() 改为 getCard()(v2.0.1+,card() 已弃用),新增 setCard;v2.0.2+ 对构造函数与输入 schema 启用严格 Zod 校验,未知选项会抛 ZodError;v2.1.0+ peer() 与 session() 始终发起 get-or-create API 调用;新增 createdAt、isActive、getMessage(),列表方法支持 page、size、reverse 分页;context() 的 searchQuery 移至 representationOptions;v2.1.1+ 扩大 fetch 重试范围至所有 TypeError 网络失败。

使用方式:按迁移清单逐步替换依赖与调用,注意移除 pollDeriverStatus(),不要轮询队列为空;队列是持续处理系统,需重新设计等待“完成”的逻辑。

限制:本技能仅针对 v1.6.0→v2.1.1 的上述变更,未提供其他版本路径或完整代码细节;其余迁移步骤与文件(DETAILED-CHANGES.md、MIGRATION-CHECKLIST.md)内容暂未提供。