1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | memorax-code |
| 作者/维护者 | MemoraX（memorax-ai） |
| 来源链接 | https://github.com/memorax-ai/memorax-code |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 548（数据来自 GitHub API） |
| Forks | 38（数据来自 GitHub API） |
| 最新版本 | 0.1.7（数据来自 npm registry） |
| 安装方式 | npm install -g @memorax/memorax-code |
2. 功能介绍与亮点
memorax-code 是一个给 Codex、Claude Code、DeepSeek Harness、OpenCode 四类编程 agent 提供跨会话共享记忆层的技能。它以一个“路由器”技能为入口，先判断当前请求属于哪一类记忆权威，再转给对应的处理逻辑。
核心亮点：
- 四类记忆边界清晰：编码记忆（跨会话的修复经验、失败尝试、设计取舍，云端存取）、仓库记忆（架构地图、模块归属、PR/Issue 证据，存在本地
.repo_memory/）、个人档案记忆（语言/语气等交互偏好）、流程记忆（可复用的操作步骤与校验规则）——路由器按内容自动分类，避免用户手动决定存到哪 - 后台自动写回：完成一轮任务后在后台提炼可复用的经验并写入编码记忆，无需用户手动调用
- 账号免注册即可用：
memorax-code setup自动探测已安装的 agent 并完成连接，不强制要求预先注册账号；已有账号的用户可用--existing-account接入 - 安全边界文档详尽：独立的 SECURITY.md 明确划分本地 Backend、各 agent 自有的模型凭据、以及与云端 MemoraX 的记忆流量三类信任边界，本地 Backend 默认只绑定回环地址，配置或权限记录缺失时按失败即拒处理
3. 适用场景
固定分类：元技能与 Agent 增强
适合长期维护同一代码仓库、经常在多次独立会话之间切换的 Claude Code 或 Codex 用户：新会话不必重新粘贴项目背景，agent 能记住此前踩过的坑、仓库的架构脉络，以及用户偏好的语言、语气与工作步骤。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅。安装后可用
/memorax-code直接调用 - Codex：原生支持 ✅。安装后可用
$memorax-code直接调用 - OpenClaw：不支持 ❌。作者在 GitHub Issue 中明确回复“目前 MemoraX Code 暂不支持 OpenClaw”，现阶段开发重点集中在 Codex、Claude Code、DeepSeek Harness 与 OpenCode 四个客户端
- Hermes Agent：不支持 ❌。官方文档明确列出的支持客户端为 Codex、Claude Code、DeepSeek Harness、OpenCode 四类，未包含 Hermes Agent，仓库内也未检索到相关适配代码
5. 推荐理由
四类记忆边界清晰的路由技能，账号免注册即可用，安全边界文档详尽
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 仓库创建三周内积累 548 星、38 fork，被第三方趋势追踪服务 Trendshift 收录为趋势仓库，npm 周下载量约 1,080 次；作者为小型初创团队 |
| 可用性 | 8 | 一条 npm 安装命令加一条 setup 命令即可自动识别并接入已安装的 agent，默认无需注册账号；文档拆分为安装、配置、故障排除、安全四份独立说明并各附示例；三周内发布 8 个版本，含针对性 bug 修复 |
| 安全性 | 7 | SECURITY.md 详细划分本地服务、各 agent 自有凭据与云端记忆流量三类信任边界，默认回环绑定、配置缺失时失败即拒，上传前对疑似凭据内容做正则脱敏；License 明确。第三方独立评测（见第 8 章）同时指出：核心的编码记忆功能依赖一个不可审计的云端排序/去重服务，且客户端本身不支持删除或纠正已存记忆 |
综合评分：7.0
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 与本技能的差异 |
|---|---|---|
| claude-mem | 本地优先的 agent 持久记忆系统，自动压缩上下文并跨会话检索注入 | 记忆完全存于本地，不依赖任何云端服务；本技能把仓库记忆、个人档案存在本地，但核心的跨会话编码记忆必须经由云端处理 |
| supermemory | 面向多 agent 的通用记忆与个性化上下文基础设施 | 定位更通用、覆盖场景更广；本技能专门针对编程 agent 场景，把记忆按编码/仓库/个人档案/流程四类边界拆分得更细 |
| cognee | 自托管的开源知识图谱记忆引擎，通过 CLI 为 agent 提供记忆能力 | 需要用户自行部署并维护图数据库等基础设施，数据完全留在本地；本技能开箱即用但编码记忆的存储与检索交由云端托管 |
8. 用户评价
Simon Strandgaard（GitHub 用户 neoneye，维护对比多款 agent 记忆系统的独立项目 agent-memory-atlas）在其项目页面发布过一份针对本技能的技术分析：肯定其在数据上传前的凭据脱敏机制设计严谨、且检索结果附带明确的“未命中原因”字段，操作透明度较高；同时指出本地客户端缺少删除与纠正已存记忆的能力，且从云端召回的记忆内容以普通文本形式呈现给模型，未标注其为外部数据来源。作者在项目自身的 GitHub Issue 中回应关注并提供了该分析链接。
9. 其他补充
仓库提供简体中文版 README（README.zh.md），并维护 Discord 与微信两个社区交流群组。npm 包三周内已发布 8 个版本（0.1.0 至 0.1.7），迭代频率较高；memorax-code uninstall 会移除本地集成与全局包，但默认保留本地记忆目录与云端已存记忆，需要用户另行清理。
10. 安装使用方式
- 安装：
npm install -g @memorax/memorax-code（需要 Node.js 20 及以上版本） - 初始化：
memorax-code setup（自动探测已安装的支持客户端并完成账号免注册连接），已持有 MemoraX 账号的用户可改用memorax-code setup --existing-account - 安装完成后需重启或刷新对应的 agent 客户端
- 触发方式：Claude Code 中输入
/memorax-code；Codex 中输入$memorax-code；OpenCode 中直接要求 agent 按名调用memorax-code技能 - 更新：
memorax-code update；卸载：memorax-code uninstall
11. 注意事项
- 项目仍处于 0.x 阶段（pre-1.0），接口与行为可能随版本继续调整
- 目前不支持 OpenClaw 与 Hermes Agent
- 核心的编码记忆功能依赖联网访问云端 MemoraX 服务；仓库记忆与个人档案记忆则完全存于本地
.repo_memory/目录 - 客户端本身不提供删除或修正已存编码记忆的入口，需登录 MemoraX 官方控制台网页完成