# 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，見 [設定](/zh/config-files)）。