Bastra Recall：为 AI 助手提供跨会话持久记忆的本地 Markdown 记忆库

核心能力与快速开始

★ 12 · TypeScript

能做什么

把 AI 助手的偏好、项目决策、事实和经验教训存为独立的 Markdown 文件，构成可读可编辑的本地记忆库；通过 MCP、Skill 与钩子在会话开始或操作前按需浮现相关记忆，而非每次注入全部内容；支持多个 MCP 兼容客户端（Claude Code、Claude Desktop、Codex CLI、Cursor 等）共享同一 vault；提供 CLI 命令进行安装、诊断（doctor）、记忆浏览（map）和规则生成；内置本地关键词搜索，语义检索可选通过本地 Ollama embeddings 实现，也支持选择 OpenAI embeddings；提供 REST API 供非 MCP 客户端接入；实验性的代码感知功能可提示文件被哪些文件导入或调用。

适用场景

在 Claude Code、Codex CLI、Cursor 等 AI 编程客户端之间共享同一份项目约定与决策记忆；替代或补充不断膨胀的 CLAUDE.md / AGENTS.md，让助手只在需要时获取相关条目；记录并复用已解决问题的经验教训，减少跨会话重复说明；用 Obsidian 或任意文本编辑器审阅、修正助手自动记录的记忆内容。

项目形态

可直接使用的工具

部署方式

本地运行。macOS 提供引导式安装脚本（curl | bash，含 Homebrew 安装）或 npx bastra-recall install；macOS 与 Linux 需 Node 22+，也可用 npm 全局安装。Linux 使用 npm 安装，无 Homebrew、LaunchAgent（bastra autostart）和 .mcpb 扩展路径。Windows 未覆盖、未测试。

主要依赖

Node 22+（npx / npm 安装路径）；macOS（Apple Silicon 与 Intel）或 Linux（x86_64、arm64）。可选语义检索需要本地 Ollama 及其嵌入模型；启用后还会运行本地 doc2query 改写，无 GPU 时可能耗时数小时。启用代码感知需单独从 PyPI 安装 Graphify，目前仅 macOS 与 Linux。

使用限制

自动召回依赖具体客户端集成与助手行为，不保证每条指令都被遵循。Windows 未覆盖且未测试，无编译版钩子客户端。语义检索与背景改写为可选且默认关闭，启用 OpenAI embeddings 会将查询与索引记忆文本发送给 OpenAI。不提供托管的多设备同步；使用 iCloud、Google Drive 或 Dropbox 同步 vault 时并发编辑可能冲突。代码感知为实验性功能，在判断改动影响面时并未显著优于普通搜索，且会消耗上下文与后台 CPU。会话级上下文预算仅在影子模式下测量，尚未实时强制限制。

许可证

MIT

最近推送

2026-10-05 01:29

资料检查：2026-10-05 07:00 · 卡片整理：2026-10-05 09:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在编写代码、排错和代码审查时，让 AI 编程助手跨会话记住项目偏好、技术决策和已解决问题的经验，并在会话开始或操作前自动浮现相关记忆，避免重复交代上下文。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证