KN Box Skill 用于在需要上传文件以供预览或分享时，通过 knbox CLI 将网页、Markdown 文件和图片上传到 KN Box，并返回公开预览 URL。
用途 该技能面向智能体发布生成内容的场景，帮助将本地文件或目录上传到 KN Box，并获取可分享的公开链接。
主要能力
- 上传文件或目录，并返回公开预览 URL。
- 支持将文件上传到指定的远程目录。
- 支持列出文件、切换保存的远程目录、打开文件或目录。
- 返回 JSON 结果，其中 data.entryUrl 适合作为网页目录的展示 URL，data.uploaded[].url 包含单个文件的 URL，summary 是简短的人类可读结果，breadcrumbs 包含有用的后续命令。
使用方式 要求使用 knbox CLI 作为唯一上传机制。优先使用 KNBOX_TOKEN 进行非交互式认证。默认服务器为 https://box.kn.run。不要上传敏感信息。
上传前，先验证 CLI 能否访问 KN Box： knbox auth whoami --json
如果因用户未登录而失败，请让用户运行： knbox auth login
在非交互式环境中，向用户索取 KN Box CLI token 并设置： 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
导航相关命令： 列出文件：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 以非零状态退出，读取 stderr 并报告失败。不要假设文件已上传。
适用场景 适用于智能体需要发布生成的网页、Markdown 文件或图片，并获取公开预览 URL 以便预览或分享的场景。
限制
- 必须使用 knbox CLI 作为唯一上传机制。
- 不要上传敏感信息。
- 上传默认在冲突时失败，需谨慎使用 --rename 或 --overwrite。
- 若命令失败，不应假设文件已上传。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。