boss-agent-cli：一個預設低風險的 BOSS 直聘本地輔助 CLI
本地輔助BOSS直聘CLI，用於AI代理、搜尋、福利過濾、入圍名單、JSON信封輸出；預設低風險且合規。
秒懂
- 它是什麼？
- 面向 AI 代理的 Python CLI，用於搜尋、福利過濾和本地短名單，同時預設阻止敏感操作。
- 適合誰用？
- 該專案的價值在於劃清職位搜尋中可自動化的唯讀部分與應保持手動的操作之間的界線，並透過結構化 JSON 介面暴露前者。 對這個專案的判斷應以 README 中的實際入口為準：先按文件執行專案命令，再檢查產生的設定、服務狀態或輸出是否符合預期；若核心依賴、平台條件或文件未涵蓋的部署細節不合適，就不應只因功能清單完整而採用。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
預設唯讀且由使用者觸發的理由
README 開頭解釋說，自動申請和批量打招呼腳本恰恰自動化了 BOSS 直聘平台不希望被自動化的操作，被封號只是時間問題。boss-agent-cli 選擇了相反的方向：它將職位搜尋中低風險、唯讀、由使用者觸發的部分交給終端和 AI 代理，而將打招呼、申請、發消息等敏感操作留給使用者在官方網站上手動完成。專案將合規描述為不是修補，而是預設姿態。因此，打招呼、申請、交換聯絡方式、閱讀候選人履歷或回覆等命令預設被封鎖並回傳 COMPLIANCE_BLOCKED。透過顯式的 `boss config set operating_mode research` 可以啟用有邊界的瀏覽器協議研究，但仍要求進行去識別化、檢查點、停止控制和可稽核的腳本來源。README 沒有定義研究模式下具體應用哪些風險控制適應，只列出了約束。
職位發現、福利過濾與本地短名單
功能清單涵蓋三個主要領域。職位發現包括帶分層過濾器的關鍵字搜尋，以及透過 search、show、detail 命令進行的快取導航。差異點在於福利過濾：`--welfare "雙休,五險一金"` 會翻頁取得詳情，並進行真正的 AND 匹配，還可用 `--sort score` 按本地匹配分數排序。本地短名單可讓你檢視詳情、同步網頁收藏的職位、用本地標籤和備註組織候選人、離線比較職位，並查看漏斗統計。申請和發消息仍留在官方網站。還提供 AI 求職輔助：JD 分析、履歷潤色、關鍵字建議、履歷最佳化、短名單匹配報告、面試準備和聊天輔導。本地模型權重不捆綁在套件內，預期來自 Ollama 或 vLLM 端點。
安裝、快速開始與 JSON 信封
建議的安裝路徑是 `uv tool install boss-agent-cli`，然後執行 `patchright install chromium` 安裝瀏覽器核心（僅用於使用者觸發的登入和本地匯出）。文件記錄的低風險迴圈是 `boss doctor`、`boss login`、`boss status`，然後是搜尋、詳情和短名單命令，例如 `boss search "Golang" --city 廣州 --welfare "雙休,五險一金"` 和 `boss shortlist add <security_id> <job_id> --tags backend,remote`。每個命令都在 stdout 上輸出僅 JSON 的信封，包含 `ok` 欄位和退出碼 0 或 1；stderr 儲存日誌。命令面被記錄為 38 個頂層命令加上 9 個一級招聘者子命令，分組為認證、發現、組織、受限研究爬取、履歷/AI、實用工具和招聘者類別。README 指向單獨的 Command Reference 以取得完整參數。
代理整合：MCP、子處理程序與 Python 嵌入
文件記錄了三種整合方式。推薦的方式是帶 50 個工具的 MCP 伺服器，可透過 JSON 設定在 Claude Desktop 或 Cursor 中執行 `uvx --from boss-agent-cli[mcp] boss-mcp`。還提供了 Docker 選項，容器刻意不包含瀏覽器核心；你在主機上執行 `boss login` 並掛載 `~/.boss-agent`。第二種方式是子處理程序：讓代理讀取 `boss schema` 取得自描述，然後解析 stdout 的 JSON。第三種是 Python 嵌入，使用帶型別標註的 API：`from boss_agent_cli import AuthManager, BossClient` 以及 `client.search_jobs("Golang", city="北京")`。README 還展示了一個 OpenCode 範例，複製已檢查的設定檔並執行 `boss-mcp --data-dir ./.boss-agent`。
平台抽象與招聘者模式
CLI 使用即時平台登錄。BOSS 直聘是預設平台，同時支援候選人和招聘者角色。智聯招聘（zhilian）具有候選人側唯讀對等，並透過 `agent` 瀏覽器/CDP 自動化 V1 提供招聘者流程；前程無憂（qiancheng）是註冊佔位符，在滿足唯讀研究門檻之前回傳 NOT_SUPPORTED。平台選擇透過 `--platform zhipin|zhilian|qiancheng` 完成，或透過 `boss config set platform zhilian` 設定預設。招聘者命令（`hr jobs list/online/offline`）目前僅支援預設招聘者平台 `zhipin-recruiter`；智聯招聘者自動化透過 `agent` 命令和瀏覽器/CDP 介面卡暴露。候選人個人資料流程預設被封鎖。
架構、設定與本地儲存
架構圖顯示一個 Click CLI 位於合規護欄之下，護欄之上是 AuthManager、平台登錄、BossClient（httpx + 節流）、CacheStore（SQLite WAL）和 AIService（OpenAI 相容 / Ollama / vLLM）。輸出層強制在 stdout 上輸出 JSON 信封。不變量：stdout 僅 JSON，stderr 儲存日誌，退出碼為 0 或 1，錯誤攜帶 code/recoverable/recovery_action，`boss schema` 是權威能力來源。設定位於 `~/.boss-agent/config.json`，涵蓋請求延遲、批量打招呼延遲、日誌級別、CDP URL、匯出目錄和平台/角色。`~/.boss-agent/` 下的本地狀態包括加密令牌、快取搜尋、短名單、本地履歷、AI 設定和外部模型登錄。模型權重不捆綁在 Python 套件內。
許可證、免責聲明與未經驗證的說法
倉庫採用 MIT 許可證，版權歸 can4hou6joeng4 所有，年份為 2026。許可證授予使用、複製、修改、合併、發布、分發、再許可和出售副本的權利，且不提供任何形式的擔保。README 新增了免責聲明，指出該專案僅用於學習和本地輔助，使用者必須遵守適用法律、BOSS 直聘使用者協議及其隱私政策。預設低風險模式阻止自動化外聯、批量操作、繞過風險控制和候選人個人資料流程。來源未建立任何安全保證、生產就緒或支援承諾；這些需要單獨驗證。
針對 can4hou6joeng4-boss-agent-cli，閱讀 README 時應把安裝入口和日常使用入口分開看。先確認文件點名的執行檔、套件管理器或容器命令，再對照專案要求的作業系統、執行時版本與外部服務。這些前置條件會直接決定首次啟動能否成功，不能用其他專案的慣例代替。
配置層面的重點在於找出 can4hou6joeng4-boss-agent-cli 真正讀取的檔案與參數。若 README 提到環境變數、設定檔、資料目錄、插件或 provider，就應逐一記錄其名稱和預設值，並觀察啟動後產生的日誌與輸出。文檔沒有交代的默認行為，應視為未知，尤其不能自行推定安全性、持久化或相容性。
從維護角度看，can4hou6joeng4-boss-agent-cli 的功能清單不等於完整的營運承諾。需要實際檢查 README 列出的版本、依賴、資料格式和錯誤處理，確認升級時哪些狀態會被保留，哪些整合需要額外憑證。若要放入團隊流程，還要先確認其授權文字對分發、修改和商業使用的具體限制。
最小驗證可以沿用 can4hou6joeng4-boss-agent-cli 自己提供的命令與檔案：在乾淨目錄建立最小設定，執行文件中的初始化或啟動命令，再查看 README 指定的輸出、狀態頁、產物或日誌。測試至少涵蓋一次成功流程與一次缺少必要參數的失敗流程，這樣才能分辨功能存在與實際可操作之間的差距。
can4hou6joeng4-boss-agent-cli 的實際價值還取決於它如何處理日常變更。可以先改動一個 README 明確列出的選項，觀察重載、重新建置、快取失效或資料更新是否符合說明，再恢復原設定確認狀態沒有留下難以察覺的副作用。對需要網路、資料庫、瀏覽器或模型服務的專案，這個步驟也能把程式本身的問題與外部依賴故障區分開。
若 can4hou6joeng4-boss-agent-cli 要交給其他人使用，交接內容不能只包含安裝命令。還要記下入口命令的完整參數、需要提交的設定檔、敏感值的存放位置、失敗時應查看的日誌，以及 README 明確列出的不支援情況。這些資訊會影響排障時間，也能避免使用者把社群版、實驗性功能或本地限定能力誤當成穩定服務。
在 can4hou6joeng4-boss-agent-cli 的評估中，輸入與輸出的可追蹤性比功能數量更值得核對。保留一次命令執行的參數、產生的檔案名稱和關鍵日誌，才能在重跑時知道差異來自設定、依賴還是資料。若 README 沒有給出某項能力的介面或結果格式，文章只把它列為未說明，不替專案補上承諾。
部署 can4hou6joeng4-boss-agent-cli 前也要核對資源與權限邊界。把 README 寫明的資料庫、網路、檔案系統和第三方帳號需求列成清單，逐項確認最小權限是否足夠，並把失敗時的返回值與日誌保存下來。這樣才能判斷它適合個人試用、團隊內部流程，還是需要更完整的運維審查。
採用前可在 can4hou6joeng4-boss-agent-cli 的工作目錄執行 README 所列入口，逐項核對輸入、產物與錯誤訊息；文檔沒有承諾的行為不應當作既定能力。
編輯結論
該專案的價值在於劃清職位搜尋中可自動化的唯讀部分與應保持手動的操作之間的界線，並透過結構化 JSON 介面暴露前者。 對這個專案的判斷應以 README 中的實際入口為準：先按文件執行專案命令，再檢查產生的設定、服務狀態或輸出是否符合預期；若核心依賴、平台條件或文件未涵蓋的部署細節不合適，就不應只因功能清單完整而採用。
社群筆記