前言¶
DeepSeek Harness（DSH）右侧的文件预览面板可以查看文件，但要把整个文件复制到剪贴板，只能手动全选。预览可能只加载部分内容，或者因为重新渲染而截断文本。这个插件在文件预览工具栏插入一个「复制整个文件」按钮，直接走 Host 的文件读取通道，复制的是磁盘上的真实字节。
它是什么¶
这是一个 DSH 插件，由 Tony250-officeteam 维护，开源 MIT 协议。它通过 sidebar.right.tab.document.actions 插槽，在文件预览标题栏右侧添加一个复制按钮，和查看器菜单、自动换行、重新加载、用 VS Code 打开等操作并列。
核心功能¶
- 复制源：使用
remote.workspaceFiles.readBytes(...)读取文件，和预览本身用的同一套 Host 读取权限，拿到的是磁盘原始字节。 - 写入校验：调用
execCommand('copy')或navigator.clipboard.writeText后，会把剪贴板内容读回，和原文件内容比对，只有匹配成功才显示勾。 - 回退路径：当
navigator.clipboard不可用或失败时，退回到临时textarea+execCommand('copy')，并恢复原来的选区。 - 边界处理：
- 二进制文件：探测前 8 KB 是否含 NUL 字节，含则拒绝并提示「这不是文本文件」。
- 文件太大：超过上限时提示「文件太大，无法一次复制」，不做截断复制。
- 空文件：提示「文件内容为空」。
- 读取失败：显示具体错误，不伪装成功。
- 未知数据形态：报出实际的类型和大小（如
string(1024)），而不是猜测。
实现细节¶
跨 Host 桥的数据不是 Uint8Array。Schema 上声明的是 Uint8Array，但跨进程结构化序列化后实际到达的是 base64 字符串（文档预览自己也用 atob 解码）。直接 new Uint8Array(someString) 会静默得到空数组，这正是「显示复制成功、剪贴板却是空的」的成因。代码接受 Uint8Array / base64 / ArrayBuffer / 类数组 / {type:'Buffer',data:[...]} 全部形态。
UTF-8 BOM 要剥掉。解码后若首字符是 U+FEFF 就丢弃，避免复制出来的文本开头多一个不可见字符。
安装与启用¶
从 GitHub 安装：
dsh plugin --profile desktop add github:<your-user>/dsh-copy-file-button
或从本地目录：
dsh plugin --profile desktop add link:/path/to/dsh-copy-file-button
安装后重启 DSH，Client 半侧需要刷新一次页面才能加载。
国际化¶
插件自带 locale/en.json，按钮文案跟随 DSH 语言设置。内置中英文词条，新增语言只需在 locale/ 下加对应 JSON。
卸载¶
从 profile 的 package.json 中移除该条目（dependencies 与 dsh.profile.bundles），删掉 node_modules 里的链接，重启即可。
适用场景与注意¶
- 适合需要从 DSH 文件预览直接复制完整文件内容到剪贴板的使用场景。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
总结¶
这个插件解决了在 DSH 预览面板中手动复制大文件或完整文件不方便的问题，通过 Host 通道读取真实字节，并做写入校验，确保剪贴板内容正确。
- 目录页：https://www.skillhub.cn/plugins/Tony250-officeteam/dsh-copy-file-button
- GitHub：https://github.com/Tony250-officeteam/dsh-copy-file-button
