LCYLYM/dsh-attachments

Better Attach · 更好的 DSH 拖放

拖到对话区，添加文件附件；拖到侧边栏，创建工作区。

Drop into the conversation to attach files. Drop into the sidebar to create a workspace.

同一个文件夹，落点决定用途。工作区直接使用主机原目录。

One folder, two destinations. Workspaces use the original host directory.

| 拖到哪里 / Drop destination | 会发生什么 / Result |
| --- | --- |
| 💬 对话区 / Conversation | 文件或文件夹成为当前对话的附件，供模型读取。 / Files and folders become attachments for the model to read. |
| 📁 侧边栏 / Sidebar | 原目录成为工作区，可以在其中开始对话。 / The original directory becomes a workspace where you can start conversations. |

中文 · English · 验收记录 / Verification

dsh · dsh-plugin · deepseek-harness · attachments · drag-and-drop · workspace

Better Attach · rc.5 功能演示 / rc.5 walkthrough

观看 rc.5 视频 / Watch rc.5 MP4 · 此视频展示 rc.5；rc.6 的工具栏、附件布局与 macOS 路径桥接以本文说明为准。 / This video shows rc.5; see below for rc.6 layout and macOS path-bridge behavior.

中文

Better Attach 是 DeepSeek Harness 的附件与拖放插件，沿用 dsh-attachments 的 Git 历史和 npm 包名 dsh-multimedia-webui-input。

两个落点，两种用途

拖到对话区：把文件交给模型。 支持单个文件和整个文件夹；文件夹显示为一张卡片，保留目录层级，添加前可检查文件、筛选和预览。独立图片使用 DSH 原生视觉附件。

对话附件可在 设置 → Better Attach 或输入区的 附件设置 中选择处理方式：

| 对话附件模式 | 保存与读取方式 |
| --- | --- |
| 复制副本（默认） | 发送时保存副本，已保存内容不随原文件后续编辑改变。 |
| 引用路径 | 引用主机上的原文件或目录，模型读取其当前内容。 |

拖到侧边栏：把原目录作为工作区。 侧栏始终注册原目录，独立于对话附件设置。macOS 上，从 Finder 把一个文件夹拖到 DSH 侧边栏，插件自动获取绝对路径并注册原目录。一次拖一个文件夹；同时拖多个时会提示分别拖入。

拖拽提示由插件统一显示，独立图片仍通过 DSH 原生视觉接口添加。对话附件卡片独立横向滚动；工具栏图标可悬停查看名称。

平台支持

| 能力 | macOS | Windows / Linux |
| --- | --- | --- |
| 对话文件、文件夹附件及预览 | 支持 | 支持 |
| 选择或填写原目录，创建工作区 | 支持 | 支持 |
| Finder 拖入侧边栏，自动取得原绝对路径 | 支持，需随包附带原生桥接 | 尚不支持；需选择或填写主机目录 |

macOS 桥接随 DSH 插件启动和退出，仅在当前可见 DSH 页面的侧边栏收到真实拖拽时请求路径。切换标签页、离开侧边栏或取消拖动会取消请求；桥接不创建接收窗口。浏览器和 DSH 必须运行在同一台机器上。Windows 自动路径桥接仍是待完成能力。

安装

当前预发布版本 0.3.0-rc.6，需要 Node.js ^22.19.0 || >=24.0.0。推荐下载 GitHub Releases 中的 .tgz 包，包含 Apple Silicon 和 Intel Mac 桥接程序。

npx --yes @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-multimedia-webui-input-0.3.0-rc.6.tgz
npx --yes @deepseek-ai/dsh web

从 Git 源码安装时，先在固定源码目录构建。macOS 的原生构建需要 Xcode Command Line Tools：

npm ci
npm run build
macOS only / 仅 macOS：
npm run build:native
npx --yes @deepseek-ai/dsh plugin --profile web add /absolute/path/to/better-attach
npx --yes @deepseek-ai/dsh web

也可使用交付 TGZ 的绝对路径安装。已有 DSH 命令时，可运行 sh install.sh 或 Windows 的 ./install.ps1。修改插件后重启 DSH。npm 公开版本以注册表为准。

隔离试用时，先将 DSH_HOME 设为新目录。插件附件记录保存在其中的 better-attach/；对话附件副本位于当前工作区的 .dsh/tmp/attachments/better-attach-v2/。

其他能力

- 检查与预览：目录筛选、文本和代码预览、栅格图片预览、文件类型图标；其他格式提供下载。
- 传输恢复：上传进度、暂停、文件级重试；已完成文件复用，失败保留草稿。
- 附件复用：从记录中再次附加已保存副本或原路径引用。
- 外观：原生无图、蓝色渐变和角色图片，适配宿主颜色、窄屏、键盘操作与减少动态效果设置。

使用边界

仅支持同机回环访问。普通浏览器通常不提供原绝对路径，路径引用需明确填写主机路径。文本预览前 128 KiB，图片预览上限 20 MiB；HTML/SVG 作为文本显示，PDF、Office、音视频和压缩包提供下载。默认排除常见依赖、缓存和敏感文件名，规则不等同于完整 .gitignore 解析。

未发送的文件选择保存在页面内，刷新后需重选。清理仅删除当前会话的插件副本，保留原文件与工作区。文件落盘和模型消息成功分别记录；原生消息历史由 DSH 渲染。

