回顾

暂停的原生建筑和明确的生产要求,见 CI 费用政策。 。 。 .

跨工具编码内存+指令编译器.

Recall是编码代理的本地Repo-memory编译器. 它从校正,审查反馈,回波扫描和会话结果中学习,然后通过CLI,MCP,守护进程端点和生命周期钩子来注入收紧信任的指令.

• 网站: https://recallmemory.dev/ 页面存档备份,存于互联网档案馆
• 回顾云登入: https://app.recallmemory.dev/login 页面存档备份,存于互联网档案馆
• 支助: 邮件: 支持@ recallmemory.dev
• 释放: https://github.com/edihasaj/recall/releases (中文(简体) )
• 贡献: 捐款额
• 比较与其他内存系统: benchmark/COMPARISON.md

为什么要回忆?

你纠正你的经纪人。 下一会它忘了。 你再纠正一次 记得捕捉到 持久规则 隐藏在这些修正中——一次——并且通过生命周期钩重新注入每一会。 本地优先, 无云, 没有常见路径所需的 API 密钥 .

故事分为三行:

recall correct -r owner/repo "don't use npm, use pnpm"   # one correction
# next session start:
# → SessionStart hook fires, injects:  "- use pnpm as the package manager"
# → your agent never reaches for npm again

网页盘

捆绑的网络仪表板( 通过菜单栏项目打开) 在浏览器中打开 Dashboard,或 recall webui start)是了解Recall所学到的东西的最快方法:记忆,知识图,最近的活动,以及每个打到守护进程的人的活会.

知识图	时间线	会议

