名称： putio
描述： 通过 kaput CLI 管理 put.io 账户（传输任务、文件、搜索）—— 升起主帆，添加磁力链/URL，并检查传输状态；建议与 chill-institute 技能搭配使用。

put.io (kaput CLI)

本技能使用非官方的 kaput CLI，通过命令行操作 put.io。

如果你同时安装了 chill-institute 技能，可以：
- 使用 chill.institute 发起 传输任务（“发送到 put.io”），然后
- 使用本技能 验证和监控 传输内容是否实际到达。

安装

• 需要 Rust + Cargo 环境。
• 安装命令：
  bash cargo install kaput-cli
• 确保 kaput 在 PATH 中（通常位于 ~/.cargo/bin）。

认证（设备码流程）

1. 运行：
   bash kaput login
2. 命令行会显示一个链接和短代码（例如 https://put.io/link + ABC123）。
3. 用户在浏览器中输入该代码。
4. CLI 完成认证并在本地存储令牌。

检查认证状态：

bash skills/putio/scripts/check_auth.sh

常用操作（脚本）

所有脚本会自动定位 kaput（支持通过 KAPUT_BIN=/path/to/kaput 指定路径）。

• 列出传输任务：
  bash bash skills/putio/scripts/list_transfers.sh

• 添加传输任务（磁力链 / 种子 URL / 直链）：
  bash bash skills/putio/scripts/add_transfer.sh "magnet:?xt=urn:btih:..."

• 搜索文件：
  bash bash skills/putio/scripts/search_files.sh "查询词"

• 状态查看（传输任务；可选账户信息）：
  bash bash skills/putio/scripts/status.sh SHOW_ACCOUNT=1 bash skills/putio/scripts/status.sh

直接使用 CLI

如需高级操作：

kaput --help
kaput transfers --help
kaput files --help

安全须知

• 切勿在聊天中粘贴密码。请使用 kaput login 的设备码流程。
• kaput 会将凭据（令牌文件）存储在本地。请将其视为敏感信息，避免分享。
• 避免在共享的日志/截图中运行 kaput debug（可能泄露本地配置详情）。