config.json Policy
最後更新
config.json 中放寬或收緊工具存取範圍的 policy 鍵，以及已不再讀取的鍵。config.json 的 policy 鍵。sensitive_path、read_only_command 與（v1.3.10 起）readable_path 會與編譯進 binary 的內建值合併（使用者項目是追加，永不取代預設）；其餘僅存在於使用者設定：| 鍵 | 內建來源 | 用途 |
|---|---|---|
sensitive_path | go-pkg filesystem/jsons/sensitive_path.json（v1.3.10 前為 configs/jsons/sensitive_path.json） | 憑證、金鑰、shell 啟動檔與工具設定路徑（v1.3.7 起另含 .git、.claude、.zshrc／.bashrc 等 shell rc 檔與 .mcp.json），讀寫皆適用——需經 per-session 授權才能存取：$HOME 內為一般確認，$HOME 外需系統密碼。分類：dirs、files、prefixes、extensions |
read_only_command | configs/jsons/read_only_command.json（v1.3.3 起 532 筆；cd 於 v1.3.0 移出後為 409 筆） | 跳過 confirm gate 的 run_command 與 background_command 呼叫（v1.3.1 起涵蓋的 run_command_background 移除於 v1.3.2；git status、ls、cat ...）。v1.0.25 起條目比對 binary 加上最多前兩個參數（git config --get、docker compose ps），帶 network: true 或參數含敏感路徑的呼叫一律不符合，專用的唯讀指令工具也已移除 |
denied_command | — | run_command 一律拒絕的 binary，sh -c 內亦然 |
denied_path | — | 讀寫皆永久禁止的路徑；任何提示都無法核准。條目須為絕對路徑或以 ~/ 開頭；拒絕檔案系統根目錄 |
readable_path | go-pkg filesystem/jsons/readable_path.json | v1.3.10 起。read_files 與 find_files 可免確認讀取的 $HOME 外絕對路徑；使用者項目會加進內建的系統與套件位置（/usr、/bin、/sbin、/lib、/lib32、/lib64、/libx32、/opt、/snap、/etc、/srv、套件資料庫 /var/lib/dpkg、/var/lib/rpm、/var/lib/pacman，以及 /Applications、/System/Library、/System/Applications、/Library、/Users/Shared 與 /dev/null）。項目須為絕對路徑或以 ~/ 開頭，檔案系統根目錄會被捨棄。被拒絕或屬敏感路徑者即使列入仍受限；寫入、open_file、file_history 與 rm 照舊需要密碼 |
net_white_list | — | 豁免 http_request SSRF 防護的 host |
三個鍵已不再讀取：
sensitive_map（更名為 sensitive_path）、white_list（移除——不在 denied_command 的指令皆可執行）、path_white_list（移除——$HOME 之外的路徑改為逐 session 核准）。v1.1.1 以前存在時會在啟動記警告；v1.1.2 移除該警告，現在直接靜默忽略。v0.35.0 移除最後一批 pre-v0.28.9 相容路徑：
limits.max_skill_iterations（由 limits.max_tool_iterations 取代）與 planner_model（由 dispatcher_model 取代；v1.1.1 以前下次儲存時會從 config.json 刪除，v1.1.2 起直接保留不動）不再被採用，舊的 api_tools/／script_tools/ 目錄也不再讀取——工具改放 tools/script/（tools/api/ 本身移除於 v1.3.2，見 設定）。