dsh-local-path-attachments：将本地文件拖入 DSH Desktop 作为绝对路径引用

在 DeepSeek Harness (DSH) Desktop 中处理本地文件时，通常需要复制文件到工作区或上传二进制内容。这个插件提供了另一种方式：直接将文件拖入对话窗口，生成以绝对路径为依据的引用卡片，而不涉及文件字节的传输。

这是什么¶

dsh-local-path-attachments 是一个 DSH 插件，由 WangZetian-IVERSON 维护。它的核心作用是将 Windows 资源管理器或 Finder 拖入的文件对象转换为可视化的绝对路径卡片。这些卡片显示文件名、完整绝对路径，并提供一键移除的操作，最终将纯净的路径字符串提交给 Agent。

核心功能¶

拖放与展示：支持在 DSH Desktop 窗口内拖入单个或多个文件，生成包含文件名、完整绝对路径及移除按钮的卡片。
路径处理：支持包含空格、中文文件名、盘符路径、UNC 路径及 POSIX 路径。支持 Windows 路径不区分大小写的去重。
数量限制：每个草稿限制 50 个本地路径卡片。
原生集成：将每个卡片存储为 Composer 的原生引用节点，遵循正常的提交、失败恢复、草稿清除和会话隔离行为。

安装与启用¶

下载：从 Releases 页面下载 dsh-local-path-attachments-0.1.1.tgz。
安装：在 Desktop Profile 目录下执行安装命令：

    pnpm add "D:\path\to\dsh-local-path-attachments-0.1.1.tgz"

配置：打开 Desktop Profile 的 package.json，将插件名称追加到 dsh.profile.bundles 数组中：

    {
      "dsh": {
        "profile": {
          "bundles": [
            "dsh-local-path-attachments"
          ]
        }
      }
    }

重启 DSH Desktop 完成启用。

典型用法¶

打开 DSH 对话窗口。
从文件资源管理器或 Finder 中拖拽文件到 Desktop 窗口内。
在 Composer 区域查看生成的路径卡片，确认文件名和路径无误，或点击移除按钮删除不需要的卡片。
提交消息。此时 Agent 收到的消息中包含完整的绝对路径字符串，而非文件内容。

适用场景与注意¶

适用场景：适合需要在 Agent 上下文中引用本地文件，但不想或无法将文件复制到工作区的场景。
安全与权限：
- 绝对路径会作为用户消息的一部分发送，可能包含用户名或敏感目录名。
- 文件字节不会经过该插件传输。
- 读取工作区外文件仍受当前 DSH 沙箱和审批策略限制。
- 一张路径卡片无法绕过操作系统权限或 DSH 安全边界。
文件状态：移动或删除源文件不会更新已存在的卡片。
平台差异：macOS/Linux 的 DSH Desktop 路径感知功能已实现，但尚未经过维护者的实地测试。Web GUI 仅在无法安全解析绝对路径时才保持原有拖放行为。

该插件基于 MIT 许可证开源，维护者提供了完整的测试覆盖。如需查看源码或提交问题，可访问 GitHub 仓库。