$CMEM 官方链接： Bags.fm • Jupiter • Photon • DEXScreener

官方 CA：2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS (on Solana)

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

为 Claude Code 构建的持久化记忆压缩系统。

快速开始 • 工作原理 • 搜索工具 • 文档 • 配置 • 故障排除 • 许可证

Claude-Mem 通过自动捕获工具使用观察结果、生成语义摘要，并使其对后续会话可用，从而跨会话无缝保留上下文。这使得 Claude 即使在会话结束或重新连接后，也能保持对项目的知识连续性。

## 快速开始 在终端中启动一个新的 Claude Code 会话，并输入以下命令： ``` /plugin marketplace add thedotmack/claude-mem /plugin install claude-mem ``` 重启 Claude Code。来自先前会话的上下文将自动出现在新会话中。 ### 🦞 OpenClaw Gateway 只需一条命令，即可在 [OpenClaw](https://openclaw.ai) 网关上将 claude-mem 安装为持久化记忆插件： ``` curl -fsSL https://install.cmem.ai/openclaw.sh | bash ``` 安装程序会处理依赖项、插件设置、AI 提供商配置、Worker 启动，以及可选的实时观察推送到 Telegram、Discord、Slack 等。详情请参阅 [OpenClaw 集成指南](https://docs.claude-mem.ai/openclaw-integration)。 **核心特性：** - 🧠 **持久化记忆** - 上下文跨会话留存 - 📊 **渐进式披露** - 分层记忆检索与 token 成本可见性 - 🔍 **基于 Skill 的搜索** - 使用 mem-search skill 查询你的项目历史 - 🖥️ **Web 查看器 UI** - 实时记忆流，地址：http://localhost:37777 - 💻 **Claude Desktop Skill** - 从 Claude Desktop 对话中搜索记忆 - 🔒 **隐私控制** - 使用 `` 标签将敏感内容排除在存储之外 - ⚙️ **上下文配置** - 对注入的上下文内容进行细粒度控制 - 🤖 **自动运行** - 无需人工干预 - 🔗 **引用** - 通过 ID 引用过去的观察结果（通过 http://localhost:37777/api/observation/{id} 访问，或在 http://localhost:37777 的 Web 查看器中查看全部） - 🧪 **Beta 频道** - 通过版本切换尝试 Endless Mode 等实验性功能 ## 文档 📚 **[查看完整文档](https://docs.claude-mem.ai/)** - 在官方网站上浏览 ### 入门指南 - **[安装指南](https://docs.claude-mem.ai/installation)** - 快速开始与高级安装 - **[使用指南](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem 如何自动运行 - **[搜索工具](https://docs.claude-mem.ai/usage/search-tools)** - 使用自然语言查询项目历史 - **[Beta 功能](https://docs.claude-mem.ai/beta-features)** - 尝试 Endless Mode 等实验性功能 ### 最佳实践 - **[上下文工程](https://docs.claude-mem.ai/context-engineering)** - AI Agent 上下文优化原则 - **[渐进式披露](https://docs.claude-mem.ai/progressive-disclosure)** - Claude-Mem 上下文引导策略背后的理念 ### 架构 - **[概述](https://docs.claude-mem.ai/architecture/overview)** - 系统组件与数据流 - **[架构演进](https://docs.claude-mem.ai/architecture-evolution)** - 从 v3 到 v5 的历程 - **[Hooks 架构](https://docs.claude-mem.ai/hooks-architecture)** - Claude-Mem 如何使用生命周期 Hooks - **[Hooks 参考](https://docs.claude-mem.ai/architecture/hooks)** - 7 个 Hook 脚本详解 - **[Worker 服务](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API 与 Bun 管理 - **[数据库](https://docs.claude-mem.ai/architecture/database)** - SQLite Schema 与 FTS5 搜索 - **[搜索架构](https://docs.claude-mem.ai/architecture/search-architecture)** - 使用 Chroma 向量数据库的混合搜索 ### 配置与开发 - **[配置](https://docs.claude-mem.ai/configuration)** - 环境变量与设置 - **[开发](https://docs.claude-mem.ai/development)** - 构建、测试、贡献 - **[故障排除](https://docs.claude-mem.ai/troubleshooting)** - 常见问题与解决方案 ## 工作原理 **核心组件：** 1. **5 个生命周期 Hooks** - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd（共 6 个 Hook 脚本） 2. **智能安装** - 缓存依赖检查器（Pre-hook 脚本，非生命周期 Hook） 3. **Worker 服务** - 运行在 37777 端口的 HTTP API，提供 Web 查看器 UI 和 10 个搜索端点，由 Bun 管理 4. **SQLite 数据库** - 存储会话、观察结果、摘要 5. **mem-search Skill** - 支持渐进式披露的自然语言查询 6. **Chroma 向量数据库** - 混合语义 + 关键词搜索，用于智能上下文检索 详情请参阅 [架构概述](https://docs.claude-mem.ai/architecture/overview)。 ## MCP 搜索工具 Claude-Mem 通过 **4 个 MCP 工具**提供智能记忆搜索，遵循节省 Token 的 **3 层工作流模式**： **3 层工作流：** 1. **`search`** - 获取带有 ID 的紧凑索引（约 50-100 token/结果） 2. **`timeline`** - 获取感兴趣结果周围的按时间顺序排列的上下文 3. **`get_observations`** - 仅获取经过筛选的 ID 的完整详情（约 500-1,000 token/结果） **工作原理：** - Claude 使用 MCP 工具搜索你的记忆 - 从 `search` 开始获取结果索引 - 使用 `timeline` 查看特定观察结果周围发生的事情 - 使用 `get_observations` 获取相关 ID 的完整详情 - 通过在获取详情前进行筛选，**节省约 10 倍的 Token** **可用的 MCP 工具：** 1. **`search`** - 使用全文查询搜索记忆索引，支持按类型/日期/项目过滤 2. **`timeline`** - 获取特定观察或查询周围的按时间顺序排列的上下文 3. **`get_observations`** - 通过 ID 获取完整的观察详情（始终批量处理多个 ID） **使用示例：** ``` // Step 1: Search for index search(query="authentication bug", type="bugfix", limit=10) // Step 2: Review index, identify relevant IDs (e.g., #123, #456) // Step 3: Fetch full details get_observations(ids=[123, 456]) ``` 详细示例请参阅 [搜索工具指南](https://docs.claude-mem.ai/usage/search-tools)。 ## Beta 功能 Claude-Mem 提供 **Beta 频道**，包含 **Endless Mode**（用于扩展会话的仿生记忆架构）等实验性功能。可以在 http://localhost:37777 的 Web 查看器 UI → 设置中，在稳定版和 Beta 版本之间切换。 有关 Endless Mode 的详情及如何尝试，请参阅 **[Beta 功能文档](https://docs.claude-mem.ai/beta-features)**。 ## 系统要求 - **Node.js**：18.0.0 或更高版本 - **Claude Code**：支持插件的最新版本 - **Bun**：JavaScript 运行时和进程管理器（如缺失会自动安装） - **uv**：用于向量搜索的 Python 包管理器（如缺失会自动安装） - **SQLite 3**：用于持久化存储（内置） ### Windows 设置注意事项 如果你看到类似以下的错误： ``` npm : The term 'npm' is not recognized as the name of a cmdlet ``` 请确保 Node.js 和 npm 已安装并添加到你的 PATH 中。从 https://nodejs.org 下载最新的 Node.js 安装程序，并在安装后重启终端。 ## 配置 设置在 `~/.claude-mem/settings.json` 中管理（首次运行时使用默认值自动创建）。可配置 AI 模型、Worker 端口、数据目录、日志级别和上下文注入设置。 有关所有可用设置和示例，请参阅 **[配置指南](https://docs.claude-mem.ai/configuration)**。 ## 开发 有关构建说明、测试和贡献流程，请参阅 **[开发指南](https://docs.claude-mem.ai/development)**。 ## 故障排除 如果遇到问题，向 Claude 描述问题，troubleshoot skill 将自动诊断并提供修复方案。 有关常见问题和解决方案，请参阅 **[故障排除指南](https://docs.claude-mem.ai/troubleshooting)**。 ## Bug 报告 使用自动生成器创建详尽的 Bug 报告： ``` cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report ``` ## 许可证 本项目基于 **GNU Affero General Public License3.0** (AGPL-3.0) 授权。 Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. 有关完整详情，请参阅 [LICENSE](LICENSE) 文件。 **这意味着：** - 你可以自由使用、修改和分发本软件 - 如果你修改并在网络服务器上部署，必须公开你的源代码 - 衍生作品也必须基于 AGPL-3.0 授权 - 本软件不提供任何保证 **关于 Ragtime 的说明**：`ragtime/` 目录单独基于 **PolyForm Noncommercial License 1.0.0** 授权。详情请参阅 [ragtime/LICENSE](ragtime/LICENSE)。 ## 支持 - **文档**：[docs/](docs/) - **Issues**：[GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **仓库**：[github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) - **官方 X 账号**：[@Claude_Memory](https://x.com/Claude_Memory) - **官方 Discord**：[加入 Discord](https://discord.com/invite/J4wttp9vDu) - **作者**：Alex Newman ([@thedotmack](https://github.com/thedotmack)) **Built with Claude Agent SDK** | **Powered by Claude Code** | **Made with TypeScript**

标签：Agent SDK, AI 编程助手, Claude Code, Meme 币, MITM代理, RAG, Solana, 上下文压缩, 上下文窗口, 会话持久化, 加密货币, 大模型工具, 开发效率, 智能注入, 网络可观测性, 自动化攻击, 自动化攻击, 自动记录, 记忆管理, 逆向工具