dsh-checkpoint-memory

给 DeepSeek Harness 用的长期记忆插件。

它会为你的 MEMORY.md 索引文件加上硬性上限（默认 200 行 / 25 KB），拒绝会让索引继续变大的写入，同时把 checkpoint-memory 协议注入 dsh，并在 Web 页面显示一个「同步记忆」按钮。

本插件基于上游仓库 tinqiao-oss/engramory 的 adapters/dsh/plugin 目录修改、重命名而来。完整修改清单见 UPSTREAM.md。

功能

硬性上限守护：超过 maxLines / maxBytes 的增长型写入会被拒绝；缩小的写入始终放行，方便压缩整理。
完整 skill 安装：激活时把 skill/ 里的协议文件安装到 $DSH_HOME/skills/checkpoint-memory/，幂等、不删除用户自己的文件。
规则自动注入：把规则片段追加到 $DSH_HOME/AGENTS.md，每次启动自动生效。
Web 同步按钮：在 Web 页面输入框工具行增加「同步记忆」按钮，一键执行 /checkpoint-memory。

dsh plugin --profile web add dsh-checkpoint-memory

开发时可以用本地目录：

dsh plugin --profile web add link:/path/to/dsh-checkpoint-memory

安装后插件会通过自带的 cordis.patch.yml 自动挂载到 profile，无需手工改配置。

要覆盖默认值，在你的 profile patch 层里按 id 修改已有行（不要再写一次 - insert:，否则会插入重复行）：

- id: checkpoint-memory
  config:
    indexName: MEMORY.md
    maxLines: 200
    maxBytes: 25600
    # indexPath: /absolute/path/to/your/MEMORY.md

一次 patch 会整体替换目标行的 config，所以你想保留的键要逐个列全。

字段	默认值	说明
`indexName`	`MEMORY.md`	要守护的索引文件名。
`maxLines`	`200`	行数上限。
`maxBytes`	`25600`	UTF-8 字节上限（25 KB）。
`indexPath`	未设置	指定唯一绝对路径后只守护该文件；未指定时按文件名匹配。
`registerSkill`	`true`	是否运行时注册 `/checkpoint-memory` skill。
`installSkill`	`true`	是否把完整 skill 安装到 `$DSH_HOME/skills/`。
`appendRules`	`true`	是否追加规则片段到 `$DSH_HOME/AGENTS.md`。
`dshHome`	`$DSH_HOME` / `~/.dsh`	dsh 配置根目录。
`skill`	内置	用自定义 markdown 替换运行时 skill 正文。

插件本身不创建记忆库，只负责上限守护与协议注入。

node --test

MIT