wrangler 是做什麼的?
用於 Cloudflare Wrangler CLI 工作:部署、日誌追蹤、KV/R2/D1/Queues/Workers、金鑰、綁定以及帳號路由。
預設行為
- 優先查詢標誌/設定:
wrangler --help、子命令--help、本機node_modules/wrangler/config-schema.json,再查 Cloudflare 文件。 - 偏好使用 repo 包裝指令:
npm exec --yes --package wrangler -- wrangler ...,除非 repo 本身提供腳本。 - 執行帳號敏感操作前先執行
wrangler whoami。 - ReleaseBar 正式帳號:
[email protected]'s Account/de09342a728de2c25c85cc6b34d68739。 - OpenClaw 專案請使用 OpenClaw 帳號 /
91b59577e757131d68d55a471fe32aca。若不確定請詢問。
常見陷阱
- 不要憑記憶發明標誌。Wrangler 4 已移除或變更部分舊標誌;請用
--help確認。 wrangler kv key list沒有--limit;請改用--prefix並在本機過濾。- 當
workerd或本機儲存體啟動時,請序列執行 Wrangler KV/list/get/admin 讀取操作;平行執行可能觸發 SQLiteSQLITE_BUSY。 wrangler tail --sampling-rate必須>0且<1;使用0.999作近乎完整取樣,不可用1。- 停止自己啟動的
tail。當需要互動終止時請使用 PTY;否則請精確終止wrangler tail <worker>程序。 - 絕不列印金鑰。僅查詢確切金鑰名稱;不要傾印環境。
快速指令
npm exec --yes --package wrangler -- wrangler whoami
npm exec --yes --package wrangler -- wrangler deploy
npm exec --yes --package wrangler -- wrangler tail <worker> --format json --sampling-rate 0.999 --search '<term>'
npm exec --yes --package wrangler -- wrangler kv key list --namespace-id <id> --prefix '<prefix>'
npm exec --yes --package wrangler -- wrangler kv key get '<key>' --namespace-id <id>
帳號確認
對於 repo 設定,請在執行指令前讀取 wrangler.toml / wrangler.json(c)。如果設定中的帳號與預期產品不符,請停止並詢問。