DSH Plugins
返回列表
🖥️

dsh-fix-attachments

客户端 更新于 2026.10.30

在终端中运行以下命令:

dsh plugin install xuzhunzhi/dsh-fix-attachments

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

在 DeepSeek Harness 插件中心安装,或执行 dsh plugin install xuzhunzhi/dsh-fix-attachments(源码仓库:https://github.com/xuzhunzhi/dsh-fix-attachments),装完重启 DSH 即可。

插件介绍

如果你遇到过这样的困境:某条会话每一轮都在极短时间内失败,报错 DeepSeek Messages transport failed,换网络、换 key 都无济于事,而同机其它会话却完全正常——往往是因为会话历史里引用过的图片附件已从内容寻址存储中消失。请求在准备阶段反复尝试读取这些对象,触发 ATTACHMENT_NOT_FOUND,却被适配器统一包装成 TRANSPORT,看起来像是网络问题,实际上与网络无关。

本插件挂在 agent 请求错误的扩展点上,在判定为相关失败时扫描当前会话视图中仍参与请求的图片引用,对确实读不出的对象走官方已有的 image/offload 机制,把它们换成占位文本并持久化,然后让这一轮立刻重试。它不根据错误文案瞎猜,只修「视图上真的缺字节」的图,真网络故障仍会原样交给下游;同一轮还有修复次数上限,修过的图会被标记 offloaded,避免无限循环。

适合长期用 DeepSeek Harness、会话里传过图、又不幸撞上「这一条会话永久发不出消息」的用户。它不能找回已删的图片字节,也不替代上游在 prepareImages 里做正确降级——但在官方缺陷修复之前,它是进程内自愈的止血方案,让你感觉只是「刚才卡了一下」,而不是只能新开对话或手改压缩日志。需要批量体检或 DSH 起不来时,同一项目还提供离线 CLI 扫描会话日志。

使用场景

  • 某条会话每轮都在毫秒级报 TRANSPORT,历史里有过传图
  • 附件对象已从存储删除,prepareImages 阶段反复失败
  • 需要让坏会话继续聊下去,而不是只能新开对话

适合人员

  • 日常在 Harness 里使用图片对话的用户
  • 遇到单条会话永久发不出消息的排查者
  • 需要离线批量体检会话日志的维护者