pp-arxiv

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

arXiv — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the

arxiv-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install arxiv --cli-only

Verify:
```
arxiv-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

bash

go install github.com/mvanhorn/printing-press-library/library/other/arxiv/cmd/arxiv-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

本技能基于

arxiv-pp-cli

二进制文件运行。在调用本技能的任何命令前，必须确认CLI已安装。如果未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install arxiv --cli-only

验证安装：
```
arxiv-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等情况），可直接通过Go安装（要求Go 1.26.3或更高版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/other/arxiv/cmd/arxiv-pp-cli@latest

如果安装后执行

--version

提示“command not found”，说明安装程序未将二进制文件加入

$PATH

。请在验证成功前不要执行技能相关命令。

When Not to Use This CLI

何时不应使用此CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

请勿在需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或更改远程状态的请求中使用此CLI。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.

以下功能是其他同类型API工具所不具备的：

Research discovery

研究发现

query
— Search arXiv with documented query expressions and agent-friendly output controls.
query
— Fetch latest AI/research papers by category using submitted-date sorting and bounded result counts.
query
— Fetch exact papers by arXiv ID or versioned arXiv ID.

query
— 使用文档化的查询表达式搜索arXiv，并支持适配Agent的输出控制。
query
— 按提交日期排序，按分类获取最新AI/研究论文，并可限制结果数量。
query
— 通过arXiv ID或带版本号的arXiv ID获取指定论文。

Command Reference

命令参考

query — Manage query

arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5

— Search arXiv papers or fetch recent papers by category.

```
arxiv-pp-cli query --id-list 1706.03762 --max-results 1
```
— Fetch exact papers by arXiv ID or versioned arXiv ID.

query — 管理查询操作

arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5

— 搜索arXiv论文或按分类获取近期论文。

```
arxiv-pp-cli query --id-list 1706.03762 --max-results 1
```
— 通过arXiv ID或带版本号的arXiv ID获取指定论文。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:

bash

arxiv-pp-cli which "<capability in your own words>"

which

resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当你知道要执行的操作但不确定对应命令时，可直接询问CLI：

bash

arxiv-pp-cli which "<用你自己的语言描述所需功能>"

which

命令会将自然语言描述的功能需求匹配到CLI精选功能索引中最适合的命令。退出码

表示至少找到一个匹配项；退出码

表示无匹配结果——此时可使用

--help

或缩小查询范围。

Auth Setup

认证设置

No authentication required.

Run

arxiv-pp-cli doctor

to verify setup.

无需认证。

执行

arxiv-pp-cli doctor

