dsh-instruction-memory

在 DSH 设置界面中维护长期指令记忆：保存后自动注入此后每一轮对话的系统提示词。

安装

dsh plugin --profile web add dsh-instruction-memory

装完重启 DSH，设置页会出现「指令记忆」入口。卸载：

dsh plugin --profile web remove dsh-instruction-memory

只由用户本人维护

这份记忆的内容只属于用户。 本插件刻意不注册任何面向模型的工具——模型没有任何 途径自行添加、修改或删除记忆条目。写入入口只有设置页（以及用户本人直接编辑存储文件）， 因此不会出现 AI 悄悄给用户"记下"指令的情况。

条目内容由用户输入并被原样注入，本插件不对其做语义判断或自动生成。

组成

文件	作用
lib/index.js	Host 半：读取/保存记忆，注册 systemPrompt 段落，暴露同源 JSON 路由
lib/client.js	Client 半：在 settings.section 注册「指令记忆」设置页（手写模块，无需构建）
cordis.patch.yml	bundle patch：把 Host 行插入宿主组合
contract-test.mjs	契约测试：驱动真实路由，验证两半之间的响应格式
verify.mjs	装载验证：按 DSH 的方式加载两半
smoke-test.mjs	注入渲染逻辑的单元测试

生效方式

• 始终 条目：无条件遵守。
• 按需 条目：由模型按相关性自行判断是否适用，不相关时忽略；可填「适用场景」辅助判断。
• 优先级 高 > 普通 > 低，决定注入顺序。
• 注入字数上限：超出时按优先级保留，被略过的条目数会在注入文本末尾注明。

条目全部停用或总开关关闭时，该提示词段落整个注销，系统提示词与未安装本插件时逐字节一致。

存储

记忆保存在 DSH 数据根目录下（设置页会显示完整绝对路径）：

<DSH_HOME>/instruction-memory/memory.json      # DSH_HOME 默认为 ~/.dsh

路径优先级与官方 @deepseek-ai/dsh-home-paths 一致：显式 $DSH_HOME → ~/.dsh。 空白的 $DSH_HOME 视为未设置，绝不会退回当前工作目录——否则用户换个目录启动 DSH 就会得到第二份空记忆，看起来像"记忆消失"。

1.0.0 之前的构建曾把数据写在宿主进程 cwd 下（.dsh-instruction-memory.json）。 首次启动新版本时会自动迁移到上述位置，并把原文件改名为 *.migrated 保留。

该文件可手工编辑，改完点设置页的「重新载入」即可读回。

兼容性

dsh.compatibility.dsh 声明为 >=0.1.5-rc.1。

准确说明：本插件仅在 dsh 0.1.5-rc.1（Windows / Node 22） 上实测通过。 该版本下限是"已实测"的记录，不是对更高版本兼容性的验证结论。

发布（维护者）

# 1. 自检（prepublishOnly 也会自动跑，占位符未替换会中止发布）
npm test
node check-metadata.mjs
# 2. 发布（需先 npm login）
npm publish

发布前自检会拒绝在 TODO 占位符残留时发布，避免把空仓库地址或无名版权声明发出去。

数据格式

{
  "version": 1,
  "enabled": true,
  "budgetChars": 4000,
  "entries": [
    {
      "id": "im-xxxx",
      "title": "回答语言",
      "content": "所有回答使用简体中文。",
      "mode": "always",
      "when": "",
      "priority": 1,
      "enabled": true,
      "updatedAt": 1700000000000
    }
  ]
}

mode 为 always | auto；priority 为 2 高 / 1 普通 / 0 低。