Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

bimbase-parametric-component

/bimbase-parametric-component

Pisze skrypty Python do parametrycznego modelowania w pyp3d i uruchamia je w wbudowanym interpreterze BIMBase.

Repozytorium
esab ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

93/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena13 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/run_pyp3d.ps1

Co robi i kiedy

Pisze skrypty Python do parametrycznego modelowania w pyp3d i uruchamia je w wbudowanym interpreterze BIMBase.

Wyzwalacze z opisu

创建一个圆柱生成这个形状的脚本跑一下这段脚本执行这个 .py在 BIMBase/PKPM-BIM 里布置
Oryginalny opis (EN)

指导使用 pyp3d 编写 Python 参数化建模脚本。识别到用户要建参数化组件、用自然语言描述几何模型、要求生成建模脚本、或任何涉及 pyp3d 函数库的编写任务时,必须及时调用此 SKILL,即使用户只是说"创建一个圆柱"或"生成这个形状的脚本"。用户说"跑一下这段脚本""执行这个 .py""在 BIMBase/PKPM-BIM 里布置"时同样调用本 SKILL——它自带 BIMBase 内嵌 Python 解释器的自动定位与执行脚本,无需手工填写解释器路径。

Jak działa

  1. 何时必须调用
  2. 首要工作流(必须完成才能写代码)
  3. 规范底线(绝对不能违反)
  4. 最小模板
  5. 运行代码:解释器由脚本自动定位,禁止写死路径
  6. 实现要点
  7. 输出代码要求
  8. 同一处改到第二次还不对就停手
  9. 响应策略
Sekcje z nagłówków SKILL.md, w oryginale · 127 linii, 365 słów
Podgląd SKILL.md
---
name: bimbase-parametric-component
description: 指导使用 pyp3d 编写 Python 参数化建模脚本。识别到用户要建参数化组件、用自然语言描述几何模型、要求生成建模脚本、或任何涉及 pyp3d 函数库的编写任务时,必须及时调用此 SKILL,即使用户只是说"创建一个圆柱"或"生成这个形状的脚本"。用户说"跑一下这段脚本""执行这个 .py""在 BIMBase/PKPM-BIM 里布置"时同样调用本 SKILL——它自带 BIMBase 内嵌 Python 解释器的自动定位与执行脚本,无需手工填写解释器路径。
license: MIT
---

# pyp3d 参数化组件开发指导

本 Skill 指导如何正确使用 BIMBase MCP Server 的检索工具链,产出符合规范的 pyp3d 参数化组件脚本。
当用户意图是"创建/修改/重构参数化组件"时,必须先执行本 Skill 的工作流,再进入编码。


## 何时必须调用

- 用户要求创建参数化几何、参数化构件、BIM 参数化组件
- 用户给出几何需求并要求可调参数、参数联动、参数约束
- 用户要求使用 `pyp3d`、`Component`、`Attr`、`replace()` 等模式实现模型
- 用户要求对现有参数化组件做功能扩展、性能优化或几何修复

## 首要工作流(必须完成才能写代码)

**pyp3d 的 API 与任何已知 Python 库都不同,严禁凭记忆或经验猜测函数名与参数。**

1. **规划**:调用 `get_skill_manifest()`,阅读返回 JSON 中各 symbol 的 description,确定本次任务需要哪些函数(symbol)。
2. **取文档**:调用 `get_skill_bundle(symbols=[...])` 一次性获取所有将使用函数的文档正文(会自动附带编码规范 `basic_writing_style`)。**凡是文档中未出现的函数、参数、用法,一律禁止写进代码。**
3. **未命中处理**:若某个 symbol 拼错或不存在,工具不会报死错,而是在响应中返回 `candidates`(全部可用函数的精简清单)。此时直接从 `candidates` 中选择语义最接近的标准 symbol 重试,不要反复尝试拼写变体,更不要臆造函数名。
4. 明确组件目标、参数清单、参数范围、几何约束、异常输入边界。

若以上任一步未完成,不进入具体代码实现。
输出代码后自动运行代码,向用户清晰介绍建模思路,无需展示代码细节,提示用户在 BIMBase系列软件,例如PKPM-BIM里查看布置模型

## 规范底线(绝对不能违反)

- 顶部必须包含 `from pyp3d import *`
- 文件中只能定义一个继承自 `Component` 的类
- 参数用 `self['参数名'] = Attr(...)` 显式定义;造型逻辑写在带 `@export` 装饰器的 `replace(self)` 方法中;最终几何赋给 `show=True` 的输出槽位
- 在 `if __name__ == "__main__":` 下实例化并 `place(实例)` 输出
- 参数名与代码中**禁止特殊符号和角标/下标**(如 `(`、`-`、`x₁`);中文变量名用 `_` 连接、不用空格,标点一律用英文
- **并集/合并一律用 `Combine`,禁止用 `Bool` 做并集**(Bool 并集网格质量差);Bool 仅用于减(差集)、交(交集)
- 其余编码细则(Section 装填类型、Arc 方向、Vec2/Vec3 维度一致、单位 mm 等)以 bundle 返回的 `basic_writing_style` 文档为准

## 最小模板

