v1.3.11
首頁 GitHub

設定

最後更新


檔案佈局


  1. ~/.config/agenvoy/
  2. ├── config.json                       主設定——模型、優先序、tier、路由角色、channel 旗標、回覆語言、輸出目錄、限制、policy 覆寫
  3. ├── daemon.log                        Daemon 日誌
  4. ├── runtime.uid                       Server 模式單例紀錄
  5. ├── daemon.sock                       TUI 經由 daemon 執行 agent 與 MCP 操作的 Unix socket（0600，v1.2.0）
  6. ├── mcp.json                          全域 MCP server
  7. ├── tasks.json                        一次性排程任務
  8. ├── crons.json                        週期性 cron 任務
  9. ├── allow_skill                       全域 skill always-allow 清單（一行一個名稱）
  10. ├── allow_tool                        全域工具自動核准清單（一行一個樣式，可用 `prefix*`）
  11. ├── .telegram / .discord              已授權聊天 ID（一行一個，OTP 驗證成功後寫入）
  12. ├── .store/
  13. │   ├── history.db                    SQLite——session、message_meta、messages + FTS5、action_history、file_history、usage
  14. │   ├── db_0 ... db_3                 ToriiDB——工具與額度快取、對話向量、錯誤記憶、online marker
  15. │   └── temp/                         被移除的檔案，加上時間戳後綴移至此
  16. ├── prompts/                          Session prompt role（.md，經 /v1/roles 暴露）
  17. ├── skills/                           Skill 儲存（git 版本控管）
  18. │   ├── .system/                      內建 skill
  19. │   ├── .system_design/               以 /skill 安裝的選用 skill
  20. │   ├── scheduler/                    Scheduler skill 目錄（<short>-<hash8>/SKILL.md）
  21. │   └── .Trash/                       已移除 skill（可從 .Trash 復原）
  22. ├── tools/                            Tool 儲存（git 版本控管）
  23. │   ├── script/                       Script tool（tool.json + script.py）
  24. │   ├── .system/                      內建 tool
  25. │   └── .extension/script/            由 extension 安裝的 tool
  26. ├── vendor/                           Web 儀表板的第三方資產，daemon 啟動時下載，於 /vendor/* 提供
  27. ├── download/                         聊天收到的附件與下載檔案（內含 .Trash/）；~/Downloads 不存在時的預設輸出目錄
  28. └── sessions/
  29.     ├── .Trash/                       已移除的 session
  30.     └── <sid>/
  31.         ├── history.json              近期對話，以差量追加
  32.         ├── summary.json              滾動摘要
  33.         ├── .summary_cursor           增量摘要游標
  34.         ├── action.log                Tool call 稽核軌跡 —— [時間戳][window_hash][kind][task_hash] 內容
  35.         ├── .cmd_history              該 session 的 TUI 輸入歷史
  36.         ├── .claude_code/             claude-code 的 session id 與 resume 狀態，每個模型 + system prompt 雜湊一份（v1.1.3；v1.1.1 起為 claude_code_<model>.json）
  37.         └── pending/                  待決的 ask_user / confirm metadata，每個 task hash 一份 JSON
  39. <專案根>/.config/agenvoy/              專案範圍的 tool 與 skill
  40. ├── tools/script/
  41. └── skills/
  42. <專案根>/.agenvoy/allow_skill          專案範圍的 skill always-allow 清單（與全域取聯集）
  43. <專案根>/.agenvoy/allow_list           專案範圍的工具允許清單

刻意不存放於此的東西


  • 供應商 API key —— 絕不進 config.json；一律在 keychain
  • MCP 憑證 —— 在 mcp.json 使用 ${VAR} 佔位符，值留在環境變數
  • store_secret 取得的祕密 —— 僅存 keychain；不進 LLM context、歷史、action.log 或 tool 參數
  • Session 設定與人格 —— 在 .store/ 底下 SQLite 的 session 表，不是 per-session JSON 檔
  • Session 歷史 —— 熱區間為 history.json，另鏡射進 .store/ 的 ToriiDB 與 SQLite
  • 操作者筆記 —— 已於 v1.0.23 連同 find_note、/note 與 /v1/note* 一併移除；SQLite note 表與 ~/.config/agenvoy/knowledge/ 皆不再讀取。常駐指示請改用 role 或 skill
  • 使用者自訂 API tool —— 移除於 v1.3.2：tools/api/、tools/.extension/api/ 與 <專案根>/.config/agenvoy/tools/api/ 下的 api_* JSON tool 不再載入、建立或監看；殘留的 .json 會在 log 留下 [Invalid] api tool 警告。改用 script tool，或 public_api_list 搭配 http_request
  • Tool 呼叫結果 —— 單次執行內的記憶體去重，加上 fetch_page、search_web 與 http_request GET 呼叫 30 分鐘的 ToriiDB cache；其餘不跨重啟保留
EN