pp-arxiv

arXiv — Printing Press 命令行工具

前置条件：安装命令行工具

此技能使用 arxiv-pp-cli 二进制文件。**调用此技能中的任何命令之前，必须确认已安装该命令行工具。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

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

2. 验证：arxiv-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接通过 Go 安装（需要 Go 1.26.6 或更高版本）：

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

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功之前，请勿运行技能命令。

不应使用此命令行工具的情况

对于需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或更改远程状态的请求，请勿启用此命令行工具。此 Printing Press 命令行工具仅提供用于检查、导出、同步和分析的只读命令。

独特功能

其他任何用于此 API 的工具都不具备以下功能。

研究发现

• query — 使用有文档说明的查询表达式和便于 Agent 使用的输出控制来搜索 arXiv。
• query — 按提交日期排序并限制结果数量，获取最新的 AI/研究论文。
• query — 按 arXiv ID 或带版本号的 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 获取指定论文。

查找合适的命令

如果你知道要做什么，但不清楚该用哪个命令，可以直接询问命令行工具：

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

which 会根据此命令行工具精选的功能索引，将自然语言功能查询解析为最匹配的命令。退出代码 0 表示至少有一个匹配项；退出代码 2 表示没有可靠匹配项——请改用 --help，或使用范围更窄的查询。

身份验证设置

无需身份验证。

运行 arxiv-pp-cli doctor 验证设置。

Agent 模式

为任意命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可通过管道传输 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 可保留部分字段。点分路径可深入嵌套结构；数组则逐项遍历。对于输出冗长的 API，这是控制上下文大小的关键：

  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 参数。

• 非交互式 — 从不提示输入；所有输入都通过标志提供

• 只读 — 请勿使用此命令行工具执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他会修改数据的请求

响应封装

从本地存储或 API 读取数据的命令，会将输出封装在一个来源信息对象中：

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

解析 .results 获取数据，并查看 .meta.source 了解数据来自实时 API 还是本地存储。只有当 stdout 指向终端时，才会将便于人类阅读的 N results (live) 摘要输出到 stderr；通过管道传输的内容或 Agent 消费者会在 stdout 上收到纯 JSON。

Agent 反馈

当你（或 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 报告。简短、具体，一行即可：这才是会不断累积的部分。

输出交付

每个命令都接受 --deliver <sink>。除标准输出之外（或取代标准输出），还会将输出发送到指定的接收目标，这样 Agent 无需手动管道传输即可路由命令结果。支持三种接收目标：

接收目标	效果
stdout	默认；仅写入标准输出
file:<path>	将输出原子写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到 URL（使用 --compact 时为 application/json 或 application/x-ndjson）

不支持的方案会被拒绝，并返回一条结构化错误，列出支持的方案。Webhook 失败时会返回非零状态，并在标准错误中记录 URL 和 HTTP 状态。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。如果计划任务中的 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 在运行时发现它们。

退出代码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
5	API 错误（上游问题）
7	触发速率限制（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 arxiv-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并带上 --agent）

安装 MCP 服务

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

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

验证：claude mcp list

直接使用

1. 检查是否已安装：which arxiv-pp-cli 如果未找到，请提供安装选项（参见本技能顶部的先决条件）。
2. 根据用户查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

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

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