前言¶
在 DSH 里做 3D，常见做法是自己在对话里拼 API、写脚本、管登录和产物路径。Meshy 已经提供 meshy-cli 和面向智能体的技能包；若要把「文生 3D、贴图、重拓扑、绑骨动画、格式导出、打印切片交接」放进 Harness 工作流，还需要插件把 CLI、会话凭据和技能目录接进 dsh 的沙箱 shell。
下面介绍社区插件 meshy-dsh（维护者 meshy-dev，分类：联网工具）。它把 Meshy 的 3D 生成与 3D 打印技能挂到 DeepSeek Harness 上，由智能体通过 shell 驱动 CLI，并把结果写入当前项目。
这是什么¶
meshy-dsh 是 Meshy 为 DeepSeek Harness（dsh）提供的插件：打包 meshy-cli 依赖，挂载与 meshy-3d-agent 同步的技能，并在 Web / Desktop 侧提供 Meshy 设置页与 GLB 预览。当前 package 版本为 0.3.2，许可证 MIT。
插件解决两类问题：一是让 agent 在统一技能下调用 Meshy（含费用确认后再扣积分）；二是解决 dsh 沙箱无法持久保存 CLI 登录的问题——由插件维护登录、刷新会话，并注入每次 shell 调用所需环境，同时不把 MESHY_API_KEY 暴露给 agent 的 shell。
核心功能¶
技能侧（README 与 package.json 描述一致）覆盖：
- 文本或图像生成 3D 模型
- 贴图、重网格（remeshing）、绑骨与动画
- 格式转换（如导出 FBX 等，以 CLI 能力为准）
- 3D 打印：生成可打印文件，并支持与切片器（slicer）交接
在 dsh web 配置下，新会话输入 / 可看到 meshy-3d-generation 与 meshy-3d-printing。智能体会检查 CLI；若未登录会引导登录，展示费用并等待确认后再消耗 credits。
登录与站点
- 一次登录即可：在 Settings → Meshy 或对话中通过
meshy_sign_in工具（链接 + 验证码；Web 上带二维码）。 - 可选中国区 meshy.cn，与 meshy.ai 同账号同积分；登录凭据由 CLI 加密存储（与系统密钥相关），本机终端里的
meshy可共享该登录。 - 插件不向 agent shell 导出
MESHY_API_KEY。
Web / Desktop 界面
- 左侧栏 Meshy 入口：账户信息与示例请求，点选后新开会话并预填提示词。
- Settings → Meshy（Plugins 下同名页）：CLI 版本、登录方式（浏览器或 API key）、账户、站点（meshy.ai / meshy.cn）、积分；中国区暂不显示账户名与邮箱。
- 右侧栏点击
.glb或 agent 交付的模型卡片：交互式 3D 预览（拖拽旋转、滚轮缩放、重置或自动旋转），显示文件大小与三角面数；单文件最大 256 MB（分块读取，突破 dsh 整文件 32 MB 预览限制）。 - tui 与 headless 无上述 UI，技能行为一致。
实现要点（供排查）
cordis.patch.yml将内置 filesystem skill provider 再挂载到本包skills/。lib/index.js维护登录，为 shell 提供DSH_MESHY_NODE、DSH_MESHY_CLI、会话相关变量及工作区.meshy状态目录；注册meshy_sign_in；Web/Desktop 上另有四条受认证路由固定参数调用 CLI。- 项目内
.dsh/skills或.agents/skills中同名 skill 优先于插件自带技能。
安装与启用¶
插件按 profile 安装；你用到哪个 profile 就装哪个（web、tui、desktop）。
官方安装命令：
dsh plugin --profile web add meshy-dsh
# or from GitHub
dsh plugin --profile web add github:meshy-dev/meshy-dsh
安装后可用下面命令确认配置里是否出现 meshy-dsh 层：
dsh --profile web --dump-config
输出中应包含 # == meshy-dsh 段。在 dsh web 新会话里用 / 查看上述两个 Meshy 技能是否列出。
典型用法¶
- 在对应 profile 安装插件并完成 Meshy 登录（Settings 或对话内
meshy_sign_in）。 - 新建 web 会话，用自然语言描述需求。README 示例：
make a low-poly treasure chest and export FBX
- 按 agent 提示确认费用后再继续；生成文件会保存在当前项目工作区，Web/Desktop 下可直接预览 GLB。
Sidebar 里的示例请求可作为起点，编辑后发送即可。
适用场景与注意¶
适合谁
- 已在 DSH 里用 agent 写代码、管仓库，希望把 Meshy 3D / 打印流水线放进同一工作区的人。
- 需要 Web/Desktop 内预览 GLB、在设置页统一管理 CLI 与积分的人。
注意
- 插件与 dsh 进程同权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，自行评估信任边界。
- Meshy 为付费 credits 服务；agent 会在扣费前展示成本并等待确认。
- 社区目录 skillhub.cn 插件页 与 DeepSeek / 幻方无官方从属关系；DSH 生态是「一切皆插件」，本文事实以仓库 README 与发布包为准。
结尾¶
meshy-dsh 把 Meshy CLI 与 3D/打印技能接进 DeepSeek Harness，并处理沙箱下的登录与会话注入；Web/Desktop 还提供设置页与 GLB 预览。若你要在 dsh 里从提示词或图片走到可导出模型乃至打印文件，可按 profile 安装插件、登录 Meshy 后直接在会话里描述任务。
- 目录页：https://www.skillhub.cn/plugins/meshy-dev/meshy-dsh
- GitHub：https://github.com/meshy-dev/meshy-dsh
