CocoSgt/dsh-attachments 预览 preview

CocoSgt/dsh-attachments

Project Overview项目介绍

This is a third-party native plugin built exclusively for DeepSeek Harness (DSH) that enables users to add any file (including images) to their AI conversation without type-based rejection. It can be installed via the DSH CLI from npm using the command dsh plugin --profile web add dsh-attachments, or directly from this GitHub repository with dsh plugin --profile web add github:CocoSgt/dsh-attachments. After installation completes, you must restart the dsh web process for the plugin to load and become active. It adds three intuitive new UI entry points for file upload to the DSH web client interface.

The plugin stores uploaded files in the ./dsh/uploads/ directory of your current session workspace, and displays each file as an interactive card above the input composer. The three upload entry points are a paperclip button on the input toolbar that opens a multi-select file picker, full-window drag-and-drop with an overlay hint, and direct paste of files from your clipboard. Each card shows the file name, size, and a delete button; image cards also show a local thumbnail preview. Clicking a card opens a preview overlay with options to open the file or copy its reference for later re-use.

There are several important limitations to be aware of before using the plugin. It requires an active session workspace to store files, so no files can be uploaded when no workspace is set. Each file is capped at 32MB due to RPC transfer limits, and any file larger than that will fail loudly instead of being accepted silently. Unsent pending attachments are lost when DSH restarts, and the ./dsh/uploads/ directory is not automatically garbage-collected. The plugin is released under the open-source MIT license, free to use and modify.

这个仓库是专为 DeepSeek Harness 开发的第三方原生插件,核心功能是允许用户将任意格式文件(包括图片)添加到 AI 对话上下文,不会因为文件类型或模型不支持视觉能力而拒绝上传。它会将文件写入会话工作区的 .dsh/uploads 目录,以带操作按钮的卡片形式展示在输入框上方,不会在输入框中添加额外引用文本,始终保持草稿干净。

它提供三种添加附件的入口方式:点击输入工具栏左侧的回形针按钮打开文件选择器(支持多选无格式过滤)、全窗口拖放文件、直接粘贴文件。用户发送消息时,插件会在 agent/pre-step 阶段将附件列表自动注入到模型请求中,注入完成后附件卡片自动消失。这个插件面向需要在 DSH 对话中灵活上传各类文件,不想被默认上传规则限制的用户。

单个文件大小上限为 32MB,超大文件需要用户自行放到项目目录并在消息中引用路径;插件要求会话必须有工作目录,否则无法存储文件;未发送的附件会在 DSH 重启后丢失,上传目录不会自动垃圾回收。可以通过 DSH 的 CLI 命令从 npm 或 GitHub 安装,采用 MIT 许可证开源。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • 12 stars - an early-stage project星标 12,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-attachments

把 CocoSgt/dsh-attachments 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-attachments

简体中文 | English

npm package: dsh-attachments · GitHub repository: CocoSgt/dsh-attachments

A third-party attachment plugin for DeepSeek Harness (dsh): bring any file into the conversation, zero type rejection.

  • Every file — images included — goes through the stash pipeline: the file is written to the session workspace at <cwd>/.dsh/uploads/ and staged per session, and a card (icon tile + file name + size + ✕) appears above the composer. Nothing uses the host's native draft-image pipeline (createDraftImages/addImages are not used); if the model needs to see an image, it reads it by path with the harness-native read_image tool, so non-vision models are never blocked by "this model doesn't support images".
  • The draft stays completely clean — no reference text is ever written into the input box. When you send your next message, the host folds the attachment list into the model request during the agent/pre-step wave as a message with source: { kind: 'user' } (inserted right before your message, same injection pattern as the official dsh-agent-instructions), so it lands in the logs and replays safely. After injection the cards disappear automatically.
  • Whether — and how — to handle a file is the model's business. The plugin does no type sniffing, so there is no "unsupported format" rejection. The only hard limit is the 32 MB per-file RPC transfer cap (put larger files directly into the project directory and reference the path in your message).

Entry points

  1. Paperclip button (left end of the input toolbar): opens a file picker, multi-select, no accept filter.
  2. Full-window drag & drop: dragging files anywhere over the window shows an overlay hint; drop to bring them in.
  3. Paste: pasting files lands them through the same intake. Pasting text that contains attachment reference lines (📎 … → .dsh/uploads/…, e.g. copied from a previous message) re-materializes them as cards.

Attachment cards

Stashed files render as cards above the composer (conversation.input.dock): extension icon tile + file name + size + ✕. The ✕ removes the file from the session stash and deletes it from disk. Image cards carry a local thumbnail preview. Cards are backed by the host-side pending list as the source of truth (listStash) and refresh via 2-second polling (they vanish once the stash is consumed by a send). Clicking a card opens a preview overlay: images render directly, text/code render as plain text, everything else offers "open with system app", and the header carries a "copy reference" action whose text is the attachment's wire format — paste it back into the composer to re-attach.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev sgme 下一个 Next dsh-router-flash →