Re-s/dsh-memory-s3

README 摘要

dsh-memory-s3（记忆S3） 云端跨会话记忆插件 for DeepSeek Harness：结构化条目 + 向量检索，持久化于 S3 兼容对象存储（AWS S3 / MinIO / Cloudflare R2 / 阿里云 OSS）。 记忆不再困于单机——只要握着同一把桶钥匙，任何机器、任何部署、任何 DSH 实例都能共享与续写同一份记忆。 记忆S3 欺骗的收束点是"记忆的位置"：从本地文件系统，迁移到对象存储的永恒之海。 ✨ 特性 - S3 兼容存储后端 ：条目 CRUD + listObjects 同步 + 乐观并发（If-Match）；自定义 endpoint 兼容 MinIO/R2/OSS - 结构化记忆模型 v2.1 ： preference project decision history moment 五类条目（moment = 时刻/照片/纪念日，对应 Tulving 情景记忆），带 importance/tags/source/时间戳 + 可选四维字段： subject （主体）/ timeline （时间线归属）/ links （关联引用）/ locked （锁定保护） - 向量语义检索 ：可插拔嵌入器 + 余弦 top-k + 元数据/关键词混合召回（中文友好） - 本地缓存投影 ：冻结快照只读本地缓存（rc.6 同步注入约束），S3 异步回源，离线降级只读 - 写入审批门 ：所有写操作强制 DSH approval seam（ask/auto/off），模型不可见不可改 - 审计三链 ：审批对 + 审计账本 + 快照，可从会话日志重建全部写入 - 照片/文件附件 ：条目可挂照片/文件——二进制存 S3 files/{id} 不可变对象（uuid 键 + If-None-Match 创建 + sha256 完整性），条目 JSON 只存附件元数据数组；本地文件经扩展名白名单 + 魔法字节嗅探 + 大小上限（20MB）三重校验； memory s3 attach / memory s3 get file / memory s3 detach 三工具 - 反链索引（v2.1） ：写入 links （引用即链接，Obsidian/Zettelkasten 心智）自动回填本地反链索引（ lib/backlinks.mjs → backlinks.json ，0600 持久化，替换语义）； memory s3 backlinks 查询「谁引用了该条目」（读路径无审批）；被引用数（图中心性）是快照注入的排序信号 - 分层快照注入（v2.1） ：冻结快照按 Bonds（locked / 高重要性约定，保底 40% 预算）→ Moments（moment 按新近）→ Facts（按 importance，同分按被引用数）三层投影；带 links…

分类