Scope Recall
为多个编码助手提供可追溯、可检查的本地长期记忆。
- Star 数
- ★ 534
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 82/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时使用 Codex 和 Claude Code、希望从同一 SQLite 存储检索会话记忆的开发者。
- 不适合
- 需要未经配置即可获得语义检索和后台模型处理的团队
- 需要把不同项目、分支或作用域的记忆自动合并的用户
- 源码审查
- 82/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Scope Recall 是一个供 Claude Code、Codex、Hermes、WorkBuddy 和 DeepSeek Harness 共用的本地记忆系统,使用 SQLite 保存原始对话,并让提取出的事实和向量能够追溯、重建。用户通过 scope-recall 命令安装、配置和管理记忆;系统也提供 Hermes 工具与 Codex MCP 接口,以及本地浏览器管理页面。检索可组合词法和向量通道,自动回忆会把通过门槛的条目注入会话;没有模型路由或预算时,原文检索仍可用。数据存放在经过验证的 Core 数据目录中,向量索引是可重建的伴随数据。适合需要跨多个受支持助手共享、审查和维护本地记忆的开发者;模型处理、身份绑定和主机授权需要按需配置。
先在目标 Python 环境安装 hermes-scope-recall[codex],再运行 scope-recall setup 检查主机、存储、作用域、模型预算和工作计划,并确认安装。主机获准使用 hooks 或 MCP server 后,系统捕获会话原文到 SQLite,并可由后台 worker 提取事实、维护向量及处理索引任务。会话检索会筛选可见且通过词法覆盖或向量相似度门槛的记忆;用户还可用 scope-recall memory 浏览、搜索、检查历史、修正、静音或删除内容。Hermes 工具和 Codex MCP 暴露只读的 profile、entity 和 trace 视图;本地 UI 支持浏览、审查操作、私密规则、导出及备份状态。
- 同时使用 Codex 和 Claude Code、希望从同一 SQLite 存储检索会话记忆的开发者。
- 需要检查某条记忆来自哪段对话、修正事实或删除相关对话的个人用户。
- 希望在没有模型路由或预算时先启用原文检索,再单独配置模型能力的团队。
- 需要通过只读
profile、entity或trace接口查看已核实事实及关系的 Hermes 或 Codex 用户。 - 要把外部记忆文件或对话导出导入本地存储,并在写入前预览来源与时间范围的用户。
如何安装或部署这个 Agent?
在 hooks 将使用的 Python 环境安装 Codex extra,然后运行设置命令并审阅计划。新会话开始时,按主机提示批准 plugin hooks 或 MCP server。开发 checkout 可从仓库根目录安装;包索引命令则安装已发布版本。
python -m pip install -U "hermes-scope-recall[codex]"
scope-recall setup开发 checkout:
python -m pip install -U ".[codex]"若要启用模型能力,运行交互配置或提供路由文件;密钥以环境变量引用,设置过程不要求输入密钥值。
scope-recall setup --configure-models
scope-recall setup --models <route-file.json>如何使用这个 Agent?
开始新的受支持主机会话,并按提示批准 hooks 或 MCP。用 CLI 管理、检索或检查记忆:
scope-recall memory
scope-recall ui
scope-recall private on --session <id> --mode full导出可见存储:
scope-recall memory export --out <new directory or .zip>通过 Codex 的 MCP 或 Hermes 工具使用只读 profile、entity、trace 视图;具体连接由主机集成处理。
这个 Agent 有哪些优点和局限?
- SQLite 保存原始对话,事实与向量保留来源关联且可重建。
- 支持 Claude Code、Codex、Hermes、WorkBuddy 和 DeepSeek Harness,并可将多个入口接入同一存储。
- 无模型路由或预算时仍提供原文检索;CLI 可本地检查、修正和删除记忆。
- 私密规则支持会话、目录或全库范围,并可选择完全拒绝处理或只读模式。
- 模型路由和预算需另行配置;没有配置时完整模型记忆能力不可用。
- 每个主机需要安装与批准对应 hooks 或 MCP 集成,并绑定身份和作用域。
- 向量模型变更需要显式重新嵌入;打开存储不会自动执行可能付费的重建。
- README 描述了多主机集成,但未提供命名平台 ChatGPT、Claude AI 或 API 的原生集成证据。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Scope Recall 当前 | 82 · 表现良好 | 命令行工具免费 | ★ 534 | 1 天前 | Python | Codex · Claude Code |
| MemOS 2.0 Stardust | 51 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 12k | 1 天前 | TypeScript | — |
| PowerContext | 82 · 表现良好 | 命令行工具免费 | ★ 1.5k | 今天 | Python | Codex · Claude Code |
| Memoh | 50 · 缺口较多 | — | ★ 2.8k | 今天 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安装需查看计划并确认,模型预算默认为零,密钥仅用环境变量引用;删除展示依赖项并以 --yes 执行,卸载默认保留记忆,清理需单独规划。原始对话、事实及向量的来源和可重建边界有说明。扣分:敏感内容仍会存入本地长期记忆,文档要求索引前检查屏幕文本;提供方依赖版本范围较宽,材料未显示依赖漏洞审计,因此依赖安全仅部分有证据。
文档、CLI 描述和 dsh 插件共同说明有界工作、失败回报、重试限制及可恢复存储,整体方向一致。扣分:样本未包含核心存储和检索实现,无法核实这些保证如何覆盖所有路径;依赖和主机可用性也取决于外部提供方与宿主环境。
产品明确面向五种主机,覆盖共享存储、迁移、私密模式、原文检索和可选模型增强,并清楚标出各能力边界。触发规则具体区分自动与显式召回及用户请求。扣分:支持范围广且 Python 版本、主机审批和部署流程各异,实际适配仍依赖环境配置与宿主重载。
仓库结构、安装与主机指南、配置参考、管理和迁移文档较完整;MIT 许可证明确,安全支持版本和报告渠道也有说明。扣分:仅提供了部分文件样本,未见实际变更日志内容;维护者以集体名称标注,责任归属不够具体,示例和问答覆盖也无法从样本确认全面性。
产品提供带来源的检索、检查、修订、抑制、删除、导出和画像/实体/路径读取,且说明适用边界,能支持实际记忆管理。扣分:模型增强需自行配置路由与预算,SQLite、索引、备份及主机集成带来持续管理成本;样本描述了合成基准但不能证明真实私有对话上的质量。
文档将许多操作和能力关联到具体指南、配置项及 CLI 行为,并区分合成基准可测内容与不能证明的语义质量;技能要求通过工具结果和证据引用回答。扣分:此审查样本缺少关键实现和完整测试结果,跨来源佐证仅部分可见,故不把文档声明视为独立验证。
- 本评估仅基于所给文件样本,未运行代码;核心存储与检索实现不在样本中。
- 索引前应审查屏幕识别文本;删除会连带删除来源消息及由该消息产生的事实,且无法撤销,也不会清除主机历史或既有备份。
- 配置模型路由前请确认代理设置、凭据环境变量和预算;带外部模型的请求可能经过配置的代理。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v4.0.3 scope-recall v4.0.3
发布说明摘录
hermes memory setup and scope-recall setup --host hermes now give a new Hermes entry's memory to Hermes Desktop on the same machine as well as to the CLI: the entry gets the owner principal (desktop, local) and its owner_private row on the CLI row's scope, so a Desktop chat recalls and captures without a scope-recall grants edit. hermes --tui still needs the owner's approval, because the browser dashboard's chat tab runs the TUI and a dashboard on loopback can serve it without a login. Running setup again keeps an existing entry's grants; add Desktop to an entry made by an earlier …在 GitHub 查看 ↗ -
v4.0.2 scope-recall v4.0.2
发布说明摘录
A Hermes that installs Scope Recall from its plugin catalog can now use it. hermes memory setup with scope-recall selected runs the ordinary setup through the provider's setup hook, using the plugin environment's interpreter, and reports a refusal in one line. Hermes entries in a shared store carry the Hermes profile's identity instead of a fixed agent id, so a fresh installation's sessions no longer fail with an agent_identity conflict; an unused entry recorded with the old id is repaired. Setup leaves a catalog-installed plugin directory under Hermes's control, treats a home that selec …在 GitHub 查看 ↗ -
v4.0.1 scope-recall v4.0.1
发布说明摘录
Empty or whitespace-only HTTP 200 responses now get bounded recovery as unfinished upstream responses, while uncertain billing reservations and duplicate-execution safeguards remain in place. Hermes notices retain their trusted host origin across display timestamps and later human messages; those messages keep their own origin and are captured once. Scheduled Hermes sessions without a user no longer participate in memory and report capability_gap:unbound_session in diagnostics. After more than 60 seconds idle, binding a Hermes session warms the query embedding route in the background using t …在 GitHub 查看 ↗
常见问题
没有配置模型服务时还能用吗?
记忆存在哪里?
不同助手能否共用一个存储?
导入外部记忆会被直接当作事实吗?
谢谢反馈,我们会据此改进页面。