<div align="center">
dsh-attachment
<img src="assets/markdown/attachment.svg" alt="附件图标" width="250" height="250" />
为 DeepSeek Harness 带来直观、持久、低侵入的文件与文件夹附件体验。
拖放即用 · 保留目录树 · 输入区与历史消息一致展示 ฅ( ̳• ·̫ • ̳ฅ)
[English](README.en.md) · 简体中文
 !DSH Plugin !Version !License
</div>
---
✨ 功能亮点
| 能力 | 表现 |
|---|---|
| 📁 文件夹拖放 | 一个文件夹对应一张附件卡片，同时完整保留内部目录树 |
| 📄 普通文件 | 支持拖入、预览卡片、持久化历史与流式下载 |
| 🖼️ 原生图片共存 | PNG、JPEG、WebP、GIF 继续使用 Harness 原生图片预览、画廊和多模态检查 |
| 🧠 模型可读取 | 提交后写入当前工作区的 .deepseek-harness/attachments/，为模型提供明确路径 |
| 🧩 低侵入扩展 | 通过公开的输入附件栏 slot、会话定义与 Host 路由完成集成 |
| 🪶 原布局保持 | 输入区没有插件附件时，页面布局和原版 Harness 保持一致 |
插件自身不设置附件数量或单文件字节上限；实际可用范围由浏览器、运行环境与目标模型共同决定。
🖼️ 效果预览
拖放界面
拖入文件或文件夹时，只在原界面上方增加清晰的虚线边界，Harness 原生图片接收界面仍然保留。
<p align="center"> <img src="assets/markdown/01-drag-drop-overlay.png" alt="拖放附件界面" width="760" /> </p>
图片消息历史
原生图片消息继续显示在持久化会话历史中，并可交给支持多模态输入的模型。
<p align="center"> <img src="assets/markdown/02-image-conversation.png" alt="图片消息与模型回复" width="700" /> </p>
多图片预览
多张原生图片与插件提供的文件、文件夹卡片共用同一条输入附件区域。
<p align="center"> <img src="assets/markdown/03-multiple-image-preview.png" alt="多图片输入预览" width="700" /> </p>
🚀 安装
当前版本可直接从 npm 安装到原生 DSH 的 web profile：
dsh plugin --profile web add dsh-attachment检查组合后的配置并启动 DSH：
dsh --profile web --dump-config
dsh --profile web移除插件：
dsh plugin --profile web remove dsh-attachment🧭 工作流程
flowchart LR
A["拖入文件或文件夹"] --> B["输入区附件卡片"]
B --> C["提交用户消息"]
C --> D["持久化附件元数据"]
D --> E["复制到工作区附件目录"]
E --> F["模型读取文件或目录树"]- 浏览器端负责拖放识别、上传、输入卡片和历史渲染；
- Host 端负责字节传输、持久化元数据、下载路由与工作区落盘；
- 图片继续走 Harness 原生链路，插件只接管普通文件与文件夹；
- 拖入目录时，内部成员按完整目录树传输，不会拆成大量输入卡片。
📦 DSH 插件约定
本仓库是可直接安装的标准 DSH bundle：
package.json声明dsh.bundle.patch；cordis.patch.yml插入 Host 插件行；dsh.client.platform设置为web；exports["./client"]暴露预构建浏览器 bundle；- 官方
@deepseek-ai/*包全部使用peerDependencies； - 插件与 Tauri API 解耦，可用于原生 DSH Web profile。
🧪 开发与验证
环境要求：Node.js ^22.19.0 || >=24.0.0、pnpm。
pnpm install
pnpm run build
pnpm test
npm pack --dry-run当前版本面向 DeepSeek Harness 0.1.0-rc.5 的标准 bundle、Web Client 发现、输入附件栏、会话事件与 Host 路由接口。
🔐 安全与跨平台
- 文件名、MIME 类型、附件 ID 与目录成员路径均按不可信输入校验；
- Windows 盘符、UNC 路径、绝对路径及目录穿越片段会在写入前被拒绝；
- GitHub CI 同时覆盖 Linux 与 Windows，避免路径语义差异造成回归；
- 安全问题报告方式及支持范围见 [
SECURITY.md](SECURITY.md)。
🛍️ 插件市场
Marketplace 数据模板、截图 URL 和提交前检查项记录在 [MARKETPLACE.md](MARKETPLACE.md)，README 图片资源位于 [assets/markdown/](assets/markdown/)。
📄 License
[MIT](LICENSE)
<div align="center">
让附件安安静静待在该在的位置，也让模型更轻松地找到它们。 (｡•̀ᴗ-)✧
</div>