前言¶
在 DeepSeek Harness（DSH）里用右侧文档预览打开工作区文件时，官方预览头会显示路径、渲染器选择、换行开关和 Reload，但没有把预览内容或文件信息带出预览区的入口。要把 Markdown、代码或日志整份拷到剪贴板，往往只能手动全选或另开终端读文件。dsh-copy-document-preview 在预览头追加一个复制按钮：文本类文件复制全文，二进制文件则复制绝对路径，并给出成功或失败的可访问性反馈。
这是什么¶
dsh-copy-document-preview 是维护者 shellpower96 发布的 DSH 客户端插件（当前 GitHub 星标为 0）。它在侧边栏文档预览的工具栏上增加一个复制按钮，通过 Harness 自带的分页文件 Remote（remote.workspaceFiles.read）读取与预览相同的 Session 权限下的文件内容，不绕过拥有该文件的 Session。
插件无构建步骤、无运行时依赖；浏览器侧只注册文档工具栏的追加槽位 sidebar.right.tab.document.actions，不替换已有控件。界面字符串经客户端 locale 服务路由，支持英文与简体中文；样式使用宿主 --dsw-alias-* 主题令牌，随明暗模式变化。
核心功能¶
预览头一键复制¶
复制按钮渲染在预览自有控件以及「在应用中打开」之后。点击后：
- 纯文本、Markdown、代码、日志：剪贴板为文件全文（不含预览行号）。
- CSV / TSV / JSON / YAML：同样为全文。
- PDF、图片、Office（
.docx、.xlsx、.pptx）、zip 等二进制：宿主报告workspace-file/not-text时，复制该文件的绝对路径并在界面上说明，而不是静默失败。
读取方式与预览一致：remote.workspaceFiles.read(sessionId, path, { offset }, signal)，宿主对单页的字节与行数限制仍然生效。
反馈与无障碍¶
复制成功时显示勾选标记约两秒；失败时显示警告标记及原因，并通过辅助技术播报。
安装与启用¶
以下命令摘自插件 README；安装后需重启 dsh web。也可从 Plugin Market 或 Plugin Manager 安装，由管理端启用 bundle。
从 npm 注册表安装：
dsh plugin --profile web add dsh-copy-document-preview
从 GitHub 安装：
dsh plugin --profile web add github:shellpower96/dsh-copy-document-preview
若本机未配置 GitHub SSH，可使用 HTTPS 形式：
dsh plugin --profile web add https://github.com/shellpower96/dsh-copy-document-preview.git#main
卸载：
dsh plugin --profile web remove dsh-copy-document-preview
典型用法¶
- 按上文为 web profile 安装插件并重启
dsh web。 - 在 DSH 中打开任意工作区文件，使右侧文档预览显示该文件。
- 在预览头找到新增的复制按钮并点击。
- 文本类文件：到目标编辑器或聊天输入框粘贴，得到完整源文。
- 二进制文件：剪贴板为绝对路径，可按路径在本地或宿主允许的方式打开原文件。
适用场景与注意¶
适合谁：经常在 Harness 侧边栏预览代码、配置、日志或 Markdown，需要把整份内容贴到 issue、文档或对话里的开发者。
限制（README 已说明）：
- 剪贴板写入依赖
navigator.clipboard，页面须为安全上下文（https://或http://127.0.0.1），且页面需处于焦点；无execCommand('copy')回退。 - 超过宿主单页限制（
maxLines、maxBytes）或超过 200 页的文件会按宿主too-large报错；插件无法从二进制文件提取文本。
安全与许可：插件在当前 dsh 进程权限下运行，安装前请自行查看仓库源码与许可证（MIT）。DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以仓库 README 与 package.json 为准。
结尾¶
dsh-copy-document-preview 补上了官方文档预览头缺少的「带出内容」能力：文本走 Session 内读的整文件复制，二进制则明确复制路径。需要进一步了解或提 issue，可访问社区目录页与 GitHub 仓库。
- 目录页：https://www.skillhub.cn/plugins/shellpower96/dsh-copy-document-preview
- GitHub：https://github.com/shellpower96/dsh-copy-document-preview
