engramory:DeepSeek Harness 的零基础设施 Agent 记忆协议

tinqiao-oss/engramory

记忆与上下文已验证
收录时间 2026-08-20
页面最后更新 2026-08-20

Engramory 为 DeepSeek Harness 提供零依赖的本地文件记忆协议,以 Markdown 文件承载长期记忆。

把 DeepSeek Harness 的 Agent 长期记忆变成纯文本 Markdown 文件加常驻索引,无需数据库或向量嵌入。

install
dsh plugin --profile web add github:tinqiao-oss/engramory
分类
记忆与上下文
平台
DSH-Plugin
作者
tinqiao-oss
分发方式
插件

engramory 核心特性

Markdown 记忆存储零依赖,无需数据库记忆整理纪律索引文件自动加载支持 Claude Code 等

engramory 仓库信息

tinqiao-oss
发布者
tinqiao-oss
仓库
tinqiao-oss/engramory
164
Star
12
Fork
0
Watch
2
开放 Issue
语言Python
许可证MIT License
官网
仓库最近更新2026-08-20 15:29:09
仓库创建时间2026-06-13 22:15:28
主题
agent-memoryai-agentsclaude-codecodexdeepseek-harnessdsh-pluginknowledge-basellm-memorylong-term-memorymarkdownmemoryprompt-engineeringzero-dependency
默认分支master

engramory 仓库简介

Engramory 是 DeepSeek Harness(DSH)的一个数据与知识类插件(DSH plugin),它把 AI Agent 的长期记忆变成一套零基础设施、纯文本的协议。它解决的是 Agent 记忆碎片化、难以人工审阅和跨会话一致性的问题——不引入数据库、向量嵌入或服务器,只用一堆人类可读的 Markdown 文件加一个常驻索引,让记忆像普通文档一样可打开、可编辑、可 diff。核心能力包括:以 feedback(程序性记忆)为骨架的角色/目的本体论、强制 Why:How to apply: 字段的策展纪律、以及一个可选的硬索引上限钩子(PreToolUse),由 tools/engramory_doctor.py 校验器把关。项目由 tinqiao-oss 维护,采用 MIT 协议,Python 3.9+ 编写,最近更新于 2026-08,目前处于 0.8.0 实验阶段。

Engramory 这个 DSH plugin 支持哪些核心特性?

Engramory 不是全新的记忆架构,而是对主流「Markdown 文件 + 小索引 + 模型策展」模式的纪律化超集。它借鉴了 Claude Code 原生自动记忆、basic-memory、obsidian-second-brain 等先例,但贡献在于「有主见的打包 + 纪律」:每个文件对应一个事实,索引始终加载,feedback 类型作为程序性记忆的主干,要求每条记忆必须写明原因和应用方式。它还提供一个 PreToolUse 钩子,对 Edit | Write | MultiEdit 等直接编辑工具强制索引上限,但注意它并非全局写保护——shell 工具、MCP 文件工具、外部编辑器等仍可绕过,因此是尽力而为而非强制保证。

Engramory 怎么安装?

安装 Engramory 作为 DSH plugin 很简单,使用以下命令:

bash
dsh plugin --profile web add github:tinqiao-oss/engramory

安装后,插件会以常驻规则(standing rules)的形式加载,例如写入 CLAUDE.mdAGENTS.md 或宿主规则文件。建议 AI Agent 在安装或检查时先阅读 AGENT-SETUP.md,那里说明了如何确认宿主能强制什么、是否已有存储、哪些不可触碰,以及该向用户报告什么。

Engramory 兼容哪些 DeepSeek Harness 版本和平台?

Engramory 是零依赖的纯 Python 工具,要求 Python 3.9+,因此理论上兼容任何能运行 Python 的 DeepSeek Harness 环境。它不依赖特定平台,只要宿主支持加载常驻规则文件即可。由于采用 MIT 许可证,你可以自由集成和修改。项目目前处于实验阶段(0.8.0),假设单写入者/串行写入,不建议依赖它作为跨 Agent 的强制可靠记忆层。

Engramory 的策展纪律和校验器怎么用?

Engramory 的核心纪律是「一个文件 = 一个事实」,并要求每条记忆包含 Why:How to apply: 字段,确保记忆不仅被存储,还能被正确应用。校验器 tools/engramory_doctor.py 会检查记忆库是否符合规范,例如索引是否完整、字段是否缺失。你可以把它集成到 CI 或手动运行,以维持记忆库的健康。

Engramory 的局限和注意事项有哪些?

Engramory 的硬索引上限钩子只对匹配的直接编辑工具生效,不是全局写保护。shell 工具(Bash、PowerShell)、后台 Monitor 命令、MCP 文件工具、外部编辑器和同步客户端都可能绕过它。因此,纪律主要靠模型遵循常驻规则来执行,是尽力而为。项目假设单写入者,串行写入,不适合多 Agent 并发写入场景。如果你需要跨 Agent 的强制可靠记忆,建议等待更成熟的版本。

查看更多 DSH 插件,访问 dsh-plugin.org

DSH-Plugin 常见问题