DeepSeek Harness Hub
← 返回列表

任意文件上传l541402398/dsh-file-uploads

DeepSeek Harnessspec-screenedoffice在 GitHub 查看 ↗
⚠ 装前注意

为输入框添加任意文件上传,提交时把路径交给模型

基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/8/14 · 已提供中文文档

从 DeepSeek Harness Web 编辑器上传任意本地文件,并在“设置”中管理它们。

综合分
31.5
GitHub 分
31.5
用户评分
★ Stars
3
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add l541402398/dsh-file-uploads
未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
数据截至 2026/8/21(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包dsh-file-uploads(未发布到 npm,仅可源码安装)
Node 引擎要求 >=22 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

未发布到 npm registry,仅可从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 01:13:38

依赖的 DSH / Cordis 模块
@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-input-trigger@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-host-webserver
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-file-uploads

License: MIT
DeepSeek Harness

为 DeepSeek Harness Web 输入框增加任意文件上传功能:文件以待发送卡片显示,提交时把容器内路径提供给模型,并可在设置中统一下载和删除。

功能

- 在现有输入框控制区旁增加 文件 按钮。
- 支持一次选择多个任意类型的本地文件,不限于图片。
- 待发送文件以类似图片附件的卡片悬浮显示在输入框上方。
- 保持编辑框干净:上传后不会向草稿写入可见路径或自动描述。
- 发送消息时,才通过 Harness 内置引用序列化管线把文件绝对路径加入模型内容。
- 提交后清空待发送卡片;提交失败时恢复卡片。
- 所有文件统一保存到固定目录,默认是 $DSH_HOME/uploads。
- 在 设置 → 上传文件 中查看文件,并支持下载和删除。
- 同名文件不会覆盖,自动保存为 name (1).ext、name (2).ext 等名称。
- 支持单文件上限和上传目录总容量限制。

兼容性

- DeepSeek Harness 0.1.0-rc.6
- Web Profile
- Node.js 22 或更高版本

Harness 当前的原生附件传输只支持栅格图片。本插件针对任意文件采用 Agent 环境可用的路径方案:先把文件存入 Harness Host/容器,再通过内置输入引用序列化器把路径加入提交内容。

安装

把带版本标签的 GitHub Release 安装到 Web Profile:

dsh plugin --profile web add "github:l541402398/dsh-file-uploads#v1.0.0"

安装后重启正在运行的 Web Profile,并刷新浏览器页面。

如需安装最新开发分支:

dsh plugin --profile web add "github:l541402398/dsh-file-uploads#main"

卸载:

dsh plugin --profile web remove dsh-file-uploads

使用方法

1. 在 Harness Web GUI 中打开一个会话。
2. 点击输入工具栏中的 文件。
3. 选择一个或多个本地文件。
4. 在输入框上方检查待发送卡片,也可以点击 × 移除。
5. 输入普通提示词,或者让编辑框保持为空。
6. 发送消息。模型实际收到的内容中会包含类似:

上传文件:/path/to/.dsh/uploads/report.pdf

这行生成内容在提交前不会显示在编辑框中。文件路径是 Harness Host 所见的路径;在 Docker 部署中,它指容器内部路径。

设置页

插件会新增 上传文件 设置区,显示:

- 固定存储目录;
- 单文件和目录总容量限制;
- 当前空间占用;
- 文件名、大小、修改时间和绝对路径;
- 下载与删除操作。

文件会持续保存,直到手动删除。

配置

插件默认无需配置,可以使用以下环境变量覆盖默认值:

| 环境变量 | 默认值 | 用途 |
|---|---:|---|
| DSH_UPLOAD_DIR | $DSH_HOME/uploads | 上传目录的绝对路径。 |
| DSH_UPLOAD_MAX_BYTES | 104857600 | 单个文件最大字节数(100 MiB)。 |
| DSH_UPLOAD_TOTAL_MAX_BYTES | 1073741824 | 上传目录最大总字节数(1 GiB)。 |

Docker Compose 示例:

services:
dsh:
environment:
DSH_UPLOAD_DIR: /data/dsh/uploads
DSH_UPLOAD_MAX_BYTES: 104857600
DSH_UPLOAD_TOTAL_MAX_BYTES: 1073741824
volumes:
- ./dsh-data:/data/dsh

安全模型

- 文件列表、上传、下载和删除接口使用与 Harness 内置 Web API 相同的回环地址/可信 Host 和 Origin 检查。
- 拒绝浏览器跨站请求。
- 文件名会被规范化,并移除路径片段和控制字符。
- 下载和删除只接受配置目录中的普通文件,不跟随符号链接。
- 上传内容先写入私有临时文件,完成同步后原子发布,不覆盖同名文件。
- 插件启动时自动清理异常中断留下的 .upload-* 临时文件。
- 意外服务端错误只写日志,不把内部路径返回给浏览器。

这套可信边界不是用户账号认证系统。如果 Harness Web GUI 会暴露给其他用户或公网,请使用带身份验证的反向代理保护整个部署,并正确配置 Harness 的 trusted hosts。

开发

运行检查:

npm test
npm run check

这是一个持久化的 Host + Client 双端 Cordis Bundle:

- index.js:Host HTTP 路由、存储、容量和可信请求检查。
- client.js:上传按钮、待发送文件卡片、隐藏引用序列化和设置页 UI。
- cordis.patch.yml:可由 dsh plugin add 安装的 dsh.bundle Composition。
- test/upload-manager.test.js:Host 存储与安全回归测试。

本地链接开发方式见 CONTRIBUTING.md。

许可证

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群