DualSPHysics Studio v1.0.3

DualSPHysics Studio v1.0.3

本版本继续面向 DualSPHysics v5.4，增加运行记录对比、DLC 来源与信任信息，以及集成在 Studio 本体预检流程中的 Mesh Doctor。

主要新增

• 按 XML SHA-256 与 CPU/GPU 后端比较兼容运行记录，并可导出原始 CSV。
• 支持 dss-extension.json DLC 元数据、许可与发布者展示，以及每次会话首次启动信任确认。
• 在现有 STL/legacy VTK 资源预检中集成 Mesh Doctor；预算内 STL 可检查边界/非流形边、重复/退化面、方向、法向、连通分量、表面积、包围盒、封闭性和封闭体积。
• 提供 DSS Output Auditor、DSS Mesh Doctor、DSS PostLab 与 DSS Validation Lab 的 DLC 源码与便携构建支持。

安全边界

• Mesh Doctor 深度拓扑检查限制为 256 MiB 或 100,000 个三角形；超出后仍执行资源预检，但不伪造拓扑结论。
• DLC manifest 的 EXE 与许可路径必须保持在声明目录内；无效 manifest 不会静默启动。
• 本软件不包含 DualSPHysics 官方二进制，只调用用户已有的 v5.4 工具。

Windows EXE 尚未进行 Authenticode 签名。下载后请使用本 Release 的 SHA256SUMS.txt 核对文件完整性。

完整变更见仓库中的 CHANGELOG.md。

DualSPHysics Studio v1.0.2

这是运行工作流与可复现性更新，重点加入资源估算、运行中心和可审计运行记录。

新增与改进

• 启动前提供保守的粒子规模、内存、显存、磁盘与耗时估算，并在 GenCase/求解后用实测信息修正。
• 新增运行中心：阶段状态、实时日志、进度、ETA、历史记录、打开输出、重新运行与诊断导出。
• 新增强确认的一键完整流程：GenCase → 明确选择的 CPU/GPU 求解器 → PartVTK；不静默切换后端，不省略 VTK。
• 每次运行在独立输出目录保存 .dss-run 原子记录、XML 快照、工具与配置哈希、阶段日志和实际结果。
• 诊断 ZIP 默认包含 XML；有隐私需求时可主动排除，导出内容始终脱敏本地路径。
• 修复 Windows 短路径与长路径别名导致的会话路径比较和脱敏占位符不一致。

下载

Windows x64 用户下载 DualSPHysics-Studio-v1.0.2-windows-x64.zip。程序为便携目录，解压后请保持目录结构完整。

验证

• GitHub Actions Windows / Python 3.13 CI 通过
• 143 项自动化测试通过
• 源码与冻结程序冒烟测试通过
• 发布 ZIP 的 145 个条目全部解压校验通过
• 发布附件 SHA-256 与隐私文件审计通过

DualSPHysics Studio v1.0.1

DualSPHysics Studio v1.0.1

这是首个稳定性更新，重点改善大型模型加载安全、算例诊断和 XML 参数编辑体验。

新增与改进

• 大型 STL/legacy VTK 加载前执行文件、点/单元和保守内存预算预检；高风险模型需确认，超过硬上限时阻止加载。
• 新增“算例医生”：按错误、警告和建议筛选 XML 问题，并提供 GenCase 快速检查入口。
• 双击诊断的“级别/问题”可打开完整详情页，查看诊断代码、完整描述、XML 路径、行号和源码上下文；双击“位置”仍可直接跳转。
• 新增可搜索的 XML 参数工作台，支持现有几何参数、物理常量和执行参数的无损编辑、校验与撤销。
• 版本、便携包说明、第三方声明和发布元数据统一为 1.0.1。

下载

Windows x64 用户下载 DualSPHysics-Studio-v1.0.1-windows-x64.zip。程序为便携目录，解压后请保持目录结构完整。

首次运行前请使用随附的 SHA256SUMS.txt 核对 SHA-256。三个 Qt/PySide 源码归档用于满足对应开源许可证的源码提供要求。

验证

• 132 项自动化测试通过
• 源码与冻结程序冒烟测试通过
• 发布 ZIP CRC、143 个文件结构及 SHA-256 校验通过

完整改动见 CHANGELOG.md。

DualSPHysics Studio v1.0.0

DualSPHysics Studio v1.0.0

DualSPHysics Studio 的首个公开版本：一个面向 DualSPHysics v5.4 的 Windows XML 可视化编辑器与本地计算流程前端。

主要功能

• XML 源码、结构树、参数说明与 3D 场景联动。
• drawbox、drawprism 几何预览和交互编辑。
• STL、VTK 外部模型查看。
• 流体、固定边界、浮动刚体关联诊断。
• GenCase、CPU/GPU 求解器和 PartVTK 本地流程集成。
• 可选 OpenAI Responses API 中文解读；离线编辑和模拟流程不依赖网络。
• 用户主动安装的独立便携工具可通过 DLC 目录发现和启动。

安全与可靠性

• XML 禁用 DTD、外部实体和网络解析，并限制文件字节数、字符数、元素数及嵌套深度。
• DualSPHysics 可执行文件仅从已保存设置、DUALSPHYSICS_ROOT 或用户明确选择的目录解析。
• 求解器与 DLC 工具均直接启动，不经过命令行 shell 或 BAT。
• 已存在的求解结果和目标 VTK 不会被自动删除或覆盖。
• 保存 XML 前自动创建源文件备份。
• 依赖审计未发现已知漏洞；官方 CPython 3.13.14 环境下 119 项测试全部通过。

下载与使用

1. 下载 DualSPHysics-Studio-v1.0.0-windows-x64.zip。
2. 校验 SHA-256 后完整解压。
3. 运行 DualSPHysicsStudio.exe。
4. 首次运行时选择合法取得的 DualSPHysics v5.4 根目录，或设置 DUALSPHYSICS_ROOT。

本项目不附带 DualSPHysics 官方二进制或案例。独立的 OSGB-to-STL 便携工具也不在主发布包内；用户可将其完整目录放到解压后的 DLC 目录，Studio 会按既有机制发现它。

Windows PowerShell 校验示例：

(Get-FileHash .\DualSPHysics-Studio-v1.0.0-windows-x64.zip -Algorithm SHA256).Hash.ToLowerInvariant()

发布目录中的 SHA256SUMS.txt 给出了所有手动上传资产的校验值。

开源与许可证

Studio 自有源码采用 MIT License。Windows 便携包包含 Qt for Python、VTK、Python 运行时及其他第三方组件，其完整声明位于包内 THIRD_PARTY_LICENSES.txt。

本 Release 同时附带 PySide、Qt Base 和 Qt SVG 6.11.1 的对应源码归档，以满足公开分发所需的源码可得性。GitHub 自动生成的 Source code 归档对应 Studio 提交 d6d914c757f6c8438c580a7ce67c438c81ae804d。

已知限制

• Windows 可执行文件尚未使用 Authenticode 证书签名，首次运行可能出现 SmartScreen 提示；请先核对 SHA-256。
• 仅支持 Windows x64 与 DualSPHysics v5.4 工作流。
• Studio 不验证用户选择的 DualSPHysics 或 DLC 可执行文件的发行者身份；只应使用可信来源的软件。

---

English summary: This is the first public Windows x64 release of DualSPHysics Studio, an independent XML visual editor and local workflow frontend for DualSPHysics v5.4. DualSPHysics binaries and the separately distributed OSGB-to-STL DLC are not bundled. Verify SHA256SUMS.txt before use.