前言¶
在 DeepSeek Harness Desktop 里写消息时，用截图工具复制到剪贴板的图片，往往无法用桌面壳自带的右键菜单「Paste」贴进输入框：该菜单是英文界面，且 Paste 角色不处理「仅剪贴板图片」的情形。Ctrl+V 在 Harness Composer 里通常仍可用，但若你希望与本地化菜单一致、或需要把粘贴的图片在会话工作区留档，就需要额外能力。下面介绍社区客户端插件 COLAR IMAGEM DEEPSEEK HARNESS（包名 dsh-colar-imagem-deepseek-harness），由 wgrbiss-spec 维护，通过替换 Composer 右键菜单并增加 Colar imagem / Paste image，走与原生粘贴相同的附件管线。
这是什么¶
该插件面向 DeepSeek Harness Desktop 的消息输入区（Composer）。它在右键菜单中提供粘贴剪贴板图片的入口，图片会作为草稿附件挂接（缩略图、上传进度、大小与数量限制、Host 拒绝提示等与原生粘贴一致）。可选地在当前会话工作区写入副本，默认目录为 pasted-images/YYYY-MM-DD/。数据在本地处理：Host 通过系统剪贴板工具读图，不依赖浏览器 clipboard-read 权限弹窗；路由限制在 loopback 与同源，插件本身不上传字节。
分类上属于 DSH 客户端插件；当前 GitHub 星标为 0（以目录页信息为准）。许可证为 MIT（见仓库 package.json）。
核心功能¶
右键菜单与语言¶
- 激活后替换 Composer 的右键菜单为 Harness 侧本地化菜单，保留 Recortar / Copiar / Selecionar tudo（剪切 / 复制 / 全选）。
- 剪贴板为图片时：Colar imagem / Paste image。
- 剪贴板为纯文本时：菜单退化为 Colar / Paste，在光标处插入文本。
- Ctrl+V 保持原生行为；开启工作区副本后，可配置是否在
Ctrl+V粘贴时也写副本（默认关）。
附件与工作区副本¶
- 默认只把图片挂到草稿，不写工作区文件（
saveWorkspaceCopies默认false）。 - 开启后，副本路径形如：
<workspace>/pasted-images/YYYY-MM-DD/colada-YYYY-MM-DD-HH-MM-SS.png；同名不覆盖，会加数字后缀。 - 设置页 Settings → COLAR IMAGEM 可调：启用菜单、工作区副本、
Ctrl+V副本、副本文件夹、剪贴板诊断等。 - 默认隐藏设置页头部的官方 「Open configuration file」 按钮（可在设置中关闭隐藏）。
剪贴板后端（Host）¶
| 系统 | 图片 / 文本（摘要） |
|---|---|
| Linux X11 | xclip |
| Linux Wayland | wl-paste（需 wl-clipboard） |
| macOS | osascript + pbpaste / pbpaste |
| Windows | PowerShell + Windows Forms |
README 标明 Linux（X11、Wayland）为已测目标；macOS、Windows 为 best-effort，无 CI。无系统后端时会回退浏览器剪贴板 API（可能触发 clipboard-read）。
限制（使用前知晓）¶
- 仅处理剪贴板 图片数据 与文本；文件管理器复制的文件引用（
text/uri-list）在 0.1.1 不会变成附件。 - 工作区副本不会自动清理。
- 插件在活跃时会 整体替换 Composer 右键菜单；撤销 / 重做仍用
Ctrl+Z/Ctrl+Shift+Z。
安装与启用¶
环境要求（来自 README / package.json）：DeepSeek Harness Desktop 0.2.2-rc.1 及以上，且 <0.3.0；Node >=22（开发与打包用）。
官方安装命令：
# Desktop app profile
dsh plugin --profile desktop add dsh-colar-imagem-deepseek-harness
也可安装本地打包文件：
dsh plugin --profile desktop add ./dsh-colar-imagem-deepseek-harness-0.1.1.tgz
安装后须 重启 Desktop 应用（Host 在启动时注册 HTTP 路由，仅刷新页面不够）。GUI 也可通过 Plug-ins → Adicionar plugin 用包名或本地目录添加。
插件以当前 DSH 进程权限运行；安装前请自行查看仓库源码与 MIT 许可证，确认是否符合你的安全策略。
典型用法¶
- 用截图工具或其它应用将图片复制到系统剪贴板。
- 在消息输入框内 右键 → Colar imagem（或英文 Paste image）。
- 图片出现在草稿附件栏；若已开启工作区副本，Toast 会提示保存位置。
在 Settings → COLAR IMAGEM 中常见项：
- Ativar o menu Colar no campo de mensagem：开关右键菜单替换。
- Guardar uma cópia no workspace：默认关。
- Guardar cópia também no Ctrl+V：默认关（需先开工作区副本）。
- Pasta das cópias：工作区相对路径，默认
pasted-images。 - Diagnóstico：即时检测剪贴板并可试粘贴。
配置说明¶
用户开关与文件夹等多存于浏览器 localStorage。Host 侧可在 profile 的 cordis.patch.yml 中覆盖默认值：
- id: colar-imagem-deepseek-harness
config:
pastedDir: pasted-images
dateFolders: true
saveWorkspaceCopies: false
saveNativePastes: false
maxClipboardBytes: 52428800
clipboardTimeoutMs: 5000
| 字段 | 默认 | 含义 |
|---|---|---|
pastedDir |
pasted-images |
副本目录（工作区相对；绝对路径与 .. 会回退默认） |
dateFolders |
true |
是否按 YYYY-MM-DD 分子目录 |
saveWorkspaceCopies |
false |
是否默认保存工作区副本 |
saveNativePastes |
false |
「Ctrl+V 也存副本」的默认值 |
maxClipboardBytes |
52428800（50 MiB） | 接受的剪贴板图片上限 |
clipboardTimeoutMs |
5000 |
单次调用系统剪贴板工具的超时 |
工作区目录示例：
<session workspace>/
└── pasted-images/
└── 2026-11-10/
├── colada-2026-11-10-00-14-06.png
└── colada-2026-11-10-00-14-07.png
适用场景与注意¶
适合谁：经常在 Desktop Composer 里贴截图、且受限于英文右键 Paste 无法处理「仅图片剪贴板」的开发者；需要在会话工作区按日期归档粘贴图片副本、又希望附件行为与原生一致的用户。
生态说明：DeepSeek Harness 奉行「一切皆插件」；社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文不作为官方应用商店说明。
安全与隐私（README）：Host 路由 /colar-imagem-deepseek-harness/... 仅接受本地页面同源请求，跨站返回 403；剪贴板字节在本机读取，副本写在会话工作区内；插件不读取或存储模型凭证。图片随正常附件流程进入对话时，仍遵循你既有的模型与上传策略。
结尾¶
经过上面的步骤，你可以在 Desktop 消息框用右键 Colar imagem 把剪贴板图片挂进草稿，并按需在工作区 pasted-images/ 留档。当前插件版本 0.1.1。
- 社区目录页：https://www.skillhub.cn/plugins/wgrbiss-spec/dsh-colar-imagem-deepseek-harness
- 源码与文档：https://github.com/wgrbiss-spec/dsh-colar-imagem-deepseek-harness
