使用说明
用于Copilot的Meshy AI
一个VS代码扩展，它公开 梅希艾 3D生成API GitHub Copilot语言模型工具，因此您可以在代理模式下直接从Copilot聊天中生成、重新混合和重新网格化3D游戏资产。
需求
- VS代码1.99或更高版本
- 启用代理模式的GitHub Copilot扩展
- A. 梅希艾 帐户和API密钥
安装
下载最新版 .vsix 从 GitHub 发布 并将其安装在VS Code中。
Windows注意事项： 不要双击
.vsix文件——打开Visual Studio安装程序，该安装程序无法安装VS Code扩展。请改用以下方法之一。
选项1--VS代码用户界面：
- 打开VS代码
- 转到“扩展”视图(
Ctrl+Shift+X) - 点击
...“扩展”面板右上角的菜单 - 选择 从VSIX安装。..
- 浏览到已下载的
.vsix并选择它
选项2——命令行：
code --install-extension meshy-mcp-<version>.vsix
入门指南
安装扩展后，设置Meshy API密钥：
- 按
Ctrl+Shift+P然后跑 Meshy：设置API密钥 - 粘贴密钥（以开头
msy_)然后按Enter键
扩展会自动激活，无需编译或设置。在代理模式下打开Copilot聊天，Meshy工具将立即可用。
可用工具
| 工具 | 它做什么 |
|---|---|
meshy_preview |
提交文本到3D预览任务并返回任务ID |
meshy_refine |
将PBR纹理添加到已完成的预览任务中 |
meshy_status |
检查任何任务的状态和进度 |
meshy_download |
将GLB从已完成的任务下载到本地路径 |
meshy_generate |
完整管道：预览→ 精炼→ 一步下载 |
meshy_generate_from_file |
批量处理JSON资产文件，从停止的地方继续 |
meshy_balance |
查看您当前的Meshy.ai余额 |
meshy_image_to_3d |
从单个参考图像生成3D模型 |
meshy_multi_image_to_3d |
从多个参考图像（正面、侧面、背面等）生成3D模型 |
meshy_retexture |
将新的AI生成的纹理应用于现有的3D模型 |
meshy_remesh |
清理几何图形、重新定位或转换3D模型的格式 |
您可以使用以下工具直接在Copilot聊天中引用这些工具 #meshy_generate, #meshy_status等，或者简单地描述你想要什么，Copilot将调用相应的工具。
配置
这些设置可以在VS代码设置中更改(Ctrl+,)under 网状:
| 设置 | 说明 | 默认值 |
|---|---|---|
meshy.apiKey |
您的Meshy.ai API密钥 | （无） |
meshy.pollIntervalSeconds |
多久轮询一次任务完成情况 | 10 |
meshy.defaultStyleSuffix |
附加到每个生成提示的文本 | （无） |
meshy.defaultNegativePrompt |
负面提示适用于所有世代 | （无） |
批量生成：资产文件格式
meshy_generate_from_file 读取一个描述要生成的资产列表的JSON文件。该格式反映了 generate_meshy_assets.py 脚本：
{
"settings": {
"style_suffix": ", low-poly game asset, PBR",
"negative_prompt": "blurry, watermark"
},
"assets": [
{
"id": "Tier1/air_intake_pump",
"output_path": "Assets/Models/Tier1/air_intake_pump.glb",
"prompt": "An industrial air intake pump"
},
{
"id": "Tier1/pressure_valve",
"output_path": "Assets/Models/Tier1/pressure_valve.glb",
"prompt": "A brass pressure relief valve",
"image_url": "https://example.com/reference.jpg"
}
]
}
进度字段(preview_id, refine_id, done)在每个步骤后都会写回文件，因此中断的运行会从中断的位置自动恢复。
您可以使用 only 按ID处理资产子集的参数（部分匹配）：
“在assets.json上运行meshy_generate_from_file，但只处理Tier1/air_intake_pump”
使用 dry_run: true 以便在不进行任何API调用的情况下预览将要处理的内容。
信贷成本
在进行任何消耗信用的API调用之前，扩展将显示一个确认提示。
| 运营 | 成本 |
|---|---|
| 预览（文本到3D，网格-6） | 20学分 |
| 优化/PBR纹理 | 10学分 |
完整管道(meshy_generate) |
30学分 |
| 图像到3D——无纹理 | 20学分 |
| 图像到3D——带纹理 | 30学分 |
| 多图像转3D——无纹理 | 20学分 |
| 多图像到3D——带纹理 | 30学分 |
重新掺合料(meshy_retexture)10学分 |
|
记住(meshy_remesh) |
5学分 |
检查余额(meshy_balance) |
免费 |
每次操作前，信用成本都会显示在确认对话框中。对于批量运行，所有待处理资产的总成本都会预先显示。
链接
- 梅希艾 -创建帐户并获取API密钥
- Meshy API文档 -API参考
- GitHub 发布 --下载最新
.vsix - 贡献 --从源代码构建并提交更改
