壓縮與重置
長時間執行如何維持在模型視窗內，以及 reset 與 remove 會清掉什麼。
執行期壓縮
除了上述儲存分層，internal/agents/exec/compact 負責把單次長時間執行維持在模型視窗內。各階段獨立，依序套用且只做到夠用為止：
| 階段 | 觸發 | 效果 |
|---|---|---|
CheckThreshold(model) |
每次迭代 | 當前模型的 token 預算——其 context window 的 80 %。自 v1.0.11 起 window 改由每小時向 https://llm-io.agenvoy.com/ 取一次的即時表提供，以 vendor + model 查表，取代原本寫死的各家族固定值；表中查不到的模型回退 128 K。v1.0.25 起表中查不到的 copilot@ 模型改用 Copilot 自身 /models 端點回報的 max_context_window_tokens（背景抓取、每 24 小時更新），取代原本一律 256 K 的回退值 |
ExtractOldHistories |
超出預算，該次執行第一次 | 把較舊的對話輪次併入滾動摘要 |
ToolHistory |
再次超出預算，或沒有較舊的對話可併入 | 將最舊的 tool-call 往返摘要成文字 |
TrimFallback |
Provider 回報 context 長度錯誤 | v1.1.1 起先跑同一套 ExtractOldHistories → ToolHistory 壓縮後重送；只有該壓縮無法縮減時，才丟掉最舊的一組對話再重送 |
RawToolFallback |
執行途中切換模型 | 將 tool 歷史轉為純文字，讓新模型可讀 |
手動壓縮可從 TUI（/compact；/memory 指令已移除，重設改為 /reset）或 POST /v1/session/:id/memory 觸發。該端點以 action 區分：compact 丟棄較舊訊息並回傳 removed、summary 重建滾動摘要並回傳 count、reset 清空對話——mode: "summary" 保留滾動摘要，mode: "all" 一併清除。v1.1.1 起 TUI popup 另有唯讀的 summary 分頁，顯示當前的滾動摘要。
搜尋路由
match 參數 |
來源 | 使用情境 |
|---|---|---|
semantic（預設） |
ToriiDB VSearch | 「我們討論過關於 X 的什麼？」—— 基於語意 |
keyword |
SQLite FTS5（封存）+ ToriiDB 子字串（近期） | 「找出含 'sandbox' 的訊息」—— 精確文字 |
跨 session error memory
Tool 失敗與解決它的修正方式以 90 天 TTL 存於 error_memory，跨 session 存續。只有以 outcome=resolved 寫入的紀錄會被儲存；failed / abandoned 的寫入會被丟棄，因此不再保留放棄的策略。命中時（透過關鍵字 Contains 或 db.VSearch），該條目的 TTL 透過 db.Expire 續期。
當同一 tool 名稱在未來 session 失敗時，toolCall.go 自動查詢 error_memory，把最多 3 筆相關紀錄以 related_errors 附在失敗的工具結果後；agent 套用已記錄的修正方式。
紀錄中的作法可在 web 儀表板的 Lessons 頁面編輯（PATCH /v1/torii/error，改寫 action 並保留 TTL）；GET /v1/torii/error 列出紀錄。
Reset / remove 行為
| 操作 | history.json |
ToriiDB DBSessionHist |
SQLite（messages + meta） | summary.json |
|---|---|---|---|---|
| Compact（自動） | 裁剪至 80% | 移除早於 cutoff 的條目 | 不動（已含全部資料） | 不動 |
Reset（/reset，mode=summary） |
刪除 | 清除 | 清除 | 保留 |
Reset（mode=all） |
刪除 | 清除 | 清除 | 刪除 |
| Remove session | 刪除目錄 | 清除 | 清除 | 刪除目錄 |