icearia0219/dsh-memory-spaces

dsh-memory-spaces

CI npm DSH 兼容性：rc.6–rc.7 已验证 许可证：MIT

会话默认私有，只有用户明确连接后才共享记忆。

dsh-memory-spaces 是一个独立的社区 DeepSeek Harness 插件，让选定会话拥有持久、可检查的记忆，而不是把所有对话合并到一个全局记忆池。用户决定哪些会话可以贡献、哪些会话可以使用，以及每轮回答有哪些记忆进入模型上下文。

为什么需要记忆空间？

有用的决策、约束、偏好和项目事实往往停留在最初讨论它们的会话中。手动复制十分重复，而不受限制的全局记忆又可能暴露无关上下文。记忆空间让一组命名的本地会话共享知识，并通过明确连接、可见来源和发送前检查保留用户控制。

和单一全局记忆有什么不同？

插件不把记忆简化为自动读写开关，而是让治理过程保持可见，并把贡献与使用分开：

| 原则 | 插件行为 |
| --- | --- |
| 默认私有 | 只有用户明确把会话连接为使用者后，该会话才会收到空间记忆。 |
| 独立关系 | 记忆来源可以贡献所选内容而不使用空间；使用者可以使用记忆而不贡献内容。仅仅建立关系不会复制已有或未来会话。 |
| 用户治理 | 创建空间、改变关系、处理生命周期、导入历史、清除来源和破坏性删除都需要用户界面操作或人类直接命令；插件不会向模型暴露这些工具。 |
| 发送前检查 | 自动匹配的记忆仍可在输入框中关闭；确认方式只注入用户主动勾选的候选记忆。 |
| 可检查记录 | 记忆版本保留生命周期状态和应用层来源，界面会显示哪些会话使用每个空间。 |
| 本地所有权 | 每个 Web Profile 使用本地 SQLite 数据库；当前版本没有远程邀请或跨实例同步。 |

截图

管理器会保留记忆版本及其来源信息，同时把记忆来源和使用会话作为两种独立关系。

显示有效导入记忆版本的记忆空间管理器

使用会话页签显示每个会话的回答时使用方式，但不会因此授予记忆写入能力。

显示独立使用方式的记忆空间使用会话列表

历史导入必须由用户明确执行，生成的摘要命令事件会留在会话记录中。

明确导入历史摘要后的会话记录

快速开始

把已发布的明确版本安装到现有 Web Profile：

dsh plugin --profile web add dsh-memory-spaces@0.1.0
dsh --profile web --dump-config
dsh web

打开一个会话，选择 记忆空间，创建空间，明确保存所选消息，再把另一个本地会话连接为使用者。发送匹配提示词前，在输入框中检查或关闭候选记忆。

本包适配官方原版 DSH >=0.1.0-rc.6  | 总结当前来源会话，并创建下一个生成摘要版本。 |
| /memory remember    | 明确保存一条带命令事件来源的记忆；所有者首次贡献时会被记录为来源。 |
| /memory forget  | 把当前会话可以管理的记忆版本标记为 deleted。 |
| /memory list | 列出因所有权、来源贡献或使用关系而可见的空间，并显示各自关系。 |
| /memory show  | 显示可见的记忆版本及生命周期状态。 |
| /memory preview  | 为诊断渲染有界自动上下文；输入框提供可交互预览。 |

记忆类型为 fact、decision、constraint、preference、task、artifact、issue、solution 和 temporary。

配置

