用途:Slax Reader CLI(命令名 reader-cli)用于将 URL 保存到用户的 Slax Reader 阅读库,列出已保存书签、获取书签详情,并执行归档、星标、标签等整理操作,同时管理账号登录状态。
主要能力与用法:登录交互式为 reader-cli login,非交互式为 reader-cli login --api-key <key> --json,登出用 reader-cli logout --json,查看账号用 reader-cli whoami --json。保存网址用 reader-cli add <url> --json,可附加 --title、--description、--tags "tag1,tag2",或加 --archive。列表用 reader-cli list --json,可分页(--page、--size)与筛选(--filter all|inbox|archive|starred)。详情用 reader-cli get <bookmark-id>,Markdown 输出加 --markdown。整理动作包括 archive、unarchive、star、unstar、delete(可恢复)、restore。另有 upgrade --check 与 skill --sync/--check。
使用规则:执行需登录的命令前先用 whoami --json 检查登录状态;未登录时优先让用户在终端运行 reader-cli login,无法交互时才提供 --api-key 方式。保存、删除前需用户确认,除非用户已明确要求;不得编造 URL,不得猜测书签 ID。支持 --json 的命令应加 --json 以便看到更新提示。多个 URL 应逐个保存。add --archive 与 archive <id> 含义不同,不可混用。返回中的 _hints.upgrade、_hints.skill 提示不应忽略,可运行 reader-cli upgrade 修复,必要时告知用户重启 Agent。安全上不得在对话或输出中打印完整 API 密钥。
限制:资料未说明具体平台、定价、速率限制及错误处理细节。