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。
相关
- 项目
- 项目
- 项目
- 项目
- 项目