这是云端跨会话记忆插件 for DeepSeek Harness：结构化条目 + 向量检索，持久化于 S3 兼容对象存储（AWS S3 / MinIO / R2 / 阿里云 OSS）。
前言¶
DSH 默认情况下记忆仅存储在本地实例中。如果你更换部署环境或机器，这些记忆将无法保留。dsh-memory-s3 通过将记忆持久化到 S3 兼容的对象存储，实现了跨设备、跨会话的记忆共享与续写。
核心功能¶
- S3 兼容存储后端：支持条目 CRUD、listObjects 同步、乐观并发以及自定义 endpoint（兼容 MinIO / R2 / OSS）。
- 结构化记忆模型 v2.1：定义了 preference、project、decision、history、moment 五类条目，支持 importance/tags/source 等元数据。
- 向量语义检索：提供可插拔的嵌入器支持，支持余弦 top-k 检索以及元数据/关键词混合召回。
- 本地缓存投影：支持冻结快照、只读本地缓存、S3 异步回源以及离线降级模式。
- 写入审批门：所有写操作强制通过 DSH 的 approval seam，模型不可见不可改。
- 审计三链：记录审批对、审计账本和快照，可从会话日志重建全部写入。
- 照片/文件附件：支持给条目挂载文件，二进制对象存储于 S3 并进行本地校验。
- 反链索引（v2.1）：自动回填本地反链索引，支持查询「谁引用了该条目」。
- 分层快照注入：按 Bonds → Moments → Facts 的顺序注入快照，支持关联引用标记。
安装与启用¶
使用官方 CLI 进行安装，将插件添加到 Web profile：
npx @deepseek-ai/dsh plugin --profile web add https://github.com/Re-s/dsh-memory-s3.git
工具列表¶
安装后，DSH 将暴露以下工具用于记忆管理：
memory_s3_save：保存一条记忆（过审批门）。memory_s3_search：关键词检索。memory_s3_recall：语义召回。memory_s3_list：列表/过滤。memory_s3_backlinks：查询反链（无审批，读本地索引）。memory_s3_update：更新条目（过审批门）。memory_s3_delete：删除条目（过审批门）。memory_s3_forget：抑制自动注入而不删除。memory_s3_attach：挂载附件（过审批门）。memory_s3_get_file：下载附件到本地（无审批，校验）。memory_s3_detach：移除附件（过审批门）。memory_s3_sync：手动同步 S3 增量。
权限与注意¶
- 无 GUI 表单入口：插件没有可视化配置表单，需通过
settings.yaml手动配置。在插件的 Plugin list 中可见，但在 Plugin configuration 中不可见。 - 权限要求：插件运行需要以下权限：
harness:tool,filesystem:read,filesystem:write,network:https,subprocess:none,shell:none,python:none,credentials:env。 - 版本兼容性：兼容 DSH 0.1.0-rc.6 和 0.1.2-rc.1。
- 凭据管理：S3 凭据只从环境变量读取（
AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY），绝不落盘。
生态链接¶
- GitHub: https://github.com/Re-s/dsh-memory-s3
- 目录页: https://www.skillhub.cn/plugins/Re-s/dsh-memory-s3
