用途:把使用 Honcho Python SDK v1.6.0 的代码迁移到 v2.0.0(Honcho 3.0.0+ 所需),适用于升级 honcho 包、修复升级后的破坏性变更,或错误信息指向这些变更时。
主要能力:给出 v1.6.0 与 v2.0.0 的 API 对照与改写方式,覆盖:异步架构由 AsyncHoncho/AsyncPeer/AsyncSession 改为 Honcho 配合 .aio 访问器(如 client.aio.peer(...)、peer.aio.chat(...));术语 Observation 改为 Conclusion,ObservationScope/AsyncObservationScope 改为 ConclusionScope/ConclusionScopeAio;Representation 类移除,改为返回 str;get_config/set_config 改为 get_configuration/set_configuration,并使用 honcho.api_types 中的 PeerConfig、SessionConfiguration、WorkspaceConfiguration 等类型;流式调用由 chat(stream=True) 改为 chat_stream();poll_deriver_status() 移除,get_deriver_status() 改为 queue_status(),如需轮询需自行实现;.core 属性移除;representation 参数由 include_most_derived 改为 include_most_frequent、max_observations 改为 max_conclusions;update_message 从 client 移到 session;card() 返回类型由 str 改为 list[str] | None。另含新异常类型与新导入位置的说明,以及 DETAILED-CHANGES.md、MIGRATION-CHECKLIST.md 等参考文件。
使用方式:按资料中的前后对照改写代码,替换类、方法名、参数与导入路径,并更新流式与配置调用。资料未提供安装命令、触发指令或自动执行步骤。
限制:资料仅覆盖 v1.6.0 到 v2.0.0 的迁移对照,未说明收费、价格、支持平台、兼容范围与迁移后验证方法,这些暂未提供;迁移前建议备份代码。