dsh-gen3d
DeepSeek Harness 的 3D 角色生成插件,直连 Meshy、混元3D、Tripo3D、Rodin 等官方 API
AI 分析
核心用途是快速生成 3D 角色模型。适合 3D 创作者和游戏开发者,用户需自备对应平台的 API Key 凭证。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:LuZhouheng/dsh-gen3d说明文档
阅读完整 README ↗凭证配置
本插件不含任何 API key。所有真实生成调用都使用你自己购买并配置的官方 key;未配置时回退 mock,不会偷偷调用任何第三方服务。
插件直连四家官方 API,各配各的 key(变量名与 src/config.ts 注册表一致,详见 docs/CREDENTIALS.md):
| 供应商 | 凭证变量名 | 获取入口 | 备注 |
|---|---|---|---|
| Meshy | MESHY_API_KEY | platform.meshy.ai 登录后 Settings → API(API settings 页) Create API Key | 注册即可建 key;key 只显示一次,可随时吊销 |
| 腾讯混元 3D(生成) | HUNYUAN3D_API_KEY | TokenHub 控制台创建 API Key(混元调用指南) | 官方主推路径,Bearer 直用;首次开通送 100 免费积分 |
| 腾讯混元 3D(后处理) | HUNYUAN3D_SECRET_ID + HUNYUAN3D_SECRET_KEY | 腾讯云控制台 访问管理 → API 密钥管理(CAM) | 可选;TC3 签名路径(腾讯云 API 3.0),绑骨 / 文生动作 / 智能拓扑等后处理能力必需 |
| Tripo3D | TRIPO3D_API_KEY | platform.tripo3d.ai/api-keys 生成 | key 以 tsk_ 开头;tcli_ 开头的 Client ID 仅标识应用,不能用于认证 |
| Rodin(Hyper3D) | RODIN_API_KEY | hyper3d.ai 登录后 API Key Management 页面 "+Create new API Keys" | 需 Business 订阅($120/月) 才有 API access;key 只显示一次,可吊销 |
配置方式
推荐写入 $DSH_HOME/.credentials.yaml($DSH_HOME 未设置时默认 ~/.dsh)。解析器兼容两种写法,根映射为权威 DSH 形态(文档仅一个扁平映射),credentials: 包裹层为兼容形态(README 旧示例),二者等价:
### 配置方式
推荐写入 `$DSH_HOME/.credentials.yaml`(`$DSH_HOME` 未设置时默认 `~/.dsh`)。解析器兼容两种写法,**根映射**为权威 DSH 形态(文档仅一个扁平映射),**`credentials:` 包裹层**为兼容形态(README 旧示例),二者等价:
```yaml