Scope Recall

为多个编码助手提供可追溯、可检查的本地长期记忆。

Star 数
★ 534
最近更新
1 天前
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具Agent 插件 / 技能MCP 服务器
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
PythonSQLiteShell / 命令行本地文件系统MCP Server
典型场景
同时使用 Codex 和 Claude Code、希望从同一 SQLite 存储检索会话记忆的开发者。
不适合
  • 需要未经配置即可获得语义检索和后台模型处理的团队
  • 需要把不同项目、分支或作用域的记忆自动合并的用户

这个 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 支持浏览、审查操作、私密规则、导出及备份状态。

  1. 同时使用 Codex 和 Claude Code、希望从同一 SQLite 存储检索会话记忆的开发者。
  2. 需要检查某条记忆来自哪段对话、修正事实或删除相关对话的个人用户。
  3. 希望在没有模型路由或预算时先启用原文检索,再单独配置模型能力的团队。
  4. 需要通过只读 profile、entity 或 trace 接口查看已核实事实及关系的 Hermes 或 Codex 用户。
  5. 要把外部记忆文件或对话导出导入本地存储,并在写入前预览来源与时间范围的用户。

如何安装或部署这个 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?

FollowAgents 源码审查 · FARS-2.1
表现良好
82/ 100 五分制 4.1 / 5
信任安全 23/29
可靠稳定 9/14
适用触发 16/18
规范维护 15/18
有效结果 12/13
证据核验 7/8
查看各维度的扣分理由
信任安全23 / 29 · 4.0/5

安装需查看计划并确认,模型预算默认为零,密钥仅用环境变量引用;删除展示依赖项并以 --yes 执行,卸载默认保留记忆,清理需单独规划。原始对话、事实及向量的来源和可重建边界有说明。扣分:敏感内容仍会存入本地长期记忆,文档要求索引前检查屏幕文本;提供方依赖版本范围较宽,材料未显示依赖漏洞审计,因此依赖安全仅部分有证据。

可靠稳定9 / 14 · 3.2/5

文档、CLI 描述和 dsh 插件共同说明有界工作、失败回报、重试限制及可恢复存储,整体方向一致。扣分:样本未包含核心存储和检索实现,无法核实这些保证如何覆盖所有路径;依赖和主机可用性也取决于外部提供方与宿主环境。

适用触发16 / 18 · 4.4/5

产品明确面向五种主机,覆盖共享存储、迁移、私密模式、原文检索和可选模型增强,并清楚标出各能力边界。触发规则具体区分自动与显式召回及用户请求。扣分:支持范围广且 Python 版本、主机审批和部署流程各异,实际适配仍依赖环境配置与宿主重载。

规范维护15 / 18 · 4.2/5

仓库结构、安装与主机指南、配置参考、管理和迁移文档较完整;MIT 许可证明确,安全支持版本和报告渠道也有说明。扣分:仅提供了部分文件样本,未见实际变更日志内容;维护者以集体名称标注,责任归属不够具体,示例和问答覆盖也无法从样本确认全面性。

有效结果12 / 13 · 4.6/5

产品提供带来源的检索、检查、修订、抑制、删除、导出和画像/实体/路径读取,且说明适用边界,能支持实际记忆管理。扣分:模型增强需自行配置路由与预算,SQLite、索引、备份及主机集成带来持续管理成本;样本描述了合成基准但不能证明真实私有对话上的质量。

证据核验7 / 8 · 4.4/5

文档将许多操作和能力关联到具体指南、配置项及 CLI 行为,并区分合成基准可测内容与不能证明的语义质量;技能要求通过工具结果和证据引用回答。扣分:此审查样本缺少关键实现和完整测试结果,跨来源佐证仅部分可见,故不把文档声明视为独立验证。

风险与缓解建议
  • 本评估仅基于所给文件样本,未运行代码;核心存储与检索实现不在样本中。
  • 索引前应审查屏幕识别文本;删除会连带删除来源消息及由该消息产生的事实,且无法撤销,也不会清除主机历史或既有备份。
  • 配置模型路由前请确认代理设置、凭据环境变量和预算;带外部模型的请求可能经过配置的代理。
证据充分度:低 评估于 2026年11月7日 审查版本 424e5703df73
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/scope-recall-hermes.svg?lang=zh)](https://followagents.com/zh/agents/scope-recall-hermes)
<a href="https://followagents.com/zh/agents/scope-recall-hermes"><img src="https://followagents.com/badge/scope-recall-hermes.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 查看 ↗

常见问题

没有配置模型服务时还能用吗?
可以。设置会报告原文检索可用;要启用完整模型功能,需配置模型路由和预算。
记忆存在哪里?
原始对话保存在经验证的 Core 数据目录中的 SQLite;向量索引作为可重建的伴随数据保存。
不同助手能否共用一个存储?
可以。README 记录了多个主机作为入口接入同一存储的方式;经任一入口删除的记忆适用于所有入口。
导入外部记忆会被直接当作事实吗?
不会。导入先预览来源;批准导入只允许写入,不代表内容已被确认属实。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。