knbox

KN Box 技能

需要上传文件以供预览或分享时，请使用 KN Box。

要求

• 仅使用 knbox CLI 作为上传方式。
• 如果有 KNBOX_TOKEN，优先使用非交互式身份验证。
• 默认服务器为 https://box.kn.run。
• 请勿上传敏感信息。

验证访问权限

上传前，请验证 CLI 能否连接到 KN Box：

knbox auth whoami --json

如果因用户尚未登录而失败，请让用户运行：

knbox auth login

在非交互式环境中，请向用户索取 KN Box CLI 令牌并设置：

export KNBOX_TOKEN=knbox_xxx

默认服务器已是 https://box.kn.run。只有在用户明确要求使用其他 KN Box 服务器时，才设置 KNBOX_URL。

上传文件

上传文件或目录：

knbox upload <file-or-dir> --json

上传到指定的远程目录：

knbox upload <file-or-dir> --to /agent-output --json

读取返回的 JSON：

• data.entryUrl 是网页目录的最佳展示 URL。
• data.uploaded[].url 包含各个文件的 URL。
• summary 是简短易懂的结果说明。
• breadcrumbs 包含有用的后续命令。

导航

列出文件：

knbox ls [path] --json

更改已保存的远程目录：

knbox cd <path>

打开文件或目录：

knbox open <path> --json

对于文件，open 会返回公开 URL。对于目录，它会返回目录列表。

冲突处理

默认情况下，发生冲突时上传会失败。

只有在可以创建独立副本时，才使用 --rename：

knbox upload <path> --rename --json

只有在用户明确要求替换现有文件时，才使用 --overwrite：

knbox upload <path> --overwrite --json

失败处理

如果 knbox 以非零状态退出，请读取标准错误输出并报告失败。不要假设文件已上传。