LQ-1123/paste-to-workspace

paste-to-workspace

[Release v0.8.1]()
GitHub
License: MIT
DSH: Web Profile

把粘贴或拖入聊天框的图片与任意文件保存为会话工作区文件，发送时以
[Image: source: ] / [File: source: ] 文本注入消息——
图片由 modlens 读图，其他文件由模型按路径直接读取。输入框保持干净，预览条
与对话气泡内直接渲染缩略图 / 文件卡片。

✨ 功能一览

- 🖼️ 任意文件拖放：从 Finder / 微信 / QQ / 网页把任意类型文件拖到窗口
任意位置即保存到工作区 .dsh-paste/，进入待发预览条（纯文本/链接拖放仍走
原生行为）
- 📋 图片粘贴：Cmd/ctrl+V 粘贴截图/图片同样进入待发列表
- 🎨 类型图标渲染：图片显示缩略图；其他文件显示 RemixIcon line 图标 +
原始文件名 + 大小（PDF/Word/Excel/PPT/TXT/Markdown/压缩包/音视频/代码/
字体/电子书等 15 组），未知格式用代码图标兜底，样式随浅/深主题
- ⬇️ 点击即下载：点文件卡片唤起浏览器另存为（保留原始文件名），不再打开
预览页
- 🚀 纯文件发送：只上传文件、不输入任何文字也能发送（Enter 或发送按钮
均可），一次调用 = 一个回合，文字与文件不拆消息
- 🧵 一回合双气泡：文字留在原气泡、图片/文件卡片移到独立用户行（显示层
拆分，模型侧始终是一条消息）
- 🌓 主题适配：卡片底色/边框/文字/图标全部走宿主设计 token，深浅主题
自动切换
- ✏️ 官方提示文案改写：拖放时宿主全页提示"图片拖动到此处即可添加"自动
改写为"文件拖动到此处即可添加"，限制行替换为任意文件说明
- 🧹 30 天自动清理：超期文件自动清扫（只动插件自己的 pasted- 文件）

🚀 安装

前置：已装好 DSH（dsh web 可正常运行），dsh plugin 可用（依赖 pnpm）。

从 GitHub 安装（推荐，一行命令，产物已入库无需构建）：

dsh plugin --profile web add "github:LQ-1123/paste-to-workspace"
验证 bundle 已挂载
dsh --profile web --dump-config | grep paste-to-workspace

也可以本地路径（开发调试时）或 npm 包名安装：

dsh plugin --profile web add /path/to/paste-to-workspace

安装后重启 dsh web 生效：宿主在进程启动时通过 package.json 的
dsh.client 声明发现浏览器端 bundle，浏览器端无需额外配置。

禁用与重新启用

在 Profile patch 或 overlay 中把 bundle 行设为 disabled: true：

- id: paste-to-workspace
disabled: true

删除该字段或设为 false 即可重新启用。

卸载

dsh plugin --profile web remove @dsh-user/paste-to-workspace

📖 使用

重启 GUI 后：

1. 拖入任意文件（.txt / .md / .pdf / .doc / .zip …）或粘贴图片：输入框
上方出现预览条——图片为缩略图、其他文件为图标卡片（点击卡片下载、
点灰色 × 移除）；
2. 发送（Enter 或发送按钮，不输入文字也可以）：一次回合——有文字时
显示两个气泡（文字一条、媒体一条），纯文件只有一条；
3. 模型侧收到 [Image: source: /Users/.../.dsh-paste/pasted-.png]（modlens
自动读图）或 [File: source: /Users/.../pasted-*.txt]（模型按路径读取
文件内容）；
4. 文件落在工作区 .dsh-paste/ 目录，历史消息里点击文件卡片可随时重新下载。

🧩 工作原理

- 浏览器侧（lib/client.js）：捕获阶段拦截图片粘贴与任意文件拖放 →
POST 到宿主路由 → 路径进入旁路待发列表（草稿零改动）；
conversation.input.dock 预览条渲染待发项；发送时包装 sendSession 把
路径拼成 token 追加到消息（一次调用 = 一个回合）；MutationObserver 把
已发送消息里的 token 显示层替换为图片/文件卡片并拆成两个气泡；拖放期间
改写宿主"图片…"提示文案。
- 宿主侧（lib/index.js）：POST /save 保存任意类型文件到
/.dsh-paste/pasted--.（扩展名取自原始
文件名，无扩展名文件按原名保存）；GET /file?path=…[&meta=1] 回读文件 /
返回原始文件名与大小；DELETE /file?path=… 移除未发送文件。路径校验严格
（必须位于已知粘贴根目录内且匹配插件命名格式），跨站请求 403。

⚠️ 已知限制

- 粘贴（Cmd+V）只拦截聊天输入框内的图片；文件请用拖放
- 不支持拖入文件夹（请打包成 zip 再拖）
- 单文件上限约 24 MB（base64 后 32 MB JSON 体）
- 发送过的文件在 .dsh-paste/ 保留 30 天后自动清理，历史卡片点击下载可能
404（预期行为）
- 待发文件是全局列表：未发送前切换会话，文件会跟着下一次发送走
- 拖放提示文案改写仅作用于拖放进行时；宿主 UI 若有其他“图片”字样不在本
插件职责范围

📜 许可

MIT。文件图标来自 RemixIcon（Apache-2.0），path 数据
内嵌于客户端 bundle。

🕒 更新历史

- v0.8.1：官方拖放提示“图片”→“文件”运行时改写；限制行替换为任意文件说明
- v0.8.0：点击文件卡片直接下载（保留原始文件名）；图片缩略图仍为预览
- v0.7.9：纯文件发送（空草稿占位符保持发送按钮可用，Enter/按钮均可）
- v0.7.8：移除按钮改灰色 ×、置于卡片内部，卡片加高至 48px
- v0.7.7：修复 .ts 被解析为视频的冲突（TypeScript 优先）
- v0.7.6：中性单色图标（随主题），未知格式改用代码图标兜底
- v0.7.5：改用 RemixIcon line 图标（内嵌 SVG，无网络依赖）
- v0.7.4：全格式覆盖，无扩展名文件按原名保存
- v0.7.3：图标瓦片加宽（更“胖”）
- v0.7.2：文件卡片/图标紧凑化
- v0.7.1：样式随宿主主题 token 切换
- v0.7.0：拖放支持所有文件类型 + 文件图标渲染
- v0.6.x：30 天自动清理、串行保存、流式输出、拖放接管全局化
- v0.3 ~ v0.5：输入框保持干净、缩略图预览条、一回合双气泡