Skip to content

v0.1.0 — 首次發布

Choose a tag to compare

@kiki830621 kiki830621 released this 26 Aug 04:44
· 58 commits to main since this release

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 mcp

Claude 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(spctlsource=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