让开源，少一点语言距离。
npm包中文文档

@hy-sde-org/dsh-tool-memory

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

在ctx上面向模型的长期记忆工具（保留、回忆、反映、memory_edit、学习）。内存服务，加上第一次项目内存提示注入- DeepSeek线束的独立插件，无需更改上游线束。

中文使用文档
中文原文
文档目录4 节
  1. 六种工具
  2. 提示注射
  3. 配置( tool-memory 行)
  4. 测试

@hy-sde-org dsh-tool-memory

面向模型的内存表面 对于DeepSeek线束-六个工具 retain， recall， reflect， memory_edit， learn, mine_sessions 越过主机 ctx.memory 服务，再加上a memory:project 系统提示符位置 部分 在每个项目开始时重新加载会话的项目内存 会话． 从 @oh-my-pi coding-agent 内存表面;存储存在于 @hy-sde-org/dsh-memory.

这个包裹是 agent-plane：它作为预设行挂载，并解析 主人 memory 服务，没有注册自己的服务。它安装为 独立插件的股票DeepSeek线束(dsh-v0.2.0-rc.2 后来)—— 看到 @hy-sde-org/dsh-memory 用于安装配方和预设示例。

六种工具

  • retain -存储一个或多个持久事实(用户偏好，项目 决策（架构选择）。批处理相关事实； 条目是自包含的、规范化的和重复数据删除的。
  • recall -相关度排名搜索银行+课程+摘要。返回 这是往返的路线 memory_edit． 提问前主动提问 关于过去的决定或偏好。当一个主人 sessionQuery 服务是 挂载后，过去的会话点击合并为 session 源层。
  • reflect -在许多存储的记忆中合成一个答案(混合， 不像 recall）. 接地只是记忆；验证存储库事实。
  • memory_edit - - - - - - update (替换内容/重要性), forget (硬 删除), invalidate (软替换，可选 replacement_id）. 教训 摘要条目是只读的事实。
  • learn -抓住一个持久的教训（什么/什么时候/为什么） learned.md； 写入路径中和去掉了提示注入标记和秘密。
  • mine_sessions -从你自己过去的会议中收获可重用的经验教训 (来自压缩摘要的摘要，来自转弯/结束错误原因的失败， 全部完成的待办事项)，存储为 learn 带有会话来源和的条目 deduped。需要一个主机 sessionQuery 服务;没有它就会报告 不可用而不是错误-这个独立的船桥 （session-history.ts， ctx.get('sessionQuery') 鸭子类型)，但没有会话 后端。

提示注射

apply() 寄存器 systemPrompt.section({ name: 'memory:project', order: 150 }) 在每个程序集中计算谁的文本并返回调用会话的文本 〇项目记忆 memory_summary.md + learned.md，合并和首尾 截断, injectionMaxChars （默认16000字符）-或 '' 对于一个 没有内存的项目。存储的内存保持文字，所以是完整的 {{variable}} 其中的组不会解析为提示变量。会话 身份来源于 context.agent.session.header.cwd，所以每个项目 看到自己的银行，一个新的过程在第一次转弯时就把它捡起来。

配置( tool-memory 行)

关键默认的意义
root<harness home>/memories必须匹配 ctx.memory 一行的根。
injectionMaxChars16000为注入的摘要+课程组合char预算。
enabledtrue集 false 在保留工具的同时禁用提示注入。

测试

pnpm -r --filter @hy-sde-org/dsh-tool-memory test

版本与发布记录

@hy-sde-org/dsh-tool-memory 共发布 11 个版本，首次发布于 2026/08/26；过去 12 个月发布了 11 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @hy-sde-org/dsh-tool-memory 的常见问题

@hy-sde-org/dsh-tool-memory 是什么？

在ctx上面向模型的长期记忆工具（保留、回忆、反映、memory_edit、学习）。内存服务，加上第一次项目内存提示注入- DeepSeek线束的独立插件，无需更改上游线束。

如何安装 @hy-sde-org/dsh-tool-memory？

在项目目录运行 npm install @hy-sde-org/dsh-tool-memory，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4.0.5）、@deepseek-ai/dsh-tools（^0.2.1-rc.5）、@hy-sde-org/dsh-memory（^0.2.1-rc.5）、@deepseek-ai/dsh-system-prompt（^0.2.1-rc.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@hy-sde-org/dsh-tool-memory 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@hy-sde-org/dsh-tool-memory 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@hy-sde-org/dsh-tool-memory 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@hy-sde-org/dsh-tool-memory 可以商用吗？

@hy-sde-org/dsh-tool-memory 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@hy-sde-org/dsh-tool-memory 还在维护吗？

最新版本 0.2.1-rc.5 发布于 2026/11/01（2 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/08/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。