• 图 ——按实体类型分2D分层视图外加3D力布局(切入工具栏). Repo + kind drops and a 包含- match 名称搜索过滤可见的集;单击一个节点来钻入链接的记忆和邻居.
• 时间线 ——每个守护进程事件的可过滤种子(编译,查询,扫描,更正,反馈,工具调用. 点击一行来扩展完整的请求/结果 JSON;直接跳到链接的记忆或向会话视图中枢.
• 会议 ——每一次不同的会议回顾都看到跨MCP,钩子和CLI流量,持续时间,事件计数和类型分解. 扩展会话, 查看其事件的内入或将其交给时间线过滤 session_id。 。 。 .

基准

LongMemEval-S 答题精度

回顾已回答 第500个中的474个 LongMemEval-S问题正确(94.8%在它的最好的实验运行.

最佳的两跑相同设置(474和470),与克文回答并判断. 其他分数按 后视 和不同的型号, 所以这不是一个头对头测试。 见 结果,我们尝试的一切 和我们如何衡量它。 。 。 .

单独的 Cloud Linux 后端证据评价也得分 474/500 (英语)由Quen回答和判断 见其 配置和范围。 。 。 .

检索与代理

LongMemEval-S,N=500,包括30个无法回答的问题ID. 相同的数据集 agentemory 发布;这些是检索度量,而不是答案的准确性.

MiniLM行隔离系统贡献(同嵌入式代理用法);e5行是Recall实际用到的. 完整数字,按类型分列,消减,方法 − benchmark/COMPARISON.md。 。 。 .

安装

云为可选. 连接服务器可读的 Cloud 账户可以同步 和在线检索,它向您配置的 Cloud 发送代理询问文本. 在 Cloud 标签中独立关闭检索 recall cloud-query off。 。 。 . 保留了已有的解密设置.

对于私人备份和设备同步,请选择 私人同步 ^ 本地搜索 内 麦克应用程序。 内存文本,注释和证据在上传前被加密; 4; 搜索在您的设备上运行,包括同步和索引后下线。 保存 每个设备的密码句相同。 主机MCP和云搜索需要 单独的服务器可读模式。 见 私人云同步 用于恢复和此隐私界限的界限.

Mac App 存储版

沙盒店版, 回顾:编码内存窗口与 2.0.7版本于2026年10月15日被拒绝(准则4.3) 和4.2.6; 2.0.14(1)于2026年10月23日上传,尚未上传 提交。 审批后将自动免费发布. 它包括自己的运行时间,并通过本地HTTP连接代理. 记忆是 存储在应用程序容器中,仓库访问通过文件夹获得 拣取者. 见 存储发布和连接细节。 。 。 .

家庭工作人员(macOS)

brew tap edihasaj/tap
brew trust --cask edihasaj/tap/recall
brew install --cask edihasaj/tap/recall
recall setup --yes
recall doctor

Homebrew 7+需要第三方包的明确信任. 这些命令 只能信任那个召回的桶。 运行 brew update 第一个如果 brew trust 无法使用.

召回检查菜单栏和仪表板上的完整发布. 一个乡下人 安装可以从仪表板上更新 更新 页面; 提醒安装 水缸,重新启动它的守护进程,并重新打开应用程序。 直接 .app 安装于 a 可写 /Applications 文件夹还更新 in-app。 召回验证归档 校验和,它的苹果开发者签名,以及替换前的公证 应用。 如果新守护进程无法启动, 它会恢复先前的应用程序 .

巴什一行线( macOS, Linux)

curl -fsSL https://recallmemory.dev/install.sh | bash

运行 npm i -g @edihasaj/recall + 键 recall setup --yes 然后打印可选背景服务的下个步骤.

npm (macOS, Linux) (英语)

npm i -g @edihasaj/recall
recall setup --yes
recall doctor
# Optional: run as a background service
recall daemon install            # launchd on macOS, systemd --user on Linux

在Linux上, recall daemon install 写入 ~/.config/systemd/user/recall-daemon.service 并赋予它。 日志 : journalctl --user -u recall-daemon。 。 。 .

Power Shell (窗户)

irm https://recallmemory.dev/install.ps1 | iex

安装 @edihasaj/recall 通过 npm 的 CLI ,下载系统- TRAY 伴奏(recall-tray-<arch>.exe改为: %LOCALAPPDATA%\Programs\Recall,注册每个用户的 Run-key 条目进行自动启动,并发射托盘。 支助 arm64 财务报告和审定财务报表 amd64。托盘显示 更新召回 当一个完整的发布准备就绪时;它在单独的PowerShell窗口中打开同样的安装器,在托盘退出之后. 重新运行安装器也更新了已有的安装,有数据库备份以及包和托盘校验和检查. 日志在 %LOCALAPPDATA%\Recall\。 。 。 .

GitHub 发布

下载 回忆. app.zip打开它,移动 Recall.app 输入 /Applications,然后运行设置 :

open /Applications/Recall.app             # click Install + Start once
recall setup --yes
recall doctor

安装 + 开始曝光捆绑的22CLI ~/.local/bin/recall编辑 Homebrew cask自动链接同一捆绑的发射器.

来源

git clone https://github.com/edihasaj/recall.git
cd recall
nvm use
npm ci
npm run build
npm link

源开发预计节点22,匹配捆绑的应用运行时间. 如果测试 以失败方式 NODE_MODULE_VERSION 错误来自 better-sqlite3切换到节点 22 并重新安装依赖性, 因此本地模块 ABI 匹配测试 运行时间.

从源创建 macOS App

构建 macOS 应用程序捆绑 :

npm run build:app

scripts/build-app.sh 嵌入了22号节点. 它更喜欢 RECALL_NODE_PATH=/path/to/node 设置时,否则节点运行时间从 目前安装 /Applications/Recall.app,然后你的壳 node。 。 。 .

装入 /Applications数字 :

npm run install:app

应用程序嵌入了它自己的节点运行时间外加召回 dist/, (中文(简体) ), drizzle/,以及 node_modules/,然后通过启动管理捆绑守护进程. 运行时 /Applications,应用程序默认登记为登录项目,所以菜单栏状态图标在登录后返回;守护进程启动代理仍然是背景工作者. 首选项有两个能见度开关: 显示停靠图标 (默认关闭)和 显示菜单栏图标 (默认情况下). 两者都关闭后,"召回"持续在后台运行;再打开"召回"(Finder,Spotlight或Aloadpad)来将仪表板带回.

针对已安装的应用程序配置本地代理运行时间 . recall setup --yes 用于所支持的检测运行时间的电线 MCP 和生命周期钩, 因此内存注入不依赖于选择调用的模式 query数字 :

recall setup --yes                       # shared MCP + hooks for detected runtimes
recall setup --scope project --yes       # add project-scoped hooks to the current repo
recall setup --uninstall-hooks --yes     # remove Recall-managed hooks

默认情况下, 钩子会注入紧凑的 Repo 内存包 SessionStart 和每个项目的相关分数匹配 UserPromptSubmit。选择退出即时注射或电线提供者证书,以便守护进程能够在时间表上运行内存维护,参见 文件/配置。 。 。 .

所支持的运行时间以及整合的深度:

没有使用寿命周期的运行时间 API 无法在快速/ 工具/ 会话事件上调用, 因此 Recall 安装了管理规则块, 指示代理机呼叫 capture_correction 财务报告和审定财务报表 query 自己来 在那里捕捉取决于之后的模型——以钩为主的运行时间不.

编码配置文件( 多 CODEX_HOME(c) 财务、财务和预算

Codex 支持多个家庭和驱动工具( Paseo, 每个账户) 设置)常见点提供者在 ~/.codex-primary, (中文(简体) ), ~/.codex-secondary, (中文(简体) ), 诸如来. recall setup 电线 每个 它找到的档案 不仅仅是 ~/.codex数字 :

• 默认家( E)CODEX_HOME 如果设置, 否则 ~/.codex,加任意 ~/.codex-* 长得像真正的Codex家的哥哥config.toml, (中文(简体) ), auth.json,或 sessions/。 备份后缀目录被跳过 .
• 设定 RECALL_CODEX_HOMES 改为 :编号 :, 分隔列表以覆盖发现 .
• 共享并联的配置文件 config.toml 写了一次 symlink被遵循而不是被替换——所以共享-配置布局仍然保留 共享,而不是伪造成不同的副本.

安装 + 设置行为 :

• 常规应用启动,守护进程启动,守护进程重启是代理集成的非模拟. 在您移除后, 它们不会重新添加钩或 repo 指令文件 .
• 内存"再思考":当提供者证书被存储时,守护进程每天运行调度器(无法通过 RECALL_DISPATCHER_INTERVAL_SECONDS精炼/相接/总结记忆。 使用 recall maintenance credentials --help 用于特定提供者字段。 观察性: recall maintenance usage, (中文(简体) ), recall maintenance stats。没有密钥,待完成的任务会通过SessionStart浮出水面,供现场代理人员索赔.
• recall doctor 检查安装状态; recall doctor --fix 或者说 recall setup --yes 用于支持代理运行时间的电线MCP+接钩.
• 当地回收 .recall/context.md 是一种可选的出口/退货,而不是主要的一体化.

永久去除本地数据

预览每个本地项目Recall将删除:

recall data purge --dry-run

然后永久删除:

recall data purge --yes

清洗删除了整个Recall数据目录,包括数据库, WAL文件,备份,日志,缓存,本地模型,以及同步状态. 也可以删除 生成的召回管理的关键链证书 .recall/context.md 出口, 守护进程服务 代理钩和规则 以及召回MCP注册 这个 回顾已安装的可执行程序或应用程序 。 命令是安全的重运行和 支持 --json 用于自动化。 使用 --keep-integrations 只有在你想的时候 钩子和MCP接线以保留并重建在下次使用时的清洁本地商店. 环境变量和用户授权的文件永远不会被重写.

第一个运行

初始化 DB :

recall init

扫描真实的 Repo :

recall scan ~/Projects/some-repo
recall list
recall publish ~/Projects/some-repo

如果后来通过守护进程或 MCP 询问了未见的回购, 现在回想一下, 通过解决本地克隆并扫描回购, 尝试一个懒惰的一次性靴子陷阱. 召回还可以将repo-local背景发布到 .recall/context.md;将其视为可选出口/退货,而不是主要代理一体化. Bootstrap现在保持操作命令的热度,并留下更软的扫描事实作为候选者,或在维护清理期间丢弃.

检查质量/健康/注射包:

recall quality -r owner/repo
recall health -r owner/repo
recall maintenance quality
recall eval value-retrieval --snapshot
recall maintenance quality --history
recall reliability
recall reliability --canary --real-embeddings
recall compile -r owner/repo
recall compile -r owner/repo --query "pytest -q" --include-candidates

Bootstrap 本地嵌入和衍生 sqlite-vec 索引 :

recall doctor
recall embeddings setup
recall embeddings info
recall embeddings bootstrap
recall embeddings verify
recall embeddings rebuild-index
recall search -r owner/repo "pnpm"

可选嵌入式 vars :

RECALL_EMBEDDING_PROVIDER=multilingual-e5
RECALL_EMBEDDING_DIMS=384
RECALL_EMBEDDINGS_DISABLED=true

Windows x64和ARM64支持本地向量检索. 原生ARM64使用a 捆绑了ARM64扩展;其他平台保留了已存在的sqlite-vec加载器. 这一更新保存了现有的数据库。 如果本地扩展缺失 或无法加载, 记得保留词典检索并报告 原因在其中 /health。见 存储策略。 。 。 .

守护进程维护在定时器上运行.

有用的内脏:

RECALL_MAINTENANCE_INTERVAL_SECONDS=3600
RECALL_ACTIVITY_RETENTION_DAYS=30
RECALL_FEEDBACK_RETENTION_DAYS=180
RECALL_SIGNAL_RETENTION_DAYS=180
RECALL_SQLITE_VACUUM_ENABLED=true
RECALL_SQLITE_VACUUM_MIN_FREE_PAGES=100
RECALL_SQLITE_VACUUM_MIN_FREE_RATIO=0.1
RECALL_CANDIDATE_UNCONFIRMED_DAYS=30
RECALL_RELIABILITY_PROBE_ENABLED=true
RECALL_RELIABILITY_PROBE_INTERVAL_SECONDS=86400
RECALL_RELIABILITY_PROBE_REAL_EMBEDDINGS=true

recall reliability 将编译器选择、钩子排放、观测使用、, 并解决了结果。 每日探测器检查现场数据库 最新的备份, 和一个一次性的活生生的金丝雀 见 可靠性和不确定性。 。 。 .

检查滚动会话历史:

recall history list -r owner/repo
recall history search -r owner/repo "pnpm"

会议历史卷起更正,审查反馈,汇编意见, 以及用户对迅速活动的决定/指示. 编译的上下文包括一个小的相关历史部分,这样可以决定 重新使用时没有将每个提示促进到持久的记忆中. 历史注射与内存注射分开跟踪 recall maintenance quality。 。 。 .

运行检索 eval 定着 :

recall eval retrieval --file docs/retrieval-eval.example.json
recall eval retrieval --file docs/retrieval-eval.example.json --json
recall eval retrieval --file docs/retrieval-eval.recall.json
recall eval retrieval --file docs/retrieval-eval.recall-hybrid.json

对于随着时间的推移而变化的事实,实验性的本地MCP工具 temporal_remember 财务报告和审定财务报表 temporal_query 保存已过时的证据和支持 明确的历史查询。 见 时间断言和比较 方法 用于语义,当前边界,以及 合成基准.

教书

增加一个更正:

recall correct -r owner/repo "don't use npm, use pnpm"
recall list -r owner/repo

手动确认内存 :

recall confirm <memory-id>

报告审查反馈:

recall review -r owner/repo "review said use error boundaries"

质量模型

recall quality 显示 :

• 阶段 : cold | growing | mature
• 质量分数
• 升级前需要的复课
• 汇编信任阈值
• 消除相似性阈值

行为:

• 冷的再现器学得更快
• 成熟重置器需要更多的重复证据
• 响亮的再投注 少冲动

守护进程

启动 HTTP 守护进程 :

node dist/daemon.js

作为用户服务安装(在macOS上启动, systemd --user linux 上; 在 Windows 上, 托盘应用程序监督守护进程 —— 见上面的 PowerShell 安装器 :

recall daemon install
recall daemon status

有用的服务命令 :

recall daemon start
recall daemon stop
recall daemon uninstall

检查钩遥测:

recall hook stats
recall hook stats --agent codex
recall hook stats --json

默认 URL :

http://localhost:7890

有用的终点 :

curl -s http://localhost:7890/doctor
curl -s http://localhost:7890/update
curl -s 'http://localhost:7890/quality?repo=owner/repo'
curl -s -X POST http://localhost:7890/compile \
  -H 'Content-Type: application/json' \
  -d '{"repo":"owner/repo"}'

curl -s -X POST http://localhost:7890/correct \
  -H 'Content-Type: application/json' \
  -d '{"repo":"owner/repo","session_id":"s1","text":"don'\''t use npm, use pnpm"}'

GET /doctor 返回已安装的版本、数据路径、检测到的代理设置, 并将信号升级为JSON. Windows 托盘使用此本地状态报告; recall doctor 进行全面审计. GET /update 比较已安装的运行时间和 GitHub 最新完成的时间 释放。 它仅在包后提供更新, macOS app, 两个Windows 托盘二进制, 且检查摘要更新器已完成上传 .

会话收藏器端点 :

curl -s -X POST http://localhost:7890/session/start \
  -H 'Content-Type: application/json' \
  -d '{"session_id":"codex-1","client":"codex","repo_path":"'"$PWD"'"}'

curl -s -X POST http://localhost:7890/session/end \
  -H 'Content-Type: application/json' \
  -d '{"session_id":"codex-1","client":"codex","repo_path":"'"$PWD"'","payload":{"exit_code":0}}'

可选的复古本地背景文物:

recall publish .
cat .recall/context.md

Claude 代码 MCP

回顾支持MCP运输:

• 斯特迪奥:克洛德代码产物 直接召回. 这是最便携的默认.
• HTTP: Claude 代码连接到守护进程 http://localhost:7890/mcp。 。 。 . 这需要提醒应用程序/守护程序运行 .

包装的macOS app, stdio 配置 :

{
  "mcpServers": {
    "recall": {
      "command": "/Applications/Recall.app/Contents/Resources/Runtime/bin/node",
      "args": ["/Applications/Recall.app/Contents/Resources/Runtime/dist/mcp.js"]
    }
  }
}

源检出, 之后的 stdio 配置 npm run build数字 :

{
  "mcpServers": {
    "recall": {
      "command": "node",
      "args": ["/path/to/recall/dist/mcp.js"]
    }
  }
}

守护进程 HTTP 配置 :

claude mcp add --transport http -s user recall http://localhost:7890/mcp

相当的JSON:

{
  "mcpServers": {
    "recall": {
      "type": "http",
      "url": "http://localhost:7890/mcp"
    }
  }
}

其余的守护进程 API 仍然在同一端口可用, 例如 /health, (中文(简体) ), /compile,以及 /session/start。 。 。 .

有用的 MCP 工具 :

• query
• report_correction
• capture_correction
• report_review
• signal_outcome
• session_end
• quality
• list
• confirm

会话折叠器

用薄薄的包装纸 scripts/ 如果您想要从会话开始后返回到自动学习, 在检索有用之前:

scripts/recall-codex
scripts/recall-claude

他们:

• 发送 /session/start 以当前 git 根或 pwd
• 让真正的客户端正常运行
• 发送 /session/end 带有最终退出代码

必要时覆盖目标:

RECALL_CODEX_BIN=/path/to/codex scripts/recall-codex
RECALL_CLAUDE_BIN=/path/to/claude scripts/recall-claude
RECALL_DAEMON_URL=http://localhost:7890 scripts/recall-codex

MCP 第一个

建议的生产模式:

• 通过本地调用 /Applications/Recall.app
• 允许代理通过调用 MCP 查询/实况报告
• 处理 .recall/context.md 作为可选导出/后退,而不是主路径

快速测试循环

recall init
recall scan ~/Projects/some-real-repo
recall quality -r owner/repo
recall compile -r owner/repo
recall correct -r owner/repo "don't use npm, use pnpm"
recall list -r owner/repo

如果您需要重复的会话提升测试, 请使用守护进程 /correct 结束点不同 session_id 数值.

发展

npm ci
npm run docs:check
npm run typecheck
npm test
npm run build

发行和本乡出版笔记 文件/检索。登陆页面是静态 HTML/CSS 中的 文档/ 与 GitHub Pages 一起部署。 公众爬行配置 文件/机器人.txt,其中列出了Cononical的登陆网页 URL 文件/ siteap.xml。 。 。 .

IndexNow 所有权不承诺给仓库。 页面工作流程写入 公众 /<key>.txt 部署时将校验文件输入上传的站点 从存储器密钥中 COMPASS_INDEXNOW_KEY,共享 Compass 组合 键。 没有这个秘密的运行跳过台阶,并发布网站不变.