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。