与 SDK、上位机配合

CLI 只负责把算法包安装到本机。SDK 与上位机通过同一个 package ID 选择算法包，版本不需要写进 SDK 配置。

SDK：只配置 package ID

在 target 的 algorithms 中填写 qnbot algorithm list 显示的 package_id：

from qnbot_sdk import TargetAlgorithm, TargetConfig

target_config = TargetConfig(
    algorithms=(TargetAlgorithm("<package-id>"),),
)

已经创建的 Sdk 不会热更新包列表，安装、升级、降级或卸载后应重新创建 Sdk。

完整字段说明见 Python SDK 配置字段速查（C++ 见 C++ SDK 配置字段速查）。

上位机：算法包交付与更新

Qnbot Studio 在界面内完成算法包的下载、版本检查与更新，离线交付时由上位机取得算法包 ZIP 或目录，再交给 CLI 安装到本机。因此上位机与 SDK 使用的是同一份已安装算法包。

更新算法包后，请重启上位机或重建对应的 SDK 实例，确保加载到新的版本。参见 Qnbot Studio 上位机文档。

安全提示

仅使用 get.qnbot.com 稳定入口和官方 OTA 下载，不要改用第三方镜像。Token 与 App Key 密码只保存在本机 CLI 配置中，不要写入脚本、日志或提交到代码仓库。