信息卡

一句话定位

给 Codex、Claude Code 等编程智能体加一层跨会话共享记忆："Never lose context. Never start over."——工程教训自动写回，新会话即插即用。

走红原因分析

AI 编码工具最大的隐性损耗是每次新会话从零开始：踩过的坑、项目的入口点、用户的沟通偏好全部归零。memorax-code 主打"后台自动写回"，无需手动调用 skill 存记忆，且覆盖四大主流 agent 统一管理，恰好踩中记忆赛道最热的真空地带。

核心功能拆解

• 后台记忆写回：自动从已完成的对话轮次提取可复用知识写入 Coding Memory。
• 语义比对写入：保存前比较新旧含义——等价请求不动；改进或冲突则更新条目并移除被取代文字；一次性任务指令不污染长期记忆；意图不明先询问再写入。
• 四类记忆边界：Coding Memory（工程教训）、Repo Memory（仓库结构与历史证据）、Personal Memory（沟通偏好）、Procedure Memory（可复用任务流程）。
• 偏好连续性：记录 User Profile 并按配置节奏注入后续任务。
• Repo Memory 自动维护仓库知识，本地存于 `.repo_memory/`。
• 客户端集成负责触发检索、提醒和写回；也可用内置 skill 或 CLI 手动搜索/添加。

架构与技术栈浅析

npm 包 @memorax/memorax-code，Node.js 实现 CLI 与配置（~/.memorax-code/config.toml）；setup 自动检测已安装的 agent 并以 skill/plugin 形式注入集成；云端依赖 MemoraX 账户，本地轨迹捕获默认开启且可降级为仅元数据或关闭；隐私设计上只上传选定的用户指令与最终回复，不传完整 trace、模型凭证或本地 token。

安装与环境要求

Node.js ≥20（推荐 24 LTS）、Python 3（Repo Memory 操作需要）；DeepSeek Harness 场景要求 Node ^22.19.0 || >=24。

快速上手示例

npm install -g @memorax/memorax-code
memorax-code setup --existing-account   # 连接已有账户
memorax-code setup                      # 或 90 天访客模式试用

Codex 中 `$memorax-code`、Claude Code / DeepSeek Harness 中 `/memorax-code` 调起。官方验证法：同一会话依次让 agent 构建 Repo Memory → 复查历史错误教训 → 记住本次教训，关闭后开新会话发召回指令，agent 应能找回并应用。

进阶使用要点

访客账户需 `account --show-mark-id` 获取 Mark ID 激活；`status` 排障、`update` 升级、`uninstall` 需先于 npm 移除运行；Windows 上 v0.1.3–v0.1.6 升 0.1.7 要先 stop 再 update --latest。日常使用靠后台自动写入，README 强调手动召回仅是快速验证手段。

典型应用场景

• 长期维护的 monorepo：沉淀构建陷阱、部署流程供后续会话复用。
• 团队多人协作：统一沉淀个人偏好避免反复调教风格。
• 在多个 agent 间迁移而不丢失上下文资产。

同类生态位对比

对位 TencentDB-Agent-Memory、dsh-mneme、memsearch 等记忆方案；memorax-code 胜在四宿主通吃加语义级写回去重，代价是云端依赖 MemoraX 账户而非纯本地。

资源导航

仓库：https://github.com/memorax-ai/memorax-code ；npm 包名 @memorax/memorax-code；许可证 MIT。