SuperLocalMemory icon

SuperLocalMemory

SuperLocalMemory 是開源、local-first 的 AI 代理與團隊記憶控制平面,可在本機儲存與檢索專案知識,支援受治理修正、共享記憶,以及選擇性搜尋圖片、螢幕截圖與 PDF。

SuperLocalMemory

AI 代理程式的本機記憶控制

SuperLocalMemory 是開源、local-first 的 AI 代理與團隊記憶控制平面。它會在使用者的電腦上儲存決策、文件及其他專案資訊,接著透過回憶功能提供這些資訊,避免每個代理程式工作階段都只有彼此隔離的情境。

其核心設計著重於受治理的檢索:結果可以指出確切且有支援的答案、在比對不完整時顯示最接近的可用記憶,或表明該資訊不存在。在文件記載的本機 Mode A 中,核心記憶與回憶功能不需要模型提供者呼叫、API 金鑰、雲端帳戶或 Docker。

此專案可透過 MCP 或指令連接多個代理程式,並包含圖片、螢幕截圖與 PDF 的選用索引功能。它也提供取代過時記憶、審查修正,以及透過受治理 mesh 共享記憶的工作流程。

主要功能

Local-first 文字記憶

Mode A 讓核心記憶與回憶功能在使用者的本機上執行,不需要模型提供者呼叫、雲端帳戶或 Docker。

明確處理不確定性

回憶功能會區分有依據的答案、接近但不完全相符的結果,以及要求的資訊不存在的情況,而不是一律回傳看似相關的結果。

受治理的修正

記憶可分類、取代、審查與回復。文件中的 CLI 範例會使用 --replaces 更新 staging 資料庫事實,並提供修正審查流程。

共享且受治理的記憶

此專案旨在透過 mesh 在本機代理程式與網路機器人之間共享記憶,並將存取權限按照公司資料的方式進行治理。儲存庫也包含團隊與共享記憶工作流程的文件。

選用的媒體檢索

選用的媒體模式會使用第二個本機模型為圖片、螢幕截圖與 PDF 建立索引,讓一次回憶操作即可回傳文字與媒體。

代理程式連線

提供命令列存取、MCP 支援,以及適用於多種編碼代理程式與桌面工具的連線或外掛程式方式。

使用情境

  • 持續的專案情境

    一次記錄架構決策、部署程序與環境資訊,接著讓這些內容可供跨工作階段的編碼代理程式使用,無需每次重新解釋專案。

  • 團隊與多代理程式知識

    將多個本機代理程式與面向網路的機器人連接至共享記憶 mesh,讓團隊能使用共同的決策與文件,同時保有受治理的資訊存取權。

  • 具備證據意識的代理程式工作流程

    在準確性很重要時使用回憶行為:將已接受的答案與接近的結果分開,並將不存在的資訊回傳為不存在,而不是默默填入猜測。

  • 可搜尋的視覺與文件檔案庫

    當專案知識包含螢幕截圖、掃描資料、PDF 或其他需要依描述尋找的圖片時,啟用選用的媒體模式。

  • 持續維護的營運知識

    透過取代較舊的記憶來修正不斷變動的營運資訊,例如資料庫版本、連接埠或部署程序,並保留審查或回復途徑。

Pros and Cons

Pros

  • 核心文字記憶可在 Mode A 中於本機執行,不需要模型提供者呼叫、雲端帳戶或 Docker。
  • 檢索行為會明確處理缺失或不確定的資訊,不會將每個搜尋結果都視為已驗證的答案。
  • 此專案支援多種代理程式連線,並提供修正、取代、審查與共享記憶工作流程。
  • 選用的本機媒體檢索功能可將回憶範圍擴展至圖片、螢幕截圖與 PDF。

Cons

  • 此產品主要是面向開發者、以命令列與整合為導向的工具;設定時需要將其連接至正在使用的代理程式或工具。
  • 媒體索引是選用功能,不屬於基礎文字工作流程的一部分,且需要專案文件所述的額外本機資源,包括約 1.5 GB 儲存空間與 16 GB 記憶體。

FAQ

如何安裝 SuperLocalMemory?

SuperLocalMemory 可透過代理程式引導的設定流程、macOS/Linux shell 安裝程式、npm、pip、uv 或儲存庫安裝指令碼進行安裝。README 也記載了受支援工具的設定與連線指令。

是否需要雲端帳戶或模型提供者 API 金鑰?

在 Mode A 中,核心記憶與回憶功能不會呼叫模型提供者,記憶也會保留在本機。會將資料傳出的選用功能會在文件中另行說明,因此使用者可以選擇是否啟用。

除了文字之外,也能搜尋圖片和文件嗎?

文字會使用本機文字模型進行搜尋。若啟用圖片與文件功能,第二個本機模型會處理這些檔案,而一次回憶操作即可同時回傳文字與媒體結果。

代理程式如何連線至記憶系統?

此專案提供 slm connect 等指令來連線代理程式,並支援使用 MCP 或執行指令的代理程式或 harness。儲存庫列出了 Claude Code、Codex、Cursor、Windsurf、Zed、Claude Desktop、JetBrains 與 OpenCode 等工具的連線方式。

Quick Facts

類別
開發者工具
主要使用者
AI 代理程式使用者與團隊
部署方式
Local-first;Mode A 會將核心記憶保留在使用者的本機上
存取方式
CLI、MCP 與代理程式整合
支援系統
Windows、Linux 與 Apple Silicon macOS
來源
開源 GitHub 儲存庫