# @hy-sde-org/dsh-tool-memory 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-memory/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:25:24.743Z
中文译文更新时间：2026-11-01T09:19:46.439Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-memory
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-memory/?lang=original
项目主页：https://github.com/hy-sde/dsh-memory#readme
源码仓库：https://github.com/hy-sde/dsh-memory

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：83.2 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- 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
- 首次发布：2026-08-26T03:24:23.879Z
- 最新版本发布：2026-11-01T04:25:24.568Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

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

## 安装

```sh
npm install @hy-sde-org/dsh-tool-memory
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-memory`、`yarn add @hy-sde-org/dsh-tool-memory`、`bun add @hy-sde-org/dsh-tool-memory`

## README

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

**面向模型的内存表面** 对于DeepSeek线束-六个工具 `retain`， `recall`， `reflect`， `memory_edit`， `learn`, `mine_sessions` 越过主机 `ctx.memory` 服务，再加上a `memory:project` 系统提示符位置 部分 **在每个项目开始时重新加载会话的项目内存 会话**． 从 [@oh-my-pi](https://github.com/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` 一行的根。 |
| `injectionMaxChars` | `16000` | 为注入的摘要+课程组合char预算。 |
| `enabled` | `true` | 集 `false` 在保留工具的同时禁用提示注入。 |

## 测试

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

## 常见问题

### @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 和提交记录判断。