dsh-hunyuan-3d

在智能体工作流里，3D 资产往往不能只停留在「任务已提交」：后续回合、Blender 或格式转换工具需要的是磁盘上的真实路径。dsh-hunyuan-3d 把腾讯云混元生3D（ai3d OpenAPI）封装成 dsh 工具，覆盖文生3D与图生3D的提交、轮询与下载，让模型拿到统一的结果结构，而不是一堆临时链接。

核心能力围绕两个工具展开：hunyuan_3d_model 负责提交建模任务，默认会等待完成并把资产落到本地；hunyuan_3d_query 用于 wait: false 的异步任务或事后找回结果。两者返回一致的 job_id、状态、计费信息与 files[]（含本地路径、大小、类型与预览地址）。插件同时支持 OpenAI 兼容网关与腾讯云原生 API 两种接入方式，凭证与运行参数可在「设置 → 插件 → 腾讯云混元生3D」中配置，并遵循凭证只写不回显、设置即时生效的 dsh 惯例。

服务侧并发上限为三个并行任务，插件在本地做排队与槽位管理，避免无效请求；生成结果的下载链接约 24 小时失效，因此长时间未取回的任务需要重新提交而非重复下载。适合需要在 dsh 里把混元生3D 与建模、渲染、格式转换串联起来的开发者与创作者，以及希望用统一工具参数在两种 API 入口间切换的团队。