Back to Details

slax-reader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slax Reader CLI

Slax Reader CLI

Use 
reader-cli
to save URLs into the user's Slax Reader library.
使用
reader-cli
将网址保存到用户的Slax Reader阅读库中。

Before using commands

使用命令前

Check login state with:
bash
reader-cli whoami --json
If not logged in, ask the user for an API key or ask them to run:
bash
reader-cli login
Do not ask the user to paste an API key into the conversation unless they explicitly choose that flow.
通过以下命令检查登录状态：
bash
reader-cli whoami --json
若未登录，请询问用户提供API密钥或让他们运行：
bash
reader-cli login
除非用户明确选择该流程，否则不要要求用户在对话中粘贴API密钥。

Commands

命令

TaskCommand
Log in non-interactively
reader-cli login --api-key <key> --json
Log in interactively
reader-cli login
Log out
reader-cli logout --json
Save URL
reader-cli add <url> --json
Save with title
reader-cli add <url> --title "Title" --json
Save with description
reader-cli add <url> --description "Description" --json
Save with tags
reader-cli add <url> --tags "tag1,tag2" --json
Archive URL
reader-cli add <url> --archive --json
Check CLI update
reader-cli upgrade --check --json
Sync skill
reader-cli skill --sync --json
Check skill sync
reader-cli skill --check --json
任务命令
非交互式登录
reader-cli login --api-key <key> --json
交互式登录
reader-cli login
登出
reader-cli logout --json
保存网址
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
归档网址
reader-cli add <url> --archive --json
检查CLI更新
reader-cli upgrade --check --json
同步技能
reader-cli skill --sync --json
检查技能同步状态
reader-cli skill --check --json

Bookmark rules

书签规则

  • Preserve the exact URL the user asked to save.
  • Add 
    --json
    when you invoke commands so update hints are visible.
  • Use comma-separated tags with 
    --tags "tag1,tag2"
    .
  • Use 
    --archive
    only when the user asks to archive/preserve content or when they explicitly approve archive mode.
  • If the user provides multiple URLs, save them one at a time so failures are isolated.
  • 保留用户要求保存的原始网址。
  • 调用命令时添加
    --json
    参数，以便显示更新提示。
  • 使用
    --tags "tag1,tag2"
    格式添加逗号分隔的标签。
  • 仅当用户要求归档/保存内容或明确批准归档模式时，才使用
    --archive
    参数。
  • 如果用户提供多个网址，逐个保存，以便隔离失败情况。

Update and skill hints

更新与技能提示

reader-cli --json
commands may include a top-level 
_hints
object.
reader-cli --json
命令的返回结果中可能包含顶层
_hints
对象。

_hints.upgrade

_hints.upgrade

When 
_hints.upgrade
appears, finish the user's current request first. Then tell the user there is a newer CLI version and offer to run:
bash
reader-cli upgrade
当出现
_hints.upgrade
时，先完成用户当前的请求。然后告知用户有更新的CLI版本，并提议运行：
bash
reader-cli upgrade

_hints.skill

_hints.skill

When 
_hints.skill
appears, finish the user's current request first. Then tell the user the installed AI Agent skill is out of sync with the CLI and offer to run:
bash
reader-cli skill --sync
After syncing the skill, tell the user to start a new AI Agent session so the updated skill is loaded.
Do not silently ignore 
_hints
.
当出现
_hints.skill
时，先完成用户当前的请求。然后告知用户已安装的AI Agent技能与CLI不同步，并提议运行：
bash
reader-cli skill --sync
同步技能后，告知用户启动新的AI Agent会话以加载更新后的技能。
请勿忽略
_hints
提示。

Security rules

安全规则

  • Never print the full API key in conversation or command output.
  • Confirm with the user before saving URLs unless the user has already clearly asked you to save them.
  • Do not invent URLs. Save only URLs provided by the user or found during an authorized research task.
  • 切勿在对话或命令输出中打印完整的API密钥。
  • 保存网址前需与用户确认，除非用户已明确要求保存。
  • 不得编造网址。仅保存用户提供的网址或在授权研究任务中找到的网址。