slax-reader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

命令

Task	Command
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密钥。
保存网址前需与用户确认，除非用户已明确要求保存。
不得编造网址。仅保存用户提供的网址或在授权研究任务中找到的网址。

slax-reader

Original

Translation

Slax Reader CLI

Slax Reader CLI

Before using commands

使用命令前

Commands

命令

Bookmark rules

书签规则

Update and skill hints

更新与技能提示

`_hints.upgrade`

`_hints.upgrade`

`_hints.skill`

`_hints.skill`

Security rules

安全规则