📎 dsh-screenshot-paste

为 DeepSeek Harness (DSH) Web GUI 提供截图与文件粘贴板功能：粘贴、拖拽或浏览上传文件，以引用芯片的形式置于输入框上方，发送消息时自动附带文件路径。

纯外部插件：不修改 DSH 源码，仅使用官方扩展点（UI 插槽、API 路由、agent/pre-step 事件）。

---

✨ 功能特性

	特性	说明
📋	多方式上传	Ctrl+V 粘贴、拖拽、点击浏览（支持多文件）
🗂️	文件类型丰富	图片 / PDF / Office 文档 / 压缩包 / 音视频 / 文本；白名单之外的类型（如 .exe）明确拒绝
🏷️	引用芯片	上传的文件以芯片形式显示在输入框上方，支持预览与移除
📤	自动附带路径	发送消息时自动将文件路径追加至消息内容，发送后自动清空
🧹	零输入框污染	不向输入框、光标或草稿插入任何内容
💰	零常驻开销	不注册工具、不贡献提示词；无引用时对模型请求无任何影响
🔒	安全	所有 API 仅限本机回环访问；文件名经过校验，防止路径穿越；保存目录自动创建

📦 安装

环境要求

• 已安装 DeepSeek Harness 及其 dsh 命令行工具
• 目标 profile 为 web

安装插件

固定版本（推荐，可复现）：

dsh plugin --profile web add github:PdxGame/dsh-screenshot-paste@v0.1.0

如需跟踪最新 main，去掉 @v0.1.0 后缀。

[!TIP] 若 dsh 不在 PATH（例如通过 pnpm dsh 启动的环境），在 DSH 安装目录下改用：

pnpm dsh plugin --profile web add github:PdxGame/dsh-screenshot-paste@v0.1.0

[!IMPORTANT] 安装完成后，重启 dsh web 并强制刷新浏览器（Ctrl+F5），客户端资源才会重新加载。

安装后验证

重启后打开 http://127.0.0.1:3080，任意会话输入框工具区应出现 📎 按钮。也可命令行验证宿主 API：

curl http://127.0.0.1:3080/api/screenshot-paste/list
# 应返回 {"dir":"F:\\dsh-screenshots","files":[...]}