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。