docs: examples/Readme.html v2.1 更新引擎 DLL 架构说明

2026-06-21 17:05:19 +08:00
parent 75d8aae1f2
commit b50c55d0a3
1 changed files with 17 additions and 4 deletions
@@ -169,7 +169,7 @@
 <body>
 <div class="container">

-<h1>Dynamics 示例案例 <small>v2.0</small></h1>
+<h1>Dynamics 示例案例 <small>v2.1</small></h1>
 <p class="subtitle">10 个从简单到复杂的物理模拟案例，展示分子动力学模拟框架的多种应用场景</p>

 <h2>📋 案例总览</h2>
@@ -412,7 +412,12 @@
  <h3>配置</h3>
  <p style="color:var(--text-dim); font-size:0.875rem;">
    每个案例的 <code>input/input.txt</code> 可配置物理参数、力开关、算法、引擎、渲染方式等。
-    从 case06 起支持 <code>save_trajectory</code> 开关、摄像机初始位置、<code>display_amp</code> 视觉放大等高级功能。
+  </p>
+
+  <h3>引擎架构</h3>
+  <p style="color:var(--text-dim); font-size:0.875rem;">
+    外部引擎（C / C++ / Fortran）以 <strong>DLL 方式</strong> 运行，主程序通过 ctypes 在进程内直接调用，不启动子进程。DLL 预编译在 <code>engines/release/</code> 中，源码位于 <code>engines/src/{c,cpp,fortran}/</code>。重新编译：
+    <code>cd engines/src/c && make dll</code>
  </p>
 </div>

@@ -421,10 +426,18 @@
 <pre style="font-size:0.825rem; color:var(--text-dim); line-height:1.5;">
 dynamics/
 ├── dynamics.py          # 统一运行入口
-├── compute.py           # Python 物理引擎
+├── compute.py           # 物理引擎 + 显示数据生成
 ├── draw.py              # VisPy 3D 动画
 ├── plot_wave.py         # 波形能量图
-├── engines/             # C / C++ / Fortran 引擎
+├── .gitattributes       # DLL/二进制文件保护
+├── engines/
+│   ├── engine_dll.py    # DLL 加载器（ctypes）
+│   ├── python/          # Python 引擎（dynamics_lib.py）
+│   ├── release/         # 预编译 DLL（C / C++ / Fortran）
+│   └── src/             # 引擎源码
+│       ├── c/           # C 源码 + Makefile → dynamics_c.dll
+│       ├── cpp/         # C++ 源码 + Makefile → dynamics_cpp.dll
+│       └── fortran/     # Fortran 源码 + Makefile → dynamics_f90.dll
 ├── examples/            # 案例目录
 │   ├── case01/  ~  case10/
 └── output/              # 默认输出目录