Qinling-Melon-Farmers/dsh-memoir

Name: Qinling-Melon-Farmers/dsh-memoir
Author: Qinling-Melon-Farmers

Bundle捆绑包 Native原生 ⭐ 33 Apache-2.0 Memory & Knowledge记忆与知识库 Sessions & Context会话与上下文

DeepSeek Harness (DSH) local-first cross-session project memory: zero bundled runtime deps, bounded cache-friendly Hot Memory, BM25 recall/cache, provenance, lifecycle and bilingual Web GUI; no embeddings or external service. / DSH 本地项目记忆插件。

Project Overview项目介绍

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

dsh-memoir is a native cross-session memory plugin built exclusively for the DeepSeek Harness (DSH) agent environment. It enables users to persist validated work conclusions, learned lessons, and planned follow-up actions from completed agent sessions, and injects bounded, cache-optimized Hot Memory into new sessions to help the agent pick up work where it left off. It uses local BM25 ranking to retrieve relevant long-tail historical memories, and does not require any external embedding APIs, vector databases, or cloud memory services. To install from the npm registry, users first need to have the correct DSH version installed, then run dsh plugin --profile web add dsh-memoir@latest to add it to their DSH web profile.

After each effective work turn completed by the top-level agent, the plugin automatically triggers a reminder to summarize the work and persist it to long-term memory. It intelligently skips idle turns, aborted tasks, and subagent turns to avoid unnecessary duplicate summaries and unwanted memory bloat. The plugin ships with a full-featured bilingual Web GUI that integrates natively into the DSH web interface, allowing users to browse, search, filter, edit, and manage all their stored memories. It is targeted at individual developers and local development workflows that need AI agents to work consistently on projects across multiple sessions.

dsh-memoir is released under the permissive Apache-2.0 open source license, so users can modify and redistribute it according to the terms of the license. All user memory data is stored locally on the user’s own device, and the plugin will never automatically delete any memory data when you upgrade or uninstall the plugin. Users must match their DSH version to the plugin version requirements: versions older than DSH 0.1.5-rc.1 require older locked plugin versions. After installation, a full restart of the DSH web process is required for the plugin to load correctly and become available.

这是一款专为 DeepSeek Harness（DSH）打造的本地优先跨会话记忆原生插件，用于持久化存储 Agent 已确认的工作结论、经验教训和后续行动规划，能够在新会话中注入边界清晰、缓存友好的热记忆（Hot Memory），并通过本地 BM25 排序召回跨会话的长尾历史记忆。它无需依赖外部 embedding 服务、向量数据库或云端记忆服务，作为 npm 包发布，零运行时依赖，DSH 宿主环境提供所需 peer 依赖。

它支持在有效工作回合结束后自动触发蒸馏提醒，会自动跳过空闲、中断和子代理回合，仅提醒顶层 Agent 对已完成工作进行归纳总结，用户还可以通过自带的全功能 Web 图形界面手动新增、编辑、归档、标记记忆，也支持浏览检索全局和项目级记忆。该插件适合需要 AI 代理跨会话持续推进项目开发的个人开发者或本地开发工作流使用。

本插件采用 Apache-2.0 开源协议，所有记忆都存储在用户本地设备，插件升级或卸载都不会自动删除用户的记忆数据。当前版本要求 DSH 版本在 >= 0.1.5-rc.1 < 0.1.6-0 之间，旧版 DSH 用户需要锁定到对应旧插件版本。支持通过 npm 一键安装，也可从源码编译安装，安装完成后需要重启 DSH web 才能生效。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-memoir（Qinling-Melon-Farmers/dsh-memoir）
仓库：https://github.com/Qinling-Melon-Farmers/dsh-memoir
本站详情页：https://www.yhbd.top/plugins/qinling-melon-farmers-dsh-memoir/
本站登记：类型 bundle · 归类 原生 DSH 插件 · 许可证 Apache-2.0 · ⭐ 33 · 最近提交 2026-09-30 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示

