印记存储器
持久存储系统 克劳德代码赋予克劳德在对话中幸存的长期记忆。
作为一个 MCP服务器 --本地工作（stdio）或通过HTTP与OAuth远程工作。
特性
- 混合搜索 --FTS5全文+向量嵌入+精确匹配，融合 快速反应部队 排名和时间衰减评分
- CJK支持 --中文/日文/韩文文本使用jieba进行分段，以实现准确的全文搜索
- 内存CRUD --使用类别/来源/重要性标签存储、搜索、更新、删除记忆
- 对话搜索 --按关键字搜索记录的对话，可按平台过滤
- 知识库 --下降
.md文件在bank/；它们是自动分块、嵌入和可搜索的 - 每日日志 --仅附加每日日记
- 消息总线 --所有来源共享时间线
- 任务队列 --提交任务，以便Claude Code异步执行（支持多轮会话）
- 上下文压缩 --使用局部Ollama模型总结旧的上下文行，并进行截断回退
单个SQLite数据库中的所有数据（WAL模式）。
快速启动
# Install
pip install git+https://github.com/Qizhan7/imprint-memory.git
# Register with Claude Code
claude mcp add -s user imprint-memory -- imprint-memory或在本地克隆：
git clone https://github.com/Qizhan7/imprint-memory.git
cd imprint-memory && pip install -e .工具
| 工具 | 说明 |
|---|---|
memory_remember | 存储内存（类别、来源、重要性） |
memory_search | RRF统一搜索 跨越记忆、银行和对话 |
memory_list | 列出最近的回忆 |
memory_update | 按ID更新内存 |
memory_delete | 按ID删除内存 |
memory_forget | 删除与关键字匹配的记忆 |
memory_pin / memory_unpin | 固定/取消固定核心存储器（固定=无时间衰减） |
memory_add_tags | 向内存中添加标签（逗号分隔） |
memory_add_edge | 用类型关系链接两个记忆 |
memory_get_graph | 查看内存的标签、边和邻居预览 |
memory_find_duplicates | 查找语义上相似的对（数据消除审计） |
memory_find_stale | 寻找低活动的旧记忆 |
memory_decay | 降低非活动记忆的重要性（默认情况下为模拟运行） |
memory_reindex | 重建所有嵌入（切换提供程序后） |
memory_daily_log | 添加到今天的日志中 |
conversation_search | 搜索对话历史记录（所有平台） |
search_telegram | 搜索电报+心跳对话 |
search_channel | 搜索任何特定渠道（不和谐、松弛等） |
message_bus_read / post | 读/写共享消息总线 |
cc_execute | 为Claude Code提交任务 |
cc_check / cc_tasks | 检查任务状态，列出最近的任务 |
配置
所有通过环境变量：
| 变量 | 默认值 | 描述 |
|---|---|---|
IMPRINT_DATA_DIR | ~/.imprint/ | 所有数据的基本目录 |
IMPRINT_DB | $IMPRINT_DATA_DIR/memory.db | SQLite数据库路径 |
TZ_OFFSET | 0 | UTC偏移小时数（例如。 12 NZST） |
EMBED_PROVIDER | ollama | ollama, openai，或 google |
EMBED_MODEL | auto | 型号名称（默认值： bge-m3 / text-embedding-3-small / gemini-embedding-2) |
OLLAMA_URL | http://localhost:11434 | 奥拉马终点 |
OPENAI_API_KEY | -- | 适用于OpenAI兼容的提供商 |
EMBED_API_BASE | https://api.openai.com | 与OpenAI兼容的API的基本URL |
GOOGLE_API_KEYS | -- | Google Gemini嵌入的逗号分隔键（或 GOOGLE_API_KEY 对于单个密钥） |
嵌入提供者
Ollama（默认） --免费，本地：
ollama pull bge-m3 && ollama serveOpenAI API --无本地GPU：
export EMBED_PROVIDER=openai OPENAI_API_KEY=sk-...任何与OpenAI兼容的API （Voyage AI、Azure等）：
export EMBED_PROVIDER=openai OPENAI_API_KEY=... EMBED_API_BASE=https://... EMBED_MODEL=...谷歌双子座嵌入 --支持文本+图像（多模式）：
export EMBED_PROVIDER=google GOOGLE_API_KEYS=key1,key2 # comma-separated for round-robin没有嵌入提供商？回到FTS5关键字搜索——仍然有效，只是语义较少。
切换提供商后，运行 memory_reindex 重建嵌入。
HTTP模式
对于Claude.ai通过隧道进入：
pip install imprint-memory[http]
imprint-memory --http # → http://0.0.0.0:8000/mcpOAuth凭据通过 ~/.imprint-oauth.json 或环境变量(OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET, OAUTH_ACCESS_TOKEN).
数据布局
~/.imprint/
├── memory.db # SQLite (memories, vectors, tasks, bus)
├── MEMORY.md # Auto-generated index
└── memory/
├── 2026-04-01.md # Daily logs
└── bank/ # Knowledge files (.md)独立与全栈
此软件包可独立工作 — pip install 在Claude Code中，您将获得持久内存。没有其他依赖关系。
如果您还需要多渠道消息传递（Telegram等）、Claude.ai集成、心跳自动化、仪表板和计划任务，请参阅完整系统： 克劳德印记。它将印记内存作为依赖项安装。
许可证
麻省理工学院