dsh-mmem

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-Mmem

`dsh-Mmem` 是面向 [DeepSeek Harness（DSH）](https://www.npmjs.com/package/@deepseek-ai/dsh) 的独立长期记忆插件。它把记忆视为需要治理的数据：每条正式记忆都有 Owner、来源、可见性、修订关系和所属 Memory Space；候选记忆默认等待人工审批，也可以由用户显式开启按本地时区运行的定时自动审核。

本插件只使用 DSH 的公开扩展点。DSH 仍然拥有 Agent Runtime、Session、Workspace、工具、权限和模型路由；dsh-Mmem 不修改 DSH 源码，也不创建与 DSH 平行的 Workspace 身份。

> 当前版本是公开 alpha：[`@mistymoon/dsh-mmem@0.0.1-alpha.0`](https://www.npmjs.com/package/@mistymoon/dsh-mmem)。完整开发与发行验收基于 DSH `0.1.0-rc.8`；DSH `rc.7` 也完成了独立 clean Profile 的安装和 Web Settings discovery 验证。建议先在中性测试数据或可恢复副本上试用。

## 安装与下载

运行环境：

- Node.js `^22.19.0 || >=24.0.0`
- DSH `>=0.1.0-rc.7 <0.1.0`
- 当前推荐 DSH `0.1.0-rc.8`

普通用户应通过 DSH 插件命令安装已经验收的确切版本：

```powershell
dsh plugin --profile web add @mistymoon/dsh-mmem@0.0.1-alpha.0
```

希望跟随 alpha dist-tag 时可以使用：

```powershell
dsh plugin --profile web add @mistymoon/dsh-mmem@alpha
```

如果只想把 npm 包下载为 `.tgz`、暂不安装：

```powershell
npm pack @mistymoon/dsh-mmem@0.0.1-alpha.0
```

自行维护 Cordis/DSH 组合的集成开发者也可以把它作为依赖安装：

```powershell
npm install @mistymoon/dsh-mmem@0.0.1-alpha.0
```

公开包已经声明 `dsh.bundle.patch`、Host 入口与 Web client discovery；使用 DSH 插件命令时不需要手工修改已安装的包。插件在 Harness 进程中运行，安装前应先审阅本仓库和包内的 `cordis.patch.yml`。

## 首次使用

1. 在 DSH Web 中打开一个属于目标 DSH Workspace 的 live Session。
2. 进入 Memory Settings。若该 Workspace 尚未绑定 Memory Space，页面会显示首次设置。
3. 创建一个 Memory Space，或把已有 Space 绑定到当前 Workspace。
4. 选择 Binding 是只读还是读写；需要接收新 Observation/Candidate 时，将一个读写 Space 设为该 Workspace 的 Default Write Space。
5. 审批模式默认是 `manual`。只有在用户显式保存 `scheduled-auto`、IANA 时区和当地审核时间后，定时审核才会启动。

Workspace 身份只取自 live DSH `SessionHeader.cwd`。浏览器不能自行提交 Owner、`cwd`、任意 Workspace 身份或 Archive 路径。

## 核心能力

- **可追溯治理**：Confirmed Memory 保留 Owner、Memory Kind、可见性、来源消息 ID、时间与 append-only revision lineage；纠正通过新记录替代旧记录，不静默改写历史。
- **候选审核**：支持搜索、筛选、人工批准/拒绝、编辑、合并、冲突处理和 partial-success 批量决策。Pending、Rejected 和 Import Draft 永不参与召回。
- **安全召回**：默认使用本地 BM25，并在检索前后执行 Owner、authority、scope、有效期、visibility 与 disclosure gate；模型看到的 Recall Snapshot 会写入 DSH Session 日志。
- **多个 Memory Spaces**：每个 Space 使用物理隔离的 Archive；一个 DSH Workspace 可绑定 Space，一个 Space 也可由多个 DSH Workspaces 共用。
- **可治理的跨 Space 召回**：跨空间关系只影响只读召回，不复制记忆、不改变 Source Space，也不授予修改来源记录的权限。
- **本机定时审核**：按用户 IANA 时区和当地时间运行，处理 DST、跨进程 lease 和每日去重；它不依赖 CI/CD 读取用户私有数据。
- **旧数据迁移**：提供从旧 MistyMoon SQLite confirmed rows 到已选定 Space Archive 的显式 plan/apply/rehearse-rollback/rollback 流程。

## Memory Space 与互通模式

Memory Space 是独立治理与召回单元，不等于 Memory Scope，也不等于 DSH Workspace。完整领域词汇见 [`CONTEXT.md`](CONTEXT.md)。

| 模式 | 跨 Space 召回 | 适用场景 |
| --- | --- | --- |
| `isolated` | 不跨 Space；只查询当前 Active Space | 项目、身份或叙事必须完全隔离 |
| `selective` | 仅按显式单向 Grant 读取，并过滤 Memory Kind/visibility；授权不传递 | 只共享某类可控事实 |
| `federated` | 显式 Federation 成员间互相召回；新 Space 不会自动加入 | 多个 Space 需要完整而可审计的共用记忆 |

Borrowed Recall 始终保留 Source Space、授权关系和 policy revision，并与本地结果共同重新应用一次全局数量/字符预算。如果读取期间共享策略发生变化，借用结果会被全部丢弃。

## 审批模式

### `manual`

默认模式。候选只能由 Owner 在 Session-bound Settings UI 或受治理工具中批准、拒绝、编辑或合并。重复/冲突候选要求显式选择 keep-both 或 supersede。

### `scheduled-auto`

用户显式选择 IANA 时区和当地时间后，插件在本机 DSH Runtime 中集中审核。每个候选都使用 fresh、无 parent/seed、无工具的 DSH Agent Session 生成结构化建议；Memory 治理层在提交前重新校验策略 revision、Owner、Workspace Binding、Space、Candidate、来源和冲突。

失败、低置信度、格式异常、`boundary`、`commitment`、阻塞冲突或治理状态变化都会 defer 到人工队列。自动审核不会把 Archive 写权限交给评估模型。

这里的“自动审批”是用户本机的可取消调度任务，不是读取真实 DSH Home 的云端 CI。CI/CD 只运行中性测试、构建和发布审计。

## 数据与安全边界

- Memory Archive、设置、DSH Sessions、日志和凭据位于用户私有 DSH Home，不属于 npm 包，也不应进入 Git。
- Pending、Rejected、Import Draft、跨 Owner/scope 或未获 disclosure 授权的内容不会进入召回。
- 默认 `local-dsh-host-rpc` authority 面向本机回环、单 Owner Web 部署；其他通道在提供可信 principal Adapter 前失败关闭。
- 外部记忆或高级检索引擎只能作为可替换 Provider；Archive 仍是治理事实来源。

## 当前限制

- 这是 alpha 版本，尚未声明兼容 DSH `rc.9`、后续 rc 或 stable；扩大范围前需要重新跑完整兼容矩阵。
- 自动候选抽取 seam 已存在，但默认不捆绑抽取 Provider；候选仍可由受治理的 DSH 工具提出。
- 默认检索是本地 BM25；PageIndex 和 graph Adapter 默认关闭，远程引擎、embedding 与 reranking 不属于当前基线。
- Lifecycle confirmation plan 是进程内对象，重启后需要依据重放的 Archive 重新创建。
- Standalone migration 支持事务级回滚；已导入批次目前没有业务级“整批撤销”命令，单条记录仍可通过 append-only forget 治理。

## 旧 MistyMoon 数据迁移

迁移不会发现或创建 DSH Workspace/Memory Space。目标 Archive 必须属于用户已经选定的 Space，并应在 DSH 停止写入该 Archive 时操作。`plan` 只输出数量、路径和摘要，不输出记忆内容：

```powershell
pnpm migrate:standalone -- plan
pnpm migrate:standalone -- apply
pnpm migrate:standalone -- rehearse-rollback
pnpm migrate:standalone -- rollback
```

先运行 `rehearse-rollback`；只有结果为 `applicable: true` 时，才应使用返回的 confirmation 执行实际 rollback。首次迁移应使用中性副本演练，不直接操作唯一真实档案。

## 仓库结构

```text
dsh-Mmem/
├─ CONTEXT.md       Memory Space、Scope、Binding 与共享的领域词汇
├─ packages/
│  ├─ memory/       Archive、治理、召回、调度与迁移核心
│  ├─ settings-ui/  Session-bound DSH Settings tab 与 browser bundle
│  └─ bundle/       唯一公开包 @mistymoon/dsh-mmem
├─ scripts/         构建、发布审计与迁移 CLI
├─ research/        竞品调研与发行验收记录
├─ cordis.patch.yml 开发组合入口
└─ AGENTS.md
```

内部 workspace 包保持 `private: true`；唯一公开安装面是 `@mistymoon/dsh-mmem`。

## 开发与发布验收

开发环境使用 pnpm `11.7.0`：

```powershell
pnpm install
pnpm check
```

生成并审计唯一可上传 tarball：

```powershell
pnpm pack:npm
```

该命令不会登录或发布 npm。npm 登录、版本、dist-tag、`npm publish` 和 Release 仍由 Owner 手动执行。npm 版本不可重复发布；已经上传的 `0.0.1-alpha.0` 不能用于下一次发布。新预发布版本必须显式指定 tag，例如把下面的 `VERSION` 替换成新版本号：

```powershell
npm publish .\.artifacts\npm\mistymoon-dsh-mmem-VERSION.tgz --tag alpha --access public
```

每个新版本发布后，都应从 registry 包在全新 DSH Home 中重复 clean Profile 验收。

## 兼容性、调研与许可证

- 完整发行验收：[`research/release-readiness-0.0.1-alpha.0.md`](research/release-readiness-0.0.1-alpha.0.md)
- DSH 记忆插件生态、差异化与采用判断：[`research/dsh-memory-plugin-ecosystem-2026-08-21.md`](research/dsh-memory-plugin-ecosystem-2026-08-21.md)
- 问题反馈：[GitHub Issues](https://github.com/mianyoubiaoqing/dsh-Mmem/issues)

本项目使用 MIT License。外部 Provider、模型、二进制与第三方代码保留各自许可证；LivingMemory 是 AGPL-3.0 项目，只作为产品行为参考，其实现不会复制到本 MIT 仓库。