JasperGuWP/dsh-project-memory

Name: JasperGuWP/dsh-project-memory
Author: JasperGuWP

插件Plugin 原生Native ⭐ 3 MIT 开发工具Developer Tools 记忆Memory 安全Security 工具Tools

Project-level persistent memory plugin for deepseek-harness: auditable Markdown memory files with memory_load_context / upsert / finalize / forget tools. Zero-dependency, installable via dsh plugin add.

项目介绍Project Overview

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

dsh-project-memory 是 deepseek-harness 的项目级持久记忆插件，跨会话读写当前项目 memory/ 下的可审计 Markdown 文件，落盘为普通文本，支持 git 审计与 diff，不依赖模型内部上下文。提供 memory_load_context（按关键词与目录载入）、memory_upsert（按用户明确要求写入）、memory_finalize（收尾沉淀为 reference）、memory_forget（删除条目）四个工具。适用于多会话项目协作、长期任务上下文保留与可审计的持久化场景。文件即记忆，配合 .git 即可追踪全部变更。注意：写入时拒绝 token、cookie、password、JWT、.env 等敏感信息，命中返回 ok:false。

dsh-project-memory is a project-scoped persistent memory plugin for deepseek-harness. It lets the model read and write auditable Markdown files under the current project's memory/ directory across sessions, stored as plain text for git diffing and review, independent of in-model context. It exposes four tools: memory_load_context (keyword search plus full catalog), memory_upsert (writes only on explicit user request), memory_finalize (appends a reference entry at task end), and memory_forget (deletes a memory). Use it for multi-session projects, long-running task continuity, and auditable, git-trackable persistence. Caveat: write tools reject tokens, cookies, passwords, JWTs, and .env values, returning ok:false on match.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

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

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。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.

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

命令行安装CLI Install

dsh plugin --profile web add dsh-project-memory

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

READMEREADME

4.6 KB · 缓存于 2026-08-25 04:53:56 · 4.6 KB

dsh-project-memory

deepseek-harness 的「项目级持久记忆」插件：让模型跨会话读写当前项目 memory/ 目录下的可审计 Markdown 记忆文件——落盘为普通文本，可 git 审计 / diff，不依赖模型内部上下文。

通用、零外部依赖：不预置任何项目知识，装到哪个项目就服务于哪个项目。

工具

四个工具，名字均可用 toolPrefix 加前缀：

工具	作用
`memory_load_context`	会话/任务开始加载相关记忆；关键词检索 + 全量 `catalog` 清单
`memory_upsert`	仅在用户明确要求「记住 / 以后都按这个来」时写入或更新一条记忆
`memory_finalize`	任务收尾把结论沉淀为一条 reference 记忆（固定文件，避免文件膨胀）
`memory_forget`	遗忘：删除正文文件 + 对应索引行（保护 `MEMORY.md` 与 `reference.md`）

特性

文件即记忆：memory/MEMORY.md（纯索引）+ memory/*.md（正文）。
索引格式：- [类别] 主题：一句话摘要 → 文件名.md
敏感信息拦截：token / cookie / password / 密钥 / JWT / .env 命中即拒存（返回 ok:false）。
工作区感知根目录：优先 sandboxPolicy.resolve({ session })（会话 cwd），回退 config.memoryRoot → process.cwd()。
检索：中英分词 + 多字段 + 正文 + 新鲜度加权；catalog 可当「列记忆」用。
防膨胀：maxReferenceEntries 给 reference 设上限，自动裁最旧。

安装

方式 A：一键安装（Bundle，推荐）

本仓库是一个 dsh Bundle（package.json 声明了 dsh.bundle.patch）。其他用户用 dsh plugin 直接装到自己的 profile：

# Git 源（锁定 commit 更稳）
dsh plugin --profile web add github:<owner>/dsh-project-memory#<sha>

# 或 npm（若已 pnpm publish）
dsh plugin --profile web add dsh-project-memory

# 或 tarball（pnpm pack 产物）
dsh plugin --profile web add ./dsh-project-memory-0.1.0.tgz

装完重启 dsh 进程生效（node 半侧无热加载）。插件零外部依赖、无构建步骤，git 源装上即可用；若 pnpm 对 git 依赖提示 allowBuilds，按提示在 profile 的 pnpm-workspace.yaml 加一行后重跑。

校验 / 移除：

dsh --profile web --dump-config | grep -A2 project-memory
dsh plugin --profile web remove dsh-project-memory

方式 B：手动本地插件（不打包也行）

插件是零依赖的单文件 .ts，不走包管理也可以：

下载 memory-plugin.ts 到本机。
在你 profile 的 cordis.patch.yml 加一行（name 用绝对路径）：

- insert:
    - id: project-memory
      name: '/absolute/path/to/memory-plugin.ts'
      # config:
      #   toolPrefix: ''            # 需要命名空间时，如 'proj_' → proj_memory_upsert
      #   memoryRoot: ./memory      # 默认 = 会话工作区 /memory
      #   maxReferenceEntries: 200  # reference.md 最多保留条数

重启 dsh。

配置

键	默认	说明
`memoryRoot`	会话工作区 `/memory`	记忆根目录（绝对或相对，相对按会话工作区解析）
`indexFilename`	`MEMORY.md`	索引文件名
`referenceFilename`	`reference.md`	收尾沉淀固定文件名
`toolPrefix`	`''`	工具名与 systemPrompt 节名的前缀
`maxReferenceEntries`	无限制	reference.md 最多保留条数，超出裁最旧

触发规则（插件会自动注入为系统提示节）

会话/任务开始：memory_load_context 载入相关记忆。
仅当用户明确要求「记住 / 以后都按这个来 / 以后都这样做」：memory_upsert。
非平凡任务收尾：memory_finalize 沉淀一条。
过期或被取代的记忆：memory_forget 删除。
绝不存密钥：写工具会拒绝并返回 ok:false。

30 秒验证

会话 A：记住：这个项目用 pnpm 打包。 → 确认调用了 memory_upsert 且成功。
会话 B（新会话，勿复制 A 的对话）：这个项目怎么打包？ → 确认调用了 memory_load_context 并复述 pnpm。

兼容性

测试于 deepseek-harness（Node ≥ 22）。Bundle 入口为预编译 memory-plugin.js；本地 .ts 方式（方式 B）由 Node 原生 type-stripping 加载（开发环境 tsx）。
零外部依赖：运行期只 import node:fs / node:path；defineTool、Context 等均已内联/本地化，因此本地插件、Bundle、user preset 任一形态都能直接加载，不会踩 @deepseek-ai/* 解析不到的 ERR_MODULE_NOT_FOUND。

License

MIT

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

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