在 DeepSeek Harness Web 中处理本地文件时,通常存在一个割裂点:macOS Finder 复制文件后,剪贴板中存储的是原生文件列表而非纯文本路径。由于浏览器的安全隔离,编辑器无法直接获取本地文件系统的绝对路径。dsh-paste-path 插件通过读取 macOS 原生剪贴板数据,在不触发浏览器权限弹窗、不上传文件的前提下,将文件路径直接传递给编辑器。
插件简介¶
该插件是 DeepSeek Harness 的一个 macOS 客户端扩展。它利用 osascript 读取剪贴板中的文件列表数据(NSFilenamesPboardType),并在编辑器提示时通过 Ctrl+V 将绝对路径插入草稿。它不修改普通的文本粘贴行为(Cmd+V),也不对文件进行任何形式的打开或上传操作。
安装与启用¶
使用官方命令安装插件:
dsh plugin --profile web add dsh-paste-path
安装完成后,需要重启 dsh web 服务并刷新页面以使插件生效。
使用方法¶
- 在 macOS Finder 中选中一个或多个文件或文件夹,按
Cmd+C复制。 - 返回 DSH Web 界面。
- 当编辑器提示显示“Ctrl+V Paste path”时,按下
Ctrl+V。 - 插件会将选中项目的绝对路径插入到当前草稿中,每个路径占一行。
插件会自动跳过草稿中已经存在的重复路径。
注意事项¶
- 平台限制:该插件仅适用于 macOS 平台。
- 网络环境:剪贴板端点仅接受回环连接。因此,在远程 DSH 部署场景下(例如通过公共主机名或局域网 IP 访问),插件将因 403 错误而无法提供本地路径。
- 权限问题:macOS 可能会因自动化权限限制而拒绝
osascript的访问,需要手动授予相关权限。 - 行为定义:插件仅传递路径字符串,不上传文件内容,也不缓存 HTTP 响应。