findshan/dsh-agent-memory

Name: findshan/dsh-agent-memory
Author: findshan

Plugin插件 Native原生 ⭐ 2 MIT Memory & Knowledge记忆与知识库 Dev Workflow开发与代码工作流 Sessions & Context会话与上下文

DeepSeek Harness的自进化记忆：捕获→梦境整合→检索注入→进化。用户画像、项目记忆、纠正学习、简历叙事——追溯至可回放的会话日志。自进化记忆插件。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-evolving-memory is a cross-session memory compression layer for DeepSeek Harness. Built on top of official compaction, it uses a cheap model to further extract and consolidate session summaries into human-readable Markdown files, exposing six tools including memory_search, memory_read, memory_save, and memory_dream. Use it when an agent needs to retain user profiles, project state, and long-term knowledge across sessions. Note: file categorization follows soft conventions enforced via prompts, so the model may misfile content.

dsh-evolving-memory 是 DeepSeek Harness 的跨会话记忆压缩层。它在官方 compaction 之上，用廉价模型把会话摘要进一步提取整合为可读 Markdown 文件，提供 memory_search、memory_read、memory_save、memory_dream 等 6 个工具。当需要让智能体跨会话保留用户画像、项目状态与长期知识时使用。注意：分类为软约定，文件归类依赖模型判断，可能放错位置。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-agent-memory】【https://github.com/findshan/dsh-agent-memory】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-evolving-memory

把 findshan/dsh-agent-memory 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.6 KB · 缓存于 2026-09-01 05:12:19 · 3.6 KB

dsh-evolving-memory

文件化自进化记忆 —— DeepSeek Harness 的跨会话压缩层（v2）

记忆的本质是信息的压缩与提取。本插件叠在官方 compaction（会话内压缩）之上，用廉价模型把已压缩的会话摘要进一步提取、整合为人类可读的 Markdown 记忆文件——用户可看、可改，智能体可检索、可进化。

设计要点


记忆 = 压缩与提取	消费官方 `compaction/summary` 事件做提取（T1），不重复读原始日志；dream 做跨会话整合（T3）
纯 Markdown 文件	user / agent / memory / dream + 每项目 project.md + daily/ 时间层；无 schema、无迁移、无置信度、无状态机
人机共治	`user.md` 用户可读可编辑；agent 写入只是建议，用户有最终决定权
目录式披露注入	常驻注入只有记忆目录（确定性生成，零模型调用，有界）；内容按需 `memory_search`（找）+ `memory_read`（展开）披露——与 DSH skill 机制同构
三层压缩	会话 compact（官方）→ 提取进 daily/（情景记忆）→ dream 固化进主题文件（语义记忆），对应"睡眠时情景→语义固化"
廉价模型驱动	提取与整合走便宜模型（KB 级输入一次调用）；无 key 时记忆读写/检索照常，仅模型步骤跳过

Install / 安装

dsh plugin --profile web add dsh-evolving-memory
dsh --profile web

记忆文件落在 $DSH_HOME/memory/：

├── daily/2026-08-16.md   # 今日要点 + 会话纪要 + 待办（时间层，dream 后归档）
├── user.md               # 用户画像（身份/偏好/目标/禁忌/想法）—— 用户可编辑
├── agent.md              # 智能体自我认知与工作方式
├── memory.md             # 长期记忆（兜底落点）
├── dream.md              # 梦境整合日志（审计）
└── projects/<p>/project.md

工具（6 个）

memory_search（找）· memory_read（展开）· memory_catalog（目录）· memory_save（写）· memory_correct（纠错即学）· memory_dream（整合）

分类是软约定（写进 prompt，不是代码）：用户的事→user.md，项目的事→project.md，时间→daily/，拿不准→memory.md。检索兜底一切——放错文件也能找到。

配置

Key	默认	含义
`memoryDir`	`$DSH_HOME/memory`	记忆根目录
`dreamIntervalHours` / `dreamMinSessions`	`24` / `5`	梦境整合门控
`model` / `apiKey` / `baseURL`	`deepseek-chat` / env / `api.deepseek.com`	廉价模型（提取+整合）
`catalogBudgetTokens` / `catalogTopN`	`1000` / `5`	目录注入预算与每文件行数
`searchTopK`	`5`	默认检索条数
`autoExtract`	`true`	消费 compact summary 自动提取
`dailyRetentionDays`	`30`	daily 保留天数，dream 后归档

Development / 开发

npm run typecheck
npm run build
node test/smoke.mjs          # 无模型：布局/保存/读取/检索/目录/纠错/捕获/时间层/持久化
DEEPSEEK_API_KEY=sk-... node test/integration.mjs  # 真实模型：提取/纠错/梦境整合

为什么做这个

DSH 生态的记忆插件要么是 JSON 记录 + 置信度机器（复杂），要么没有跨会话整合。v2 回归本质：记忆就是几份活的文档 + 一个会读写的智能体——系统只提供文件、检索器、整合触发器，判断全部交给模型。明文本是 AGI/ASI 时代的通用接口。PRD：PRD.md · 旧方案：PRD-v1.md

License

MIT

渲染基于仓库 findshan/dsh-agent-memory 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令