DSH Plugins
返回列表
🖥️

dsh-media-rescue

客户端 更新于 2026.11.15

在终端中运行以下命令:

dsh plugin install BrainZombie/dsh-media-rescue

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

在 DeepSeek Harness 中执行 dsh plugin install BrainZombie/dsh-media-rescue,或在插件面板添加来自 https://github.com/BrainZombie/dsh-media-rescue 的插件目录。

插件介绍

在 DeepSeek Harness 里,回复正文里的 Markdown 图片通常走 GET /api/file?path= 拉取文件。一旦路径拼错或文件落在别处,就会 404,界面退化成「图片无法预览」。这类问题往往不是内容被拦截,而是约定的工作区路径和磁盘上的真实位置对不上——图已经生成,只是引用写错了。

dsh-media-rescue 在显示层做救援:只有内置 /api/file 返回 404 时才介入(prefix 路由、最长前缀匹配),再通过五层文件名策略找真实文件——原名、去掉生成器帧号、正文把目录名粘进文件名的别名、被截短的前缀、以及 Markdown 转义吃掉的符号。每个候选都经过组合文件系统探测,有歧义就放弃、不猜。找到后,若目标在工作区内会把真文件拷到正文引用的位置(只创建不覆盖),否则把请求改写到真实路径,响应语义与内置实现一致。

它还在源头预防:在 tools/post-execute 里,当工具结果里出现真实存在的媒体路径时,追加可直接粘贴的 Markdown 图片语法;并注册 GET /ws/ 直链,避免 URL 被转义破坏。索引侧支持工具结果(运行时)、roots 配置目录、以及经 sessionQuery 的历史会话,让装插件之前就写坏的会话也有机会恢复。

适合经常看图生图、截图、导出媒体到非约定目录的 Harness 用户,以及需要排查「路径到底解析到哪」的维护者。注意:只按文件名匹配、不比对图像内容;消息正文不改写,导出仍可能是旧路径;与同样接管 /api/file 的插件互斥。

使用场景

  • 回复里 Markdown 图片显示「图片无法预览」但文件其实在别的目录
  • 图生工具输出路径和正文引用路径不一致导致 /api/file 404
  • 需要恢复安装插件之前就写坏路径的历史会话图片

适合人员

  • 经常在 Harness 里看图生图、截图结果的用户
  • 会把媒体导出到非默认工作区目录的开发者
  • 负责排查图片 404 与路径解析的 Harness 维护者