运行时插件 id 仍是 file-native（上传路由 /plugins/file-native/*）。npm / GitHub 仓库名是 dsh-files-native。

• 图片（PNG / JPEG / WebP / GIF）走官方草稿图栏（64px 缩略图，点击灯箱），发送后进模型视觉上下文。
• 其它文件落到会话工作区 .dsh-uploads/，同一条轨上用 64px 高可读横条卡（扩展名角标 + 文件名 + 大小）。
• 发送后文件卡贴在用户气泡栈（与官方图同一列），作业回复不会插在提问和文件中间。
• 发送成功即清输入框待发轨。回复结尾只画「产物」chip。

不要和 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。

限制

• 单文件 50 MB，单批 20 个。
• 上传路由仅 loopback。
• 刷新会丢掉「已上传未发送」的文件卡（磁盘文件仍在 .dsh-uploads/）。