dsh-clipfile：在 DSH Composer 中挂载文件与文件夹

在 DeepSeek Harness (DSH) 的 Web 端编辑器中，直接传递文件或文件夹结构往往需要手动上传或编写复杂的路径引用。dsh-clipfile 插件为 DSH Composer 增加了原生的文件挂载能力，支持剪贴板粘贴、原生文件选择器以及路径模糊搜索，解决文件传递的交互瓶颈。

这是一个由 whyzsm 维护的客户端插件，旨在简化 DSH Web 端编辑器中的文件交互。

核心功能¶

该插件提供了以下四种文件交互方式：

1. 剪贴板粘贴：在 macOS Finder 中复制文件或文件夹，在编辑器中直接按 ⌘V 粘贴。插件通过 osascript furl 检测剪贴板内容，无需上传文件。
2. 原生文件选择器：点击编辑器旁的 ＋ 按钮，调用 macOS 原生文件选择器（NSOpenPanel），支持多选文件或文件夹。
3. @ 提及路径补全：在编辑器中输入 @ 后跟关键词，利用 mdfind 进行路径模糊搜索，自动补全文件路径。
4. 分页 Markdown 转换：粘贴的文件夹会转换为 INDEX.md（索引页）和 pages/*.md（分页内容），供智能体按页阅读，避免一次性加载过多数据。
5. 可移除的标签：每个附件以标签形式显示，点击 ✕ 即可移除。标签仅对当前会话有效，切换对话时显示该对话的附件，发送消息后自动清理。

安装与启用¶

安装该插件只需执行以下命令：

dsh plugin --profile web add whyzsm/dsh-clipfile

典型用法¶

1. 在 Finder 中选中文件或文件夹，在 DSH 编辑器中按下 ⌘V 粘贴。
2. 点击编辑器旁的 ＋ 按钮，打开系统文件选择器进行多选。
3. 输入 @ 后跟文件路径中的关键词，系统会自动补全路径。

注意事项¶

• 平台限制：该插件仅支持 macOS 平台，依赖 osascript、NSOpenPanel 和 /opt/homebrew/bin/python3。
• 零拷贝机制：附件处理采用零拷贝机制：插件读取原始路径的只读内容，并将转换后的分页 Markdown 打包写入 .dsh-clipfiles/md/ 目录。
• 会话作用域：附件标签仅对当前会话可见，切换对话时显示该对话的附件，发送消息后自动清除。

总结¶

dsh-clipfile 通过原生的文件交互方式，提升了 DSH Web 端处理本地文件和文件夹的效率。更多细节可查看插件目录或源码。