DSH Plugins
返回列表
🧠

dsh-readcache

记忆 更新于 2026.08.25

在终端中运行以下命令:

dsh plugin install yongshuai0314/dsh-readcache

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install yongshuai0314/dsh-readcache 即可安装本插件,源码见 https://github.com/yongshuai0314/dsh-readcache 。

插件介绍

长会话中,上下文压缩后的恢复、并行子代理协作、编辑前后的文件对比,都会反复读取同一份未变更的文件。每一次重复都要重新执行磁盘 I/O 和行号渲染,却拿到字节完全相同的内容。dsh-readcache 拦截 tools/execute 事件流中 read 工具的成功结果,将之存入进程内缓存,后续同参数读取直接命中,省掉冗余的 I/O 与渲染开销。

缓存之所以安全,是因为每次命中都会重新 stat 文件并精确比对版本令牌(dev:ino:size:mtimeNs:ctimeNs)。无论 edit/write 工具、bash 命令还是外部编辑器,任何写操作都会改变令牌并使条目立即失效,绝不会吐出过期内容。写入竞态由双 stat 防护消除;缓存键包含代理 id,确保每次命中都以该代理自身的先前观察为凭据,保留先读后改的语义约束。内存由 LRU 上限约束:300 条、总量 16 MiB、单条 4 MiB。插件还注册了 readcache 管理工具,可查看命中/未命中计数、已节省字符数,或直接清空缓存。

如果你经常运行长会话、多代理并行工作流,或频繁触发压缩后的文件重读,dsh-readcache 能在不改变工作流的前提下削减冗余延迟,同时保证内容正确性。安装后重启即生效,无需额外配置。

使用场景

  • 长会话上下文压缩后恢复,反复重读未变更文件
  • 多代理并行工作流中多个子代理加载同一文件
  • 编辑前后对比导致同参数 read 被多次触发

适合人员

  • 运行 DeepSeek Harness 长会话的开发者
  • 编排多代理并行工作流的用户
  • 关注 Harness 文件 I/O 延迟的性能敏感用户