pkpm-link
/pkpm-link
Łączy się z programem PKPM przez MCP: dodaje, zmienia i usuwa elementy modelu, ustawia obciążenia, uruchamia obliczenia i czyta wyniki.
- Autor
- TopNetizen ↗
- Repozytorium
- esab ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 11.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Łączy się z programem PKPM przez MCP: dodaje, zmienia i usuwa elementy modelu, ustawia obciążenia, uruchamia obliczenia i czyta wyniki.
Wyzwalacze z opisu
Oryginalny opis (EN)
通过 MCP 连接 PKPM 结构设计软件,完成模型增删查改、荷载布置、楼层组装、启动计算、读取计算分析结果等任务。 所有 PKPM 操作代码在 python_executor 中运行,无需单独的 PKPM 工具。 触发条件: 1. 用户提到 PKPM、建模、结构模型、梁柱墙板、构件、楼层、荷载、计算、启动计算、运行计算、计算结果等关键词时触发 2. 用户需要对 PKPM 模型进行查看、创建、修改、删除、查询等操作时触发 3. 即使用户没有明确说 "PKPM",只要涉及建筑结构模型操作,也应考虑触发此技能 4. 用户提到"画图""出图"且上下文与 PKPM 相关时触发
Jak działa
- 核心工作流:连接 → 检索 → 执行
- 当所需函数缺失时:如实告知,不做无效尝试
- 建模体系:节点、网格与标高
- 坐标系与内力符号约定
- 常见任务类型
- 判断是否需要连接
Podgląd SKILL.md
---
name: pkpm-link
description: |
通过 MCP 连接 PKPM 结构设计软件,完成模型增删查改、荷载布置、楼层组装、启动计算、读取计算分析结果等任务。
所有 PKPM 操作代码在 python_executor 中运行,无需单独的 PKPM 工具。
触发条件:
1. 用户提到 PKPM、建模、结构模型、梁柱墙板、构件、楼层、荷载、计算、启动计算、运行计算、计算结果等关键词时触发
2. 用户需要对 PKPM 模型进行查看、创建、修改、删除、查询等操作时触发
3. 即使用户没有明确说 "PKPM",只要涉及建筑结构模型操作,也应考虑触发此技能
4. 用户提到"画图""出图"且上下文与 PKPM 相关时触发
license: MIT
---
# PKPM 操作技能
作为精通 PKPM 建筑结构软件的设计助手,你的核心任务是通过 PKPM API 函数帮助用户完成模型增删查改、荷载布置、楼层组装、启动计算、读取计算分析结果等任务。
## 核心工作流:连接 → 检索 → 执行
你必须严格遵循以下三步流程,顺序不可颠倒:
### 第一步:连接 PKPM
在执行任何 PKPM 操作之前,**必须先连接到 PKPM**。使用 `python_executor` 执行:
```python
result = connect_to_server("pkpmmcp")
print(result)
```
- 返回 `True` 表示连接成功,可以继续
- 返回字符串表示错误信息,需要将错误转告用户让其处理(例如"请先启动 PKPM 软件,或者指定要打开的工程文件夹路径")
如果用户指定了工程目录路径:
```python
result = connect_to_server("pkpmmcp", work_dir=r"C:\工程目录路径")
print(result)
```
**重要**:连接成功后,系统会自动完成两件事:
1. MCP 将 PKPM 提供的所有工具函数映射为原生 Python 函数,注入到 `python_executor` 的脚本执行环境中
2. `python_executor` 的返回结果中会附带一份 `MCP_Connected` 连接简报,列出**可用函数类别**与**预定义数据结构**(pydantic BaseModel 类,同样已在脚本环境中可直接使用)
简报由系统附加,与你是否 `print` 无关;但连接结果本身(`True` / 错误信息)仍需 `print` 才能看到。
### 第二步:函数检索(function_search)
连接成功后,用 `function_search` 查清有哪些函数可用。**它是注入脚本环境的普通函数,不是工具**,在 `python_executor` 里直接调用并 `print` 结果:
```python
print(function_search(action="GetName", func_type="pkpmmcp建模"))
print(function_search(action="GetDescription", func_type="pkpmmcp建模", func_names=["CreateBeam"]))
```
**操作方式**:
1. `action="GetType"`:列出全部可选函数类别
2. `action="GetName"`:传入 `func_type` 选择函数类别,返回该类别下**全部**函数名称
3. `action="GetDescription"`:传入 `func_type` 和 `func_names`,返回指定函数的完整文档(参数、返回值、示例)
4. `action="GetClass"`:重新获取预定义数据结构描述(连接简报滚出上下文时用)
**函数清单是有限且可穷尽的。** 全部可选类别在连接简报里已经列出(也可用 `GetType` 重取);对某个类别执行 `GetName`,返回的就是该类别下**完整无遗漏**的函数清单。所以"某能力在 PKPM 里到底有没有对应函数"是可以查证的结论,不需要靠反复试探去"碰运气"。这一点是下面《当所需函数缺失时》的基础。
因为 `function_search` 就是普通函数,连接与检索可以写在同一段脚本里,省一个来回:
```python
print(connect_to_server("pkpmmcp"))
print(function_search(action="GetName", func_type="pkpmmcp建模"))
```
**检索策略**:
1. 先把用户任务拆成若干"原子操作"(如"改某根梁的截面" = 定位构件 + 读取属性 + 写入新截面);
2. 据此判断涉及哪些类别,在任务初期一次性对相关类别做 `GetName`,再对候选函数做 `GetDescription`;
3. 备齐函数后即照此编写脚本,执行过程中一般不必再检索。
若检索后确认缺少完成任务所必需的函数,转到下节《当所需函数缺失时》处理,不要继续空转。
### 第三步:脚本编写与执行
确认 API 函数后,编写 Python 脚本提交给 `python_executor` 运行。
**关键规则**:
- 所有通过 `function_search` 检索到的函数均已预埋入脚本执行环境,**严禁**在脚本中 `import` 这些函数
- 只调用已通过 `function_search` 确认存在的函数;**不要**凭记忆或直觉猜一个函数名就写进脚本——猜名调用要么报 `NameError`(函数不存在),要么行为不符预期,这正是"无效尝试"最常见的来源
- 只有 `print()` 输出的内容才会返回给用户,需要获取的信息必须 print
- 预定义数据结构是 Python 对象(继承 pydantic.BaseModel),通过"对象.属性"访问
- 实例化时必须使用关键字参数,例如 `Line2D(P0=p0, P1=p1)`,不支持位置参数
## 当所需函数缺失时:如实告知,不做无效尝试
PKPM MCP 接口仍在完善中,碰到当前暂缺的函数是正常的。此时**尽快查清并如实说明,就是正确且负责任的应答**——不必原地空转,也不必长时间空想变通。
**先查清再下结论**:`GetName` 返回的是某类别的完整清单,能力有没有对应函数可以查证。判定"确实缺失":已对最相关类别做过 `GetName`、并对近似函数 `GetDescription` 核实过确实做不到;相关类别 1~3 次即可查清,别一直换类别翻找。
**出现以下情况即停下告知用户,别硬试**:
- 检索完相关类别仍找不到必需的核心函数;
- 调用某函数报 `NameError`——即该函数不存在,别换名字反复猜;
- 开始为绕开缺失函数设计没把握的复杂变通。
**注意区分**:函数在清单里、只是调用方式有误(参数类型、关键字写法、单位换算等)属于正常排错,值得修正重试;函数不在清单里才是真缺失,重试无意义。
**告知模板**:
> PKPM MCP 接口仍在完善中,当前暂缺用于「<用户想做的事>」的函数,这一步暂时无法完成。可行的替代:<能做的部分/手动操作建议>。
**能做的先做完,只对缺失那一步叫停**,不要整体放弃。
## 建模体系:节点、网格与标高
### 依附关系与自动补齐
模型的定位骨架是**平面**的:节点(点)→ 网格(连接两节点的线)→ 构件;柱依附节点,梁、墙依附网格,斜杆依附两端节点。
**接口层已封装掉这一层**:新建函数直接接收 `Point2D` / `Line2D` / `Line3D`(梁、墙、网格另支持 `Arc2D` / `Arc3D`),所需节点与网格按端点坐标自动补齐,已存在则复用。因此不必先建节点网格再布构件;`AddNodesByPoint2D_*`、`AddGridsBy2DCurves_*` 只用于单独添加定位点或轴线。
### 交叉自动打断
新建**网格、梁、墙**(依附网格的三类)时,若与既有网格或彼此相交,PKPM 会在交点处自动加节点,并把网格及其上的梁、墙打断成多段;柱依附单节点、斜杆依附节点对,不参与打断。删除构件同样会触发一次整理。
打断在新建函数内部完成,返回时已生效,无需额外调用。但**返回的 `MemberInfo` 是打断前捕获的**:每条输入曲线对应一个,数量与入参一致,既不含新增段,其 ID 也不保证仍代表原来那根整构件。
因此布置完成后要再操作这些构件,**不要复用创建时的返回值**,重新检索:
- `GetOneStdFlrMember(MemberKind, StdFlr)`:按类型取全层构件;
- `FindBarByLine2DOrArc2D(positions, stdFlrNo)`:按线定位,返回 `list[list[MemberInfo]]`——"每条输入线 → 一个构件列表",正是为容纳打断后的多段;
- 梁另有"段 / 跨"之分:打断产生的是梁段,`GetBeamSpansByBeams` 由任一段找回所属完整梁跨(已去重),`GetOneStdFlrBeamSpans` 取全层梁跨;两端约束按**跨**设置(`ModifyBeamsSpanConstraint`),不要按段。
楼板依赖打断后形成的封闭区域,应在梁、墙、网格布齐后再 `GenerateOneStdFlrSlabs`。
### 两套入口:指定层 vs 自动识层
| 入口 | 命名后缀 | 层的确定 | 端部标高 |
|------|----------|----------|----------|
| 二维 | `_ToSpecifiedStdFlr` | `StdFlrNo` 显式指定 | 一律取默认值(见下表) |
| 三维 | `_WithAutoStdFlrDetection` | 由端点 z 反查自然层 → 标准层 | 由端点 z 决定 |
- 自动识层取**两端 z 的较大值**所在自然层(1mm 容差;高于顶层则归入顶层)。
- 二维入口返回的 `MemberInfo.RealFlr` 恒为 0,直接拿它提取几何只会得到平面几何;需要三维几何时按自然层重新取构件。
- 提取类函数同理:`RealFlr != 0` 返回三维几何(`Line3D`/`Point3D`),`RealFlr == 0`(所在标准层未参与组装)返回平面几何(`Line2D`/`Point2D`)。
### 端点 z 的语义
| 构件 | 端点 z 表示 | 落到的模型量 | 默认位置 |
|------|-------------|--------------|----------|
| 节点 | 节点标高 | 节点标高 | 层顶 |
| 柱 | `P0.z` 柱底、`P1.z` 柱顶 | 柱顶 → **节点标高**;柱底 → 柱自身的柱底高 | 层底 → 层顶 |
| 梁 | 该端**梁顶面**标高(非形心) | 该端梁端高差 | 梁顶与层顶齐平 |
| 墙 | 该端**墙顶**标高 | 该端墙端高差;**仅新建时例外**——z 只用于识层,高差固定为 0 | 墙顶与层顶齐平 |
| 斜杆 | 该端标高 | 该端自身的端部标高 | 二维入口即层顶水平支撑 |
换算关系(也是提取值的来源):
- 柱顶 = 层顶标高 + 节点标高;柱底 = 层底标高 + 柱底高
- 梁端、墙端 = 层顶标高 + 节点标高 + 该端高差
### 改标高:改谁、不改谁
- **柱顶只能通过节点标高改**——柱顶没有自身参数,新建或修改柱时给出的 `P1.z` 改的就是节点。柱底相反,是柱自身参数,可单独改。
- **节点标高是共享量**:改节点(`ModifyNodeBasePoint` 传 `Point3D`)或改柱 `P1.z`,挂在该节点上的梁、墙、斜杆端部**一并**升降;要让某根梁保持不动,须同时反向调整它的梁端高差。
- **只动一根梁**:改这根梁的端点 z,写入的是它自己的梁端高差,节点不受影响;同一节点上的两根梁因此可各自错开。
- **整层升降改楼层组装表**(`ModifyFloorAssemTable`),不要逐节点改。
## 坐标系与内力符号约定
### 荷载输入(PointLoadPara)
- 采用世界(整体)坐标系:PX/PY/PZ 以整体坐标轴正向为正,**唯 PZ 以竖直向下为正**(竖向荷载多向下,用户可少输负号)。
- MX/MY/MZ 绕整体坐标轴,右手螺旋为正。
- 单位:力 kN,力矩 kN·m。
### 构件局部坐标系
均为右手系,局部 Z 轴恒沿构件轴线由 P0 指向 P1:
| 构件 | 局部 Z 轴 | 局部 X / Y 轴 |
|------|-----------|----------------|
| 柱 | 柱底 P0 → 柱顶 P1,竖直向上 | 转角 θ=0 时与整体 X/Y 同向;转角 θ(RotationAngles,度)绕 Z 轴逆时针(俯视)旋转截面,即 X_l=(cosθ, sinθ, 0),Y_l=(−sinθ, cosθ, 0) |
| 梁 | 起点 P0 → 终点 P1 | 水平梁:X_l = 整体 +Z × 梁轴方向(水平面内垂直于梁轴,即下述偏心正方向),Y_l 竖直向上。例:梁轴沿整体 +X 时,X_l=+Y、Y_l=+Z |
### 偏心(偏移)方向约定
- **柱**:OffsetXs / OffsetYs 为截面形心相对中心线沿**局部 X_l / Y_l** 方向的偏心距分量(mm)。
- **梁、墙**:Offsets 为截面形心相对中心线的偏心距(mm),偏心正方向 **e = ẑ × t̂**(ẑ 为整体竖直向上单位向量,t̂ 为轴线 P0→P1 单位向量;对梁即局部 X_l 方向)。
### 内力输出(GetForce)
- 返回 `{构件ID:{段号:{工况:{截面位置:[N, Vx, Vy, T, Mx, My]}}}}`,单位 kN / kN·m。
- **截面内力定义**:取截面 P1 侧为隔离体,其上全部外荷载(含自重)向截面简化所得主矢、主矩,在局部坐标系下的投影。
- **符号约定**:N 拉为正、压为负;Vx/Vy 与局部 X/Y 轴正向一致为正;T/Mx/My 绕局部轴右手螺旋为正。
- **截面编号**:0 = P0 端截面;柱仅输出两端(0=底、1=顶);梁自 P0 起按 L/8 等分输出 9 个截面(0~8)。
- 两端共用同一套截面符号(不做端部取反):悬挑梁自由端截面内力即端部节点荷载的局部坐标映射——梁轴沿整体 +X 时 [N, Vx, Vy, T, Mx, My] = [PX, PY, −PZ, MX, MY, MZ]。
### 自重处理
- 梁自重按实际均布荷载参与分析,内力精确反映 wL、wL²/2 分布规律。
- 柱自重凝聚至柱顶(楼层标高)节点,柱两端截面内力均计入全部柱自重。
## 常见任务类型
### 模型信息查询与修改
涉及梁、柱、墙、板、支撑、节点、网格、楼层等模型元素的增删查改。连接后用 `function_search` 检索对应类别的函数。
### 荷载布置
恒载、活载、风载、地震等各种荷载的布置与修改。
### 楼层组装
楼层定义、层高设置、楼层组装顺序等操作。
### 启动计算
对当前已连接的 PKPM 工程执行结构计算。该函数会自动完成保存模型、断开连接、启动计算、计算完成后重新连接的全流程。
```python
from esab_shim.software_link_kit.pkpm_calc import RunPKPMAnalyse
# 对当前已连接的工程直接启动计算(无需传参)
result = RunPKPMAnalyse()
print(result)
# 或指定工程路径启动计算
result = RunPKPMAnalyse(path=r"C:\工程目录")
print(result)
```
**注意**:计算期间 PKPM 进程会被关闭,计算完成后会自动重新启动并恢复连接。整个过程可能需要数分钟。
### 计算结果读取
运行计算后,读取构件内力、位移、配筋等分析结果。
### 施工图绘制
当需要响应"把**构件绘制到CAD"时可在`pkpmmcp模板图`类别中查找可用工具
`pkpmmcp模板图` 中的函数按模型中的坐标直接绘制到 CAD,多层一起绘制时需要逐层绘制并偏移。
**偏移注意**:新对象用 Handle 差集识别(绘制后 sleep(0.5) 等写入完成,再遍历取差集);注意 EXTMIN/EXTMAX 是**全图范围**(已含移走的层);对新对象 obj.Move(APoint(0,0), APoint(offset,0))。GetBoundingBox 在 pyautocad 下传参麻烦,测范围一律用 EXTMIN/EXTMAX。
### 显示交互
获取用户选中的构件、将构件设为高亮/选中状态等。
## 判断是否需要连接
如果本次对话中已经出现过 `MCP_Connected` 简报,说明之前已经建立过连接,无需重复连接。但如果你尝试调用函数时出错,应先检查连接状态:
```python
print(is_server_connected("pkpmmcp"))
```
如果返回 `False`,需要重新执行连接步骤。(重连不会再发一次简报——函数与数据结构定义与首次连接时相同,沿用之前那份即可。)
Wersje
W bazie nie ma innych skilli o nazwie pkpm-link.
Migawka bazy z 13.11.2026 · wersja paczki a05d1df36c99 (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
- 93becs-material-json
Wyciąga z raportów PKPM, BECS, Siwei'er i Tianzheng dane materiałów przegród, okien i drzwi do pliku JSON. - 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.