前言¶
DSH 的插件机制可以把不同能力接进同一个会话。如果当前工作流仍主要使用文本模型，又想直接粘贴图片做理解或 OCR，或者生成图片和视频，就需要一个能对接媒体模型的客户端适配。
下面介绍 dsh-xiapan-media。它由 dongsheng123132 维护，是面向 DeepSeek Harness 的插件，通过虾盘云提供 xiapan-vision 视觉路由、gpt-image-2 图片生成和 Seedance 视频生成。客户端插件使用 MIT 许可；模型推理、额度、风控和充值由虾盘云服务端提供。
这是什么¶
dsh-xiapan-media 是一个 DSH 客户端插件，核心价值是把三项媒体能力放进现有 DSH 会话：图片理解/OCR、图片生成、视频生成。
package.json 声明版本为 0.1.0，要求 node >=22.19.0、dsh >=0.1.0-rc.6，许可证为 MIT。
核心功能¶
识图/OCR¶
xiapan-vision 路由用于让会话直接粘贴图片。图片由虾盘云 qwen3.7-flash 转译为文本，再交回原文本模型继续处理。
插件还提供三个文件工具：
xiapan_vision_analyzexiapan_vision_ocrxiapan_vision_locate
作图/改图¶
xiapan_image_generate 调用 gpt-image-2，支持 1–4 张、尺寸/质量与参考图。产物保存到工作区 .dsh-media/images/。
视频生成¶
xiapan_video_generate 调用 Seedance，支持文生视频、图生视频、5–15 秒、480p/720p/1080p。产物保存到 .dsh-media/videos/。
由于 DSH v1 attachment 服务目前只原生保存图片，视频会作为真实 .mp4/.webm 文件路径返回。
插件拆分¶
插件包通过 cordis.patch.yml 一次安装三个独立插件行。任何一项都可以单独从 profile 中删除。
安装与启用¶
固定提交安装¶
先使用固定提交安装，便于确认行为可复现：
dsh plugin --profile web add "github:dongsheng123132/dsh-xiapan-media#COMMIT_SHA"
这里的 COMMIT_SHA 是占位符。发布后应把它换成 README/Release 中经过 CI 的完整提交；当前已核实资料未给出具体完整提交 SHA。
选择识图路由¶
自动粘贴识图依赖文本路由 uking-managed。安装完成后，在 DSH 模型选择器里选择 U-King DeepSeek + 虾盘云识图，路由 ID 为 xiapan-vision。
如果用户只安装了原生 DeepSeek 路由，可以把视觉插件的 innerProvider 改成实际文本 provider ID。
凭据顺序¶
凭据按以下顺序解析：
- DSH credentials 服务中的
UKING_DSH_API_KEY - 同名环境变量
XIAPAN_API_KEY~/.uking/device.json中的设备凭据
未找到凭据时会提示登录/充值，不会尝试匿名调用。
Authorization 只允许发送到 api.u-claw.org.cn；旧域名 api.u-claw.org 会被自动改为 .org.cn。
付费与审批¶
作图和视频工具默认注册 DSH tools/pre-execute 审批闸门。无审批服务的 headless 环境会拒绝，不会静默扣费。
只有管理员明确把 requireApproval 设为 false 时，才允许无人值守付费调用。
Seedance 价格以虾盘云实时计费或服务端账单页展示为准；插件文案不是报价承诺。
安全边界¶
- 输入文件必须位于配置的工作区根目录内；拒绝
..越界和指向工作区外的符号链接。 - 单张输入图最大
10 MiB，下载产物最大200 MiB。 - 产物使用临时文件 + 原子改名写入，不覆盖已有文件。
- 只接受 HTTPS 虾盘云 API 和 HTTPS 产物 URL。
- 错误信息会遮蔽常见密钥格式。
开发验证¶
本地开发时可运行：
npm install
npm test
npm run check
适用场景与注意¶
它适合需要在 DSH 会话中处理图片、生成图片/视频，并愿意使用虾盘云凭据的开发者或团队。
使用前注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码、许可证和凭据配置。 - 视觉路由需要可匹配的文本路由；如果当前只有原生 DeepSeek 路由，先调整
innerProvider。 - 作图和视频可能产生费用，headless 或无人值守环境要保留审批约束。
- 文件输入和产物大小有限制，跨工作区路径与外部符号链接会被拒绝。
结尾¶
dsh-xiapan-media 的价值在于把视觉理解、gpt-image-2 作图和 Seedance 视频生成接进 DSH 会话，同时保留凭据解析、审批闸门和工作区文件边界。
GitHub：https://github.com/dongsheng123132/dsh-xiapan-media
目录页：已核实资料未给出 URL，本文不列出不确定的目录页链接。
