# @atonev/opencode-short-term-memory 中文文档

规范地址：https://npmcn.com/package/%40atonev/opencode-short-term-memory/

版本：1\.4\.0
npm 元数据更新时间：2026-10-30T07:44:20.188Z
中文译文更新时间：2026-11-08T11:46:14.348Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40atonev/opencode-short-term-memory
原文对照：https://npmcn.com/package/%40atonev/opencode-short-term-memory/?lang=original
项目主页：https://github.com/andrejtonev/opencode-short-term-memory#readme
源码仓库：https://github.com/andrejtonev/opencode-short-term-memory

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

- 包体积（解压后）：1.3 MB，118 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-05-08T09:44:36.422Z
- 最新版本发布：2026-10-30T07:44:19.987Z
- 近 30 天下载量：1786（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

OpenCode插件,用于自动结构化会话内存,并带有特定生成的上下文交付和手动内存工具.

## 安装

```sh
npm install @atonev/opencode-short-term-memory
```

也可以使用：`pnpm add @atonev/opencode-short-term-memory`、`yarn add @atonev/opencode-short-term-memory`、`bun add @atonev/opencode-short-term-memory`

## README

# OpenCode 短期内存

为每次谈话自动更新结构化内存并带来有用 将上下文保存到以后的请求中。 OpenCode V1和V2 支持同一核心 特性通过本地服务器和终端 UI 集成.

> 非官方插件;不隶属于OpenCode团队或由团队维护.

## 它会做什么

-   将可见的对话归纳为 **用户指令**, (中文(简体) ), **长地平线 A. 背景情况**, (中文(简体) ), **决定**, (中文(简体) ), **结论** 财务报告和审定财务报表 **活动引用**。 。 。 .
-   在闲置后更新背景, 在压缩前尝试刷新 .
-   默认使用单独的干净的总结会话, 或活动对话 当配置时。 一个明确的内存模型在两种模式中都起作用.
-   将保存的内存作为会话信息,而不要求回复 默认。 可选系统/内容转换以清洁模式提供.
-   给任务子代理人一个被冻结的他们父母所保存的内存快照.
-   提供本地 `/stm` 菜单中包含滚动结果和代理工具.
-   本地保存可读的 Markdown 。 重置清除已保存的内存并启动未来 在持续的历史边界后更新,而不删除对话.

记忆是LLM摘要,不是完整的笔录或保证指令 存储。 供应商证书、模型兼容性和配额由 OpenCode; STM世代消耗了该模型的用量允许.

## 安装