| 字段 | 默认值 | 含义 |
| --- | ---: | --- |
| databasePath | 必填；bundle 使用 profile:memory-spaces-v4.sqlite | 安装包会把文件解析到所属 DSH Profile 下。测试可使用 :memory:。 |
| journalMode | wal | SQLite 日志模式：wal、delete、truncate 或 persist。 |
| busyTimeoutMs | 5000 | 数据库被锁定时等待多久再让操作失败。 |
| maxMemoryBytes | 8192 | 单个记忆版本的最大 UTF-8 字节数。 |
| maxQueryBytes | 4096 | 从人类直接输入中保留用于检索的最大 UTF-8 字节数。 |
| maxRecallItems | 8 | 预览与注入考虑的最大排序候选数。 |
| maxRecallBytes | 16384 | 完整警告、JSON 来源与记忆正文的字节上限。 |
| historySummaryProvider | 空 | 固定摘要提供方；空值使用会话最近路由，并且必须与模型字段配对。 |
| historySummaryModel | 空 | 固定摘要模型；空值使用会话最近路由，并且必须与提供方字段配对。 |
| historySummaryMaxTokens | 1200 | 摘要输出 token 上限；因 token 上限截断的输出不会保存。 |
| maxHistoryImportBytes | 65536 | 发送给摘要模型的有界 transcript 最大字节数。 |

Schema 版本 4 使用独立的来源表和使用者表。放在配置目标路径上的版本 3 数据库会先备份，再按以下规则迁移：read 变为自动使用；write 变为来源；read_write 变为两者；manual_only 变为来源加发送前确认。新默认值不会静默复用旧的全局 $DSH_HOME/memory-spaces-v3.sqlite；需要迁移时请按备份与恢复明确移动。其他未知 schema 版本会快速失败且不改变日志模式。

兼容性、升级与移除

本包适配 >=0.1.0-rc.6

安全与隐私

- 关系变更只能通过定址到具体会话的浏览器私有 UI 命令完成；公开 /memory 命令和模型工具无法执行。
- 已存记忆仍是不可信数据。标签安全 JSON 会转义字面量 <，注入警告会把记忆中的指令、权限声明和工具请求标记为不可信背景；这些措施不能保证抵抗 Prompt Injection。
- 保存所选对话、导入历史和创建快照前，界面会显示 API Key、密码、私钥、token、身份证件和其他敏感内容的警告。凭据格式检测只报告类别，不回显匹配值。
- 快照访问 token 与编辑 token 相互独立。SQLite 只保存 hash；链接具有有效期、次数上限、计数和撤销状态。快照不授予任何记忆关系。客户端移除查询参数之前，URL 仍可能通过浏览器或剪贴板历史、日志、截图、Referrer 或代理泄漏。
- SQLite 数据库保存在本地且没有加密。部署者负责 TLS、服务认证、文件保护和备份策略。
- 历史导入会为每个所选会话执行一次模型调用。提供方可能根据自身策略计费或保留提交的 transcript。

模型体验

当人类直接输入匹配 automatic 使用者空间中的有效记忆时，模型会在直接提示词之前收到一条带来源的额外用户消息。它包含固定的不可信背景警告，以及带生命周期和来源字段的标签安全 JSON。confirm 使用者只会收到在匹配输入框预览中明确勾选的候选记忆。目标会话日志会记录实际注入消息，记忆数据库会记录目标会话、可用时的回答事件序号和使用时间。

没有固定提示词或工具 schema 成本。匹配步骤在提供方分词前最多增加 maxRecallBytes UTF-8 字节。取消、提供方失败、空摘要输出、工具调用、token 截断和超限历史摘要输出都不会写入数据。

限制

- 会话 id 不是账号身份。此版本没有团队、组织目录、远程邀请或跨实例同步。
- 消息选择只包含浏览器当前已加载的会话历史。需要更早内容时，请先在会话中加载历史，再重新打开选择窗口。
- 快照链接只包含文本，并且只属于创建它的 DSH 实例。除非公开部署改变基础 URL，否则 127.0.0.1 只能在同一台机器访问。
- 冲突状态由用户治理。更新现有记忆会创建版本链，但插件不会从语义上检测两条独立保存的记忆是否矛盾。
- 检索使用字面 FTS5 trigram 排序，而不是 embedding 相似度。
- 没有外部数据库备份时，插件不能撤销清除来源和删除完整空间，但这不代表物理残留或其他系统副本已经安全擦除。

文档

- 架构与数据模型
- 威胁模型、安全策略与备份/恢复
- DSH 兼容性、声明核验与质量审计
- 故障排查、性能边界与发布清单

所有者与许可

由付雨嫣维护，使用 MIT License 发布。