本次 macOS Finder 单文件夹工作区拖入、对话拖放与最终界面由用户在真实 DSH 测试后确认。自动检查覆盖事件隔离、多目录反馈和原目录注册；Windows 自动路径桥接与桌面验收尚未完成。验证范围见原生路径说明，历史检查见验收记录。

卸载后重启 DSH：

npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-multimedia-webui-input

英文

Better Attach 是 DeepSeek Harness 的附件与拖放插件。它延续了 dsh-attachments 的 Git 历史，并保留 npm 包名 dsh-multimedia-webui-input。

两个目标，两种用途

拖入对话，将文件交给模型。 附加单个文件或整个文件夹。文件夹会变成一张卡片，保留其层级结构，并在添加前提供过滤和预览。独立图片使用 DSH 的原生图片输入。

在 设置 → Better Attach 或编辑器旁的 附件设置 中选择对话附件模式：

| 对话附件模式 | 存储与读取 |
| --- | --- |
| 复制文件（默认） | 发送时保存一份副本；之后对原文件的编辑不会改变该副本。 |
| 引用路径 | 引用主机上的原始文件或目录；模型读取其当前内容。 |

拖入侧边栏，将原目录用作工作区。 在 macOS 上，从 Finder 将一个文件夹拖入 DSH 侧边栏，以解析其绝对路径并注册原目录。每次拖放一个文件夹；多个文件夹会提示你分别拖放。对话附件设置不会改变工作区注册。

一个插件自有的拖拽提示覆盖两个目标。独立图片仍使用原生 DSH 视觉附件。附件卡片在编辑器上方水平滚动；将鼠标悬停在紧凑的工具栏图标上可查看其标签。

平台支持

| 能力 | macOS | Windows / Linux |
| --- | --- | --- |
| 对话文件、文件夹和预览 | 支持 | 支持 |
| 通过选择或输入原始路径创建工作区 | 支持 | 支持 |
| 从 Finder 侧边栏拖放自动解析原始路径 | 支持，需打包的原生辅助程序 | 不可用；请选择或输入主机目录 |

macOS 辅助程序随插件启动和停止。路径请求仅限于对可见 DSH 页面侧边栏的真实拖拽。离开侧边栏、切换标签页或取消操作都会取消请求。该辅助程序不会创建接收窗口。浏览器和 DSH 必须运行在同一台机器上。Windows 自动路径集成仍未完成。

安装
当前预发布版本：0.3.0-rc.6。需要 Node.js ^22.19.0 || >=24.0.0。从 GitHub Releases 下载 .tgz；其中包含 Apple Silicon 和 Intel Mac 辅助程序。

npx --yes @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-multimedia-webui-input-0.3.0-rc.6.tgz
npx --yes @deepseek-ai/dsh web

若要从 Git 源码安装，请先在一个永久目录中构建。macOS 原生编译需要 Xcode Command Line Tools：

npm ci
npm run build
macOS only:
npm run build:native
npx --yes @deepseek-ai/dsh plugin --profile web add /absolute/path/to/better-attach
npx --yes @deepseek-ai/dsh web

交付的 TGZ 也可以作为绝对包路径提供。若已安装 DSH，可使用 sh install.sh，在 Windows 上使用 ./install.ps1。插件变更后请重启 DSH。请在 npm 上查看公开可用的版本。

若要进行隔离安装，请先将 DSH_HOME 设置为一个新目录。插件附件记录使用其 better-attach/ 目录。会话副本位于当前工作区下的 .dsh/tmp/attachments/better-attach-v2/。

更多功能

- 审阅与预览： 目录过滤、文本/代码和光栅图像预览、文件类型图标，以及其他格式的下载。
- 可恢复传输： 进度、暂停和文件级重试；已完成的文件会被复用，失败时保留草稿。
- 附件复用： 从历史记录中重新附加已保存的副本或原始路径引用。
- 外观： 原生纯色、蓝色渐变和角色插画，支持宿主配色、窄布局、键盘访问和减少动态效果。

边界

仅限回环访问。普通浏览器通常不会提供原始绝对路径，因此引用需要显式的主机路径。文本预览限制为 128 KiB，图像预览限制为 20 MiB。HTML/SVG 仍作为文本处理；PDF、Office、音频、视频和归档文件提供下载。常见依赖项、缓存和敏感文件名默认被排除；这不是完整的 .gitignore 解析器。

未发送的文件选择仅存在于页面中，重新加载后必须重新选择。清理仅影响此插件当前会话的副本，保留原始文件和工作区。已保存的文件和成功的模型消息分别跟踪；DSH 拥有原生消息历史记录。

用户已针对真实 DSH 确认了 macOS Finder 单文件夹工作区拖放、会话拖放和最终界面。自动化检查覆盖事件隔离、多目录反馈和原始目录注册。Windows 自动路径集成和桌面验收仍未完成。参见原生路径范围和历史验证。

卸载，然后重启 DSH：

npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-multimedia-webui-input

开发与文档 / Development & docs

npm ci
npm run check
npm ci --prefix fixtures/dsh-latestbash
npm run test:live:latest
npm ci --prefix fixtures/dsh-next
npm run test:live:next

安装与兼容 / Compatibility · 录制说明 / Recording · 市场收录 / Plugin directories

录制脚本独立于生产插件，视频中的文件读取与模型回复来自真实 DSH。 / The recorder is separate from the production plugin; file reads and model responses in the video come from real DSH.

MIT 许可证 / MIT license. 图片来源 / Artwork provenance. GitHub Topics: dsh, dsh-plugin, deepseek-harness, attachments, drag-and-drop, workspace.