memorax-ai/memorax-code
A memory plugin for AI coding that turns engineering experience, repository knowledge, and your way of working into memory that remains useful in future tasks.
MemoraX Code – 為 AI 編碼助手提供持久性上下文
是什麼 – 一個透過 npm 分發的工具,為 GitHub Codex、Anthropic Claude Code、DeepSeek Harness 和 OpenCode 等大型語言模型編碼代理添加共享且雲端備份的記憶層。它在不同聊天會話之間記錄並重用工程知識(經驗、架構圖、偏好、流程),讓助手能從上次中斷處繼續工作。
如何運作
- 記憶類型 – 四種作用域儲存:
- 編碼記憶 – 可重複使用的經驗、修復方案、設計依據。
- 倉儲記憶 – 倉儲層級的事實(模組所有者、入口點、最近的 PR/提交)。
- 個人記憶 – 使用者特定的偏好(語氣、語言、輸出格式)。
- 流程記憶 – 重複任務的檢查清單與可重複使用的步驟。
- 此工具以 CLI(
memorax-code)形式在本地執行,透過 API 金鑰與 MemoraX 雲端服務通訊。也可在無帳戶情況下使用 90 天的訪客模式。 - 當編碼代理完成一個回合後,MemoraX Code 會提取關鍵指令與代理的最終回應,然後將簡潔條目寫入相應的記憶儲存。它從不上傳完整對話記錄。
- 代理可按需檢索相關記憶(例如在 Claude Code 中使用
/$memorax-code),或在系統偵測到匹配上下文時自動取得。
核心功能
| 功能 | 你將獲得 |
|---|---|
| 背景記憶自動寫回 | 教訓自動保存,無需手動標籤 |
| 偏好持續性 | 你的語氣、語言和輸出風格在會話間持續保留 |
| 流程複用 | 保存的檢查清單會在類似未來任務中被建議 |
| 倉儲級知識庫 | 架構圖、入口點、最近的問題/PR 數據保持最新 |
| 活躍記憶控制 | CLI 命令可手動搜尋、新增或刪除條目 |
| 多客戶端整合 | 支援 Codex、Claude Code、DeepSeek Harness、OpenCode;支援時顯示配額提醒 |
快速開始
- 全域安裝 –
npm install -g @memorax/memorax-code(需要 Node 20+,倉儲記憶功能需 Python 3)。 - 連接 – 執行
memorax-code setup(建立訪客帳戶)或在建立 MemoraX 帳戶並提供 API 金鑰後,執行memorax-code setup --existing-account。 - 使用 – 在支援的 AI 編碼客戶端中呼叫技能(
$memorax-code或/memorax-code)。工具將自動捕獲上下文,並在你於同一倉儲中開啟新會話時自動檢索。
典型工作流程
# 克隆你希望助手工作的倉儲
git clone https://github.com/SWE-agent/test-repo.git && cd test-repo
# 在 AI 客戶端中執行技能以建立倉儲記憶
$memorax-code # (在 Claude Code 中為 /memorax-code)
# 幾輪對話後,助手將儲存經驗。
# 關閉聊天,重新開啟新會話,然後詢問:
$memorax-code "回憶工程經驗並建議檢查項目"
助手將取得儲存的經驗,並用於指導下一步任務。
管理
memorax-code status– 查看目前設定和雲端連線狀態。memorax-code uninstall– 清理整合但保留本地資料(~/.memorax-code)。- 所有記憶均可在 MemoraX 控制台(https://platform.memorax.net/)中檢視、編輯或刪除。
安全與隱私
- 僅傳送選定的片段(使用者指令 + 最終代理回應)至雲端;原始模型憑證與完整日誌保留在本地。
- API 金鑰儲存在
~/.memorax-code/config.toml,必須保密。 - 详细的網路與保留策略記錄於
SECURITY.md中。
誰會受益
- 依賴 AI 配對程式員,並希望助手記住過去修復、架構決策或個人編碼風格的開發者。
- 在多個專案中使用多個 AI 編碼代理,並需要一致知識庫的團隊。
- 任何希望減少重複提示、提升 AI 驅動程式碼審查或功能實作效率的人。
許可證 – MIT。
相關
- 專案
- 專案
- 專案
- 專案
- 專案