第七章 速查附錄
本章覆蓋第 28–30 章：參數取值速查、正則與通配符語法、術語表。
第二十八節 參數取值速查
[!ref] 詳解見使用者手冊「工具體系總覽」節。
28.1 預設上限
| 項 | 預設 | 上限 |
|---|---|---|
| 單次工具傳回 | 4096 位元組 | 256 KiB |
| 單次出站訊息 | 3800 字 | 取決於 IM |
終端機命令超時（fs.exec） |
120 s | 參數 / tools.yaml 可調 |
| 工具執行空閒兜底（zAgent） | 10 分鐘無回饋 | ZAGENT_TOOL_TIMEOUT_SEC 可改；截止點 = max(最近回饋 + 10 分鐘, 工具時限 + 6 分鐘)；子任務家族豁免 |
| MCP 呼叫空閒兜底（zAgent） | 35 分鐘無回饋 | 每次回饋重設；有時限通告時至少「剩餘時限 + 5 分鐘」；不再按總時長取消 |
| 「已執行」計時出現 | 60 s | 之後每 20 s 對表 |
| 複讀檢測視窗 | 25 行 / 25 回合 | 單輪 3（相鄰）或 5 次截停；跨回合 3 / 5 / 8 次 |
| 會話內例行程序 | 每會話 5 · 每工作區 50 | 每會話 24h 新增 ≤ 10；每工作區每日送達 ≤ 300；連續失敗 3 次暫停 |
| 低餘額行內預警 | < 50 點 | 僅 AVL-Zero |
| Alpha 版本有效期 | 45 天 | 不可調 |
| 背景任務並行 | 64 | 不可調 |
| 背景任務終態保留 | 30 分鐘 | 不可調 |
| 啟動自動復原任務數 | 5 | 不可調；其餘轉手動復原 |
| AgentParallel 腿數 | 2–16 | < 2 報錯、> 16 截斷 |
| AgentParallel 整體超時 | 600 秒 | 上限 1800；超時未完成腿轉 pending |
| AgentParallel 單腿輸出 | 8000 runes | 超出截斷，提示取全文 |
| 自愈嘗試上限（壓縮/切換/退避/產出） | 2 / 3 / 3 / 3 | 自愈歷史可下調，每類至少 1 |
| RAG 索引文件數 / 構建超時 | 4000 / 120s | 每文件 ≤ 400 符號·≤ 4 MiB；code.search 預設 20 命中、code.ask 預設 12 |
| SBOM 元件預覽 / audit 預覽 / vex 語句預覽 | 50 / 30 / 40 | 完整結果在落盤文件 |
| SBOM 可達性掃描 | ≤4000 文件 · ≤256 KiB/文件 | vex 可達性分析上限 |
| 綁定碼 TTL | 10 分鐘 | 不可調 |
| 登入憑證 TTL | 23h45m | 不可調 |
28.2 檔案大小硬上限（工具讀取）
| 工具 | 上限 |
|---|---|
read (lines) |
256 KiB |
read (bytes) |
256 KiB |
list |
4 KiB |
glob |
256 KiB |
grep |
256 KiB |
exec |
256 KiB |
28.3 結束碼語義
| 碼 | 含義 | 來源 |
|---|---|---|
| 0 | 成功 | CLI / 工具 |
| 1 | 一般錯誤 | CLI / 工具 |
| 2 | 參數錯誤 | CLI |
| 64–78 | sysexits 系列 | CLI |
| 124 | 超時 | exec |
| 137 | 被 kill | exec |