Paperzilla CLI（pz）🦖

使用 pz 从终端阅读权威论文、浏览项目推荐、检查项目详情、提交推荐反馈，以及自动化 Paperzilla 工作流。

当需要结构化输出供 Agent 使用时，请优先使用 --json 参数。

安装

macOS

brew install paperzilla-ai/tap/pz

Windows（Scoop）

scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz

Linux

curl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz
sudo mv pz /usr/local/bin/

从源码构建（Go 1.23+）

git clone https://github.com/paperzilla-ai/pz.git
cd pz
go build -o pz .
mv pz /usr/local/bin/

更新

首先检查当前已安装的版本：

pz --version

然后询问 pz 应如何升级：

pz update

pz update 可自动识别常见安装方式，并为以下方式打印对应的升级指令：

• Homebrew
• Scoop
• GitHub 发布版二进制文件
• 源码构建

若检测结果存在歧义，可显式指定安装方式：

pz update --install-method homebrew
pz update --install-method scoop
pz update --install-method release
pz update --install-method source

常见升级路径如下：

macOS

brew update
brew upgrade pz

Windows

scoop update pz

Linux / GitHub 发布版

curl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz
sudo mv pz /usr/local/bin/

源码安装

git pull
go build -o pz .
sudo mv pz /usr/local/bin/

身份验证

pz login

执行与项目相关的命令（如 project、feed、rec 和 feedback）时需先登录。

核心模型：权威论文 vs 项目推荐

该区分至关重要：

• pz paper 操作的是全局权威的 Paperzilla 论文
• pz rec 操作的是某一个项目内的推荐条目

权威论文是全局共享的；而推荐条目则是在特定项目中呈现的同一论文，附带该项目特有的相关性评估与用户反馈。

核心命令

检查更新

pz update

列出所有项目

pz project list

查看单个项目详情

pz project 

浏览项目信息流（Feed）

pz feed 

常用参数：

• --must-read
• --since YYYY-MM-DD
• --limit N
• --json
• --atom

示例：

pz feed  --must-read --since 2026-03-01 --limit 5
pz feed  --json
pz feed  --atom

检查权威论文

pz paper 
pz paper  --json
pz paper  --markdown

若希望在某个项目上下文中解析该权威论文并查看其推荐语境，请使用：pz paper --project 。

示例：

pz paper  --project 

检查项目推荐条目

pz rec 
pz rec  --json
pz rec  --markdown

当标识符来自 pz feed --json 输出时，请使用 pz rec。

提交推荐反馈

pz feedback  upvote
pz feedback  star
pz feedback  downvote --reason not_relevant
pz feedback  downvote --reason low_quality
pz feedback clear 

反馈是项目级的：同一篇权威论文在不同项目中可拥有不同的反馈。

输出与自动化

• 面向机器解析时，请优先使用 --json。
• 请将 pz feed --json 返回的推荐 ID 用于 pz rec 和 pz feedback。
• 请将权威论文 ID 用于 pz paper。
• --atom 将返回一个可用于新闻阅读器（feed reader）的个人 Feed URL。
• pz rec --markdown 在必要时可能触发 Markdown 内容生成队列。
• 匿名调用 pz paper --markdown 仅在 Markdown 已预先生成的情况下才输出内容。

Agent 使用建议

• 若用户要求检查来自项目 Feed 的某篇论文，请优先使用 pz rec。
• 若用户关注的是作为全局/权威对象的论文本身，请使用 pz paper。
• 编写脚本时，请用 --json 获取 Feed 数据，再将其中的 ID 分别传入 pz rec、pz feedback 或 pz paper 等对应命令。

配置

export PZ_API_URL="https://paperzilla.ai"

参考资料

• 文档：https://docs.paperzilla.ai/guides/cli
• 快速入门：https://docs.paperzilla.ai/guides/cli-getting-started
• 代码仓库：https://github.com/paperzilla-ai/pz