这些指南说明1.4。 实例 `1.4.0` 用于可再生产安装; 使用情况 `@latest` 选择 npm 当前的稳定释放。 见 [更改日志](https://npmcn.com/package/%40atonev/opencode-short-term-memory/CHANGELOG.md) 为释放历史.

**打开代码 V1 :** 从您的本地安装项目中运行 :

```sh
opencode plugin '@atonev/opencode-short-term-memory@1.4.0' --force
# Or install globally:
opencode plugin '@atonev/opencode-short-term-memory@1.4.0' --global --force
```

在单数中启用相同的软件包 `plugin` 服务器阵列 `opencode.json` 和终端用户界面 `tui.json`。 。 。 .

**打开代码 V2:** 安装命令为全域 :

```sh
opencode plugin add '@atonev/opencode-short-term-memory@1.4.0'
```

在复数中启用同一软件包 `plugins` 全球服务器阵列 `opencode.json` 和终端用户界面 `cli.json`。保持服务器和用户界面版本的对齐; 服务器工具本身并不确定终端菜单已装入.

见 [安装和配置](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/CONFIGURATION.md) 为配置示例, 路径、自动设置和支持的安装路径.

## 用这个

打开对话并选择 **`/stm` 从本地自动完成** 打开 拣取者. 使用裸菜单; `/stm show` 财务报告和审定财务报表 `/stm-cmd` 不是当前命令 格式.

| 行动 | 结果 |
| --- | --- |
| 显示内存 | 本次会话拯救了Markdown. |
| 日志 | OpenCode 服务器上的绝对日志文件路径 . |
| 设置 | 有效的选项和配置路径 . |
| 状态 | 记忆路径/大小,模型和活性诊断计数器. |
| 更新 | 请求符合条件的内存更新;使用内存模式. |
| 重设 | 在清除所保存的内存和设定历史边界之前确认 . |
| 创建示例配置 | 可选定制; 保留已存在的 STM 配置 . |

菜单动作运行时不要求聊天模式选择工具或解释工具 结果。 仅更新就可以调用内存模型. 使用上下、 PgUp/ PgDn 和 回家/结束导航结果, Esc关闭。 日志只返回路径:检查 在服务器上自备文件.

两个版本都暴露了7个专用 `stm_memory_*` 工具与工具 `short_term_memory` 相容包装器。 要求聊天代理使用它们 可以涉及主要模型。 见 [命令和工具](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/COMMANDS.md)。 。 。 .

## 配置

得到支持的本地设施创造了最低限度的 `stm.json` 在第一次激活时, 不替换现有 `stm.json` 或者说 `stm.jsonc`。可选实例创建 这不是一个先决条件。 如果安装来源无法验证, 设置 解释为什么自动创建被跳过 .

所有设置都是可选的 。 单独的记忆模型和每4个提醒 符合条件的用户回合 :

```jsonc
{
  "summarizerMode": "clean",
  "memoryModel": "your-provider/your-model",
  "remindEveryN": 4,
  "enableLegacyPeriodicSystemTransform": false,
}
```

离开 `memoryModel` 空白以使用 OpenCode 在干净模式下的新会话默认值, 或活动模式中的会话模式。 配置认证和提供者 选项.

设定 `enableLegacyPeriodicSystemTransform: true` 初级系统/文本 以干净模式提醒 。 活性模式总是使用会话信息发送. 信件发送避免重写系统前缀; 实际提供者缓存 重复使用和计费仍然依赖供应商。 在V2中,记录会显示 仅限 a **短期会议记忆** 标签; 显示读取已保存的文本.

见 [全部设置引用](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/CONFIGURATION.md), (中文(简体) ), [生成指南](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/MEMORY-GENERATION.md) 财务报告和审定财务报表 [提供指南](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/MEMORY-DELIVERY.md)。 。 。 .

## 本地文件和限制

内存默认为 `.opencode/memory`,相对于服务器的工作 目录。 使用状态查找实际文件 。 保持记忆的隐私 忽略它 酌情在 Git 中:存储摘要为纯文本并可以包含 谈话细节.

重置不会抹去聊天历史、 先前的插入信件或已有的孩子 示意图. 新的对话可以重现旧事实。 更新检查站 成功块; 后一失败会保存更早的进展 .

诊断日志省略了即时/记忆堆放和校正确认的证书. 校正是最佳努力;内存,模型输入和更古老的日志没有被擦除. 在共享前检查文件 .

[内存文件和重置](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/MEMORY-FILES.md) 解释存储和清理. [儿童会话和压缩](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/CHILD-SESSIONS.md) 覆盖快照时间 和完成的 -`compress` 桥。 这个 [特性比较](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/FEATURE-MATRIX.md) 财务报告和审定财务报表 [V1/V2 差异](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/FEATURE-PARITY.md) 描述特定主机的限制.

见 [文档索引](https://npmcn.com/package/%40atonev/opencode-short-term-memory/docs/README.md) 所有向导。 释放历史, 校正和验收记录与这些当前特点的指南分开.

## 常见问题

### @atonev/opencode-short-term-memory 是什么？

OpenCode插件,用于自动结构化会话内存,并带有特定生成的上下文交付和手动内存工具\.

### 如何安装 @atonev/opencode-short-term-memory？

在项目目录运行 npm install @atonev/opencode-short-term-memory，或使用 pnpm add / yarn add / bun add。

### @atonev/opencode-short-term-memory 支持 TypeScript 吗？

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

### @atonev/opencode-short-term-memory 支持 ESM 还是 CommonJS？

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

### @atonev/opencode-short-term-memory 可以商用吗？

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

### @atonev/opencode-short-term-memory 的下载量有多少？

根据 npm 官方下载统计，@atonev/opencode-short-term-memory 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,786 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @atonev/opencode-short-term-memory 还在维护吗？

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