MIT 开源的本地 Git 托管长期记忆插件：记忆持久化、事务性同步 / 回滚、全文搜索、启动注入 summary_snapshot、只读工具（memory_search / memory_context）、备份导出导入，并自带 DSH 设置页 UI。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-27
许可证
MIT
01它能帮你完成什么？
在 DeepSeek Harness 会话之间保留长期记忆
存到本地 Git 仓库的持久记忆（`summary.md`、`handbook/`、`rollouts/`、`archive/`），并提供只读的 `memory.search()` / `memory.context()` 检索
使用 DeepSeek Harness 的开发者与研究者，希望模型跨会话记住偏好与知识，又不想依赖托管记忆服务
安全清除学到的记忆，并保留可恢复的 Git 检查点
两步确认的清除流程：先保留 Git 恢复点（干净仓库复用现有 HEAD，脏路径打独立 checkpoint commit），再记录清除后的状态
需要在 DSH 设置页做可恢复的日常记忆重置的用户
无人值守地把闲置会话同步进记忆
可选的无头同步器（`./integrations/dsh/dsh-memory-sync`），只在私密的一次性 workspace 里处理闲置的本地会话日志，由宿主校验并写入 live Git 仓库
希望模型只改隔离副本、由宿主校验后自动积累记忆的用户
02如何接入 DeepSeek Harness？
前置条件
- 官方 dsh CLI（README 兼容性表：DSH runtime peer range `@deepseek-ai/dsh@^0.1.0-rc.6`，即 rc.6 与 rc.7）
- Git 可执行文件需位于 `PATH`（README 兼容性表：Git | a local executable available on `PATH`）
- Node.js 22.x（README 兼容性表）
- Python 3.11.x（README 兼容性表）
- macOS（README：macOS is the supported/tested integration target）
安装步骤
- 01
运行 `dsh plugin --profile web add github:seriousz158/dsh-memory`（GitHub 源码安装，根 bundle `dsh-git-memory` 一次安装同时激活两半）
$ dsh plugin --profile web add github:seriousz158/dsh-memory
- 02
安装后重启所选 DSH profile（README：Restart the selected DSH profile after installing）
- 03
源码方式（可选）：`git clone https://github.com/seriousz158/dsh-memory.git`，`cd dsh-memory`，再 `npm ci --ignore-scripts`
$ git clone https://github.com/seriousz158/dsh-memory.git
- 04
源码方式（可选）：`npm install --global @deepseek-ai/dsh@0.1.0-rc.7` 安装 v0.8.2 实测用的固定版本运行时，并用 `dsh --version` 确认
$ npm install --global @deepseek-ai/dsh@0.1.0-rc.7
- 05
源码方式（可选）：运行 `./integrations/dsh/install.sh` 把两个本地包装入 DSH profile（默认 `~/.dsh`；非默认路径时保持 `DSH_HOME` / `DSH_MEMORY_ROOT` 环境变量一致）
- 06
重启 DSH host，在 DSH Settings 中找到「长期记忆」并保持开关开启，让下一次模型调用启用记忆
验证接入成功
作者未说明
03DSH 适配与能力边界
原生 DSH 插件包：通过官方 `dsh plugin` CLI 安装，宿主插件与设置页 UI 插件经 DSH 的 Cordis loader 接口直接加载（非 MCP、非第三方 agent 适配）
本地 Git 托管的长期记忆
需要跨会话持久化的知识、偏好与经验→本地 Git 仓库中的持久记忆（`summary.md`、`handbook/`、`rollouts/`、`archive/`），Markdown 记录支持 front matter、namespaced ids、溯源、过期投影
安全同步与恢复
闲置的本地会话日志（可选）→dry-run / preview / apply 流程、操作锁、健康检查、有界批处理、重试退避、重复 id 诊断与仅元数据的 journal
模型只能编辑每次运行私密隔离的 workspace 副本，由宿主校验并写入 live Git 仓库只读记忆检索
有界且明确不受信任的 `summary.md` 快照（上限 12 KiB）→`memory.search()` / `memory.context()` 返回本地有界检索结果，带来源引用与按使用情况决定的确定性排序
读取用量以私有元数据存入 `.sync/usage.json`；transcripts、prompts、凭据与记忆内容不会写入 journalDSH 设置页集成
DSH 设置页 UI→记忆开关、仓库状态、近期同步状态、preview 操作、回滚与两步确认的清除操作
设置页不暴露文件系统根目录，也不直接执行 Git带恢复点的记忆清除
来自 DSH 设置页的两步确认清除请求→清除前保留 Git 恢复点（干净仓库复用清除前的 HEAD，脏路径打 checkpoint commit），清除提交直接建在该恢复点上；`.git`、`README.md`、辅助脚本、目录结构与 `.last-sync` 保持完整
面向可恢复的日常重置，不保证隐私擦除
04适合谁？何时不该用？
适合
- 使用 DeepSeek Harness 的开发者与研究者，希望模型跨会话记住偏好与知识，又不想依赖托管记忆服务
- 需要在 DSH 设置页做可恢复的日常记忆重置的用户
- 希望模型只改隔离副本、由宿主校验后自动积累记忆的用户
不适合
- 插件保持 DSH `0.1.0-rc.6` peer 兼容范围（rc.6 与 rc.7），并在固定为 `0.1.0-rc.7` 的图上实测集成；DSH `rc.8` 及之后版本在通过本仓库测试套件前均未验证。
- 清除记忆面向可恢复的日常重置，不保证隐私擦除。对隐私敏感的删除需求，需移除相关本地备份并遵循组织的保留策略；Git 历史本身不是安全擦除机制。
05兼容性、维护与安全提示
- 插件保持 DSH `0.1.0-rc.6` peer 兼容范围（rc.6 与 rc.7），并在固定为 `0.1.0-rc.7` 的图上实测集成；DSH `rc.8` 及之后版本在通过本仓库测试套件前均未验证。
- macOS 是官方支持 / 实测的集成目标；兼容性表还列出 Node.js 22.x、Python 3.11.x，以及 `PATH` 上可用的本地 Git 可执行文件。
- 清除记忆面向可恢复的日常重置，不保证隐私擦除。对隐私敏感的删除需求，需移除相关本地备份并遵循组织的保留策略；Git 历史本身不是安全擦除机制。
- 可选同步器默认 `workspace-write` 权限，更高的权限绝不是仓库默认。它需要用户自行安装的 `dsh` 可执行文件（或显式指定的 `DSH_BIN`），不调用 `npx --yes`；其会话过滤器会在 transcript 进入记忆抽取模型前脱敏常见凭据形态与 home 目录前缀。
- 项目仅通过 GitHub 源码安装与 GitHub Releases 分发，未发布到 npm；两个 workspace 实现包保持私有，只有根 `dsh-git-memory` bundle 可发布。
MIT · 活跃维护中（最新发布 v0.8.2，2026-08-25）
06常见问题
怎么安装 dsh-memory？
运行 `dsh plugin --profile web add github:seriousz158/dsh-memory` 即可。仓库根目录本身就是公开的 DSH bundle `dsh-git-memory`，包含宿主插件、设置页客户端 bundle 与其 `dsh.bundle` 补丁，一次安装同时激活两半；安装后重启所选 DSH profile。项目未发布到 npm。
记忆会上传到托管服务吗？
不会。记忆只留在本地 Git 仓库，README 明确没有托管记忆服务或云端向量数据库（There is no hosted memory service or cloud vector database）；bundle 也不包含任何记忆数据、会话日志、凭据或本地 `.dsh` 目录。
兼容哪些 DSH 版本？
v0.8.2 保持 DSH `0.1.0-rc.6` 的 peer 兼容范围，并在固定为 `0.1.0-rc.7` 的图上实测与本地集成；`rc.8` 及之后版本在通过本仓库测试套件之前均未验证。
清除记忆会发生什么？
设置页强制两次确认（点击「删除记忆」→ 输入 `删除记忆`）。在改动任何目标记忆路径前会保留恢复点：干净仓库复用现有 HEAD，脏路径打独立 checkpoint commit，清除提交直接建在该恢复点上。它面向可恢复的日常重置，不保证隐私擦除。
支持哪些平台与前置条件？
macOS 是官方支持 / 实测的集成目标；兼容性表还列出 Node.js 22.x、Python 3.11.x，以及 `PATH` 上可用的本地 Git 可执行文件。
07相关的 DSH 工作流
weknora
作者 tencent
开源的 LLM 知识库平台：把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统，支持多租户部署。
mirage
作者 strukto-ai
全球首个面向 AI 智能体的统一虚拟文件系统。
reme
作者 agentscope-ai
ReMe：面向 AI Agent 的记忆管理套件——帮 Agent「记住我、优化我」，支持 RAG 与长期记忆。
memsearch
作者 zilliztech
为 Claude Code、Codex 等 AI Agent 提供持久化、统一的多层记忆：基于 Markdown 与 Milvus 向量库，支持语义检索与混合搜索。
08数据与来源
The repository root is also a public DSH bundle named `dsh-git-memory`.
dsh plugin --profile web add github:seriousz158/dsh-memory
The package uses DSH's Cordis loader interfaces.
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-27。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。