Theme / v0.10.8

Codebase Memory

程式碼記憶與知識圖譜 MCP

基礎觀念

v0.10.4:安裝與診斷修正

了解 v0.10.4 的 Windows 系統管理員帳號修正、套件管理員保護與可診斷的錯誤訊息。

這版解決了什麼

v0.10.4 是 install-and-diagnostics release,目標是讓 v0.10.3 在 Windows 或套件管理員環境「裝不上、起不來」的使用者可以正常升級。此版本不要求索引、快取或設定遷移。

Windows 系統管理員帳號

若你是 Administrators 群組成員,v0.10.3 的 install 可能以 activation transaction I/O failed: owner-not-current-user 失敗,或 MCP server 啟動時只留下 closed transport 的 log。原因是 installer 用 token 的 user SID 比對檔案 owner,但 Windows 對新建立的物件蓋上的是 owner SID(Administrators 群組預設為 BUILTIN\Administrators),等於 installer 建立暫存檔幾秒後自己拒絕它。

v0.10.4 改為同時接受 Windows 實際蓋上的 owner SID;檔案真的屬於其他帳號時仍會拒絕,不是「信任任何 admin」。

套件管理員安裝不再被覆寫

mise、Homebrew、nix、asdf、cargo 管理的 binary 在 v0.10.3 會被 install~/.local/bin 再放一份並改 shell rc,依 PATH 順序可能蓋過套件管理員版本。v0.10.4 不再碰這類 binary 與 PATHupdate 會誠實拒絕並指名該用 mise upgradebrew upgrade 等對應指令。

另外 install --clients=claude,codex 可限制只設定你指定的 client;不帶參數的 --clients 會列出所有支援的 token。

錯誤訊息現在說得清楚

  • 啟用拒絕會指名是哪個目錄、哪條規則,不再指向從未印出的錯誤。
  • client-path 啟動失敗會以 JSON-RPC error 回傳原因,而不是只有「transport closed unexpectedly」。
  • ui_enabledui_port 成為 config set / config list 支援的第一級設定鍵,不必手改 config.json

若 MCP client 仍顯示連線關閉,先確認版本與 daemon 狀態,再依錯誤訊息排除;不要靠刪除資料庫解決。

來源:Codebase Memory v0.10.4 release