长文粘贴转附件 zhanghui6666/paste-as-text-attachment

把粘贴内容转成文本附件（DSH 插件）

把粘贴进 DSH 聊天输入框的超长文本变成 .txt 附件——正常打字和短粘贴不受影响。

中文简介：这是一个 DeepSeek Harness（DSH）Web 插件，可将聊天输入框中超过设定字符数的粘贴内容转成 .txt 附件。可在插件详情页开启或关闭功能并设置字符阈值。

功能

- 只监听当前聚焦的 DSH 聊天输入框里的粘贴事件。
- 只转换 JavaScript 字符串长度大于设定阈值的文本。
- 走 DSH 原生的文件接收路径，保留内置的附件栏和上传界面。
- 短粘贴、普通打字、以及输入框失焦时的粘贴都不受影响。
- 在内存里创建文本文件，不会把粘贴内容写到磁盘。
- 在 DSH 的 Plugins 视图里提供中英文配置页。

配置

在 DSH 中打开 Plugins → Installed → paste-as-text-attachment。插件详情页提供以下设置：

| 设置 | 默认值 | 范围 / 行为 |
| 自动转换 | 开 | 打开或关闭长粘贴转换。 |
| 字符阈值 | 10,000 | 1 到 10,000,000 之间的整数。只有超过该值的粘贴才会被转换。 |

阈值按 JavaScript 的 String.length（UTF-16 码元）计算，不是 UTF-8 字节数。设置保存在当前 DSH Web GUI 的浏览器 localStorage 中；在该 GUI 里刷新后仍然有效，但不会在配置档、浏览器或设备之间同步。

安装

在 DSH 的 Plugins → Add plugin 页面，用本仓库的 Git 地址安装：

https://github.com/zhanghui6666/paste-as-text-attachment.git

安装后 DSH 可能会提示你启用该插件包。

工作原理

插件监听 conversation.input.overlay 列表插槽，而不是替换 conversation.input.attachments——后者是单占位插槽，由 DSH 内置的附件栏使用。当出现符合条件的粘贴时，插件在内存里创建一个文本 File，并向当前聚焦的编辑器派发一个只含文件的合成 ClipboardEvent。随后 DSH 自己的粘贴处理器执行正常的附件接收流程。只有当宿主处理了该文件事件时，原来的文本粘贴才会被取消。

兼容性与隐私

- 需要 DSH Web Client 提供 conversation.input.overlay 插槽，并能处理输入框粘贴事件中的文件项。
- 需要浏览器支持 File、DataTransfer、ClipboardEvent 和 localStorage。
- 本插件不保留粘贴的文本，也不写入磁盘。文件一旦被接收，就交给 DSH 正常的附件/上传流程处理。
- 测试套件模拟了宿主编辑器的文件粘贴处理器。在依赖它处理重要日志之前，请先在目标 DSH 版本中验证行为。

开发与测试

不需要外部测试依赖；测试使用 Node 内置的测试运行器。

node --test client.test.js
测试覆盖插槽注册、配置项控制与持久化、阈值行为、禁用模式，以及宿主编辑器不接管合成文件事件时的回退逻辑。

项目文件

| 文件 | 用途 |
| client.js | 粘贴监听、配置页面，以及浏览器端设置。 |
| index.js | 宿主组合包入口。 |
| cordis.patch.yml | 向 DSH 注册组合包的插件行。 |
| package.json | DSH 组合包与 Web Client 元数据。 |
| client.test.js | 使用模拟 DSH 编辑器的本地单元测试。 |

许可证

本项目采用 MIT 许可证。完整文本见 LICENSE。

中文说明

功能

- 只监听 DSH 聊天输入框中的粘贴事件，不拦截手动输入。
- 仅当文本长度大于字符阈值时，才转为 .txt 附件。
- 走 DSH 编辑器原生附件接收流程，保留内置附件栏和上传状态展示。
- 短文本粘贴、输入框外粘贴，以及普通打字均不受影响。
- 文件在内存中创建；插件本身不会把粘贴内容写入本地磁盘。

配置

在 DSH 中打开 插件 → 已安装 → paste-as-text-attachment，可启用/关闭自动转换并设置字符阈值。默认开启，阈值为 10,000，可设为 1–10,000,000 的整数。仅超过阈值的粘贴内容会转换。

长度按 JavaScript String.length 计算（UTF-16 代码单元），不是 UTF-8 字节数。设置保存在当前 DSH Web GUI 的浏览器 localStorage 中，可跨页面刷新保留，但不会在不同 profile、浏览器或设备之间同步。

安装

在 DSH 的 插件 → 添加插件 页面填入本仓库的 Git 地址：

https://github.com/zhanghui6666/paste-as-text-attachment.git

安装后如有提示，再启用该组合包。

兼容性与验证

插件通过 conversation.input.overlay 列表插槽观察粘贴，不会替换 DSH 自带附件栏所使用的单占位 conversation.input.attachments 插槽。检测到符合条件的粘贴后，插件会创建内存中的文本文件，并向当前编辑器派发仅含文件的合成粘贴事件；只有 DSH 编辑器接收该事件后，原始文本粘贴才会被取消。

需要 DSH Web Client 提供上述插槽并支持编辑器粘贴接收文件。当前自动化测试对 DSH 编辑器接收文件的行为使用了模拟实现；正式使用重要日志前，请先在目标 DSH 版本中完成端到端验证。

本地测试

使用 Node.js 内置测试运行器，无需额外测试依赖：

node --test client.test.js