前言¶
在 DeepSeek Harness（DSH）里跑智能体时，上下文窗口有限：把整段历史对话每轮都塞回去，既占 token，也容易把无关旧话带进当前任务。常见做法是依赖单次会话或外部笔记，但缺少「按需检索、又能回到原始 session 事件」的本地闭环。
下面介绍社区插件 dsh-memory-calendar（维护者 IStarFoxI，GitHub 仓库 IStarFoxI/dsh-memory-calendar）。它面向 DSH 提供 local-first 的长期记忆：对话整理成本地文本包，需要时再检索，数据默认落在工作区目录，不上传、不云同步。社区目录页：skillhub.cn 插件页。DSH 生态是「一切皆插件」；该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-memory-calendar 是 DSH 的本地长期记忆插件，当前版本 1.0.0-beta.2（README 中称 Beta 2.0）。一句话定位来自 package.json：Local-first long-term memory for DeepSeek Harness。
它主要解决：
- 把过去的对话整理成本地文本包；
- 按需检索，不把整段记忆塞回每一轮对话；
- 命中后可以回到原始 session log 事件；
- 用「大脑 + 工作区 + 图谱」管理不同上下文的读写边界。
数据可自行备份；官方说明不承诺永久保存。
核心功能¶
面向智能体的工具¶
插件向 Harness 暴露一组记忆相关能力（名称以 README 为准）：
memory_search：按关键词、日期、标签找包；memory_timeline：按天/周查看时间线；memory_read：读取包内文本；memory_expand：从包回到原始 session log 事件；memory_pin/memory_pins/memory_unpin：显式逐字记住。
自动检查点与其它能力¶
- 上下文压力较高时自动保存记忆，压缩后补包（README 提到 70% / 85% 检查点仍在观察）；
- 支持多个大脑、工作区连接、只读参考；
- 设置页：工作区抽屉、可见会话、标签/包搜索、大脑图谱。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证。官方 README 给出四种方式，任选其一。
方式一：网盘离线包（GitHub 打不开时推荐）¶
下载 DSH记忆插件-Beta2.0-本地安装包.zip（链接与 SHA256 见仓库 README），解压后：
- DSH → Plugins →
+ Add plugin； - 选择「试试其他方式」→ 本地文件夹；
- 选解压后包含
package.json的文件夹； - 重启 DSH。
方式二：npm（Beta）¶
DSH → Plugins → + Add plugin，输入其一：
dsh-memory-calendar@1.0.0-beta.2
或：
dsh-memory-calendar@beta
方式三：GitHub¶
在添加插件处使用仓库地址（详细步骤见仓库内 dsh-bundle/INSTALL.md）：
https://github.com/IStarFoxI/dsh-memory-calendar
方式四：手动 bundle¶
- 拿到
dsh-bundle目录； - 在 DSH 中安装该目录；
- 重启 DSH；
- 打开「设置 → 记忆」。
开发环境要求 Node.js >=24；插件分 Host / Client / Packager 三个入口，见 dsh-bundle 内说明。
典型用法¶
智能体在对话中按需调用上述 memory_* 工具即可，无需把全部历史写入 system prompt。一般流程可以是：
- 用
memory_search或memory_timeline定位相关日期或标签下的包； - 用
memory_read读取包内摘要文本； - 需要核对原文时，用
memory_expand回到 session log 事件； - 对必须原样保留的片段，用
memory_pin系列工具显式固定。
用户侧可在 设置 → 记忆 管理工作区、可见会话、标签与大脑图谱。更完整的操作说明见仓库 用户说明书 与 Beta 2.0 发布说明。
数据、隐私与当前限制¶
存储位置与内容范围¶
默认数据目录：
<工作区>/.memory-calendar
- 不上传、不联网同步；
- 文本包只含 user / assistant 文本；
- 不保存 reasoning、工具完整输出、图片/附件文件本体；
- 会尽力脱敏常见密钥格式，但不保证覆盖全部；
memory_expand返回原始事件，可能包含未脱敏内容。
升级或迁移前请自行备份 .memory-calendar。大脑 root 是真实目录：删除大脑并勾选「同时删除数据」会递归删除该目录，不可恢复；不要把 root 指向系统目录或无关项目。
适用场景与注意¶
适合：希望在单机上为 DSH 智能体做长期、可检索对话记忆，且接受 local-first、无云同步的开发者。
尚未具备或仍在 Beta 的能力（以 README 为准）：完整原始归档（完整保存）为 Beta 3.0 目标；无云同步、多人共享、语义向量检索；本地 HTTP 路由没有真正的 token 鉴权，建议只在本机使用；无 Windows 系统通知；图片/视频可能只保留引用。
结尾¶
dsh-memory-calendar 把 DSH 对话收成可检索的本地包，用工具按需读取并可回溯 session 事件，适合不想把整段历史每轮灌进上下文的使用方式。安装与版本以仓库 README 为准。
