记忆库 janpauldahlke/dsh-memento

dsh-local-memento

为 DeepSeek Harness web UI 里的本地编码智能体提供有界文件的记忆。

npm 包名是 dsh-local-memento（dsh-memento 在 registry 上已被占用）。
GitHub 仓库仍是 janpauldahlke/dsh-memento。

新会话会从一份简短的 ME.md 配置档和可选的项目 MEMORY.md 获得热启动。捕获是免费的（Remember this: → 收件箱）。要晋升到注入层，得在 Memory 右侧栏手动编辑——绝不自动写入。没有 embedding，没有向量库，插件内部也不调用 LLM。

相关插件（同样是 web 右侧栏的双面 dsh.bundle 形态）：

| 插件 | 仓库 |
| 进程与端口生命周期 | dsh-agent-processes |
| 长周期任务状态 | dsh-local-long-horizon |
| NVIDIA GPU 利用率 / 显存 / 功耗 | dsh-gpu-monitor-nvml |
| 本地 LLM 端点 / slot 健康 | dsh-slot-health |

本包：dsh-local-memento
· 源码 janpauldahlke/dsh-memento。

已在 DeepSeek Harness 0.1.7-rc.2（dsh web）上验证。

环境要求

- DeepSeek Harness web 配置档（dsh web）。
- 构建需要 Node.js ≥ 20。

截图

浅色主题，与 DSH 默认一致。

| 面板 + 聊天 | Memory 面板（全屏） |
| Memory pane open | Memory fullscreen |

| 开始指南（Memory 书本图标） |
| Memory in the Start guide |

你会看到什么

- Memory 右侧栏 —— 编辑 ME.md 和项目文件，晋升或删除收件箱里的行，预览注入了什么，开关插件。
- 标签标题上的状态着色 —— 开启时绿色，关闭时灰色，轮询/写入出错时黄色。
- 收件箱 —— 来自 Remember this: / memory_remember 的草稿列表。不会被注入；智能体只有在 ~/.dsh/memory/ 下翻找时才会读到它。
- ↑ promote —— 往 ME 或项目的草稿（未保存）追加一行。保存后它就从收件箱移出（可撤销）。

安装

从 npm 安装（推荐）

dsh plugin --profile web add dsh-local-memento
restart dsh web (or rely on live patch reload), then hard-refresh the browser

从 GitHub 安装

dsh plugin --profile web add github:janpauldahlke/dsh-memento

从 git checkout 安装（开发者）

git clone https://github.com/janpauldahlke/dsh-memento.git
cd dsh-memento
npm install && npm run build
dsh plugin --profile web add "$(pwd)"

重启（或启动）dsh web，让 host + client 两面加载：

env -u DSH_WEB_URL -u DSH_SHELL -u DSH_SESSION_ID dsh web --no-open

卸载：

bash
dsh plugin --profile web remove dsh-local-memento

restart the web instance that had the plugin

首次运行 —— 写下你自己的 ME.md

插件首次启动时，会从一个通用模板生成 ~/.dsh/memory/ME.md（只有规则和注释掉的示例行）。它不会附带任何别人的配置档。

1. 打开右侧栏的 Memory。
2. 把注释掉的示例换成对你长期成立的事实。
3. 保存。新会话会原样注入这个文件。

已存在的 ME.md 不会被安装或升级覆盖 —— 只在文件缺失时创建。

项目记忆存放在 ~/.dsh/memory/projects/<key>/MEMORY.md（需要时从面板创建）。收件箱是 ~/.dsh/memory/inbox.md。

智能体工具

| 工具 | 用途 |
| memory_remember | 往收件箱追加一行（逃生通道；绝不碰 ME / 项目记忆） |
| memory_history_search | 对已结束会话日志做只读考古（失败即放行） |

聊天中的触发词（同样只进收件箱）：Remember this:、Remember:、Note this:。

界面入口

| 入口 | 路径 / 名称 |
| 仓库 | ~/.dsh/memory/（ME.md、inbox.md、projects/…/MEMORY.md） |
| 总开关 | ~/.dsh/memory/.off（面板 On/Off） |
| HTTP | GET /api/dsh-memento/health、/state、/compliance、… |
| UI | 右侧栏 Memory |

设计要点，五句话

1. ME.md（约 30 行）和可选的项目 MEMORY.md（约 45 行）是唯一始终注入的层级。
2. 上限是压力，不是拦截 —— 超出上限的保存照样接受，由你来整理。
3. inbox.md 只追加，永不注入。
4. 智能体永远不写注入层 —— 晋升靠人在面板里编辑。
5. 仪式优先于判断 —— 第一次改文件前先读项目记忆；合规只观察，从不拦截。

刻意不做：embeddings、Qdrant、FTS、晋升阶梯、frontmatter schema，以及插件内部的 LLM 调用。

架构

双面包（与其他 web 右侧栏插件同一标准）：

- Host（lib/index.js，ESM）—— 仓库、注入、收件箱、合规、HTTP、工具。
- Client（lib/client.js，CJS ModuleLoader 工厂）—— Memory 右侧栏。
- Glue —— cordis.patch.yml + package.json 里的 dsh.bundle / dsh.client。

assets/ 下的模板在构建时内联；运行时不会从磁盘读取。

许可证

MIT —— 见 LICENSE。