dsh-Mmem

dsh-Mmem 是面向 DeepSeek Harness（DSH） 的独立长期记忆插件。它把记忆视为需要治理的数据：每条正式记忆都有 Owner、来源、可见性、修订关系和所属 Memory Space；候选记忆默认按本地时区定时自动审批，Owner 也可以显式切换为逐条人工审批。

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

当前候选版本是 @mistymoon/[email protected]。完整开发与发行验收基于 DSH 0.1.0-rc.8；公开 peer range 继续保留此前验证过的 rc.7，但本次新增的侧栏与图谱 UI 只在 rc.8 完成了完整验证。建议先在中性测试数据或可恢复副本上试用。

安装与下载

运行环境：

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

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

dsh plugin --profile web add @mistymoon/[email protected]

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

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

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

npm pack @mistymoon/[email protected]

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

npm install @mistymoon/[email protected]

公开包已经声明 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. 审批模式默认是 scheduled-auto，使用宿主机 IANA 时区的每日 03:00。如需逐条人工审批，Owner 必须在设置中手动选择并保存 manual。
6. 轮次摘要默认使用不调用模型的本地快速压缩。Owner 可为当前 Memory Space 显式切换为 DSH 模型压缩，并可选指定已配置的 Provider/Model；留空则使用 DSH 默认路由。

审批提示：自动审批默认开启。 如需人工审批，请由 Owner 在 Memory Settings 中手动切换为“人工审批”并保存。

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

核心能力

• 可追溯治理：Confirmed Memory 保留 Owner、Memory Kind、可见性、来源消息 ID、时间与 append-only revision lineage；纠正通过新记录替代旧记录，不静默改写历史。
• 临时记忆与候选审核：每轮结束自动生成带 24 小时 TTL 的摘要 Candidate；默认本地压缩，也可在当前 Memory Space 显式启用已配置 DSH 模型。未过期 Pending 仅在直接进入其 Memory Space 时作为醒目标注的不可靠记忆临时召回，并可按需分页展开该轮用户可见全文。Rejected、Expired 和 Import Draft 不参与召回。
• 记忆浏览器：侧栏底部的“记忆”按钮打开 Session-bound 浏览器，可在按记忆类型分组的目录视图和语义关系图谱之间切换，并支持搜索与图谱缩放。
• 无需 embedding 的语义关系：候选审批卡片可用滑块选择是否保存本地可解释规则建议的 相关 / 矛盾 关系；关系与正式记忆在同一 Archive 事务内确认，默认不影响召回。
• 安全召回：默认使用本地 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。

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

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

审批模式

scheduled-auto

…