v0.1.0 — 首次發布
Claude Code 的長期記憶。索引這台機器上既有的 ~/.claude/projects/**/*.jsonl,讓模型能回頭查自己的過去。
檢索負責導航,不負責當答案——每一筆命中帶 (project, sessions, uuid, timestamp) 指標,讓你回去讀原文。
Install
Claude Code(plugin,推薦)
Plugin 尚未上架 marketplace(下一步)。目前手動裝:
curl -L https://github.com/PsychQuant/claude-LTM/releases/download/v0.1.0/ltm -o ~/bin/ltm
chmod +x ~/bin/ltm
ltm build # 建索引。**不能省**——沒索引時 server 會回應但查不到東西
claude mcp add --scope user --transport stdio claude-ltm -- ~/bin/ltm mcpClaude Desktop(一鍵)
下載下方 claude-ltm-0.1.0.mcpb 並雙擊。安裝後仍要跑一次 ltm build。
驗證(三層,失敗長得一樣但補救不同)
ltm --help # ① binary
ltm query "test" >/dev/null && echo 索引可查 # ② 索引
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ltm mcp # ③ 協定這一版是什麼
首次發布。檢索路徑(FTS5 + 向量兩路)、記憶層、可插拔的排序策略、MCP server、plugin shell。
MCP server 是 ltm mcp 子命令而不是第二個執行檔——單一 binary、單一 asset。
簽章
Developer ID 簽章 + Apple notarization(spctl 回 source=Notarized Developer ID)。不是 ad-hoc:本專案用 Keychain 存 anchor key,而 ad-hoc 簽章每次 build 換一個 code identity,會讓使用者反覆看到 Keychain 授權對話框。
ltm.sha256 / claude-ltm-0.1.0.mcpb.sha256 一併附上。那擋的是截斷或損毀的下載,不是竄改——雜湊與 binary 走同一條 TLS 通道。
全本機,以及那句話的限度
語意向量用 Apple 的 on-device NLContextualEmbedding,字面檢索用本機 SQLite FTS5,選用的主題標記用 on-device FoundationModels。沒有 API key、沒有雲端依賴,索引與查詢路徑不開任何對外連線。
但那不等於「資料留在這裡」:這個工具的用途就是把檢索到的原文送進呼叫端的 context,而那段原文之後往哪去取決於那個 client 與模型,不是這個 repo 能保證的事。語料含第三方逐字內容時,這一點要自己判斷。完整說明見 bundle 內的 PRIVACY.md。
完整變更見 CHANGELOG.md。