dsh-readcache
在终端中运行以下命令:
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 延迟的性能敏感用户