القائمة
用開物 Kaiwu 建構正式整合的最佳實踐 — 額度管理、查詢技巧、繁簡策略、錯誤處理、何時用 search vs extract。要把開物接進 agent / 應用前先讀這個。Reference for production-ready Kaiwu integrations.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
開物 Kaiwu CLI（kw）的安裝、認證與設定參考，以及 search/extract/credits 的完整工作流程。設定環境、遇到 kw 找不到或認證問題時的參考。Install, auth, and configure the Kaiwu CLI (kw).
查詢開物 Kaiwu API 帳戶的剩餘額度、已用量與重置時間。在大量搜尋/抓取前或遇到額度不足錯誤時使用。Check remaining Kaiwu API credits, usage, and reset time.
用開物 Kaiwu 從一個或多個 URL 抓取乾淨的 markdown/純文字內容，去除導覽列、廣告等雜訊。已經有特定網址、想讀全文時使用。Extract clean markdown/text from URLs, with optional query-based filtering.
用開物 Kaiwu 搜尋中文世界的網路 — 繁簡雙語、無審查、回傳 LLM-ready 結果。需要找資訊、查最新消息、還沒有特定 URL 時使用。Search the Chinese-language web (Traditional + Simplified) with agent-optimized results.
| name | kaiwu-best-practices |
| description | 用開物 Kaiwu 建構正式整合的最佳實踐 — 額度管理、查詢技巧、繁簡策略、錯誤處理、何時用 search vs extract。要把開物接進 agent / 應用前先讀這個。Reference for production-ready Kaiwu integrations. |
把開物 Kaiwu 接進正式 agent / 應用的最佳實踐。要做整合，這是最快的入門。
| 你要做的事 | 用 |
|---|---|
| 找資訊、還沒有 URL | kw search |
| 快速一般查詢 | kw search --depth basic（預設，1 額度） |
| 需要精確事實 / 原文摘要 | kw search --depth advanced（2 額度） |
| 要一段可引用的綜合答案 | kw search --answer |
| 已有 URL、要讀全文 | kw extract |
| 從多源只挑相關段落 | kw extract --query "..." |
省額度原則：先 basic 搜尋拿到候選 URL，真正需要全文時才對少數 URL 用 extract，比每次都 advanced 划算。
--lang zh-CN 效果更好；台灣在地議題用 --lang zh-TW。--time-range week（或 day/month/year），避免拿到過期資訊。kw credits --json 確認餘額。credits_needed 與 credits_remaining，據此降級（例如改 basic、減少 max-results）。| 狀態 | 意義 | 建議 |
|---|---|---|
| 401 | 金鑰無效 / 缺失 | 檢查 KAIWU_API_KEY |
| 429 | 額度不足 | 降級或等重置 |
| 502 | 搜尋引擎暫時無法使用 | 退避重試 |
extract status: failed | 該 URL 抓取失敗（反爬蟲 / 逾時） | 該 URL 不計費；改用 search --depth advanced 取摘要 |
extract 是逐 URL 回報成功/失敗的，永遠檢查每筆 status，別假設全部成功。
--json，不要 parse 人類可讀格式。KAIWU_API_KEY，不要把金鑰寫進程式碼或 commit。-o file.json 落地結果。search --json → 取 results[].url → extract --json --query。