@atonev/opencode-short-term-memory

中文文档
1.4.0发布于 2026/10/30MITTypeScriptES Module近 30 天下载 1786

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

中文使用文档
文档目录5 节
  1. 它会做什么
  2. 安装
  3. 用这个
  4. 配置
  5. 本地文件和限制

OpenCode 短期内存

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

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

它会做什么

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

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

安装

这些指南说明1.4。 实例 1.4.0 用于可再生产安装; 使用情况 @latest 选择 npm 当前的稳定释放。 见 更改日志 为释放历史.

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

opencode plugin '@atonev/[email protected]' --force
# Or install globally:
opencode plugin '@atonev/[email protected]' --global --force

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

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

opencode plugin add '@atonev/[email protected]'

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

见 安装和配置 为配置示例, 路径、自动设置和支持的安装路径.

用这个

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

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

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

两个版本都暴露了7个专用 stm_memory_* 工具与工具 short_term_memory 相容包装器。 要求聊天代理使用它们 可以涉及主要模型。 见 命令和工具。 。 。 .

配置

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

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

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

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

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

见 全部设置引用, (中文(简体) ), 生成指南 财务报告和审定财务报表 提供指南。 。 。 .

本地文件和限制

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

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

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

内存文件和重置 解释存储和清理. 儿童会话和压缩 覆盖快照时间 和完成的 -compress 桥。 这个 特性比较 财务报告和审定财务报表 V1/V2 差异 描述特定主机的限制.

见 文档索引 所有向导。 释放历史, 校正和验收记录与这些当前特点的指南分开.

版本与发布记录

@atonev/opencode-short-term-memory 共发布 19 个版本,首次发布于 2026/05/08;过去 12 个月发布了 19 个版本。

版本发布日期距今
1.4.0latest2026/10/309 天前
1.4.0-rc.15rc2026/10/2811 天前
1.4.0-rc.142026/10/2811 天前
1.4.0-rc.112026/10/2712 天前
1.4.0-rc.102026/10/2613 天前
1.4.0-rc.92026/10/2613 天前

关于 @atonev/opencode-short-term-memory 的常见问题

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