前言¶
DSH 的 Web 界面本身支持图片附件，但如果你要把普通文件、甚至整个文件夹交给模型处理，还需要一个能保留目录结构、持久化到工作区，并且尽量不打乱原有输入区的插件。
下面介绍 dsh-attachment。它由 WJZ-P 维护，许可证为 MIT，当前版本面向 DeepSeek Harness 0.1.0-rc.5 的 web profile 使用。
这是什么¶
dsh-attachment 是一个 DSH 插件包，用于在 Web Client 输入区增加文件和文件夹附件体验。
它的定位不是替换原生图片链路，而是在普通文件和文件夹场景上提供卡片、历史与落盘路径；当输入区没有插件附件时，页面布局和原版 Harness 保持一致。
核心功能¶
- 文件夹拖放：一个文件夹对应一张附件卡片，同时完整保留内部目录树。
- 普通文件：支持拖入、预览卡片、持久化历史与流式下载。
- 原生图片共存：PNG、JPEG、WebP、GIF 继续使用 Harness 原生图片预览、画廊和多模态检查。
- 模型可读取：提交后写入当前工作区的
.deepseek-harness/attachments/，为模型提供明确路径。 - 低侵入集成：通过公开的输入附件栏 slot、会话定义与 Host 路由完成集成。
- 布局保持：输入区没有插件附件时，页面布局和原版 Harness 保持一致。
安装与启用¶
当前版本可以直接从 npm 安装到原生 DSH 的 web profile。先执行安装：
dsh plugin --profile web add dsh-attachment
安装后，可以检查组合后的配置，再启动 DSH：
dsh --profile web --dump-config
dsh --profile web
如果需要移除插件，执行：
dsh plugin --profile web remove dsh-attachment
典型用法¶
1、安装插件：
dsh plugin --profile web add dsh-attachment
2、检查插件接入后的配置：
dsh --profile web --dump-config
3、启动 DSH 的 web profile：
dsh --profile web
4、在输入区拖入文件或文件夹，提交消息后附件会持久化并复制到工作区附件目录。
5、插件会把附件写入 .deepseek-harness/attachments/，让模型可以基于明确路径读取文件或目录树。
适用场景与注意¶
这个插件适合在 DSH web profile 下需要以下能力的场景：
- 拖入普通文件并保留历史卡片；
- 拖入文件夹时保留目录树；
- 在会话中保留附件历史；
- 为模型提供工作区中的明确文件路径；
- 与 Harness 原生图片附件共存。
使用前需要注意：
- 插件自身不设置附件数量或单文件字节上限；实际可用范围由浏览器、运行环境与目标模型共同决定。
- 文件名、MIME 类型、附件 ID 与目录成员路径均按不可信输入校验。
- Windows 盘符、UNC 路径、绝对路径及目录穿越片段会在写入前被拒绝。
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。 - 当前版本面向 DeepSeek Harness
0.1.0-rc.5的标准 bundle、Web Client 发现、输入附件栏、会话事件与 Host 路由接口。 - 官方
@deepseek-ai/*包全部使用peerDependencies。
链接¶
插件目录页：
https://www.skillhub.cn/plugins/WJZ-P/dsh-attachments
GitHub 仓库：
https://github.com/WJZ-P/dsh-attachments
社区目录是独立站点，不应理解为官方应用商店。dsh-attachment 的价值在于把普通文件和文件夹附件纳入 DSH 的 Web 工作流，同时保持原生图片链路与原有输入区布局。
