结构龙虾周报：可驱动PKPM分析引擎，并实现全流程的过程可视化
StructureClaw Weekly · 2026-04-21
可驱动 PKPM 分析引擎，
运行流程也看得见了。
这周 StructureClaw 主要推进了两件事：可驱动 PKPM SATWE 结构分析引擎，以及全流程的过程可视化。从“能算”，走到“让你看见怎么算”。
驱动 PKPM · 全流程过程展现 · 分析不再是黑箱
国产引擎
驱动 PKPM SATWE ——从自然语言到计算结果
StructureClaw 现在已经可以驱动 PKPM SATWE 引擎完成结构静力分析。
整个链路实现了闭环：V2 模型 → JWS 转换 → SATWE 执行 → 结果提取。
模型转换器
将 V2 统一模型 JSON 自动转换为 PKPM JWS 工程文件。支持 H/I 型钢、箱型、管型、矩形等多类截面，覆盖 Q235 到 Q460 及 GJ 系列钢材牌号，并支持多层标准层与自然层的自动映射。
SATWE 执行
通过 PKPM 官方的 JWSCYCLE.exe 与 DirectorySet.conf 机制启动计算，并支持超时控制与并发锁管理。
结果提取
通过 APIPyInterface.ResultData 提取完整设计结果，包括模态周期、梁柱内力、节点位移、层间位移角、层刚度、刚度比、剪重比、轴压比等关键指标，全部可量化输出。
配套技能同步落地
PKPM 计算书 — 基于 SATWE 结果自动生成计算书（Markdown / Word / PDF），覆盖模态分析、层刚度、基底剪力、构件设计结果等核心内容。
引擎矩阵
分析引擎从 2 个扩展到 3 个
| 引擎 | 静力 | 动力 | 计算书 |
| PKPM SATWE |
所有引擎统一从 V2 模型格式出发，新引擎只需补充对应 converter。
过程展现
分析不再是黑箱——你能看到每一步在做什么
过去，用户发出一条消息，最终只能看到 AI 的回复；中间经历了什么、系统正在做什么、卡在了哪里，都不清楚。
现在，StructureClaw 已经实现完整的分阶段实时过程展现。发出请求后，你可以看到整个工程计算管线是如何一步步执行的。
五阶段管线，实时可见
理解意图 → 建模 → 校验 → 分析 → 报告
每个阶段都有独立进度状态（pending / running / done / error），并在阶段之间自动流转。
步骤级实时流
每个阶段下都能看到具体工具调用步骤，例如“提取参数”“转换模型”“运行 SATWE”等。每一步都有开始、完成或报错状态，并附带时间戳与耗时信息。
技能标签
每个步骤都会标注当前由哪个技能执行，例如 pkpm-static、frame，让你知道“是谁在干活”。
产物状态卡片
模型、分析结果、报告三个产物分别拥有独立状态（pending / available / error），完成后即可预览，不再需要盲等。
为什么这件事重要
工程计算并不是秒回任务。一次 PKPM SATWE 分析往往需要几分钟。如果界面上只有一个 loading，用户很容易误以为系统卡住了。现在你可以清楚看到“正在转换模型 → 正在运行 SATWE → 正在提取结果”，整个过程更可感知，也更让人放心。
结构龙虾的基础设施
三件新功能让结构龙虾系统更扎实
并发会话
前端支持多个聊天会话同时存在、同时流式接收消息，也支持流取消与消息持久化。你可以并行发起多个分析任务，不必串行等待。
V1 → V2 模型统一
StructureModel 内部格式已统一迁移至 V2，作为唯一模型格式。所有分析引擎都从同一个 V2 格式出发，减少版本转换带来的歧义。
严格技能激活
只有用户显式选择的技能才会被激活，对应工具才会执行。工作流边界更加清晰，不相关技能不会干扰结果。
