记忆

dsh-file-memory

ICCuse/dsh-file-memory · ★ 0

ICCuse精选

文件型工作记忆:memorize/recall 把关键前提逐字保存在会话笔记文件,无损挺过上下文压缩。

许可证
MIT
收录
2026-08-14
维护状态
active
安装方式
github
查看 manifest 检查详情
manifest 状态
已声明
manifest 路径
package.json#dsh
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:ICCuse/dsh-file-memory

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 为什么
  2. 工具
  3. 配置
  4. 安装

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。