🧰

dsh-attachment-s3

联网工具更新于 2026.08.25

在终端中运行以下命令：

dsh plugin install guaguasong/dsh-attachment-s3

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 中执行 dsh plugin install guaguasong/dsh-attachment-s3 即可安装该插件，源码地址为 https://github.com/guaguasong/dsh-attachment-s3。

插件介绍

DeepSeek Harness 的会话附件默认写入本机 DSH_HOME 目录，一旦跑在多实例、容器编排或跨机器迁移的场景，图片就会变成孤岛：A 节点收的图 B 节点读不到，机器一换附件就丢。dsh-attachment-s3 把整条附件落盘链路指向 S3 兼容的对象存储 bucket，实现与内置本地后端完全对等的 AttachmentStore 接口——同一时刻只挂一个后端，装了就替换，不叠加。

核心能力集中在三点。写入采用条件请求（If-None-Match: *），相同字节并发上传时后到者自动校验已有对象而非盲目覆盖，天然去重。读取按引用声明的字节范围精确拉取，重算哈希、重解图片头后才交给模型请求，桶端被篡改会在到达模型前以 ATTACHMENT_CORRUPT 暴露。会话日志中只记录 sha256: 开头的透明标识，永远不暴露 key 或 URL，因此前后端切换不改变任何对话语义。凭证走引用名而非明文值，密钥轮换后下一个请求即生效，无需重启。

适合这样的团队：在 Kubernetes、ECS 或多机房里横向扩展 Harness 节点、需要附件集中持久化且跨机器可读取；使用 AWS S3、MinIO、Cloudflare R2 等任意 S3 兼容服务；希望把附件生命周期管理（加密、存储类、过期）交给 bucket 策略而非应用层。注意它目前只处理 PNG / JPEG / WebP / GIF 图片，每个部署对应一个 bucket，会话日志的持久化仍由 profile 自身的存储后端负责。