dsh-files-native
DSH 插件:接近原生质感的附件上传——拖入/粘贴/回形针,图片缩略图与文件卡片混排在官方附件栏
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:meyaomiao/dsh-files-native#3f12179d7eaf2d65c322edd4746023320dd6846e
Files Native 以 dsh-files-native 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
如果附件轨帮到了你，欢迎到 GitHub 仓库 点个 Star ⭐，让更多 DSH 用户看到它。问题与建议请提 Issue。
| 插件版本 | 状态 | 对应 DSH |
|---|---|---|
| 0.2.x（当前主线，含 0.2.1） | ✅ | 0.1.5-rc.1 / 0.1.5-rc.2（及之后的 0.1.5 线） |
| 0.1.x | 🔧 维护态（仅修 bug） | DSH ≤ 0.1.2-rc.1（仍兼容 0.1.1-rc.2 / 0.1.2-alpha.4） |
inject 只有 slots。有侧栏则气泡卡走预览，没有则新页签打开。dsh-file-fix / dsh-file-upload / dsh-paste-to-path 叠装。运行时插件 id 仍是 file-native（上传路由 /plugins/file-native/*）。npm / GitHub 仓库名是 dsh-files-native。
.dsh-uploads/，同一条轨上用 64px 高可读横条卡（扩展名角标 + 文件名 + 大小）。不要和 dsh-file-fix / dsh-file-upload / dsh-paste-to-path 叠装。
| 空输入框（回形针在左，无额外上边距） | 待发：图 + 已上传 / 上传中 / 超限 |
|---|---|
| 空输入框 | 待发混排 |
| 拖入窗口任意位置 | 发送后：图与文件卡跟用户气泡（产物走官方卡） |
|---|---|
| 拖入遮罩 | 发送后 |
本地预览页（可切状态）：打开仓库里的 preview.html。市场截图清单见 screenshots.json。
| 操作 | 行为 |
|---|---|
| 拖进窗口任意位置 | 全屏「松开以添加文件」；松手即分流，不必对准卡片 |
| Ctrl+V 粘贴文件 | 同上分流；纯文本粘贴不受影响 |
| 输入框回形针 | multiple 文件选择，不限格式 |
| Esc | 取消本次拖入 |
# 方式〇: npm（推荐）
npm i -g dsh-files-native
dsh plugin --profile web add dsh-files-native
# 方式一: GitHub
dsh plugin --profile web add github:meyaomiao/dsh-files-native
# 方式二: 克隆后本地挂载
git clone https://github.com/meyaomiao/dsh-files-native.git
cd dsh-files-native
pnpm install && pnpm build
dsh plugin --profile web add .
然后彻底重启 dsh web，浏览器硬刷新。宿主入口的 inject 必须含 webServer 与 sessions（漏了 DSH 会起不来，见 插件开发门禁）。
| 半区 | 入口 | Cordis inject | 职责 |
|---|---|---|---|
| host | src/index.ts | webServer, sessions | loopback 上传/删除；文件落到会话 cwd .dsh-uploads/；agent/pre-step 注入路径清单 |
| client | src/client.ts | slots | 整窗拖入/粘贴拦截；回形针；输入框混排轨；对话区文件卡 |
关键约束：
useSession / useInput。会话 id 只读 InputZone 快照 session.id。MutationObserver。卡片一次性 portal 进相邻用户气泡栈。[data-file-native-host]:empty 隐藏，避免 composer gap 多出一截上边距。有文件时轨 padding 对齐官方图栏 4px 12px 0。.dsh-uploads/）。改仓库前先读 CONTRIBUTING.md（Issue → 分支 → Draft PR）。思考原则见 AI-ISSUE-WORKFLOW.md。插件硬约束见 AGENTS.md。