設定

檔案佈局

~/.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、note + FTS5、messages + FTS5、action_history、file_history、usage
│   ├── db_0 ... db_3                 ToriiDB——工具與額度快取、對話向量、錯誤記憶、online marker
│   └── temp/                         被移除的檔案，加上時間戳後綴移至此
├── prompts/                          Session prompt 規則（.md，經 /v1/rules 暴露）
├── skills/                           Skill 儲存（git 版本控管）
│   ├── .system/                      內建 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/* 提供
├── knowledge/                        舊版筆記，僅讀取一次以遷移進 SQLite note 表
├── 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 輸入歷史
        └── 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           專案範圍的工具允許清單

config.json

模型、路由與 channel 設定：

reply_lang 與 output_dir 可由 TUI /config，或 GET / POST /v1/config/system 與 /v1/config/output_dir 設定；/config 也可切換 Startup on login（/v1/config/startup）。原本獨立的 startup、reply-language、output-dir TUI 指令已移除，改用 /config。Daemon 監看 config.json，每次寫入都會重新載入 agent registry 與 Telegram / Discord。

除了模型與 channel 設定，config.json 也承載 runtime 限制與可選的 policy 覆寫。缺少的限制欄位、reply_lang、output_dir 與 model_tag 會以預設值補齊並於啟動時寫回。

不從 config.json 讀取的套件層預設值：

Daemon port 不可設定：17989 為套件常數，limits.port 條目會被忽略。

config.json 的 policy 鍵。前兩者會與編譯進 binary 的內建值合併（使用者項目是追加，永不取代預設）；其餘僅存在於使用者設定：

三個鍵已不再讀取，若存在會在啟動時記警告：sensitive_map（更名為 sensitive_path）、white_list（移除——不在 denied_command 的指令皆可執行）、path_white_list（移除——$HOME 之外的路徑改為逐 session 核准）。

v0.35.0 移除最後一批 pre-v0.28.9 相容路徑：limits.max_skill_iterations（由 limits.max_tool_iterations 取代）與 planner_model（由 dispatcher_model 取代，下次儲存時會從 config.json 刪除）不再被採用，舊的 api_tools/／script_tools/ 目錄也不再讀取——工具改放 tools/api/ 與 tools/script/。

Runtime 限制沒有環境變數——env 覆寫已移除，config.json 是唯一調整點。

專案內設定

configs/
├── jsons/
│   ├── sensitive_path.json           憑證 / 金鑰路徑
│   ├── exclude_list.json             列目錄 / 走訪時排除的路徑
│   ├── read_only_command.json        跳過確認的指令
│   ├── local_compat.json             內建本機端點（Ollama、llama.cpp）
│   ├── reply_lang.json               回覆語言代碼與標籤
│   └── tui_tools.json                僅限 TUI 的工具與 skill
└── prompts/                          System prompt 模板、reasoning guide、channel prompt

Repo 內不再附帶供應商與模型目錄——模型清單改由各供應商 API 即時取得。

Session 人格

Session 設定存放在 ~/.config/agenvoy/.store/history.db 的 session 表，不再是 per-session 檔案：name、self_id、model（預設 auto）、reasoning、rule（人格內文），以及聊天綁定（chat_id、guild_id、channel_id、user_id）。self_id 會正規化為小寫，只接受最多 32 個 ASCII 字母、數字、_ 或 -；非空值必須唯一。

人格內文會在每一輪渲染進 system prompt 的 ## Bot Persona 區塊。編輯走 TUI /bot 或 GET / POST /v1/session/:id。

Daemon 啟動時，舊版的 per-session bot.json、bot.md、config.json、status.json、usage.log 與 summary.meta.json 會遷移進 SQLite，之後不再寫入。state 表本身已於 v0.35.3 移除——session 的存活狀態改為 ToriiDB online marker，不再是儲存的資料列。

權限模式

生效的權限模式（single-confirm 或 always-allow）由進入點決定：

模式會渲染進 system prompt 的 ## Permission Mode。位於唯讀指令清單的指令在任何模式下都跳過 gate。

MCP 設定

單一檔案：~/.config/agenvoy/mcp.json。Session 範圍的層級已移除。完整 schema 與 ${VAR} 展開行為見 MCP 客戶端頁。

KuraDB

已無 kuradb_enabled 旗標，也沒有 /v1/kuradb 端點。KuraDB 與其他 MCP server 一樣註冊——在 mcp.json 加一筆條目——其工具以 mcp__kura__* 出現。TUI /kuradb 精靈已於 v0.35.0 移除：請自行以 kuradb.sh 安裝（需真實 TTY 處理 sudo），再透過 /mcp 註冊。

Telegram / Discord 啟用

刻意不存放於此的東西

• 供應商 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
• 操作者筆記 —— .store/ 底下 SQLite 的 note 表，絕不在 ~/.config/agenvoy/knowledge/；該目錄只讀取一次以遷移舊筆記
• Tool 呼叫結果 —— 單次執行內的記憶體去重，加上 fetch_page、search_web 與 http_request GET 呼叫 30 分鐘的 ToriiDB cache；其餘不跨重啟保留