文件型工作记忆:memorize/recall 把关键前提逐字保存在会话笔记文件,无损挺过上下文压缩。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ICCuse/dsh-file-memory
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 中文
面向长任务的文件型工作记忆。两个模型侧工具——memorize 与 recall——把关键前提以逐字字节形式保存在工作区内按会话隔离的笔记文件里,因此能无损地挺过上下文压缩:摘要器可以把事实模糊或丢掉,但文件能逐字节原样往返。
为什么
压缩检查点是 LLM 生成的、并逐代被 LLM 重写;prompt 空间里的"状态文档"提案每一轮仍会对上一版状态再摘要。文件是 agent 手上唯一无损的介质:写一次,读回即原样。这是对 prompt 空间压缩的务实补充,在当前随附的 compaction-basic 后端上今天就能用。
工具
| 工具 | 行为 |
|---|---|
memorize(entries) |
把逐字去重后的行追加到 <workspace>/.dsh-notes/<session>.md。 |
recall(query?) |
读回笔记,可选按包含 query 的行过滤;输出上限 maxRecallChars。 |
两者都要求 agent 会话与已挂载的 fs 服务;笔记文件相对会话工作区 cwd 解析(会话无 cwd 时回退到后端默认基准)。
配置
| 字段 | 默认 | 含义 |
|---|---|---|
maxRecallChars |
6000 |
recall 输出上限。 |
notesDir |
.dsh-notes |
工作区内的笔记目录名;必须是裸目录名。 |
maxRecallChars 必须为 >= 1 的整数;配置错误在插件加载时直接抛错。
安装
尚未发布到 npm —— 直接从此仓库安装:
npm install github:ICCuse/dsh-file-memory
# 或:pnpm add github:ICCuse/dsh-file-memory
然后在 profile 组装中挂载(package.json 已声明 dsh.bundle):
- id: dsh-file-memory
name: 'dsh-file-memory'
发布后亦可 dsh plugin --profile web add dsh-file-memory。
链接
同类插件
volcengine/OpenViking#examples/dsh-memory-plugin★ 38815
面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护,以及对接 OpenViking 服务端的 recall/write 记忆工具。
vectorize-io/hindsight#coding-agents★ 37670
Hindsight:会学习的 Agent 长期记忆系统,自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。
agentscope-ai/ReMe#dsh★ 3526
将 DeepSeek Harness 接入 ReMe 本地优先、自进化的个人知识库:自动把已完成的主 Agent 对话沉淀为用户掌控的 Markdown 记忆,通过 reme_search 结合 BM25、可选向量检索和 wikilink 展开搜索对话与资料,并按日整理长期记忆。
zilliztech/memsearch#MemSearch★ 2670
供 DSH 与其他编程 Agent 共享的 Markdown 记忆,支持自动捕获、步骤前上下文注入、搜索召回,以及通过审阅面板实现 memory-to-skill 自进化。
vshulcz/deja-vu#extensions/dsh★ 1074
读取本机上其他三十三个编程智能体已经写下的会话文件——Claude Code、Codex、Cursor、VS Code Copilot Chat、opencode、OpenClaw、Hermes、Kimi、Cline、Zed 等,包括安装之前的历史:提供 deja_recall、deja_session、deja_blame、deja_fix、deja_how、deja_remember 六个工具与 /deja 命令,并可选地把召回结果加入运行时上下文。本地 BM25 索引,不用大模型,不用向量嵌入,不联网(dsh plugin --profile web add dsh-deja)。
adoresever/graph-memory★ 630
DeepSeek Harness 的可追溯、可检索跨会话记忆:把对话知识沉淀为带类型的图节点(任务/技能/事件)与关系边。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。