13323232dong/dsh-file-attachments

DSH 通用文件附件

面向 DeepSeek Harness (DSH) 的会话级通用文件附件。

它用紧凑的附件栏取代了路径注入：图像、视频、音频、文档、压缩包、未知文件和文件夹都作为安全的、会话级附件保存。浏览器和智能体工具接收的是附件 ID，而绝不是本地机器路径。

功能特性

- 直接将文件拖拽或粘贴到 DSH 对话中。无需额外的选择器 UI。
- 预览图像和视频；为文档、音频、压缩包、文件夹和其他文件显示类型卡片。
- 分块上传，使用 SHA-256 最终校验，单文件上限 2 GB / 批量上限 10 GB。
- 每条主机路由上均实现会话、租户、用户和智能体隔离。
- 智能体工具可用于列出、读取、提取、搜索、物化附件，以及将附件显式导入资产或知识服务。
- 安全的文件夹清单：仅使用相对路径；.git、node_modules、.DS_Store、设备文件和不安全路径均会被拒绝。

平台支持

该插件使用 Node.js 和标准 Chromium 浏览器 API 实现，当 DSH 运行在受支持的 Node.js 运行时上时，可在 macOS、Windows 10/11 和 Linux 上工作。

| 能力 | Windows Chrome / Edge | macOS Chrome | Firefox |
| --- | --- | --- | --- |
| 文件拖拽和粘贴 | 支持 | 支持 | 支持 |
| 图像 / 视频预览 | 支持 | 支持 | 支持 |
| 带目录树的文件夹拖拽 | 支持 | 支持 | 仅浏览器回退方案 |
| 分块文件上传 | 支持 | 支持 | 支持 |

文件夹遍历在可用时使用 File System Access API，其次是标准 Chromium 目录条目 API，最后是浏览器文件列表。在 Windows 上要获得完整的文件夹树支持，请使用当前的 Chrome 或 Edge。

安装

从本地克隆安装：

git clone https://github.com/13323232dong/dsh-file-attachments.git
cd dsh-file-attachments
npm install
npm run build
dsh plugin --profile web add .

安装后重启 DSH Web 进程。该插件以更高优先级的通用附件栏占用 conversation.input.attachments 槽位，因此请移除其他独立消费文档级文件拖放事件的插件。

配置

核心附件存储无需外部服务即可工作。可选的、向兼容 OPC 的资产或知识 API 的显式导入需要服务端设置：

- id: opc-file-attachments
config:
apiBaseUrl: https://your-opc-api.example
identityHmacSecret: !!js process.env.OPC_DSH_IDENTITY_HMAC_SECRET

切勿将 identityHmacSecret 暴露给浏览器。浏览器仅发送其当前 DSH 会话 ID；主机负责解析主体并对出站请求进行签名。

开发

npm install
npm test
npm run typecheck
npm run build

许可证

MIT