你的金鑰存在作業系統鑰匙串裡，
不在提示詞裡，也不在儲存庫裡

存在你主目錄下 ~/.agentsroom/secrets.json 這一個金鑰庫檔案裡。每個值都透過 Electron safeStorage 加密，所以加密金鑰握在你的作業系統鑰匙串手裡。檔案以僅限屬主的許可權（0600）寫入並原子替換，崩潰也不會讓它只寫了一半。

不能。代理可以列出你金鑰的名稱，並請求把其中一個注入到某條命令或某個環境裡，這已經足夠它把活幹完。沒有任何一條程式碼路徑會把值返回給代理、返回給介面層或經由 MCP 送出。解析只在 Electron 主程序中發生。

永遠不會。金鑰庫在設計上就只屬於本機。金鑰不會被髮送到 AgentsRoom 的伺服器，不會備份到雲端，也不會轉發給行動應用。它們在你的機器上建立，為你的機器加密，也就留在那裡。

在原本寫值的地方寫 {{secret:NAME}}：開發終端的命令裡，或者代理的環境裡。AgentsRoom 會在那個程序啟動時替換成真實的值，而留在你設定裡的始終是引用。

AgentsRoom 會拒絕儲存這個金鑰。這裡刻意沒有把值以明文寫到磁碟的兜底方案，因為一個會悄悄退化成普通檔案的金鑰庫，只會給你加密的信心，卻沒有加密。

它解決的是 AI 代理一介入就開始扎心的那部分問題：把憑據擋在檔案、提示詞和對話之外。你的專案在執行時該有什麼照舊，而值本身待在金鑰庫裡、啟動時注入，不再躺在一個代理能讀、一次提交能順走的檔案中。

在另一臺機器上不能。這些值是用你的作業系統鑰匙串保管的金鑰加密的，所以單獨拿走的檔案就是一堆密文。除此之外，金鑰庫以僅限屬主的許可權寫入，同一臺機器上的其他使用者帳戶同樣打不開。

secrets_list，而且只有它。它返回這臺機器上儲存的金鑰名稱，讓代理先知道有哪些金鑰，再在一條開發命令裡、或在它啟動的某個程序的環境裡以 {{secret:NAME}} 的形式引用其中之一。沒有任何工具會返回值，所以代理沒有什麼可列印、可抄進它正在寫的檔案，也沒有什麼可洩進對話裡。當它需要的某個金鑰還不存在時，它會請你在應用裡新增，而不是請你把它粘進聊天框。