验证配置是否正确。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5 --agent --select entries.id,entries.title
```
Previewable —
```
--dry-run
```
shows the request without sending
Live-first — arXiv search is most useful against the live API. Generic sync/local-store commands are present from the Printing Press scaffold, but this CLI should be treated as live-query-first because arXiv
```
/api/query
```
requires caller-supplied search or ID parameters.
Non-interactive — never prompts, every input is a flag
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

在任意命令后添加

--agent

参数。该参数等价于：

--json --compact --no-input --no-color --yes

。

可管道传输 — 标准输出为JSON格式，错误信息输出到标准错误流
可过滤 —
```
--select
```
参数保留指定字段子集。使用点路径可访问嵌套结构；数组会遍历每个元素。这在处理 verbose API时对缩小上下文范围至关重要：
bash
```
arxiv-pp-cli query --search-query 'cat:cs.AI' --max-results 5 --agent --select entries.id,entries.title
```
可预览 —
```
--dry-run
```
参数会显示请求内容但不实际发送
优先实时查询 — arXiv搜索对实时API的依赖度很高。虽然Printing Press框架提供了通用的同步/本地存储命令，但由于arXiv
```
/api/query
```
需要调用者提供搜索或ID参数，因此本CLI应优先作为实时查询工具使用。
非交互式 — 从不弹出提示，所有输入均通过标志参数提供
只读 — 请勿使用此CLI执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他修改状态的请求

Response envelope

响应包结构

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令会将输出包裹在溯源包中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

字段获取数据，通过

.meta.source

判断数据来自实时API还是本地存储。仅当标准输出为终端时，才会在标准错误流中打印人类可读的

N results (live)

摘要——管道/Agent消费端会在标准输出中获取纯JSON数据。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

arxiv-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
arxiv-pp-cli feedback --stdin < notes.txt
arxiv-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.arxiv-pp-cli/feedback.jsonl

. They are never POSTed unless

ARXIV_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

ARXIV_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当你（或Agent）发现此CLI存在问题时，可记录反馈：

arxiv-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
arxiv-pp-cli feedback --stdin < notes.txt
arxiv-pp-cli feedback list --json --limit 10

反馈条目会存储在本地

~/.arxiv-pp-cli/feedback.jsonl

文件中。仅当设置了

ARXIV_FEEDBACK_ENDPOINT

且传递了

--send

参数或设置

ARXIV_FEEDBACK_AUTO_SEND=true

时，反馈才会被POST到指定端点。默认行为仅存储在本地。

请记录让你感到意外的内容，而非正式的bug报告。简短、具体、单条记录：这样的反馈价值更高。

Output Delivery

输出传递

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

所有命令均支持

--deliver <sink>

参数。输出会除了（或替代）标准输出外，发送到指定的输出接收器，以便Agent无需手动管道即可路由命令结果。支持三种输出接收器：

输出接收器	作用
`stdout`	默认值；仅写入标准输出
`file:<path>`	原子性地将输出写入 `<path>` （临时文件+重命名）
`webhook:<url>`	将输出正文POST到指定URL（当使用 `--compact` 时为 `application/json` 或 `application/x-ndjson` 格式）

不支持的协议会返回结构化错误，并列出支持的类型。Webhook请求失败时会返回非零退出码，并在标准错误流中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

arxiv-pp-cli profile save briefing --json
arxiv-pp-cli --profile briefing query --search-query 'cat:cs.AI' --max-results 5
arxiv-pp-cli profile list --json
arxiv-pp-cli profile show briefing
arxiv-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的标志值，可在多次调用中复用。适用于定时Agent每次运行都使用相同配置调用同一命令的场景——即HeyGen的“Beacon”模式。

arxiv-pp-cli profile save briefing --json
arxiv-pp-cli --profile briefing query --search-query 'cat:cs.AI' --max-results 5
arxiv-pp-cli profile list --json
arxiv-pp-cli profile show briefing
arxiv-pp-cli profile delete briefing --yes

显式传递的标志参数优先级高于配置文件中的值；配置文件中的值优先级高于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，以便Agent在运行时自动发现。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

退出码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
5	API错误（上游问题）
7	请求受限（请等待后重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
arxiv-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

的规则：

为空、
help
或
--help
→ 显示
```
arxiv-pp-cli --help
```
输出
以
install
开头 → 如果结尾为
```
mcp
```
→ 执行MCP安装；否则 → 参考上方前提条件中的安装步骤
其他情况 → 直接使用（添加
```
--agent
```
参数执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

bash

claude mcp add arxiv-pp-mcp -- arxiv-pp-mcp

Verify:

claude mcp list

从本CLI的公开库条目或预构建版本中安装MCP二进制文件，然后注册：

bash

claude mcp add arxiv-pp-mcp -- arxiv-pp-mcp

验证安装：

claude mcp list

Direct Use

直接使用

Check if installed:
```
which arxiv-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

arxiv-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
arxiv-pp-cli <command> --help
```
.

检查是否已安装：
```
which arxiv-pp-cli
```
如果未找到，提供安装选项（参考顶部前提条件中的步骤）。
将用户查询与上方“独特功能”和“命令参考”中的最佳命令匹配。

添加

--agent

参数执行命令：

bash

arxiv-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
arxiv-pp-cli <command> --help
```
。