算法包管理

安装与更新

配置算法源访问

首次使用在线算法源时，先配置同事提供的有效 Token：

qnbot algorithm config-token TOKEN

也可以使用 App Key 登录。命令会隐藏密码输入，不接受明文密码参数：

qnbot algorithm login -u APP_KEY

自动化环境可从标准输入提供一行密码：

secret-manager-command | qnbot algorithm login -u APP_KEY --password-stdin

Token 与 App Key 密码只保存在本机 CLI 配置中，不要写入脚本、日志或提交到代码仓库。

在线安装

先查看当前账号有权访问的算法包，再按 App ID 安装：

qnbot algorithm list --available
qnbot algorithm install APP_ID
qnbot algorithm install APP_ID@VERSION

不指定版本时安装在线源当前发布的版本；指定 @VERSION 时安装该版本。

离线安装

离线场景由上位机或交付渠道提供算法包 ZIP 或目录，再把本地路径交给 CLI：

qnbot algorithm install ./package.zip
qnbot algorithm install ./offline-packages/

目录模式只安装第一层的 ZIP，不会扫描子目录。

版本规则

• 每个 package_id 只保留一个当前版本。
• 显式安装不同版本会替换当前版本，因此既可以升级也可以降级。
• 重复安装相同内容会显示为 already_installed。
• 在线或离线包都必须与当前操作系统、CPU 架构和 SDK 版本匹配。

安装完成后，用查看算法包确认当前版本，再在配置 target 时使用对应的 package_id。

查看与卸载

查看算法包

列出已安装的算法包：

qnbot algorithm list

列出当前账号有权访问的在线算法包，并可按关键字、App ID 和平台过滤：

qnbot algorithm list --available
qnbot algorithm list --available --query hand --app-id APP_ID --platform macos-arm64

裸 list 始终只列出本地已安装版本；--available 始终查询在线源。

查询某个 package_id 的当前版本，或确认指定版本是否为当前版本：

qnbot algorithm info package_id
qnbot algorithm info package_id@package_version

通过 list 或 info 取得 SDK 配置使用的 package_id 与当前 package_version。版本只用于信息查询和卸载保护，不需要填写到普通 SDK 配置中。

卸载算法包

不指定 package_version 时，无条件卸载执行时的当前安装槽位：

qnbot algorithm uninstall package_id

如需版本保护，可同时指定 package_version。仅当当前版本仍为该版本时才会卸载，版本不匹配时不会卸载：

qnbot algorithm uninstall package_id@package_version

JSON 输出

自动化脚本可使用 --json 获取稳定的 JSON 输出：

qnbot --json algorithm list

--json 是全局选项，写在子命令之前，便于脚本解析 list、info 和 install 的结果。