Fidelis Memory

本地服务

github.com记忆与知识241 周前更新

代码仓库访问官网

关于 Fidelis Memory

Fidelis Memory 是面向 Codex、Claude Code 等 Agent 的本地记忆 MCP 服务。它保存 Markdown 和文本笔记，并检索已存储的原文，侧重逐字回忆而非由模型改写记忆。

主要功能

01在本地保存 Markdown 和文本笔记
02检索已保存的原文措辞
03支持向量和混合检索
04允许更正内容取代旧记录
05显示有效性和历史状态
06以用户级后台服务运行

适用场景

01找回早期摘要遗漏的条件
02引用 Agent 记忆所依据的原文
03结合向量和关键词检索笔记
04查看更正记录及其历史

MCP 相关

Fidelis 为已连接的客户端提供回忆、保存、更正、获取和检查记忆的 MCP 工具。它提供 Codex 和 Claude Code 的安装命令，并说明其他客户端选项。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hermes-labs-ai-fidelis-memory": {
      "command": "uvx",
      "args": [
        "fidelis-memory"
      ],
      "env": {
        "FIDELIS_PORT": "<FIDELIS_PORT>"
      }
    }
  }
}

启动命令uvx fidelis-memory

需要配置的环境变量

FIDELIS_PORTPort of the local fidelis-server process (default: 19420).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypifidelis-memory0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
mode	enum	否	“fast”：向量搜索（默认）。“thorough”：混合搜索，速度较慢，用于获取第二意见。fast \| thorough
as_of	string	否	可选的 ISO-8601 日期或时刻。按记忆在该时点的状态作答：排除之后写入的记录，并忽略之后发生的取代。
limit	integer	否	返回的最大结果数。
query	string	是	自然语言搜索查询。
historical	boolean	否	保持相关性顺序；不要降低已被取代或已过期记录的排序。

详细介绍

Fidelis Memory

你的 Agent 可能会忘记摘要。Fidelis 会找回原始笔记。

为 Codex、Claude Code 和其他 Agent 提供本地记忆：跨会话保存文本，并在需要时检索原始段落。

由 Hermes Labs 提供

PyPI · 连接 Agent · 技术参考

项目摘要可能会写着“账单迁移已回滚”。而原始笔记会说明失败的原因，以及在幂等性修复经过验证之前不要重试。如果你的下一个会话依赖这一条件，那么缺失的这句话就至关重要。

Fidelis 会存储你的 Markdown 和文本笔记，并检索其中保存的原文。默认检索不会让生成式模型改写你的记忆。

用一条笔记试试看

此流程支持 Python 3.10+、macOS 或 Ubuntu，以及本地 Ollama 服务。必要时启动 Ollama（在单独的终端中运行 ollama serve）。无需模型 API 密钥。当前版本为 0.3.0rc1。

ollama pull nomic-embed-text
python3 -m venv ~/.venvs/fidelis
source ~/.venvs/fidelis/bin/activate
python3 -m pip install "fidelis-memory[hybrid]==0.3.0rc1"
fidelis init

demo_dir=$(mktemp -d)
cat > "$demo_dir/atlas.md" <<'NOTE'
Atlas billing migration:
Duplicate charges appeared in staging. Rolled back.
Do not retry until the idempotency fix is verified.
NOTE

fidelis watch "$demo_dir" --once
fidelis recall-hybrid "Atlas billing migration retry condition" --tier zero_llm

fidelis watch 和 fidelis recall-hybrid 使用由 fidelis init 启动的后台服务。

检查检索到的文本中是否包含回滚信息和重试条件。这是对已保存笔记的检索，不是生成的回答。要使用你自己的文件，请将 "$demo_dir" 替换为笔记目录。如果检索失败，请运行 fidelis health，并确认 Ollama 中有 nomic-embed-text。运行 fidelis init 后，请保留虚拟环境；后台服务会使用它。

这会对你的机器进行以下更改：fidelis init 会安装一个面向当前用户的后台服务（在 macOS 上使用 launchd，在 Linux 上使用 systemd --user），并在登录时自动启动 fidelis-server。fidelis watch 会将笔记发送到该服务，由它将笔记保存到默认位于 ~/.cogito/store 的本地存储中，而不是临时演示目录。fidelis recall-hybrid 也会查询同一个运行中的服务，并搜索整个共享存储，因此结果可能包含你之前保存的笔记，而不只是演示笔记。监视器还会将已导入的文件记录在 ~/.fidelis/watched.json 中。要在 macOS 上移除默认服务，请运行 fidelis init --uninstall；这会停止服务并且只删除 launchd plist。在 Linux 上，使用 systemctl --user list-unit-files '*fidelis-server*' 查找已安装的单元，然后运行 systemctl --user disable --now <unit>，从 ~/.config/systemd/user/ 删除该单元文件，并运行 systemctl --user daemon-reload。这两种方式都不会删除你的数据。Fidelis 保存的所有内容都共享同一个存储，因此删除 ~/.cogito/store 会清除其中的全部内容，而不只是演示笔记；仅在一次性安装中这样做。另外，删除临时演示目录（$demo_dir）；如果你想清除文件路径记录，也请删除 ~/.fidelis/watched.json。

连接 Agent

笔记可以在本地检索后，为你的客户端安装 MCP 连接：

fidelis mcp install --client codex
# Or, for Claude Code:
fidelis mcp install

重启客户端并尝试：“使用 Fidelis 查找我的 Atlas 账单迁移笔记。重试前必须做什么？引用相关文本。”

客户端会获得用于检索、存储、更正、获取和检查记忆的工具。客户端会决定何时调用这些工具；安装连接并不会让它在每轮对话中都自动检索。其他客户端和卸载命令包括 Cursor、Gemini CLI、Copilot CLI 和 OpenClaw。另有一个独立的 Pi 扩展，可在提示词处理时检索信息。

Fidelis 保留的内容

原始措辞。 watch、store 和其他逐字写入路径会保留你提供的文本，因此检索可以返回摘要可能省略的条件。
本地检索。 快速向量搜索是默认的 MCP 召回路径。显式混合搜索会结合关键词和向量结果，在 zero_llm 层级无需生成式大模型；本地嵌入仍需要 Ollama。
随时间推移的修正。 修正可以取代之前的记录，而不会将其删除。召回可以显示有效性和历史状态，而不是悄然替换旧笔记。

Fidelis 还提供可选的提取和模型辅助路径。这些路径可能会转换或筛选输入；如果重点是保留原始措辞，请使用逐字路径。检索到的文本仍可能有误或已过时，并且你的 Agent 所使用的模型提供方在回答时可能会看到这些内容。