Back to home@Frank-NF

dsh-drop-md

Drag-and-drop markdown enhancer for DeepSeek Harness (DSH): inline small files, @-reference large ones, one-click SKILL.md install

Stars
0
Language
JavaScript
Created
Aug 30, 2026
Updated
Aug 30, 2026
GitHub repo

Introduction

dsh-drop-md

English · 中文


中文

拖拽增强插件:把 Markdown 文件直接拖进 DSH 输入框——小文件全文插入草稿,大文件落盘工作区并生成引用,SKILL.md 技能包自动校验 frontmatter 并一键安装到项目/用户技能目录。

功能

  • 拖入 .md / .txt / .markdown
    • < 50 KB:全文插入草稿(发送前可编辑)。
    • ≥ 50 KB:写入 <工作区>/.dsh-drop/<文件名>(父目录自动创建),草稿中插入 @./.dsh-drop/<文件名> 引用。
    • Shift + 拖拽:强制全文插入(上限 512 KB)。
  • 拖入 SKILL.md 技能包:frontmatter 校验(name kebab-case + description 必填),确认弹窗展示解析出的元数据,一键安装到项目(.dsh/skills/)或用户(~/.dsh/skills/)技能根,写入即生效,无需重启。
  • 零打扰:平时 dock 完全不渲染;拖拽悬停时输入框上方出现投放条;投放结果卡片约 4 秒后自动淡出。
  • 主题自适应:全部颜色使用官方主题 token,深浅色自动适配。
  • 安全设计:浏览器半通过同源 HTTP 路由访问宿主半,复刻应用自身的信任校验(loopback 授权 + 拒绝跨站 fetch + Origin 同源);无密钥、无遥测、无外网调用。

安装

dsh plugin --profile web add github:Frank-NF/dsh-drop-md

安装后重启 DSH Desktop 生效。

使用

  1. 从资源管理器拖一个 .md / .txt / .markdown 文件(或 SKILL.md 技能包)到 DSH 窗口。
  2. 输入框上方出现投放条——松手。
  3. 小文件进入草稿;大文件落盘并生成 @ 引用;SKILL.md 弹出安装确认。

环境要求

  • DSH Desktop(web profile),dsh CLI 可用。
  • 无额外依赖——React 由宿主模块加载器提供。

English

Drag-and-drop enhancement for the DeepSeek Harness (DSH) composer. Drop Markdown files straight into the input box—small files are inlined into the draft, large files are saved to the workspace and referenced, and SKILL.md packages are validated and installed to the project or user skill roots with one click.

Features

  • Drop .md / .txt / .markdown onto the composer
    • Files < 50 KB are inserted into the draft as plain text (editable before sending).
    • Files ≥ 50 KB are saved to <workspace>/.dsh-drop/<name> (parent dirs auto-created) and referenced as @./.dsh-drop/<name> in the draft.
    • Shift + drop forces full-text inline insertion (up to 512 KB).
  • Drop a SKILL.md package — frontmatter is validated (name in kebab-case + description required), a confirm dialog shows the parsed metadata, and one click installs it to:
    • Project: <projectRoot>/.dsh/skills/<name>/SKILL.md
    • User: <dshHome>/skills/<name>/SKILL.md
    • Installed skills are picked up by DSH's skill watcher immediately — no restart needed.
  • Zero clutter: the dock renders nothing until you drag a file; a drop zone appears above the composer while hovering; result chips auto-dismiss after ~4 seconds.
  • Theme-aware: all colors come from official DSH theme tokens (light/dark adaptive).
  • Safe by design: the browser half talks to the host half through a same-origin HTTP route guarded with the app's own trust checks (loopback authority, cross-site rejection, same-origin enforcement). No secrets, no telemetry, no network calls.

Install

dsh plugin --profile web add github:Frank-NF/dsh-drop-md

Restart DSH Desktop after installation.

Usage

  1. Drag a .md / .txt / .markdown file (or a SKILL.md skill package) from Explorer onto the DSH window.
  2. A drop zone appears above the composer—release.
  3. Small files land in the draft; large files land in .dsh-drop/ with an @ reference chip; SKILL.md opens an install dialog.

Requirements

  • DSH Desktop (web profile) with dsh CLI available.
  • No extra dependencies — React is provided by the host module loader.