slax-reader

Name: slax-reader
Author: slax-lab

github.com/slax-lab生产力276 次安装9 周前更新

关于 slax-reader

slax-reader 是面向 Slax Reader 用户的命令行技能，通过 `reader-cli` 管理书签。它涵盖 URL 保存、列表与详情查看，以及归档、标星和恢复等操作，并包含登录与账户安全指引。

复制下面的命令，在终端中运行。

$npx skills add https://github.com/slax-lab/slax-reader-cli --skill slax-reader

安装后在 Claude Code 中输入/slax-reader确认已加载。

使用 reader-cli 将 URL 保存到用户的 Slax Reader 资料库、列出已保存的书签，并获取书签详情。

在保存、列出、获取、归档、添加标签或以其他方式访问用户的 Slax Reader 账户前，请检查登录状态：

reader-cli whoami --json

如果尚未登录，且用户可以使用终端，请优先让用户运行交互式 reader-cli login。如果用户无法完成交互流程，可提供 reader-cli login --api-key <key> --json，并且只有在用户明确选择此方式时才询问 API 密钥。

运行 login、logout、upgrade --check、skill --check 或 skill --sync 前，无需检查登录状态。

任务	命令
交互式登录	`reader-cli login`
非交互式登录	`reader-cli login --api-key <key> --json`
登出	`reader-cli logout --json`
显示账户信息	`reader-cli whoami --json`
保存 URL	`reader-cli add <url> --json`
保存并设置标题	`reader-cli add <url> --title "Title" --json`
保存并设置描述	`reader-cli add <url> --description "Description" --json`
保存并添加标签	`reader-cli add <url> --tags "tag1,tag2" --json`
归档 URL	`reader-cli add <url> --archive --json`
列出书签	`reader-cli list --json`
按页列出书签	`reader-cli list --page <number> --size <number> --json`
筛选书签	`reader-cli list --filter <all\|inbox\|archive\|starred> --json`
获取书签详情	`reader-cli get <bookmark-id>`
以 Markdown 格式获取书签	`reader-cli get <bookmark-id> --markdown`
归档书签	`reader-cli archive <bookmark-id> --json`
取消归档书签	`reader-cli unarchive <bookmark-id> --json`
为书签加星标	`reader-cli star <bookmark-id> --json`
取消书签星标	`reader-cli unstar <bookmark-id> --json`
删除书签（可恢复）	`reader-cli delete <bookmark-id> --json`
恢复已删除的书签	`reader-cli restore <bookmark-id> --json`
检查 CLI 更新	`reader-cli upgrade --check --json`
同步技能	`reader-cli skill --sync --json`
检查技能同步状态	`reader-cli skill --check --json`

用户想查看已保存的书签时，使用 reader-cli list。
用户要求查看特定子集时，使用 reader-cli list --filter inbox、reader-cli list --filter archive 或 reader-cli list --filter starred。
用户要求分页或指定结果数量时，使用 --page 和 --size。
用户要求打开、检查、总结或阅读特定书签 ID 的详情时，使用 reader-cli get <bookmark-id>。
用户希望以 Markdown 格式获取内容（例如用于后续处理或展示）时，使用 reader-cli get <bookmark-id> --markdown。
不要猜测书签 ID；请向用户询问 ID，或先列出书签。

add <url> --archive 是保存新 URL 时使用的模式；archive <bookmark-id> 则是将已保存的书签移出收件箱。两者无关，切勿混淆。
用户想要归档书签时，使用 reader-cli archive <bookmark-id>；使用 reader-cli unarchive <bookmark-id> 将书签移回收件箱。
用户想要为书签加星标或取消星标时，使用 reader-cli star <bookmark-id> / reader-cli unstar <bookmark-id>。
使用 reader-cli delete <bookmark-id> 删除书签——此操作可恢复，并非永久删除。使用 reader-cli restore <bookmark-id> 撤销删除。
除非用户已经明确要求删除书签，否则删除前请先征得用户确认。
对于这些操作，不要猜测书签 ID；请向用户索取 ID，或先列出书签。

reader-cli --json 命令可能会包含顶层 _hints 对象。

出现 _hints.upgrade 时，请先完成用户当前的请求。然后告知用户有更新版本的 CLI，并询问是否运行：

reader-cli upgrade

reader-cli upgrade 还会在需要时同步 AI Agent 技能。

出现 _hints.skill 时，请先完成用户当前的请求。然后告知用户已安装的 AI Agent 技能与 CLI 不同步，并询问是否运行相同的修复命令：

reader-cli upgrade

技能同步后，告知用户重启 Agent，以加载更新后的技能。重启后继续之前的旧对话也没问题。

只有在无法使用 reader-cli upgrade 时，才将 reader-cli skill --sync --json 用作直接手动备用方案。

不要默默忽略 _hints。

支持 Markdown