DeepSeek Harness × SlashX Gateway

dsh-plugin-slashx-gateway 是一个 DeepSeek Harness Host Bundle。它把 Harness 实例暴露为遵循 slashx.request.v1 / slashx.response.v1 的 SlashX 服务端点， 并提供文本、图片、文件、音视频、引用、卡片和按钮所需的安全媒体入口与制品出口。

当前版本：0.1.0。兼容目标：DeepSeek Harness >=0.1.0-rc.6 <0.2.0。 Harness 仍处于 Developer Preview；生产升级前必须在预发布环境重新运行本包测试和 连接验收。

兼容性结论

本插件的目标是“协议传输完整兼容 + 语义能力显式协商”，不是把所有文件都伪装成 模型原生输入。

SlashX 能力	插件接收/返回	Harness 中的真实处理
请求文本	是	原生文本内容块
请求图片	是	网关下载/解码并校验后，作为 Harness 原生图片内容块；最终仍取决于所选模型是否支持图片
请求 PDF、Office、文本、代码等文件	是	安全下载到会话工作区，并给 Agent 提供路径、MIME、大小和 SHA-256；由文件工具读取，不冒充原生模型附件
请求音频、视频	是	安全落盘为工作区文件；若要理解内容，需要在 Harness 中另配转写、抽帧或媒体分析工具
引用、按钮点击	是	作为有边界的结构化上下文交给 Agent
Markdown 响应	是	普通助手文本；SlashX 客户端具备 markdown capability 时渲染
图片、视频、音频、文件响应	是	Agent 调用 slashx_deliver；本地文件经签名制品服务发布为 HTTPS URL，或使用已有远程 HTTP(S) URL
引用、卡片、按钮响应	是	Agent 调用 slashx_deliver，插件按 slashx.response.v1 校验；客户端不支持时转为附件或 Markdown 降级，不静默丢失
异步回调	是	支持 extensions.slashxAsync、一次性 callback token、轮询和取消入口
文本逐 token SSE	否（0.1.0）	当前返回完整终态响应，长任务使用异步回调；能力端点会明确报告这一限制

重要边界：插件可以保证字段、校验、落盘和返回格式；它不能保证当前所选模型会看懂 视频，也不能凭空生成图片或文件。媒体生成与理解依赖实际装入 Harness 的模型和工具。

另外，SlashX 当前聊天运行链虽然协议定义了独立的 input.videos，聊天页的部分路径 仍会把视频放进 attachments，部分旧路径主要发送文本。本插件同时接受 videos 和带 attachmentType=video 的 attachments；要宣称端到端全部打通，仍需在 后续“DeepSeek Harness 服务商”阶段完成 SlashX 聊天入口的独立视频字段验收。

当前 SlashX 的 HTTP 同步调用路径还只声明 stream、markdown（异步时再加 async_callback）客户端能力。因此即使聊天 UI 和 slashx.response.v1 已定义图片、 视频、音频、卡片和按钮，本插件也会遵守本次请求的 capability，把这些内容显式降级为 附件或 Markdown。要在 SlashX 页面原生显示全部富组件，后续服务商接入必须让聊天路由 按真实页面能力发送 、、、、，并补齐端到端渲染验收； 插件不能擅自忽略客户端声明。