项目简介
claude-mem 是一个以 TypeScript 编写的持久化上下文项目。根据仓库描述,它会捕获代理会话中的活动、压缩整理信息,并将相关上下文提供给后续会话,目标是减少不同会话之间的知识断层。
核心功能
- 通过会话生命周期钩子和 Worker 服务记录会话、观察结果与摘要。
- 使用 SQLite 保存数据,并提供全文与向量检索相关组件;README 还列出 Chroma 向量数据库及混合搜索架构。
- 提供分层记忆检索流程:先搜索索引,再查看时间线,最后按 ID 获取详细观察记录。
- 支持上下文注入配置、隐私排除标记,以及可选的截图处理与云同步。相关配置和默认状态应以官方文档为准。
- README 和仓库描述列出 Claude Code、OpenClaw、Codex、Gemini、Copilot、OpenCode 等集成对象;不同集成的具体能力和适用版本需分别核对。
适用人群与场景
适合希望让 AI 编程助手在多个工作会话之间保留项目背景的开发者,也可供研究代理记忆、上下文管理或检索流程的团队评估。适用范围以各集成的官方说明和实际配置为准。
安装与快速开始
README 明确给出 Claude Code 的安装方式:
npx claude-mem install
README 还列出 OpenCode、OpenClaw、T3 Code、Antigravity CLI、OMP、Pi、DeepSeek Harness 等集成的安装方式。选择集成前,请查阅对应的官方安装指南及前置条件。README 特别说明,npm install -g claude-mem 安装的是 SDK/库,不会完成插件钩子注册或 Worker 服务配置。
系统与 API/模型/硬件依赖
README 所列系统要求包括 Node.js 20.0.0 或更高版本,以及 Claude Code(适用于 Claude Code 插件方式)。其还提到 Bun、uv 和 SQLite 3:Bun 与 uv 在缺失时可由安装流程自动安装,SQLite 随包提供。其他 IDE 或代理集成的依赖可能不同,需按各自文档核实。
README 表示可配置 AI 模型,并列出 Anthropic 方案、OpenRouter 或 Gemini 密钥,以及 claude-mem observer 等选项;具体模型版本、API 调用边界、数据传输范围和所需硬件规格,现有资料未提供可统一核实的说明。硬件依赖待核实。
费用与商用许可
GitHub 元数据和 README 标示许可证为 Apache-2.0。该许可证信息不代表第三方托管服务、模型 API 或其他集成均免费;服务费用及各组件的商业使用边界应分别核查。README 提及登录后有 30 天免费试用及多种记忆提供方,但未提供可在此确认的完整价格表。具体费用待核实。
项目活跃度
仓库创建于 2025-08-31,资料记录最近一次推送时间为 2026-11-01 04:24:27 UTC。仓库累计 Stars 为 108,077;这是累计数,不是近期新增数。
近期 Star 变化
OSS Radar 记录的 24 小时 Star 增量为 1,494,7 天增量为 4,934;统计时间为 2026-11-01 04:07:31 UTC。来源标记为非估算值(estimated=false)。这些是对应统计窗口内的变化,不是累计 Stars。
官方文档、演示与资源
已验证与待核实信息
依据所提供资料可确认: 项目名称、仓库地址、TypeScript 语言、仓库累计 Stars、创建与推送时间、Apache-2.0 许可证标记,以及 OSS Radar 提供的 24 小时和 7 天 Star 变化及统计时间。README 明确列出了安装命令、部分系统要求、组件和文档链接。
仍待核实: 各集成在当前版本中的兼容范围与功能差异;模型和托管服务的完整费用;数据处理、云同步及隐私配置的实际边界;硬件要求;许可证对仓库不同目录及相关服务的具体适用范围。文中未将 README 的功能说明视为独立实测结论。
