前言¶
DeepSeek Harness (DSH) Web 是一个面向智能体开发的开发者工具。在 Web 环境中直接处理非图片文件的上传、预览以及智能体生成文件的下载，通常需要额外的配置或绕过官方机制。dsh-filetransfer 插件提供了原生体验的文件草稿管理和本地交付物下载功能，将文件交互逻辑下沉到本地服务。
插件介绍¶
- 名称：dsh-filetransfer
- 维护者：kerlyken
- 核心价值：在 DeepSeek Harness Web 中实现本地化文件草稿确认、文件卡片渲染以及仅本地回环的交付物下载。
核心功能¶
- 文件草稿管理：支持拖放或选择非图片文件，在发送前以草稿卡片形式预览。
- 灵活发送：可将文件作为独立消息发送，或与普通用户文本混合发送。
- 文件渲染：支持将 Word、Excel 以及通用文件渲染为 distinct transcript cards。
- 安全删除：通过关闭按钮移除草稿文件，不暴露隐藏的引用占位符。
- 交付物下载：通过仅限本地回环的 deliverables panel 下载智能体生成的文件。
- 上传机制：上传仅在本地阶段进行，不调用
session.prompt，文件需在用户按下 DSH 正常发送按钮后才传递给智能体。
安装与启用¶
确保你的 Node.js 版本为 22.19 或更新。版本 0.2.5 目标是 DSH 0.1.0-rc.7。在 DSH 工作区目录下执行以下命令：
npx @deepseek-ai/dsh plugin --profile web add github:kerlyken/dsh-filetransfer
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh web
注意：不要安装 @deepseek-ai/dsh-cordis-host-runner，DSH Web 已内置 Host runner。
典型用法¶
配置路径¶
插件默认使用以下配置（可在 cordis.patch.yml 的 filetransfer 行覆盖）：
- Host endpoint:
http://127.0.0.1:3199 - Inbox:
<workspace>/bridge/inbox - Deliverables:
<workspace>/deliverables - Allowed origins:
http://127.0.0.1:3080和http://localhost:3080
文件标记¶
在用户文本块中使用 XML 标记引用文件：
<dsh-file path="bridge/inbox/example.docx"></dsh-file>
适用场景与注意¶
- 适用场景：需要处理文档文件（Word/Excel）或从智能体侧获取本地交付物的 Web 开发场景。
- 安全与权限：上传下载服务器绑定
127.0.0.1，会检查源，清理文件名，强制路径约束并限制上传大小。不要在没有认证和独立威胁模型的情况下暴露端口 3199。 - 集成说明：
integrations/目录包含 WeCom 等可选的依赖模块，该目录被排除在 npm 包之外，但在 CI 中经过测试。该插件核心不依赖任何第三方消息平台。
总结¶
dsh-filetransfer 提供了一套完整的本地文件处理方案，弥补了 DSH Web 在非图片文件交互上的空白。通过草稿卡片和本地回环机制，它简化了智能体与本地文件系统的交互流程。
