設定
邱敬幃 Pardn Chiu ·
檔案佈局
~/.config/agenvoy/
├── config.json 主設定——模型、優先序、tier、路由角色、channel 旗標、回覆語言、輸出目錄、限制、policy 覆寫
├── daemon.log Daemon 日誌
├── runtime.uid Server 模式單例紀錄
├── mcp.json 全域 MCP server
├── tasks.json 一次性排程任務
├── crons.json 週期性 cron 任務
├── allow_skill 全域 skill always-allow 清單(一行一個名稱)
├── allow_tool 全域工具自動核准清單(一行一個樣式,可用 `prefix*`)
├── .telegram / .discord 已授權聊天 ID(一行一個,OTP 驗證成功後寫入)
├── .store/
│ ├── history.db SQLite——session、message_meta、messages + FTS5、action_history、file_history、usage
│ ├── db_0 ... db_3 ToriiDB——工具與額度快取、對話向量、錯誤記憶、online marker
│ └── temp/ 被移除的檔案,加上時間戳後綴移至此
├── prompts/ Session prompt role(.md,經 /v1/roles 暴露)
├── skills/ Skill 儲存(git 版本控管)
│ ├── .system/ 內建 skill
│ ├── .system_design/ 以 /skill 安裝的選用 skill
│ ├── scheduler/ Scheduler skill 目錄(<short>-<hash8>/SKILL.md)
│ └── .Trash/ 已移除 skill(可從 .Trash 復原)
├── tools/ Tool 儲存(git 版本控管)
│ ├── api/ API tool(各一份 JSON)
│ ├── script/ Script tool(tool.json + script.py)
│ ├── .system/ 內建 tool
│ └── .extension/{api,script}/ 由 extension 安裝的 tool
├── vendor/ Web 儀表板的第三方資產,daemon 啟動時下載,於 /vendor/* 提供
├── download/ 聊天收到的附件與下載檔案(內含 .Trash/);~/Downloads 不存在時的預設輸出目錄
└── sessions/
├── .Trash/ 已移除的 session
└── <sid>/
├── history.json 近期對話,以差量追加
├── summary.json 滾動摘要
├── .summary_cursor 增量摘要游標
├── action.log Tool call 稽核軌跡 —— [時間戳][window_hash][kind][task_hash] 內容
├── .cmd_history 該 session 的 TUI 輸入歷史
├── claude_code_<model>.json claude-code 的 session id 與 resume 狀態,每個模型一份(v1.1.1)
└── pending/ 待決的 ask_user / confirm metadata,每個 task hash 一份 JSON
<專案根>/.config/agenvoy/ 專案範圍的 tool 與 skill
├── tools/{api,script}/
└── skills/
<專案根>/.agenvoy/allow_skill 專案範圍的 skill always-allow 清單(與全域取聯集)
<專案根>/.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
- Tool 呼叫結果 —— 單次執行內的記憶體去重,加上
fetch_page、search_web 與 http_request GET 呼叫 30 分鐘的 ToriiDB cache;其餘不跨重啟保留