aqsk-BLG/dsh-memory 预览 preview

aqsk-BLG/dsh-memory

Layered file memory for DeepSeek Harness — workspace-scoped USER/MEMORY notes, background consolidation, hybrid session recall. npm: dsh-file-memory

Project Overview项目介绍

This is a native DSH plugin, distributed as a standalone Git repository and published to npm under the name dsh-file-memory. It is built exclusively for DeepSeek Harness, and adds WorkBuddy-style layered memory capabilities to the official DSH web profile. Features include global persona and memory files, explicitly bound workspace memory, skip-aware reminders, background consolidation, hybrid session recall, and post-compaction flush, along with a bundled usage skill. To install it, users must first have a working source checkout of the official DeepSeek Harness, with an existing configured web profile. Users stop the running DSH process and run the install command from the checkout root.

After installation, the plugin inserts a memory row and enables a session-query index at the existing DSH home directory, and does not modify the DSH source tree or existing user settings. On first run, if the core memory files (USER.md, MEMORY.md, etc.) do not exist in DSH home, the plugin automatically seeds starter templates without overwriting any existing files. The plugin checks the DSH host version on load, and will fail to load with an error if the host version is below the tested minimum of 0.1.0-rc.7 by default. Users can manually override this check to downgrade the error to a warning if they are running a compatible fork.

The plugin requires Node.js version 22.19.0 or higher, or 24 and above, and is licensed under the MIT license. It has several known limitations, including that settings changes only take effect after a DSH restart, edits to core memory files only apply to new sessions, and there is no cross-device cloud sync for memory files. Users can configure plugin settings through the official DSH settings UI under Settings → Plugins → Plugin configuration, where they can also edit core memory files directly. Any changes made in the settings card do not take effect until the next time DSH is restarted.

这是一款原生 DeepSeek Harness(DSH)插件,是面向 DSH 官方 web 配置文件的可安装插件包,提供 WorkBuddy 风格的分层记忆功能。它支持全局人格文件、绑定工作区记忆、跳过感知提醒、后台记忆合并、混合会话召回和压缩后刷新,还捆绑了使用说明,是为 DSH 开发的内存模块的独立 Git 分发版,自 1.2.1 版起以 dsh-file-memory 名称发布到 npm。

安装需要用户已经克隆了 DeepSeek Harness 官方源码,并且已经配置好了 web 配置文件、聊天记录、模型和工作区设置。安装时需要先停止正在运行的 DSH 进程,在源码根目录使用 pnpm dsh 命令安装,可以指定版本标签、提交哈希,也可以从 npm 或发布压缩包安装,不会修改原有 DSH 源码和已有用户配置。

该插件仅支持 DSH 0.1.0-rc.7 及以上版本,低于要求版本默认会加载失败,也可以手动调整配置将错误降级为警告。它依赖 Node.js 22.19.0 或 24 以上版本,采用 MIT 许可证,首次运行时会自动生成四个核心记忆文件的模板,不会覆盖用户已有文件。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
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 github:aqsk-BLG/dsh-memory

把 aqsk-BLG/dsh-memory 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-file-memory

banner

English | 中文

An installable DSH profile bundle for WorkBuddy-style layered memory: global persona and memory files, live explicitly bound workspace memory, skip-aware reminders and background consolidation, hybrid session recall, post-compaction flush, and a bundled usage skill. This repository is the standalone Git distribution of the implementation developed in DeepSeek Harness. Since v1.2.1 the package is published as dsh-file-memory.

Install or remove

The expected user already runs an official DeepSeek Harness source checkout and may already have chats, model/provider settings, workspaces, and a web profile. Stop the running DSH process, then run the install from that same checkout root and from an environment with the same DSH_HOME used to start DSH:

pnpm dsh plugin --profile web add github:aqsk-BLG/dsh-memory#v1.3.2
pnpm dsh --profile web --dump-config
pnpm dsh web

Use github:aqsk-BLG/dsh-memory to follow the repository head, or replace the v1.3.2 tag with an exact commit SHA for the strongest reproducibility. A globally installed CLI may use dsh ... instead of pnpm dsh ....

Once published to npm, the registry package name is dsh-file-memory:

pnpm dsh plugin --profile web add dsh-file-memory

Or install from a release tarball: download dsh-file-memory-1.3.2.tgz from the assets of the v1.3.2 release, then:

pnpm dsh plugin --profile web add ./dsh-file-memory-1.3.2.tgz

Naming note. Since v1.2.1 this package is published as dsh-file-memory. The npm name dsh-memory is a different, unrelated package — do not install that one by mistake.

dsh plugin updates only the existing profile's dependency metadata, lockfile, installed modules, and dsh.profile.bundles list. It does not modify the DSH source tree, create another agent or workspace, or reset existing sessions, models, settings, storage, or workspace registrations. The bundle also leaves dshHome unset, so the plugin uses the exact same single data root as the DSH instance: inherited $DSH_HOME, or DSH's own ~/.dsh default only when that variable is unset. It never opens both roots.

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

← 上一个 Prev dsh-deepseek-usage-dashboard 下一个 Next dsh-swarm-router →