ai-memory 是面向 AI 编程助手的自托管长期记忆工具,自动记录开发会话并整理为 Git 管理的 Markdown 知识库,让不同助手、设备和团队成员接续项目上下文。默认采集、检索与任务交接无需调用大模型,也可按需启用模型辅助整理和向量检索。

适合在 Claude Code、Codex 等助手间切换完成同一项目的开发者 · 希望让团队复用调试与架构经验的项目维护者 · 希望离线使用并自行保管编程记忆的开发者

亮点

  1. 跨编程助手接续任务

    二十多种助手适配共享记忆,切换工具时可继续已有项目进度。

  2. 默认无需模型调用

    采集、搜索和任务交接无需 API 密钥,基础记忆流程不依赖大模型。

  3. 记忆保存在可读文件

    以 Git 管理的 Markdown 知识库保存记忆,内容可直接查看和编辑。

  4. 跨设备与团队共享

    连接自建服务器,在不同电脑继续项目,也让团队复用会话积累的知识。

功能说明

采集与召回

  1. 自动记录会话

    通过生命周期 hooks 记录提示词、工具调用与会话边界,存储前经过清理。

  2. 整理项目知识

    会话结束后将观察记录整理为 Markdown 页面,新会话获得有长度限制的摘要。

  3. 融合多路检索

    将全文、实体、链接及可选向量检索结果融合排序。

整理与接入

  1. 按使用情况保留

    打开页面、搜索命中或经链接访问会减缓记忆衰减,延长其保留。

  2. 空闲时模型整理

    可选后台模型将冷门笔记簇合并为页面,恢复工作时取消,保留合并前版本。

  3. 启动时自动接入

    通过 ai-memory run 首次启动助手时,自动补装缺少的 hooks 与 MCP 接入。

适合场景

  1. 在 Claude Code、Codex 等助手间切换完成同一项目的开发者

    共享记忆和显式交接可以传递已完成工作、失败尝试与待解问题,减少重新说明背景。

  2. 希望让团队复用调试与架构经验的项目维护者

    同一服务器按项目共享知识,并保留个人归属与审计记录,个人交接不与公共知识混用。

  3. 希望离线使用并自行保管编程记忆的开发者

    默认流程无需模型 API,知识以可编辑、可版本管理的 Markdown 文件保存。

