# 資料庫可用性與平台

說明已註冊的資料庫何時可供搜尋，以及 KuraDB 支援哪些 filesystem。

## 資料庫可用性

Registry 變更會立即持久化，但 daemon 只在啟動時建立 loaded database map。執行 `kura add` 後，必須先重新啟動 KuraDB，才能對新名稱送出搜尋。`/api/list` 會分別暴露 `registered` 與 `loaded`，讓 client 偵測此狀態。

若已註冊資料庫的目錄或 inbox 無法建立、`~/Kura_{name}` 路徑已存在但不是 symlink，或 `data.db` 開啟失敗，啟動時會略過該資料庫，它不會出現在 `loaded`。每次略過都會記錄於 `daemon.log`。

`kura mcp` 在被 spawn 時建立自己的 loaded map。之後新增的資料庫需重啟 MCP session 才看得到；見 [CLI：MCP](/zh/cli-reference-mcp)。

## 平台限制

請使用 macOS 的本機 APFS/HFS+ filesystem，或 Linux 的 ext4/xfs。Watcher 依賴可靠的 POSIX directory mtime 語義，不支援 Windows、SMB、NFS 或 FUSE mount。