engramory

简体中文 | English

Engramory

Agent 通用长期记忆层。 AI 记住的东西存成一个个普通 markdown 文件，一个只放指针的索引 MEMORY.md 列出全部笔记，每次会话开头读进来，细节要用时再打开。不需要数据库、向量或服务器，文件你能直接看、能改。Claude Code、Codex、DeepSeek Harness（dsh）、OpenClaw、Kiro 等都能用；一个工具负责写，别的工具可以只读同一个库。

dsh 有专用插件 dsh-engramory：装上就能用，自动带上索引，把索引写超上限的写入大多在落盘前就被拦下，侧栏还多一个记忆页。Claude Code 用 hook 拦超限写入；其他工具靠规则加校验脚本。 名字来自 *engram*（记忆痕迹）+ *memory*。本项目是 tinqiao-oss/engramory（dsh 插件的 npm 包叫 dsh-engramory），与其他所有者名下的同名仓库无关。 🤖 你是被要求安装或检查它的 AI agent？ 先读 AGENT-SETUP.md。 状态:1.5.2。 记忆库格式、工具和索引上限从此只在主版本做不兼容改动，见版本规则。 长什么样

索引里的一行：- 改完先跑测试 — 改代码后先跑测试再说完成

一条 feedback 笔记记下一次可复用的纠正，带上原因和用法：

安装 dsh 插件从 npm 装，别的都不需要。其他工具需要 Python 3.9+，在本仓库目录里运行；macOS / Linux 没有 python 就用 python3。 DeepSeek Harness（dsh）

dsh 桌面版也可以在插件页搜 dsh-engramory 安装。装好就能用：记忆默认存在 ~/.dsh/.engramory-memory/（侧栏「记忆」页里能换位置，插件会整个搬过去），侧栏多一个只读的「记忆」页。配置、大肥鱼模式、社交模式和上限规则见插件说明。

Claude Code

1. 把 rules-snippet.md 贴进 ~/.claude/CLAUDE.md（所有项目）或项目的 CLAUDE.md。 2. 可选：把本仓库复制或链接为 Claude Code 技能目录下的 engramory/，让 SKILL.md 按需可用。 3. 按 hooks/settings.snippet.json 在 settings.json 里注册写前 hook。

具体路径和验证 hook 确实生效的方法见 hooks/INSTALL.md。另附 tools/engramory_trace.py，在本地只读搜索 Claude Code 的会话记录，查某条记忆当时的来龙去脉。 Codex