yzx4036/dsh-memory-snapshot

README 摘要

dsh-memory-snapshot English 零依赖的 DeepSeek Harness（dsh）轻量快照（记忆）注入插件。宗旨： 你在 Codex、Claude Code、Hermes、OpenCode 等 Agent 工具里攒的重要 markdown 文档——约束规则、长期记忆，或者知识库仓库里的内容——散在不同目录，把路径列进来，dsh 每次会话都会主动注入，跨工作区生效 。不用迁文件、不用复制副本、不用提醒模型去读。 dsh 还是开发者预览版，插件 API 可能随版本变化，升级前看 breaking changes。 为什么做这个 dsh 没有内置的全局记忆。它的 AGENTS.md 自动加载全局只认 /.dsh/AGENTS.md 这一个文件，工作区级只管项目目录链；其他工具的全局文档（ /.claude/CLAUDE.md 、 /.codex/AGENTS.md ）dsh 完全不读（2026-08 核对官方仓库）。 但多数用 dsh 的人手里有别的 Agent 工具，或者攒了知识库仓库——里面的规则、记忆、知识都是 markdown，本来就是跨会话全局记忆的雏形，只是 dsh 不知道它们存在。 社区有别的记忆插件，但都是奔着「记忆引擎」做的：自动吸收、蒸馏、检索，还得配服务和数据库，比较重。如果已有的 markdown 文档就是你要的记忆，那就杀鸡用牛刀了。 所以这个插件走轻的： 文档不动、原地注入 。把路径列进 files ，每次会话装配系统提示词时全文带进去。没有引擎，没有数据库，没有写入通道，本体约 150 行。 当然你也可以每次手动叫 dsh 读文件，但 headless 批量、自动化流水线这些没人盯着的场景，插件能让记忆默认在场。如果你只手动用 dsh、每次都提一句，那这插件对你用处不大。 能做什么，不能做什么 能做： - 一个或多个 md 文件，任意目录（支持 ），每次会话装配提示词时全文注入 - 改完文件下次会话就生效 - 单文件字节上限（ maxBytes ），防系统提示词撑爆 - 读不到的文件标出原因，不崩会话 - 注入内容进 Trajectory 日志，模型吃了什么随时能查 不能做（要这些就去找记忆引擎插件）： - 不会自动记录对话，文件要你自己维护 - 没有模型侧写入工具，模型不会自己往文件里写东西 - 不做检索和蒸馏，全文注入，内容多了白烧 token，只适合 KB 级的精选内容 安装 其他选项： --profile headless 只装某个 profile； --files A.md,B.md 顺带配好记忆文件； --verify 装完自检。别同时装 home 和 profile 两层，会报 duplicate loader entry id ，二选一。 使用 装完就生效，之后 dsh 每个会话都自动带着你的…

分类