33 stars - an early-stage project星标 33，属于早期项目

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-memoir@0.9.1

把 Qinling-Melon-Farmers/dsh-memoir 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

23.4 KB · 缓存于 2026-09-30 22:09:52 · 23.4 KB

dsh-memoir

中文 · English · 更新日志 · Releases

DeepSeek Harness（DSH）的本地优先、跨会话项目记忆插件。 它把 Agent 已确认的工作结论、经验教训和后续行动持久化，在新会话中注入有界且缓存友好的 Hot Memory，并通过本地 BM25 排序召回长尾历史。

无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH 与 Zod 4 peer 由宿主环境提供；Zod 用于验证宿主会话投影，不捆绑进插件。

[!WARNING] 0.9.1 修复会话恢复问题 #14：0.8.1–0.9.0 写入的旧回执可能导致会话重新打开失败。 升级阻止新增异常，但不自动重写旧日志；npm 包已内置 dsh-memoir-repair 命令。旧会话仍打不开时，按恢复说明先只读检查、停机备份后再显式恢复；不要删除日志或降级数据格式。恢复前停止旧插件写入，仅关闭自动蒸馏不能阻止手动工具写入。修复已覆盖官方 DSH 0.2.0-rc.1 / 0.2.0-rc.2；仅升级 DSH 不会修复旧插件或已有异常日志。

[!IMPORTANT] 0.9.1 要求 DSH >=0.2.0-rc.1 <0.3.0-0，已验证官方 0.2.0-rc.1 / rc.2（不是无后缀正式 0.2.0）。保留首屏导引、原生设置、四种 Agent 语言、独立蒸馏回合与冻结快照。DSH 0.1.7 兼容线为 0.8.2，但仍受 #14 影响；使用本修复须先升级宿主，再安装 0.9.1。

dsh-memoir@0.7.1 修复重启和内存淘汰后旧会话快照丢失（#10），支持 DSH 0.1.5-rc.1 / rc.2。要求 >=0.1.5-rc.1 <0.1.6-0；请先核对宿主版本。旧 DSH 0.1.2 用户固定使用 0.6.2，0.1.1-rc.2 用户固定使用 0.5.6；这些旧版未包含本次修复。

npm install --global @deepseek-ai/dsh@0.2.0-rc.2
dsh plugin --profile web add dsh-memoir@0.9.1

重启 dsh web 即可。记忆保存在本机，不会随插件升级或卸载自动删除。

为什么选择 dsh-memoir

能力	用户得到什么
本地优先	JSON 单一事实源与项目内 `PROJECT_MEMORY.md`；不上传记忆，不依赖外部服务
自动蒸馏提醒	顶层 Agent 完成有效工作回合时提醒归纳，由 `memoir_record` 透明落盘；跳过 idle、aborted、subagent 和已记录回合
有界 Hot Memory	只把高价值记忆放进 system prompt，受 token 预算硬限制；同一会话冻结前缀以提高 prompt-prefix cache 命中
BM25 排序召回	中文短语、英文关键词、代码标识符和路径都可检索；跨项目 Top-K 与查询 LRU 缓存共用同一引擎
可治理的记忆	重要度、置顶、标签、归档、恢复和 supersede 生命周期；相似写入必须显式更新、替代或并存
可追溯	Agent 写入记录可信 session/turn 来源，Web 面板可复制并尽力跳回原会话
完整 Web GUI	中英双语项目/全局浏览、排序搜索、编辑、Hot Memory 预览、诊断和实时设置；可独立选择 Agent 侧中文、英文、德语或俄语

适合需要“新 Agent 接手时继续理解项目”的个人或本地开发工作流。它不是原始聊天记录备份、多人云同步服务或向量语义知识库。

界面预览

0.9.0 组件界面预览，使用演示数据。 顶部常驻插件身份、GitHub、文档与记忆设置入口，无需滚过长列表。

0.9.0 界面预览：首屏插件导引与记忆浏览

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 Qinling-Melon-Farmers/dsh-memoir 的 README.md。在 GitHub 查看原文 →