USD BRep 建模 gitend/dsh-usd-brep

dsh-usd-brep

DSH 宿主插件：让 DSH 智能体通过宿主工具驱动 NVIDIA Omniverse 的 usd-brep Python 库（基于 NURBS 的 BRep 实体建模 + 原生 OpenUSD I/O）。

插件在本地创建并管理一个隔离的 CPython 3.12 venv（usd-brep 的 wheel 只发 3.12，64 位 Windows/Linux x86_64/aarch64），首次使用时自动 pip install usd-brep，之后智能体可以调用三个宿主工具来探测环境、跑内置示例、执行自定义 snippet。

工具

| 工具名 | 参数 | 说明 |
| usd_brep_version | （无） | 探测 venv 能否 import usd_brep，返回版本号 + 可用子模块列表。 |
| usd_brep_run_example | usda（可选） | 内置示例：球 − 盒布尔差，导出 .usda 并重新导入做 sanity check。 |
| usd_brep_run_snippet | code（必需）、usda（可选） | 执行智能体写的 Python snippet。约定：snippet 必须 print(json.dumps(...)) 输出最终 JSON 值，宿主解析后作为 result 返回；导出时把 .usda 路径传 usda（注入到环境变量 USD_BREP_OUT）。 |

安装

方式一：从本仓库安装（dsh-market 或插件管理器）：

dsh plugin add git+https://github.com/gitend/dsh-usd-brep.git

方式二：本地目录安装：

plugin_manager install_bundle <本地目录>

宿主在加载时执行 apply(ctx, rawConfig)，注册全部三个工具。

配置

| 键 | 默认 | 说明 |
| pythonExe | "" | 显式指定 CPython 3.12 解释器；留空则自动探测（uv 托管位置 → py -3.12）。 |
| venvDir | ""（= ~/.dsh-usd-brep-venv） | venv 目录；留空用每用户默认位置（与宿主 cwd 无关）；相对路径按 process.cwd() 解析。 |
| autoInstall | true | 缺失时自动 pip install usd-brep。 |
| workDir | "" | 运行 snippet/示例时的 cwd。 |
| timeoutMs | 120000 | snippet 执行超时（毫秒）。 |
| defaultUsda | brep_example.usda | usd_brep_run_example 默认输出文件名。 |

平台要求

- CPython 3.12（wheel 仅 3.12；Windows 需 MSVC Redistributable）。
- 不要在同一环境混装 usd-core 25.11（同版本符号冲突会崩溃）。
- usd-brep 轮子内置 OpenUSD runtime 25.11，模型在库间通过文件交换（不共享 pxr 内存对象）。

A DeepSeek Harness (DSH) host plugin that lets DSH agents drive the NVIDIA Omniverse usd-brep Python library (NURBS-based BRep solid modeling with native OpenUSD I/O) through host tools.

The plugin creates and manages an isolated CPython 3.12 venv locally (usd-brep wheels are published for 3.12 only, 64-bit Windows/Linux x86_64/aarch64), runs pip install usd-brep automatically on first use, and then registers three host tools for the agent to probe the environment, run the built-in example, or execute custom snippets.

Tools

| Tool | Parameters | Description |
| usd_brep_version | (none) | Probes whether the venv can import usd_brep; returns the version + available submodules. |
| usd_brep_run_example | usda (optional) | Built-in example: sphere − box boolean difference, export .usda and re-import as a sanity check. |
| usd_brep_run_snippet | code (required), usda (optional) | Runs an agent-supplied Python snippet. Contract: the snippet must print(json.dumps(...)) a final JSON value, which the host parses and returns as result; pass the .usda path via usda when exporting (injected as env var USD_BREP_OUT). |

Install

From this repository (via dsh-market or the plugin manager):

dsh plugin add git+https://github.com/gitend/dsh-usd-brep.git

也可以从本地目录安装：

plugin_manager install_bundle <local-dir>

宿主在加载时运行 apply(ctx, rawConfig)，注册全部三个工具。

配置

| 键 | 默认值 | 说明 |
| pythonExe | "" | 显式指定 CPython 3.12 解释器；留空 = 自动探测（uv 管理的位置 → py -3.12）。 |
| venvDir | ""（= ~/.dsh-usd-brep-venv） | venv 目录；留空 = 按用户取默认值（与 cwd 无关）；相对路径按 process.cwd() 解析。 |
| autoInstall | true | 缺少 usd-brep 时自动执行 pip install usd-brep。 |
| workDir | "" | 运行代码片段/示例时的 cwd。 |
| timeoutMs | 120000 | 代码片段执行超时（ms）。 |
| defaultUsda | brep_example.usda | usd_brep_run_example 的默认输出文件名。 |

平台说明

- CPython 3.12（wheel 仅支持 3.12；Windows 需要 MSVC Redistributable）。
- 不要在同一环境里安装 usd-core 25.11（符号冲突会导致崩溃）。
- usd-brep 的 wheel 自带 OpenUSD 25.11 运行时；库与库之间通过文件交换模型（不共享 pxr 内存对象）。

许可 / License

MIT（见 LICENSE / see LICENSE）.