dsh-files-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 meyaomiao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+<div align="center">
+
+# dsh-files-native
+
+**给 [DeepSeek Harness](https://github.com/deepseek-ai) 接近原生质感的附件上传：拖入 / 粘贴 / 回形针，图片缩略图与文件卡混排在官方输入框同一条轨。**
+
+[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-4d6bfe)](https://github.com/topics/dsh-plugin)
+[![npm](https://img.shields.io/npm/v/dsh-files-native)](https://www.npmjs.com/package/dsh-files-native)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+
+</div>
+
+运行时插件 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` 叠装。
+
+## 截图
+
+| 空输入框（回形针在左，无额外上边距） | 待发：图 + 已上传 / 上传中 / 超限 |
+|---|---|
+| ![空输入框](screenshots/01-empty.png) | ![待发混排](screenshots/02-rail.png) |
+
+| 拖入窗口任意位置 | 发送后：图与文件卡跟用户气泡，产物在回复尾 |
+|---|---|
+| ![拖入遮罩](screenshots/03-overlay.png) | ![发送后](screenshots/04-sent.png) |
+
+本地预览页（可切状态）：打开仓库里的 [`preview.html`](preview.html)。
+
+## 入口
+
+| 操作 | 行为 |
+|---|---|
+| 拖进窗口任意位置 | 全屏「松开以添加文件」；松手即分流，不必对准卡片 |
+| Ctrl+V 粘贴文件 | 同上分流；纯文本粘贴不受影响 |
+| 输入框回形针 | `multiple` 文件选择，不限格式 |
+| Esc | 取消本次拖入 |
+
+## 安装
+
+```bash
+# 方式〇: 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 会起不来，见 [插件开发门禁](docs/plugin-dev-gate.md)）。
+
+## 当前实现
+
+| 半区 | 入口 | 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/`）。

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-files-native:接近原生质感的附件上传。
+# 运行时插件 id 仍为 file-native(上传路由 /plugins/file-native/*、notice.plugin)。
+# 图片走官方草稿图;其它文件落到会话工作区 .dsh-uploads/,发送时把相对路径交给模型。
+- insert:
+    - id: file-native
+      name: dsh-files-native