内容与来源
  • {"title":"需要运行自己的记忆服务器","detail":"服务器可放在同一台电脑或其他主机;跨设备与团队共享需要连接同一服务。"}

    ai-memory 仓库 README
  • {"title":"原生 Windows 支持仍属实验性","detail":"官方将 WSL2 列为受支持方式,原生 Windows 则标为 Experimental。"}

    ai-memory 仓库 README
  • {"title":"不同助手的接入能力不一致","detail":"Claude Desktop、VS Code Copilot 和 Zed 等仅提供 MCP 接入,Pool 仅提供 hooks,不能把所有适配都理解为同时具备自动采集与检索接入。"}

    ai-memory 仓库 README
  • {"title":"后台模型整理需要主动启用并接入大模型","detail":"将冷门笔记簇重写为完整页面的 dream 功能默认关闭;默认无模型路径不包含这种模型重写。"}

    ai-memory 仓库 README
  • {"title":"任务交接有明确的归属和领取机制","detail":"交接记录带类型与所有者,并采用仅领取一次的协议,传递的不只是背景笔记,还包括进度、失败尝试和未解决事项。"}

    ai-memory 仓库 README
  • {"title":"知识文件是源数据,检索索引可重建","detail":"Markdown 页面可手动编辑、用 grep 搜索或在 Obsidian 中打开;数据库只是派生索引,可从文件重建。"}

    ai-memory 仓库 README
  • {"title":"记忆整理可不依赖模型,并保留恢复路径","detail":"提供按层级衰减、事实压缩、近重复合并和疑似矛盾标记;压缩、去重等改写内容的功能默认关闭,原文保留在 Git 与版本链中,可用 restore-page 恢复。"}

    ai-memory 仓库 README
  • {"title":"共享项目知识与个人任务交接分开处理","detail":"团队连接同一服务器后可检索项目知识,个人交接仍归个人;同时内置多用户认证、个人归属记录和变更审计。"}

    ai-memory 仓库 README
  • AI编程

    ai-memory 仓库 README
  • 命令行

    ai-memory 仓库 README
  • 自托管

    ai-memory 仓库 README
  • 离线可用

    ai-memory 仓库 README
  • Linux

    ai-memory GitHub Releases
  • macOS

    ai-memory GitHub Releases
  • Windows

    ai-memory 仓库 README
  • 跨助手共享上下文的编程记忆工具

    akitaonrails/ai-memory: Solution for long term ...
  • 不适合要求原生 Windows 已具备正式支持的部署:当前支持矩阵只将 WSL2 标为受支持,原生 Windows 仍属实验性。

    ai-memory 仓库 README
  • 不适合希望完全免运维的托管记忆服务用户:产品采用用户自行运行服务器的方式,共享记忆需要维护可连接的服务。

    ai-memory 仓库 README
  • 在 Claude Code、Codex 等助手间切换完成同一项目的开发者:共享记忆和显式交接可以传递已完成工作、失败尝试与待解问题,减少重新说明背景。

    ai-memory 仓库 README
  • 希望让团队复用调试与架构经验的项目维护者:同一服务器按项目共享知识,并保留个人归属与审计记录,个人交接不与公共知识混用。

    ai-memory 仓库 README
  • 希望离线使用并自行保管编程记忆的开发者:默认流程无需模型 API,知识以可编辑、可版本管理的 Markdown 文件保存。

    ai-memory 仓库 README
  • 编程开发

    akitaonrails/ai-memory: Solution for long term ...
  • 跨编程助手接续任务:二十多种助手适配共享记忆,切换工具时可继续已有项目进度。

    ai-memory 仓库 README
  • 默认无需模型调用:采集、搜索和任务交接无需 API 密钥,基础记忆流程不依赖大模型。

    ai-memory 仓库 README
  • 记忆保存在可读文件:以 Git 管理的 Markdown 知识库保存记忆,内容可直接查看和编辑。

    ai-memory 仓库 README
  • 跨设备与团队共享:连接自建服务器,在不同电脑继续项目,也让团队复用会话积累的知识。

    ai-memory 仓库 README
  • Rust

    ai-memory 仓库 README
  • ai-memory 是面向 AI 编程助手的自托管长期记忆工具,自动记录开发会话并整理为 Git 管理的 Markdown 知识库,让不同助手、设备和团队成员接续项目上下文。默认采集、检索与任务交接无需调用大模型,也可按需启用模型辅助整理和向量检索。

    ai-memory 仓库 README
  • 自动记录会话:通过生命周期 hooks 记录提示词、工具调用与会话边界,存储前经过清理。

    ai-memory 仓库 README
  • 整理项目知识:会话结束后将观察记录整理为 Markdown 页面,新会话获得有长度限制的摘要。

    ai-memory 仓库 README
  • 融合多路检索:将全文、实体、链接及可选向量检索结果融合排序。

    ai-memory 仓库 README
  • 按使用情况保留:打开页面、搜索命中或经链接访问会减缓记忆衰减,延长其保留。

    ai-memory 仓库 README
  • 空闲时模型整理:可选后台模型将冷门笔记簇合并为页面,恢复工作时取消,保留合并前版本。

    ai-memory 仓库 README
  • 启动时自动接入:通过 ai-memory run 首次启动助手时,自动补装缺少的 hooks 与 MCP 接入。

    ai-memory 仓库 README

取舍

选它的理由

  • 任务交接有明确的归属和领取机制:交接记录带类型与所有者,并采用仅领取一次的协议,传递的不只是背景笔记,还包括进度、失败尝试和未解决事项。
  • 知识文件是源数据,检索索引可重建:Markdown 页面可手动编辑、用 grep 搜索或在 Obsidian 中打开;数据库只是派生索引,可从文件重建。
  • 记忆整理可不依赖模型,并保留恢复路径:提供按层级衰减、事实压缩、近重复合并和疑似矛盾标记;压缩、去重等改写内容的功能默认关闭,原文保留在 Git 与版本链中,可用 restore-page 恢复。
  • 共享项目知识与个人任务交接分开处理:团队连接同一服务器后可检索项目知识,个人交接仍归个人;同时内置多用户认证、个人归属记录和变更审计。

先想清楚

  • 不适合要求原生 Windows 已具备正式支持的部署
  • 不适合希望完全免运维的托管记忆服务用户
  • 需要运行自己的记忆服务器:服务器可放在同一台电脑或其他主机;跨设备与团队共享需要连接同一服务。
  • 原生 Windows 支持仍属实验性:官方将 WSL2 列为受支持方式,原生 Windows 则标为 Experimental。

同类推荐

查看全部

更多「编程开发」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析,沉淀可复用的工具知识。