```python
from pyp3d import *

class pythonModel(Component):
    def __init__(self):
        Component.__init__(self)
        # 定义参数及其默认值
        self['长'] = Attr(1000, obvious=True, combo=[500,1000,2000,3000,4000])
        self['宽'] = Attr(300.0, obvious=True)
        self['高'] = Attr(500, obvious=True)
        self['长方体'] = Attr(None, show=True)
        self.replace()

    @export
    def replace(self):
        L = self['长']
        W = self['宽']
        H = self['高']
        TestCube = scale(L,W,H) * Cube()
        self['长方体'] = TestCube

if __name__ == "__main__":
    FinalGeometry = pythonModel()
    place(FinalGeometry)
```

## 运行代码:解释器由脚本自动定位,禁止写死路径

`pyp3d` **只存在于 BIMBase 自带的内嵌 Python 3.7.9 里**,系统 `python` 一定会报
`ModuleNotFoundError`。但内嵌解释器的绝对路径每台机器都不同(盘符、版本年份、
是否装在中文目录都不一样),所以本 skill 不写死路径,改为调用随附脚本自动定位并运行:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "<SKILL_DIR>\scripts\run_pyp3d.ps1" "<你的脚本.py>"
```

`<SKILL_DIR>` 是本 SKILL.md 所在目录。脚本会按
**BIMBASE_PYTHON 环境变量 → 本机缓存 → 正在运行的 BIMBase 进程 → 注册表 → 按目录名扫盘**
的顺序找到内嵌解释器,用它执行目标脚本,并把 stdout/stderr 原样回传。
首次约 1 秒,之后走缓存;软件升级换了目录会自动重新解析(也可加 `-Refresh` 强制刷新)。

- 只想知道解释器在哪:加 `-PrintPython`(不传脚本路径)。
- 脚本退出码即目标脚本的退出码,报错时**完整 traceback 直接呈现给用户**。
- 聊天里贴的代码片段:**先存成 `.py` 文件再跑**,不要用 `python -c "..."`
  —— 引号、换行、中文经 shell 转义极易被悄悄破坏。
- 若返回"未找到 BIMBase 内嵌 Python":让用户设环境变量 `BIMBASE_PYTHON`
  指向 `...\PythonScript\python-3.7.9-embed-amd64\python.exe`(或 `BIMBASE_HOME`
  指向安装目录)后重试,**绝不退回系统 python,也不要把用户代码改写成能在系统 python 上跑**。
- `import pyp3d` 需要 **BIMBase.exe 正在运行**(它靠 IPC 桥连活动进程)。软件没开时报
  `RuntimeError: BIMBASE.exe not found`,这是环境问题、不是解释器找错了——提示用户先打开
  BIMBase 即可,不要因此换解释器。
  涉及含反斜杠+数字的 Windows 路径时,优先用 shell_executor 并加双引号包裹路径,避免 run_args 对路径做转义处理。
  不需要告诉用户你用的内嵌解释器
  
## 实现要点

- **参数设计**:区分主尺寸参数与派生参数,优先"基准参数 + 公式派生"维持几何一致性;加入输入校验,防止零长度、负半径、自交等退化几何
- **几何构建**:先建基准几何(点/线/弧/截面),再做变换(平移/旋转/缩放),最后做成形(Loft/Sweep/Extrusion)或布尔(减/交)操作;复杂模型按"结构分区"分段实现
- **参数化绑定**:在 `replace()` 中读取参数生成最终几何,不将数值写死

## 输出代码要求

- 代码按"几何结构部分"清晰分段,段与段之间保留空行,每段注明生成对象与参数关系
- 错误处理给出可读反馈,便于定位参数问题(如负半径报错)

## 同一处改到第二次还不对就停手

**触发条件:同一个部件的位置或尺寸,已按用户反馈改过两次仍不对。第三次不许再动代码。**

改两次还不对,说明错的不是某个数字,而是对某个基准的理解——继续微调只会把本来对的部分也搅乱,而且每轮都要用户重新看一遍模型。此时应当:

1. **停止改代码**,把当前所有拿不准的量列出来:基准点在哪、截面是形心还是角点定位、拉伸朝哪个方向、相对坐标换算是否正确。
2. 以「我现在的理解 vs 请确认」表格发给用户:

   | 项 | 我现在的理解 | 当前代码里的值 | 对吗? |
   |---|---|---|---|
   | 箱体基准点 | 底面角点 | (0, -426.78, -176.78) | ? |
   | 出水管拉伸方向 | 沿 -Z 拉 100 | 终点 z = -276.78 | ? |

3. 用户逐项确认后**一次改到位**,不要再试探性微调。

排查优先级:**先怀疑锚点语义**(`Cube`/`Box` 是角点不是中心),再查 `Vec2`/`Vec3` 维度混用与弧度/角度混用,最后才是数值本身。拿不准就回到 `get_skill_bundle` 重取该函数文档核对,不要凭印象改。

## 响应策略

- 先给出参数化方案,再给可运行代码
- 修改现有组件时优先保持原有接口稳定
- 用户要求创建模型时,必须新建一个 python 文件,不能覆盖当前已有的 Python 模型文件
Pliki w paczce (2)
  • SKILL.md 8 KB
  • scripts/run_pyp3d.ps1 8 KB

Wersje

W bazie nie ma innych skilli o nazwie bimbase-parametric-component.

Migawka bazy z 13.11.2026 · wersja paczki 828525fc6272 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86add-feature
    Dodaje funkcję modelowania parametrycznego, np. zaokrąglenie lub wyciąg, do modelu dokumentu ShapeBridge wraz z eksporterami.
  • 95plants-link
    Łączy się z PlantS przez MCP i tworzy, zmienia oraz sprawdza belki, słupy, przekroje i materiały w modelu konstrukcji przemysłowej.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.