Perplexity 发布 pplx：一个为编码智能体打造的终端搜索 API 单二进制 CLI 工具

Perplexity 正式发布了 pplx，这是一个面向其搜索 API 的官方命令行客户端。该工具旨在为人类和编码智能体提供同等服务，返回基于真实结果的搜索结果和提取的页面文本，全部以 JSON 格式呈现。需要注意的是，pplx 并非聊天客户端，不支持对话模式、模型选择或合成回答。

pplx 提供两个主要接口：pplx search web 执行实时网络搜索，pplx content fetch 则获取 URL 并返回清洗后的页面文本。其输出合同非常明确：成功时退出码为 0，标准输出上正好输出一个 JSON 对象。搜索返回的结果包含 hits 数组（包括 url、title、domain、snippet 等字段）以及 total 和 saved_to 等信息。任何失败都会导致退出码 1，标准输出为空，并在标准错误输出一个 JSON 错误对象，格式为 {"error":{"code","message","command","hint"?}}。已知的错误码包括 AUTHENTICATION、UNKNOWN_ARGUMENT、ARGUMENT_ERROR 和 BAD_REQUEST，但官方文档指出列表并非穷举，因此调用者应根据 error.code 进行分支处理。

安装过程极为简洁，只需一条 shell 命令即可完成：curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh。该脚本会从最新版本下载 manifest.json，提取标签和版本号，并将所有后续下载固定到该标签以避免并发发布冲突。接着，它会获取 SHA256SUMS 和平台对应的二进制文件，验证校验和，然后将程序安装到 ~/.local/bin/pplx，无需 sudo 权限。安装完成后，还会在 ~/.config/pplx/pplx-receipt.json 写入一份收据，但仅当安装的二进制文件成功运行后才会执行。

平台支持范围有限，仅包括 macOS Apple Silicon、Linux x86_64 和 Linux arm64 三种目标。其他平台将直接退出并报错。目前没有 Windows 版本或 Intel Mac 版本。

标记预算是智能体最关心的功能之一。--output-dir 参数可将完整结果集写入 JSON 文件。--stdout-preview[=] 参数用于截断标准输出中的长字符串字段，并添加 ... 标记。但官方 Skill 明确指出一个陷阱：--stdout-preview 在没有保存目录的情况下是无效的——它仅在同时通过 --output-dir 或 $PPLX_OUTPUT_DIR 保存结果时才进行截断。单独使用时，它会输出完整大小的结果，而每个 hit 可能达到数 KB。

保存的搜索结果位于 {dir}/web/{rand}.json，获取的内容位于 {dir}/fetch/{rand}.json。文件仅在请求成功后写入。环境变量 PPLX_OUTPUT_DIR 可设置工作空间默认值，从而避免重复指定标志。

对于内容获取，Skill 增加了一项正确性检查而非成本检查：在使用输出前，应验证 error 和 is_paywall 字段。--html 参数可通过实时爬取添加 raw_html 字段，而 --no-cache 则强制进行实时获取。

此外，pplx auth login 仅支持 TTY 模式，因此智能体和 CI 环境必须通过 PERPLEXITY_API_KEY 环境变量进行认证。API 计费标准为每 1000 次请求 5 美元，所有使用层级均限制为 50 QPS。