diff --git a/App/Hi.Wpf.dll b/App/Hi.Wpf.dll
index b3e18b0..e552bd3 100644
Binary files a/App/Hi.Wpf.dll and b/App/Hi.Wpf.dll differ
diff --git a/App/HiCbtr.dll b/App/HiCbtr.dll
index c56a7db..becd67b 100644
Binary files a/App/HiCbtr.dll and b/App/HiCbtr.dll differ
diff --git a/App/HiDisp.dll b/App/HiDisp.dll
index 41147f0..9b2613e 100644
Binary files a/App/HiDisp.dll and b/App/HiDisp.dll differ
diff --git a/App/HiGeom.dll b/App/HiGeom.dll
index 20a3da1..4fa2b7f 100644
Binary files a/App/HiGeom.dll and b/App/HiGeom.dll differ
diff --git a/App/HiLicense.dll b/App/HiLicense.dll
index 30f6bc5..8ce243e 100644
Binary files a/App/HiLicense.dll and b/App/HiLicense.dll differ
diff --git a/App/HiMech.dll b/App/HiMech.dll
index 7ead020..b51c698 100644
Binary files a/App/HiMech.dll and b/App/HiMech.dll differ
diff --git a/App/HiNC-2025-win-desktop.deps.json b/App/HiNC-2025-win-desktop.deps.json
index 4631222..12f895f 100644
--- a/App/HiNC-2025-win-desktop.deps.json
+++ b/App/HiNC-2025-win-desktop.deps.json
@@ -11,8 +11,8 @@
         "dependencies": {
           "AvalonEdit": "6.3.0.90",
           "FontAwesome.Sharp": "6.3.0",
-          "Hi.Wpf": "3.1.69",
-          "HiNc": "3.1.90",
+          "Hi.Wpf": "3.1.70",
+          "HiNc": "3.1.91",
           "runtimepack.Microsoft.NETCore.App.Runtime.win-x64": "9.0.11",
           "runtimepack.Microsoft.WindowsDesktop.App.Runtime.win-x64": "9.0.11",
           "runtimepack.Microsoft.AspNetCore.App.Runtime.win-x64": "9.0.11"
@@ -1600,39 +1600,39 @@
           }
         }
       },
-      "Hi.Wpf/3.1.69": {
+      "Hi.Wpf/3.1.70": {
         "dependencies": {
-          "HiDisp": "3.1.74"
+          "HiDisp": "3.1.75"
         },
         "runtime": {
           "lib/net9.0-windows7.0/Hi.Wpf.dll": {
-            "assemblyVersion": "3.1.69.0",
-            "fileVersion": "3.1.69.0"
+            "assemblyVersion": "3.1.70.0",
+            "fileVersion": "3.1.70.0"
           }
         }
       },
-      "HiCbtr/3.1.74": {
+      "HiCbtr/3.1.75": {
         "dependencies": {
-          "HiDisp": "3.1.74"
+          "HiDisp": "3.1.75"
         },
         "runtime": {
           "lib/net9.0/HiCbtr.dll": {
-            "assemblyVersion": "3.1.74.0",
-            "fileVersion": "3.1.74.0"
+            "assemblyVersion": "3.1.75.0",
+            "fileVersion": "3.1.75.0"
           }
         }
       },
-      "HiDisp/3.1.74": {
+      "HiDisp/3.1.75": {
         "dependencies": {
-          "HiGeom": "3.1.69",
+          "HiGeom": "3.1.70",
           "System.Configuration.ConfigurationManager": "10.0.0",
           "System.Drawing.Common": "10.0.0",
           "System.Resources.Extensions": "10.0.0"
         },
         "runtime": {
           "lib/net9.0/HiDisp.dll": {
-            "assemblyVersion": "3.1.74.0",
-            "fileVersion": "3.1.74.0"
+            "assemblyVersion": "3.1.75.0",
+            "fileVersion": "3.1.75.0"
           }
         },
         "native": {
@@ -1647,7 +1647,7 @@
           }
         }
       },
-      "HiGeom/3.1.69": {
+      "HiGeom/3.1.70": {
         "dependencies": {
           "Google.Protobuf": "3.28.3",
           "Grpc.AspNetCore": "2.66.0",
@@ -1658,8 +1658,8 @@
         },
         "runtime": {
           "lib/net9.0/HiGeom.dll": {
-            "assemblyVersion": "3.1.69.0",
-            "fileVersion": "3.1.69.0"
+            "assemblyVersion": "3.1.70.0",
+            "fileVersion": "3.1.70.0"
           }
         },
         "resources": {
@@ -1671,27 +1671,27 @@
           }
         }
       },
-      "HiLicense/3.1.69": {
+      "HiLicense/3.1.70": {
         "dependencies": {
-          "HiGeom": "3.1.69"
+          "HiGeom": "3.1.70"
         },
         "runtime": {
           "lib/net9.0/HiLicense.dll": {
-            "assemblyVersion": "3.1.69.0",
-            "fileVersion": "3.1.69.0"
+            "assemblyVersion": "3.1.70.0",
+            "fileVersion": "3.1.70.0"
           }
         }
       },
-      "HiMech/3.1.81": {
+      "HiMech/3.1.82": {
         "dependencies": {
           "CommandLineParser": "2.9.1",
-          "HiCbtr": "3.1.74",
+          "HiCbtr": "3.1.75",
           "Microsoft.CodeAnalysis.CSharp.Scripting": "5.0.0"
         },
         "runtime": {
           "lib/net9.0/HiMech.dll": {
-            "assemblyVersion": "3.1.81.0",
-            "fileVersion": "3.1.81.0"
+            "assemblyVersion": "3.1.82.0",
+            "fileVersion": "3.1.82.0"
           }
         },
         "resources": {
@@ -1706,20 +1706,20 @@
           }
         }
       },
-      "HiNc/3.1.90": {
+      "HiNc/3.1.91": {
         "dependencies": {
           "Google.Protobuf": "3.28.3",
           "Grpc.AspNetCore": "2.66.0",
           "Grpc.Net.Client": "2.66.0",
-          "HiLicense": "3.1.69",
-          "HiMech": "3.1.81",
-          "HiUniNc": "3.1.78",
+          "HiLicense": "3.1.70",
+          "HiMech": "3.1.82",
+          "HiUniNc": "3.1.79",
           "System.IO.Pipelines": "10.0.0"
         },
         "runtime": {
           "lib/net9.0/HiNc.dll": {
-            "assemblyVersion": "3.1.90.0",
-            "fileVersion": "3.1.90.0"
+            "assemblyVersion": "3.1.91.0",
+            "fileVersion": "3.1.91.0"
           }
         },
         "resources": {
@@ -1731,14 +1731,14 @@
           }
         }
       },
-      "HiUniNc/3.1.78": {
+      "HiUniNc/3.1.79": {
         "dependencies": {
-          "HiMech": "3.1.81"
+          "HiMech": "3.1.82"
         },
         "runtime": {
           "lib/net9.0/HiUniNc.dll": {
-            "assemblyVersion": "3.1.78.0",
-            "fileVersion": "3.1.78.0"
+            "assemblyVersion": "3.1.79.0",
+            "fileVersion": "3.1.79.0"
           }
         }
       },
@@ -2219,61 +2219,61 @@
       "path": "grpc.net.common/2.66.0",
       "hashPath": "grpc.net.common.2.66.0.nupkg.sha512"
     },
-    "Hi.Wpf/3.1.69": {
+    "Hi.Wpf/3.1.70": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-eeh5Rtl+QCxA7Ikm2Bwv9AGWvDBlN4tWIs/KZRlboDNt/ODXk2D9Pws5Y7Y1sWYQOAh5vd6LvITH8f6CbCTIVw==",
-      "path": "hi.wpf/3.1.69",
-      "hashPath": "hi.wpf.3.1.69.nupkg.sha512"
+      "sha512": "sha512-XWWn/kqW/B+uJe9wrcVJbJM4oNyrTy81Gt5lkLdZiik62ZybFyzr+wkzyi7fhvEZdtYdx/Bh4O9HLB/vB9LPhA==",
+      "path": "hi.wpf/3.1.70",
+      "hashPath": "hi.wpf.3.1.70.nupkg.sha512"
     },
-    "HiCbtr/3.1.74": {
+    "HiCbtr/3.1.75": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-DrBrm0QWJidZ/u5cgt+s6jyUZDs5RuLzKV3h8ur5cIlS1uzfqAB9WmBfVOlN069CeJfkEm8l8+JicLykOEenwQ==",
-      "path": "hicbtr/3.1.74",
-      "hashPath": "hicbtr.3.1.74.nupkg.sha512"
+      "sha512": "sha512-UFRlHCWAiAKJ/ri+kOWBvibIcQuelhUg/oARfuHl40zykStEDieE7Pj11G0zBuD4HdCBI9g6leQYBQ/fhjFTVw==",
+      "path": "hicbtr/3.1.75",
+      "hashPath": "hicbtr.3.1.75.nupkg.sha512"
     },
-    "HiDisp/3.1.74": {
+    "HiDisp/3.1.75": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-pP/vEIiz6iYVwHpq8kkzcDMATG5SBFZjb7oqafh+frrBV/2jkCBNy0RYbhttpHm4dl+n0SrxYfxSScD8rlxPzA==",
-      "path": "hidisp/3.1.74",
-      "hashPath": "hidisp.3.1.74.nupkg.sha512"
+      "sha512": "sha512-+9eKXTkiRtV6XWJJKFRwnL17dXauNe3+tXUrpMucR/VBcBxN8nORjVyY4Zwtd30oElcsfXhVM+n6OBC3VTiq5w==",
+      "path": "hidisp/3.1.75",
+      "hashPath": "hidisp.3.1.75.nupkg.sha512"
     },
-    "HiGeom/3.1.69": {
+    "HiGeom/3.1.70": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-8RFW9qMraHvYufrxKor69bWzGrueiamy4hOd7Tc9+Fqz7nBduTKzVvCPKX1xQixQaAzk5RB3GiYNXuPIh80srg==",
-      "path": "higeom/3.1.69",
-      "hashPath": "higeom.3.1.69.nupkg.sha512"
+      "sha512": "sha512-d7QgPPw914inkiW9CKHiMxxDK00YkP+JzbsryONDpWj7DA8FwdKaT2iZ84yL+3uxkw61Hb2KZ1/YaBsaGqauFg==",
+      "path": "higeom/3.1.70",
+      "hashPath": "higeom.3.1.70.nupkg.sha512"
     },
-    "HiLicense/3.1.69": {
+    "HiLicense/3.1.70": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-dSIp1pnmP7nqjG5AI8TQdHUkGPX93qDwk4OVoSMNOFyNfoI7a5ZR9hyad9vUgRgSLQhNmTgGbYuT8VP+/gUhUA==",
-      "path": "hilicense/3.1.69",
-      "hashPath": "hilicense.3.1.69.nupkg.sha512"
+      "sha512": "sha512-Qw0yWnQicboO9He979f9cz6fyZFpaEwIXjWJDkebQxPDCIFxeFnsHj//6rYulR1mvdkYOk19QMsqKoMRzRm0vw==",
+      "path": "hilicense/3.1.70",
+      "hashPath": "hilicense.3.1.70.nupkg.sha512"
     },
-    "HiMech/3.1.81": {
+    "HiMech/3.1.82": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-CzMve1k9P9iqcBYcALiCDe4tkTEkMWFHEbbH58njjza8gK8qPXUBPQcxSUo5VEDGYxT6Pfl7JW2KCfw37mRNbg==",
-      "path": "himech/3.1.81",
-      "hashPath": "himech.3.1.81.nupkg.sha512"
+      "sha512": "sha512-7dqJ5I6p56qgadthQNcH9DlKeOB/T5/AKua0g2C4KLn9APXsQKPcKbGV5KtYIrTD/TOBFEG6elpODkUYkF76Iw==",
+      "path": "himech/3.1.82",
+      "hashPath": "himech.3.1.82.nupkg.sha512"
     },
-    "HiNc/3.1.90": {
+    "HiNc/3.1.91": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-wwuecFVd4yJBz000fR4e9ffPv1XTW6Ou0noyvrWt1OYHy15Fg6/yBOOmUJXnm05qdgLpdQWn2mTUKv1gY9zI0Q==",
-      "path": "hinc/3.1.90",
-      "hashPath": "hinc.3.1.90.nupkg.sha512"
+      "sha512": "sha512-bwN/vgKnBv9JHxyQZEal7xgdE52nwVvplOVcK7J5Myw5uPE+5/uylpA3DidrE1YiJAdcrT+M+vRe1pNJyGwwNw==",
+      "path": "hinc/3.1.91",
+      "hashPath": "hinc.3.1.91.nupkg.sha512"
     },
-    "HiUniNc/3.1.78": {
+    "HiUniNc/3.1.79": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-a/NpehkA+3sH3TATGIcZNoonh7sbOj6nrE6+uqpmlBXMvlthPAbbhXZU95fidj2KAQbn1z2XsbAwd7gWQlil5A==",
-      "path": "hiuninc/3.1.78",
-      "hashPath": "hiuninc.3.1.78.nupkg.sha512"
+      "sha512": "sha512-bMbAWwRVuRN1QF+rYd4/99L8bHFXfYQmlJJlSn2q1FI6DzXNMZ5RtPUpWKeUT8IXU7dOkQcZPOO5vsnOM5JAzQ==",
+      "path": "hiuninc/3.1.79",
+      "hashPath": "hiuninc.3.1.79.nupkg.sha512"
     },
     "MathNet.Numerics/5.0.0": {
       "type": "package",
diff --git a/App/HiNC-2025-win-desktop.dll b/App/HiNC-2025-win-desktop.dll
index 26336fb..8f2df7a 100644
Binary files a/App/HiNC-2025-win-desktop.dll and b/App/HiNC-2025-win-desktop.dll differ
diff --git a/App/HiNC-2025-win-desktop.exe b/App/HiNC-2025-win-desktop.exe
index 6d808d9..24a770c 100644
Binary files a/App/HiNC-2025-win-desktop.exe and b/App/HiNC-2025-win-desktop.exe differ
diff --git a/App/HiNC-2025-win-desktop.pdb b/App/HiNC-2025-win-desktop.pdb
index cc97c77..51fd64a 100644
Binary files a/App/HiNC-2025-win-desktop.pdb and b/App/HiNC-2025-win-desktop.pdb differ
diff --git a/App/HiNc.dll b/App/HiNc.dll
index 8e80732..38855b6 100644
Binary files a/App/HiNc.dll and b/App/HiNc.dll differ
diff --git a/App/HiUniNc.dll b/App/HiUniNc.dll
index 6965633..0bf203a 100644
Binary files a/App/HiUniNc.dll and b/App/HiUniNc.dll differ
diff --git a/App/en/HiGeom.resources.dll b/App/en/HiGeom.resources.dll
index 9ffdc6c..b238c6d 100644
Binary files a/App/en/HiGeom.resources.dll and b/App/en/HiGeom.resources.dll differ
diff --git a/App/en/HiMech.resources.dll b/App/en/HiMech.resources.dll
index 07e6f48..c45ff60 100644
Binary files a/App/en/HiMech.resources.dll and b/App/en/HiMech.resources.dll differ
diff --git a/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.MachiningProject.html b/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.MachiningProject.html
index 81f488b..39ba9bd 100644
--- a/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.MachiningProject.html
+++ b/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.MachiningProject.html
@@ -2165,7 +2165,7 @@ Since the folder can be moving with the configuration file.</p>
   <div class="markdown level1 conceptual"></div>
 
   <div class="codewrapper">
-    <pre><code class="lang-csharp hljs">public void TrainMillingPara(SampleFlag sampleFlags, bool enableFzOnlyDuringDrilling, double outlierRatio, string dstRelFile, CancellationToken cancellationToken, ICuttingPara paraTemplate = null)</code></pre>
+    <pre><code class="lang-csharp hljs">public void TrainMillingPara(SampleFlag sampleFlags, bool enableFzOnlyDuringDrilling, double outlierRatio, string dstRelFile, CancellationToken cancellationToken, ICuttingPara paraTemplate)</code></pre>
   </div>
 
   <h4 class="section">Parameters</h4>
diff --git a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
index 8fc5478..16e5898 100644
--- a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
+++ b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
@@ -216,7 +216,7 @@ Class StepTimeShotUtil
   <div class="markdown level1 conceptual"></div>
 
   <div class="codewrapper">
-    <pre><code class="lang-csharp hljs">public static List&lt;ITimeShot&gt; GetTimeShotByFile(string file, Action&lt;int&gt; LineReaded, CancellationToken? cancellationToken = null)</code></pre>
+    <pre><code class="lang-csharp hljs">public static List&lt;ITimeShot&gt; GetTimeShotByFile(string file, Action&lt;int&gt; lineReaded, CancellationToken? cancellationToken = null)</code></pre>
   </div>
 
   <h4 class="section">Parameters</h4>
@@ -224,7 +224,7 @@ Class StepTimeShotUtil
     <dt><code>file</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.string">string</a></dt>
     <dd><p>The file path to read time shots from.</p>
 </dd>
-    <dt><code>LineReaded</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.action-1">Action</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>&gt;</dt>
+    <dt><code>lineReaded</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.action-1">Action</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>&gt;</dt>
     <dd><p>Action to call when a line is read, providing progress feedback with the current line number.</p>
 </dd>
     <dt><code>cancellationToken</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken">CancellationToken</a>?</dt>
diff --git a/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html b/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
index 6d2738b..f2056cb 100644
--- a/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
+++ b/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
@@ -87,19 +87,10 @@
         <article data-uid="">
           <h1 id="release-note">Release Note</h1>
 
-<h2 id="hinc-packages-version-3189">HiNc Packages Version 3.1.89</h2>
+<h2 id="hinc-packages-version-3190">HiNc Packages Version 3.1.90</h2>
 <ul>
-<li>Rename optimization log API: <code>OptEnableFlatProcLog</code> → &lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*&gt;</li>
-<li>Various stability improvements and bug fixes</li>
-</ul>
-<h2 id="hinc-packages-version-3188">HiNc Packages Version 3.1.88</h2>
-<ul>
-<li>Rename optimization log API for clarity (see <a href="../../user-guide/zh-Hant/script/NcOptimization/index.html#%E5%84%AA%E5%8C%96%E6%97%A5%E8%AA%8C">優化日誌</a>):
-<ul>
-<li><code>OptEnableFirstSituProcLog</code> → <code>OptEnableFlatProcLog</code></li>
-<li><code>OptEnableNcEmbeddedLog</code> → <a class="xref" href="../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableEmbeddedLog_">OptEnableEmbeddedLog</a></li>
-</ul>
-</li>
+<li>Rename optimization log API <a class="xref" href="../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_EnableIndividualStepAdjustmentLog_">EnableIndividualStepAdjustmentLog</a></li>
+<li>Fix crash from workpiece displaying with specific mechanical topology setting</li>
 <li>Improve <code>.flatproc.log</code> output to maintain step order during parallel computation</li>
 <li>Various stability improvements and bug fixes</li>
 </ul>
diff --git a/App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/NcOptimization/index.html b/App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/NcOptimization/index.html
index 8e20cb4..60320fa 100644
--- a/App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/NcOptimization/index.html
+++ b/App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/NcOptimization/index.html
@@ -242,7 +242,7 @@ N0170 X-4.125 Y45.875
 <h2 id="優化日誌">優化日誌</h2>
 <p>優化過程提供兩種日誌功能，方便分析與除錯。</p>
 <h3 id="優化過程日誌檔">優化過程日誌檔</h3>
-<p>&lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*&gt;<small>(API)</small>：啟用優化過程日誌檔輸出。預設為真。</p>
+<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_EnableIndividualStepAdjustmentLog_">EnableIndividualStepAdjustmentLog</a><small>(API)</small>：啟用優化過程日誌檔輸出。預設為真。</p>
 <p>啟用後，優化過程會為每個NC檔輸出一個 <code>.flatproc.log</code> 檔案，記錄各步階的優化條件經<a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptExtendedPreDistance_mm">OptExtendedPreDistance_mm</a><small>(API)</small>及<a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptExtendedPostDistance_mm">OptExtendedPostDistance_mm</a><small>(API)</small>展開後獨立優化計算的資訊（不包含步階間的交互關係，如加減速）。</p>
 <p>日誌檔案內容依步階順序輸出（即使平行計算時也會保持順序），每行包含：</p>
 <ul>
@@ -270,7 +270,7 @@ N0170 X-4.125 Y45.875
 <div class="NOTE">
 <h5>Note</h5>
 <p><strong>指令格式</strong></p>
-<pre><code class="lang-csharp">OptEnableSituStepAdjustmentLog = &lt;布林值&gt;;
+<pre><code class="lang-csharp">EnableIndividualStepAdjustmentLog = &lt;布林值&gt;;
 OptEnableEmbeddedLog = &lt;布林值&gt;;
 </code></pre>
 </div>
diff --git a/App/wwwroot/HiAPI-docsite/index.json b/App/wwwroot/HiAPI-docsite/index.json
index 95da0e5..7ad8b3c 100644
--- a/App/wwwroot/HiAPI-docsite/index.json
+++ b/App/wwwroot/HiAPI-docsite/index.json
@@ -1927,7 +1927,7 @@
   "api/Hi.MachiningProcs.MachiningProject.html": {
     "href": "api/Hi.MachiningProcs.MachiningProject.html",
     "title": "Class MachiningProject | HiAPI-C# 2025",
-    "summary": "Class MachiningProject Namespace Hi.MachiningProcs Assembly HiNc.dll Represents a milling project that manages the execution, simulation, and analysis of NC programs. public class MachiningProject : IDisposable, IMachiningStepHost, IGetMachiningEquipment, IMakeXmlSource, IMachiningProjectGetter Inheritance object MachiningProject Implements IDisposable IMachiningStepHost IGetMachiningEquipment IMakeXmlSource IMachiningProjectGetter Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Constructors MachiningProject(string) Initializes a new instance of the MachiningProject class with the specified directory. Uses the default MongoDB connection. public MachiningProject(string baseDirectory) Parameters baseDirectory string Base directory for file operations MachiningProject(string, MongoClient) Initializes a new instance of the MachiningProject class with the specified directory and MongoDB client. public MachiningProject(string baseDirectory, MongoClient mongoClient) Parameters baseDirectory string Base directory for file operations mongoClient MongoClient MongoDB client instance MachiningProject(XElement, string) Initializes a new instance of the MachiningProject class from XML data using MongoDB. public MachiningProject(XElement src, string baseDirectory) Parameters src XElement XML element containing configuration data baseDirectory string Base directory for resolving relative paths MachiningProject(XElement, string, MongoClient) Initializes a new instance of the MachiningProject class from XML data. public MachiningProject(XElement src, string baseDirectory, MongoClient mongoClient) Parameters src XElement XML element containing configuration data baseDirectory string Base directory for resolving relative paths mongoClient MongoClient MongoDB client instance Properties ApiVersion Gets the API version from the entry assembly. public static Version ApiVersion { get; } Property Value Version BaseDirectory Gets the base directory where project files are located. public string BaseDirectory { get; } Property Value string BoundSelectorHost Gets the bound selector host for managing selection boundaries. public BoundSelectorHost BoundSelectorHost { get; } Property Value BoundSelectorHost ClStrip Gets the cutter location strip. public ClStrip ClStrip { get; } Property Value ClStrip CoordinateEntryDisplayee Gets the displayee for coordinate entry visualization. public CoordinateEntryDisplayee CoordinateEntryDisplayee { get; } Property Value CoordinateEntryDisplayee DictionaryColorGuide Gets the color guide for dictionary-based coloring. public DictionaryColorGuide DictionaryColorGuide { get; } Property Value DictionaryColorGuide EnableCollisionDetection Gets or sets whether collision detection is enabled. When set to true, initializes collision detection mechanism. public bool EnableCollisionDetection { get; set; } Property Value bool EnablePauseOnFailure Enable Pause On Failure Detected. Only take effect if the EnableCollisionDetection or EnableStrokeLimitCheck is enabled. public bool EnablePauseOnFailure { get; set; } Property Value bool EnableStrokeLimitCheck Gets or sets whether stroke limit checking is enabled. public bool EnableStrokeLimitCheck { get; set; } Property Value bool Global global variable for RuntimeApi. Not save on XML. public Dictionary<object, object> Global { get; set; } Property Value Dictionary<object, object> InspectingKey Gets or sets the current inspecting key for visualization. When set, updates the inspecting quantity function. public string InspectingKey { get; set; } Property Value string InspectingQuantityFunc Gets the function that retrieves the quantity value for the current inspecting key. public Func<MachiningStep, double?> InspectingQuantityFunc { get; } Property Value Func<MachiningStep, double?> MachiningActRunner Gets the machining act runner responsible for executing machining operations. public MachiningActRunner MachiningActRunner { get; } Property Value MachiningActRunner MachiningEquipment Gets or sets the machining equipment used for milling. Updates related components when changed. public MachiningEquipment MachiningEquipment { get; set; } Property Value MachiningEquipment MachiningSession Gets or sets the current machining session. public MachiningSession MachiningSession { get; set; } Property Value MachiningSession MachiningToolHouse Gets or sets the milling tool house containing available tools. public MachiningToolHouse MachiningToolHouse { get; set; } Property Value MachiningToolHouse MachiningToolHouseFile Gets or sets the file path to the milling tool house configuration. public string MachiningToolHouseFile { get; set; } Property Value string MillingActRunnerConfig Gets or sets the configuration for the milling act runner. public MillingActRunnerConfig MillingActRunnerConfig { get; set; } Property Value MillingActRunnerConfig MillingGuide Gets or sets the milling guide containing visualization and analysis configurations. public MillingGuide MillingGuide { get; set; } Property Value MillingGuide MillingStepLuggageReader Gets the reader for accessing milling step luggage data. public ParallelBulkReader<MillingStepLuggage> MillingStepLuggageReader { get; } Property Value ParallelBulkReader<MillingStepLuggage> NcEnv Gets the NC environment from the NC runner. public NcEnv NcEnv { get; } Property Value NcEnv NcOptOptionDictionary Gets or sets the dictionary of NC optimization options. public Dictionary<string, NcOptOption> NcOptOptionDictionary { get; set; } Property Value Dictionary<string, NcOptOption> NcOptProc Gets the NC optimization processor for optimizing NC programs. public NcOptProc NcOptProc { get; } Property Value NcOptProc NcRunner Gets the NC runner responsible for executing NC programs. public NcRunner NcRunner { get; } Property Value NcRunner PacePlayer Gets the pace player for controlling execution pace of milling operations. public PacePlayer PacePlayer { get; } Property Value PacePlayer PlayerCommand Gets the command to execute when playing the machining project. public IShellCommand PlayerCommand { get; set; } Property Value IShellCommand Progress Gets the progress reporting mechanism for long-running operations. public Progress<IProgressReport> Progress { get; } Property Value Progress<IProgressReport> RuntimeApi Gets the shell API for interacting with this machining process. public RuntimeApi RuntimeApi { get; } Property Value RuntimeApi SessionMessageHost Gets the message host for displaying messages, warnings, and errors. public SessionMessageHost SessionMessageHost { get; } Property Value SessionMessageHost StepPropertyAccessDictionary Gets the dictionary mapping property keys to their access methods. public ConcurrentDictionary<string, PropertyAccess<MachiningStep>> StepPropertyAccessDictionary { get; } Property Value ConcurrentDictionary<string, PropertyAccess<MachiningStep>> TimeMapping Gets or sets the time mapping for synchronizing different time-based data streams. Creates a new time mapping if one doesn't exist. public TimeMapping TimeMapping { get; set; } Property Value TimeMapping Workpiece Gets or sets the workpiece to be machined. Ensures proper initialization of workpiece properties. public Workpiece Workpiece { get; set; } Property Value Workpiece XName Name for XML IO. public static string XName { get; } Property Value string Methods Act(IAct, IIndexedFileLine, CancellationToken?) Executes an act and collects all results. public void Act(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to execute. sourceCommand IIndexedFileLine The source command that triggered the act. cancellationToken CancellationToken? Cancellation token to cancel the operation. BeginSession() Initiate a simulation session. Clear the state from previous session (if existed). public void BeginSession() Dispose() Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. public void Dispose() Dispose(bool) protected virtual void Dispose(bool disposing) Parameters disposing bool EndSession() Ends the current machining session and releases associated resources. public void EndSession() GetInspectingKeyPresentName(StringLocalizer) Gets the localized presentation name for the current inspecting key. public string GetInspectingKeyPresentName(StringLocalizer stringLocalizer) Parameters stringLocalizer StringLocalizer The string localizer to use for localization Returns string The localized presentation name GetMachiningProject() Gets the MachiningProject instance. public MachiningProject GetMachiningProject() Returns MachiningProject The MachiningProject instance. GetMillingEquipment() Get MachiningEquipment. public MachiningEquipment GetMillingEquipment() Returns MachiningEquipment MachiningEquipment LoadFile(string) Loads a machining project from the specified file path. public static MachiningProject LoadFile(string projectFilePath) Parameters projectFilePath string Path to the project file to load Returns MachiningProject A new machining project instance loaded from the file MakeXmlSource(string, string, bool) Creates an XML representation of the object. This method may also generate additional resources such as related files. public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly) Parameters baseDirectory string The base directory for resolving relative paths relFile string The relative file path for the XML source exhibitionOnly bool if true, the extended file creation is suppressed. Returns XElement An XML element representing the object's state Remarks For the demand of easy moving source folder (especially project folder) without configuration file path corruption, the relative file path is applied. The baseDirectory is typically the folder at the nearest configuration file folder. Since the folder can be moving with the configuration file. PlayCsvFile(string, string) public void PlayCsvFile(string baseDirectory, string relFilePath) Parameters baseDirectory string relFilePath string PlayNc(string, string) Plays NC commands from raw text with pace control. public void PlayNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string The NC command text to execute fileNameAlternative string Alternative name to associate with the NC program PlayNcFile(string, string) Plays an NC file from the specified path with pace control. public void PlayNcFile(string baseDirectory, string relFilePath) Parameters baseDirectory string Base directory for resolving relative paths relFilePath string Relative path to the NC file ProcAct(IAct, IIndexedFileLine, CancellationToken?) Processes an act and returns the results. public IEnumerable<object> ProcAct(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to process. sourceCommand IIndexedFileLine The source command that triggered the act. cancellationToken CancellationToken? Cancellation token to cancel the operation. Returns IEnumerable<object> Enumerable of results from processing the act. ReTrainMillingPara(SampleFlag, double, string, CancellationToken) Train Milling Parameter. public void ReTrainMillingPara(SampleFlag sampleFlags, double outlierRatio, string dstRelFile, CancellationToken cancellationToken) Parameters sampleFlags SampleFlag outlierRatio double dstRelFile string cancellationToken CancellationToken RefreshDrawing() Refreshes the visual display of the milling course. public void RefreshDrawing() ResetRuntime() Reset the runtime states including: runtime geometry, collision flags, machine tool position, CL strips, message buffer and etc.. public void ResetRuntime() RunCsvFile(string, string) public IEnumerable<Action> RunCsvFile(string baseDirectory, string relFilePath) Parameters baseDirectory string relFilePath string Returns IEnumerable<Action> RunNc(string, string) Runs NC commands from raw text. public IEnumerable<Action> RunNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string The NC command text to execute fileNameAlternative string Alternative name to associate with the NC program Returns IEnumerable<Action> An enumerable of actions to be executed RunNcFile(string, string) Runs an NC file from the specified path. public IEnumerable<Action> RunNcFile(string baseDirectory, string relFilePath) Parameters baseDirectory string Base directory for resolving relative paths. If the value is null, BaseDirectory substitudes the value. relFilePath string Returns IEnumerable<Action> An enumerable of actions to be executed ShowMessageBoard(string, string, BootstrapTheme) Shows a message board with the specified title, message, and theme. public void ShowMessageBoard(string title, string message, BootstrapTheme bootstrapThemeColor) Parameters title string The title of the message board message string The message to display bootstrapThemeColor BootstrapTheme The theme color for the message board TrainMillingPara(SampleFlag, bool, double, string, CancellationToken, ICuttingPara) Train Milling Parameter. public void TrainMillingPara(SampleFlag sampleFlags, bool enableFzOnlyDuringDrilling, double outlierRatio, string dstRelFile, CancellationToken cancellationToken, ICuttingPara paraTemplate = null) Parameters sampleFlags SampleFlag enableFzOnlyDuringDrilling bool outlierRatio double dstRelFile string cancellationToken CancellationToken paraTemplate ICuttingPara UpdateIdealMillingToolOffsetTableByToolHouse() Updates the ideal milling tool offset table based on the current tool house configuration. public void UpdateIdealMillingToolOffsetTableByToolHouse() WriteShotFile(TimeSpan, string) Writes time-based shot data to a file with the specified sampling period. public void WriteShotFile(TimeSpan samplingPeriod, string relFileTemplate = \"Output/[NcName].shot.csv\") Parameters samplingPeriod TimeSpan The time period between samples relFileTemplate string Template for the output file path, can include [NcName] placeholder WriteStepFile(string) Writes step-based data to a file. public void WriteStepFile(string relFileTemplate = \"Output/[NcName].step.csv\") Parameters relFileTemplate string Template for the output file path, can include [NcName] placeholder Events OnRanNcBlock Event triggered after an NC block is executed. public event Action OnRanNcBlock Event Type Action OnShownMessageBoard Event that is triggered when a message board is shown. public event ShowMessageBoardDelegate OnShownMessageBoard Event Type ShowMessageBoardDelegate OnUpdatedInspectingQuantityFunc Event triggered when the inspecting quantity function is updated. public event Action OnUpdatedInspectingQuantityFunc Event Type Action"
+    "summary": "Class MachiningProject Namespace Hi.MachiningProcs Assembly HiNc.dll Represents a milling project that manages the execution, simulation, and analysis of NC programs. public class MachiningProject : IDisposable, IMachiningStepHost, IGetMachiningEquipment, IMakeXmlSource, IMachiningProjectGetter Inheritance object MachiningProject Implements IDisposable IMachiningStepHost IGetMachiningEquipment IMakeXmlSource IMachiningProjectGetter Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Constructors MachiningProject(string) Initializes a new instance of the MachiningProject class with the specified directory. Uses the default MongoDB connection. public MachiningProject(string baseDirectory) Parameters baseDirectory string Base directory for file operations MachiningProject(string, MongoClient) Initializes a new instance of the MachiningProject class with the specified directory and MongoDB client. public MachiningProject(string baseDirectory, MongoClient mongoClient) Parameters baseDirectory string Base directory for file operations mongoClient MongoClient MongoDB client instance MachiningProject(XElement, string) Initializes a new instance of the MachiningProject class from XML data using MongoDB. public MachiningProject(XElement src, string baseDirectory) Parameters src XElement XML element containing configuration data baseDirectory string Base directory for resolving relative paths MachiningProject(XElement, string, MongoClient) Initializes a new instance of the MachiningProject class from XML data. public MachiningProject(XElement src, string baseDirectory, MongoClient mongoClient) Parameters src XElement XML element containing configuration data baseDirectory string Base directory for resolving relative paths mongoClient MongoClient MongoDB client instance Properties ApiVersion Gets the API version from the entry assembly. public static Version ApiVersion { get; } Property Value Version BaseDirectory Gets the base directory where project files are located. public string BaseDirectory { get; } Property Value string BoundSelectorHost Gets the bound selector host for managing selection boundaries. public BoundSelectorHost BoundSelectorHost { get; } Property Value BoundSelectorHost ClStrip Gets the cutter location strip. public ClStrip ClStrip { get; } Property Value ClStrip CoordinateEntryDisplayee Gets the displayee for coordinate entry visualization. public CoordinateEntryDisplayee CoordinateEntryDisplayee { get; } Property Value CoordinateEntryDisplayee DictionaryColorGuide Gets the color guide for dictionary-based coloring. public DictionaryColorGuide DictionaryColorGuide { get; } Property Value DictionaryColorGuide EnableCollisionDetection Gets or sets whether collision detection is enabled. When set to true, initializes collision detection mechanism. public bool EnableCollisionDetection { get; set; } Property Value bool EnablePauseOnFailure Enable Pause On Failure Detected. Only take effect if the EnableCollisionDetection or EnableStrokeLimitCheck is enabled. public bool EnablePauseOnFailure { get; set; } Property Value bool EnableStrokeLimitCheck Gets or sets whether stroke limit checking is enabled. public bool EnableStrokeLimitCheck { get; set; } Property Value bool Global global variable for RuntimeApi. Not save on XML. public Dictionary<object, object> Global { get; set; } Property Value Dictionary<object, object> InspectingKey Gets or sets the current inspecting key for visualization. When set, updates the inspecting quantity function. public string InspectingKey { get; set; } Property Value string InspectingQuantityFunc Gets the function that retrieves the quantity value for the current inspecting key. public Func<MachiningStep, double?> InspectingQuantityFunc { get; } Property Value Func<MachiningStep, double?> MachiningActRunner Gets the machining act runner responsible for executing machining operations. public MachiningActRunner MachiningActRunner { get; } Property Value MachiningActRunner MachiningEquipment Gets or sets the machining equipment used for milling. Updates related components when changed. public MachiningEquipment MachiningEquipment { get; set; } Property Value MachiningEquipment MachiningSession Gets or sets the current machining session. public MachiningSession MachiningSession { get; set; } Property Value MachiningSession MachiningToolHouse Gets or sets the milling tool house containing available tools. public MachiningToolHouse MachiningToolHouse { get; set; } Property Value MachiningToolHouse MachiningToolHouseFile Gets or sets the file path to the milling tool house configuration. public string MachiningToolHouseFile { get; set; } Property Value string MillingActRunnerConfig Gets or sets the configuration for the milling act runner. public MillingActRunnerConfig MillingActRunnerConfig { get; set; } Property Value MillingActRunnerConfig MillingGuide Gets or sets the milling guide containing visualization and analysis configurations. public MillingGuide MillingGuide { get; set; } Property Value MillingGuide MillingStepLuggageReader Gets the reader for accessing milling step luggage data. public ParallelBulkReader<MillingStepLuggage> MillingStepLuggageReader { get; } Property Value ParallelBulkReader<MillingStepLuggage> NcEnv Gets the NC environment from the NC runner. public NcEnv NcEnv { get; } Property Value NcEnv NcOptOptionDictionary Gets or sets the dictionary of NC optimization options. public Dictionary<string, NcOptOption> NcOptOptionDictionary { get; set; } Property Value Dictionary<string, NcOptOption> NcOptProc Gets the NC optimization processor for optimizing NC programs. public NcOptProc NcOptProc { get; } Property Value NcOptProc NcRunner Gets the NC runner responsible for executing NC programs. public NcRunner NcRunner { get; } Property Value NcRunner PacePlayer Gets the pace player for controlling execution pace of milling operations. public PacePlayer PacePlayer { get; } Property Value PacePlayer PlayerCommand Gets the command to execute when playing the machining project. public IShellCommand PlayerCommand { get; set; } Property Value IShellCommand Progress Gets the progress reporting mechanism for long-running operations. public Progress<IProgressReport> Progress { get; } Property Value Progress<IProgressReport> RuntimeApi Gets the shell API for interacting with this machining process. public RuntimeApi RuntimeApi { get; } Property Value RuntimeApi SessionMessageHost Gets the message host for displaying messages, warnings, and errors. public SessionMessageHost SessionMessageHost { get; } Property Value SessionMessageHost StepPropertyAccessDictionary Gets the dictionary mapping property keys to their access methods. public ConcurrentDictionary<string, PropertyAccess<MachiningStep>> StepPropertyAccessDictionary { get; } Property Value ConcurrentDictionary<string, PropertyAccess<MachiningStep>> TimeMapping Gets or sets the time mapping for synchronizing different time-based data streams. Creates a new time mapping if one doesn't exist. public TimeMapping TimeMapping { get; set; } Property Value TimeMapping Workpiece Gets or sets the workpiece to be machined. Ensures proper initialization of workpiece properties. public Workpiece Workpiece { get; set; } Property Value Workpiece XName Name for XML IO. public static string XName { get; } Property Value string Methods Act(IAct, IIndexedFileLine, CancellationToken?) Executes an act and collects all results. public void Act(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to execute. sourceCommand IIndexedFileLine The source command that triggered the act. cancellationToken CancellationToken? Cancellation token to cancel the operation. BeginSession() Initiate a simulation session. Clear the state from previous session (if existed). public void BeginSession() Dispose() Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. public void Dispose() Dispose(bool) protected virtual void Dispose(bool disposing) Parameters disposing bool EndSession() Ends the current machining session and releases associated resources. public void EndSession() GetInspectingKeyPresentName(StringLocalizer) Gets the localized presentation name for the current inspecting key. public string GetInspectingKeyPresentName(StringLocalizer stringLocalizer) Parameters stringLocalizer StringLocalizer The string localizer to use for localization Returns string The localized presentation name GetMachiningProject() Gets the MachiningProject instance. public MachiningProject GetMachiningProject() Returns MachiningProject The MachiningProject instance. GetMillingEquipment() Get MachiningEquipment. public MachiningEquipment GetMillingEquipment() Returns MachiningEquipment MachiningEquipment LoadFile(string) Loads a machining project from the specified file path. public static MachiningProject LoadFile(string projectFilePath) Parameters projectFilePath string Path to the project file to load Returns MachiningProject A new machining project instance loaded from the file MakeXmlSource(string, string, bool) Creates an XML representation of the object. This method may also generate additional resources such as related files. public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly) Parameters baseDirectory string The base directory for resolving relative paths relFile string The relative file path for the XML source exhibitionOnly bool if true, the extended file creation is suppressed. Returns XElement An XML element representing the object's state Remarks For the demand of easy moving source folder (especially project folder) without configuration file path corruption, the relative file path is applied. The baseDirectory is typically the folder at the nearest configuration file folder. Since the folder can be moving with the configuration file. PlayCsvFile(string, string) public void PlayCsvFile(string baseDirectory, string relFilePath) Parameters baseDirectory string relFilePath string PlayNc(string, string) Plays NC commands from raw text with pace control. public void PlayNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string The NC command text to execute fileNameAlternative string Alternative name to associate with the NC program PlayNcFile(string, string) Plays an NC file from the specified path with pace control. public void PlayNcFile(string baseDirectory, string relFilePath) Parameters baseDirectory string Base directory for resolving relative paths relFilePath string Relative path to the NC file ProcAct(IAct, IIndexedFileLine, CancellationToken?) Processes an act and returns the results. public IEnumerable<object> ProcAct(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to process. sourceCommand IIndexedFileLine The source command that triggered the act. cancellationToken CancellationToken? Cancellation token to cancel the operation. Returns IEnumerable<object> Enumerable of results from processing the act. ReTrainMillingPara(SampleFlag, double, string, CancellationToken) Train Milling Parameter. public void ReTrainMillingPara(SampleFlag sampleFlags, double outlierRatio, string dstRelFile, CancellationToken cancellationToken) Parameters sampleFlags SampleFlag outlierRatio double dstRelFile string cancellationToken CancellationToken RefreshDrawing() Refreshes the visual display of the milling course. public void RefreshDrawing() ResetRuntime() Reset the runtime states including: runtime geometry, collision flags, machine tool position, CL strips, message buffer and etc.. public void ResetRuntime() RunCsvFile(string, string) public IEnumerable<Action> RunCsvFile(string baseDirectory, string relFilePath) Parameters baseDirectory string relFilePath string Returns IEnumerable<Action> RunNc(string, string) Runs NC commands from raw text. public IEnumerable<Action> RunNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string The NC command text to execute fileNameAlternative string Alternative name to associate with the NC program Returns IEnumerable<Action> An enumerable of actions to be executed RunNcFile(string, string) Runs an NC file from the specified path. public IEnumerable<Action> RunNcFile(string baseDirectory, string relFilePath) Parameters baseDirectory string Base directory for resolving relative paths. If the value is null, BaseDirectory substitudes the value. relFilePath string Returns IEnumerable<Action> An enumerable of actions to be executed ShowMessageBoard(string, string, BootstrapTheme) Shows a message board with the specified title, message, and theme. public void ShowMessageBoard(string title, string message, BootstrapTheme bootstrapThemeColor) Parameters title string The title of the message board message string The message to display bootstrapThemeColor BootstrapTheme The theme color for the message board TrainMillingPara(SampleFlag, bool, double, string, CancellationToken, ICuttingPara) Train Milling Parameter. public void TrainMillingPara(SampleFlag sampleFlags, bool enableFzOnlyDuringDrilling, double outlierRatio, string dstRelFile, CancellationToken cancellationToken, ICuttingPara paraTemplate) Parameters sampleFlags SampleFlag enableFzOnlyDuringDrilling bool outlierRatio double dstRelFile string cancellationToken CancellationToken paraTemplate ICuttingPara UpdateIdealMillingToolOffsetTableByToolHouse() Updates the ideal milling tool offset table based on the current tool house configuration. public void UpdateIdealMillingToolOffsetTableByToolHouse() WriteShotFile(TimeSpan, string) Writes time-based shot data to a file with the specified sampling period. public void WriteShotFile(TimeSpan samplingPeriod, string relFileTemplate = \"Output/[NcName].shot.csv\") Parameters samplingPeriod TimeSpan The time period between samples relFileTemplate string Template for the output file path, can include [NcName] placeholder WriteStepFile(string) Writes step-based data to a file. public void WriteStepFile(string relFileTemplate = \"Output/[NcName].step.csv\") Parameters relFileTemplate string Template for the output file path, can include [NcName] placeholder Events OnRanNcBlock Event triggered after an NC block is executed. public event Action OnRanNcBlock Event Type Action OnShownMessageBoard Event that is triggered when a message board is shown. public event ShowMessageBoardDelegate OnShownMessageBoard Event Type ShowMessageBoardDelegate OnUpdatedInspectingQuantityFunc Event triggered when the inspecting quantity function is updated. public event Action OnUpdatedInspectingQuantityFunc Event Type Action"
   },
   "api/Hi.MachiningProcs.MachiningProjectDisplayee.html": {
     "href": "api/Hi.MachiningProcs.MachiningProjectDisplayee.html",
@@ -2102,7 +2102,7 @@
   "api/Hi.Mapping.StepTimeShotUtil.html": {
     "href": "api/Hi.Mapping.StepTimeShotUtil.html",
     "title": "Class StepTimeShotUtil | HiAPI-C# 2025",
-    "summary": "Class StepTimeShotUtil Namespace Hi.Mapping Assembly HiMech.dll Utility methods for working with time-based shots (measurements) and mapping them to machining steps. public static class StepTimeShotUtil Inheritance object StepTimeShotUtil Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Methods GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, string, GetTimeShotByFileDelegate, IDictionary<int, List<ITimeShot>>, SessionMessageHost, CancellationToken?) Gets a dictionary mapping step indices to time shots based on actual time. public static void GetStepToShotsDictionaryByActualTime(ClStrip clStrip, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc, IDictionary<int, List<ITimeShot>> dstStepToShotsDictionary, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken) Parameters clStrip ClStrip The cutter location strip. cycleSamplingMode StepTimeShotUtil.CycleSamplingMode The cycle sampling mode. timeShotRelFile string The relative file path for time shots. getTimeShotByRelFileFunc StepTimeShotUtil.GetTimeShotByFileDelegate The delegate function to get time shots by relative file path. dstStepToShotsDictionary IDictionary<int, List<ITimeShot>> The destination dictionary to store the mapping. sessionMessageHost SessionMessageHost The session message host for logging. cancellationToken CancellationToken? The cancellation token. GetTimeShotByFile(string, Action<int>, CancellationToken?) Gets time shots from a file, reading and parsing force acceleration data. public static List<ITimeShot> GetTimeShotByFile(string file, Action<int> LineReaded, CancellationToken? cancellationToken = null) Parameters file string The file path to read time shots from. LineReaded Action<int> Action to call when a line is read, providing progress feedback with the current line number. cancellationToken CancellationToken? Optional cancellation token to cancel the reading operation. Returns List<ITimeShot> A list of time shots read from the file, or null if the file cannot be read or is invalid."
+    "summary": "Class StepTimeShotUtil Namespace Hi.Mapping Assembly HiMech.dll Utility methods for working with time-based shots (measurements) and mapping them to machining steps. public static class StepTimeShotUtil Inheritance object StepTimeShotUtil Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Methods GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, string, GetTimeShotByFileDelegate, IDictionary<int, List<ITimeShot>>, SessionMessageHost, CancellationToken?) Gets a dictionary mapping step indices to time shots based on actual time. public static void GetStepToShotsDictionaryByActualTime(ClStrip clStrip, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc, IDictionary<int, List<ITimeShot>> dstStepToShotsDictionary, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken) Parameters clStrip ClStrip The cutter location strip. cycleSamplingMode StepTimeShotUtil.CycleSamplingMode The cycle sampling mode. timeShotRelFile string The relative file path for time shots. getTimeShotByRelFileFunc StepTimeShotUtil.GetTimeShotByFileDelegate The delegate function to get time shots by relative file path. dstStepToShotsDictionary IDictionary<int, List<ITimeShot>> The destination dictionary to store the mapping. sessionMessageHost SessionMessageHost The session message host for logging. cancellationToken CancellationToken? The cancellation token. GetTimeShotByFile(string, Action<int>, CancellationToken?) Gets time shots from a file, reading and parsing force acceleration data. public static List<ITimeShot> GetTimeShotByFile(string file, Action<int> lineReaded, CancellationToken? cancellationToken = null) Parameters file string The file path to read time shots from. lineReaded Action<int> Action to call when a line is read, providing progress feedback with the current line number. cancellationToken CancellationToken? Optional cancellation token to cancel the reading operation. Returns List<ITimeShot> A list of time shots read from the file, or null if the file cannot be read or is invalid."
   },
   "api/Hi.Mapping.TimeMapping.html": {
     "href": "api/Hi.Mapping.TimeMapping.html",
@@ -5047,7 +5047,7 @@
   "brief/dev-doc/release-note/index.html": {
     "href": "brief/dev-doc/release-note/index.html",
     "title": "Release Note | HiAPI-C# 2025",
-    "summary": "Release Note HiNc Packages Version 3.1.89 Rename optimization log API: OptEnableFlatProcLog → <xref:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*> Various stability improvements and bug fixes HiNc Packages Version 3.1.88 Rename optimization log API for clarity (see 優化日誌): OptEnableFirstSituProcLog → OptEnableFlatProcLog OptEnableNcEmbeddedLog → OptEnableEmbeddedLog Improve .flatproc.log output to maintain step order during parallel computation Various stability improvements and bug fixes HiNc Packages Version 3.1.86 Re-build NcOptProc with stricter optimization logics Add optimization logging features (see 優化日誌): .flatproc.log file output for optimization process analysis Embedded log comments in optimized NC file marking source lines with (src) suffix Fix cutting depth and width accuracy by bounding-box method with workpiece surface Fix collision check error during concurrent changing collidable object Various stability improvements and bug fixes HiNc Packages Version 3.1.84 Optimize memory usage by shrinking map-size of clStripPos Fix design pattern of cutting parameter training module (MillingTraining) Add LoadCuttingParaByFile function to load cutting parameters from file Improve CsvRunner actual time parsing: automatically calculate step duration from actual time when duration is not provided Enhance message handling in RuntimeApi by unifying SessionMessageHost usage Improve optimization performance with better task scheduling Various performance improvements and bug fixes HiNc Packages Version 3.1.75 Add actual time tracking functionality (ActualTime) Various stability improvements and bug fixes HiNc Packages Version 3.1.74 Rename class MillingCutterOptLimit to MillingCutterOptOption Add physics simulation function for relief face collision depth detection (ReliefFaceCollidingDepth_mm) and optimization (EnableLimitByReliefAngle) Add UpdateNcOptOption function to step processing Fix step ordering bug from concurrent processing Fix ClStrip shrinking to zero issue"
+    "summary": "Release Note HiNc Packages Version 3.1.90 Rename optimization log API EnableIndividualStepAdjustmentLog Fix crash from workpiece displaying with specific mechanical topology setting Improve .flatproc.log output to maintain step order during parallel computation Various stability improvements and bug fixes HiNc Packages Version 3.1.86 Re-build NcOptProc with stricter optimization logics Add optimization logging features (see 優化日誌): .flatproc.log file output for optimization process analysis Embedded log comments in optimized NC file marking source lines with (src) suffix Fix cutting depth and width accuracy by bounding-box method with workpiece surface Fix collision check error during concurrent changing collidable object Various stability improvements and bug fixes HiNc Packages Version 3.1.84 Optimize memory usage by shrinking map-size of clStripPos Fix design pattern of cutting parameter training module (MillingTraining) Add LoadCuttingParaByFile function to load cutting parameters from file Improve CsvRunner actual time parsing: automatically calculate step duration from actual time when duration is not provided Enhance message handling in RuntimeApi by unifying SessionMessageHost usage Improve optimization performance with better task scheduling Various performance improvements and bug fixes HiNc Packages Version 3.1.75 Add actual time tracking functionality (ActualTime) Various stability improvements and bug fixes HiNc Packages Version 3.1.74 Rename class MillingCutterOptLimit to MillingCutterOptOption Add physics simulation function for relief face collision depth detection (ReliefFaceCollidingDepth_mm) and optimization (EnableLimitByReliefAngle) Add UpdateNcOptOption function to step processing Fix step ordering bug from concurrent processing Fix ClStrip shrinking to zero issue"
   },
   "brief/dev-doc/system-requirements.html": {
     "href": "brief/dev-doc/system-requirements.html",
@@ -5337,7 +5337,7 @@
   "brief/user-guide/zh-Hant/script/NcOptimization/index.html": {
     "href": "brief/user-guide/zh-Hant/script/NcOptimization/index.html",
     "title": "NC優化 | HiAPI-C# 2025",
-    "summary": "NC優化 組態在NC仿真前設定，然後執行輸出優化NC檔指令。 可同時參考閱讀說明章節NC優化。 組態 Note 指令格式 OptEnableFeedrate = <布林值>; OptEnableInterpolation = <布林值>; OptRapidFeed_mmdmin = <實數>; OptMinFeedrate_mmdmin = <實數>; OptMaxFeedrate_mmdmin = <實數>; OptMaxAcceleration_mmds2 = <實數>; OptExtendedPreDistance_mm = <實數>; OptExtendedPostDistance_mm = <實數>; OptSpindlePowerSafetyFactor = <實數>; OptSpindleTorqueSafetyFactor = <實數>; OptThermalYieldSafetyFactor = <實數>; OptPreferedForce_N = <實數>; OptEnableFeedrate(API)：啟用順序式(Sequential)進給率優化。 順序式係指該功能從下指令開始作用。與其相對的設定在刀具端，刀具端也能設定進給率優化，但是在裝刀時才會發揮作用。 OptEnableFeedrate(API)與所有其他啟用進給率優化的指令需同時為真，進給率優化才會啟用。 即與刀具設定端必須同時為真(true)，進給率優化才會啟用。 OptEnableFeedrate(API)預設值為真。 OptEnableInterpolation(API)：優化程序用重新插補。 重新插捕後NC碼會增加，可以更好地控制加減速。 OptFeedrateAssignmentRatio(API)：進給賦值倍率。 當優化程序用重新插補並且進給率變化超過進給賦值倍率時，系統會依據OptMaxAcceleration_mmds2(API)插入附帶進給率指令的NC碼。 進給賦值倍率越小，插補點越密集。進給賦值倍率越大，則偏離優化標的的程度越大。 在改進給賦值倍率的同時也要對應加大安全係數。 進給賦值倍率若是0.01，就是1%，每變更1%進給率就會給個新的插補點。 如果改大，比方說10%，可能會變成該處理論值應該是F100，可是優化後卻是F110，所以要配合安全係數修改。 OptRapidFeed_mmdmin(API)：優化程序中的無切削區域進給率。單位mm/min。 沒有切到工件的NC路徑，為無切削區域。優化後該路徑將採用無切削區域進給率。 OptMinFeedrate_mmdmin(API)：優化程序中的有切削區域最小進給。單位mm/min。 OptMaxFeedrate_mmdmin(API)：優化程序中的有切削區域最大進給。單位mm/min。 有切到工件的NC路徑，為有切削區域。有切削區域的最大最小進給的設定通常依據經驗法則。 OptMaxAcceleration_mmds2(API)：優化程序中的加減速限制。優化後NC碼的F值變化在該限制之內。單位 \\(mm/s^2\\)。 OptExtendedPreDistance_mm(API)：優化程序中的有切削區域等效計算的前長度。單位mm。 OptExtendedPostDistance_mm(API)：優化程序中的有切削區域等效計算的後長度。單位mm。 優化程序中的有切削區域等效計算的長度 OptSpindlePowerSafetyFactor(API)：主軸功率安全係數。 於優化後的NC碼，主軸功率將盡可能趨近於目標值。 設為0則忽略此限制。 OptSpindleTorqueSafetyFactor(API)：主軸扭力安全係數。 優化後的NC碼，主軸扭力將盡可能趨近於目標值。 設為0則忽略此限制。 OptThermalYieldSafetyFactor(API)：刀刃熱降伏安全係數。 刀刃表面溫度超過一定值時，刀刃表面會因溫差產生的壓力造成塑性變形。 優化後的NC碼，刀刃表面度將盡可能趨近於目標值。 設為0則忽略此限制。 Note 目標值算法 目標值 = 100% / 安全係數 OptPreferedForce_N(API)：優化程中的目標力。單位N。 在符合所有限制的條件下，優化程序中的加工路徑產生的力會盡可能的趨近目標力。 限制的優先序 在有切削區域中： 進給率的直接限制 優先於 加減速限制(OptMaxAcceleration_mmds2(API)) 優先於 基於物理特性算出的限制。 進給率的直接限制 包含 腳本指令 OptMinFeedrate_mmdmin(API) OptMaxFeedrate_mmdmin(API) 刀具設定 每刃最小進給 每刃最大進給 基於物理特性算出的進給率限制 包含 腳本指令 OptSpindlePowerSafetyFactor(API) OptSpindleTorqueSafetyFactor(API) OptThermalYieldSafetyFactor(API) OptPreferedForce_N(API) 刀具設定 降伏力安全係數 若同級項目中的限制有衝突，則採取其中的最低進給率。 NC碼中的優化腳本指令 於指定NC行不啟用優化 在執行 Preserve(API)() 的NC行中，不啟用優化。 Tip 指令範例 在 N0140 行不啟用優化。 ... N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@Preserve();) N0150 G01 X-3.068 Y40.776 ... 於指定NC範圍不啟用優化 使用BeginPreserve(API)()的NC行及EndPreserve(API)()的NC行及包含的NC範圍，不啟用優化。 Tip 指令範例 在 N0140、N0150、N0160 行不啟用優化。 ... N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@BeginPreserve();) N0150 G01 X-3.068 Y40.776 N0160 X-3.555 Y43.338 (;@EndPreserve();) N0170 X-4.125 Y45.875 ... 優化日誌 優化過程提供兩種日誌功能，方便分析與除錯。 優化過程日誌檔 <xref:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*>(API)：啟用優化過程日誌檔輸出。預設為真。 啟用後，優化過程會為每個NC檔輸出一個 .flatproc.log 檔案，記錄各步階的優化條件經OptExtendedPreDistance_mm(API)及OptExtendedPostDistance_mm(API)展開後獨立優化計算的資訊（不包含步階間的交互關係，如加減速）。 日誌檔案內容依步階順序輸出（即使平行計算時也會保持順序），每行包含： 原始NC行位置與步階索引 各項優化限制的計算結果，例如： FrtByPreferedForce_mm: 依目標力計算的每刃進給 FrtByYieldingStressRatio_mm: 依降伏應力比計算的每刃進給 FrtBySpindleTorqueRatio_mm: 依主軸扭力比計算的每刃進給 FrtBySpindlePowerRatio_mm: 依主軸功率比計算的每刃進給 FrtByThermalYieldingRatio_mm: 依熱降伏比計算的每刃進給 FrtByReliefAngle_mm: 依餘隙角碰撞計算的每刃進給 嵌入式日誌註解 OptEnableEmbeddedLog(API)：啟用嵌入式日誌註解。預設為真。 啟用後，優化後的NC檔中會在NC行後方加上 (src(...)) 註解，包含： LineNo: 原始NC檔的行號 StepIndex: 對應的步階索引 例如：G01 X10.0 Y20.0 F500 (src(LineNo: 140, StepIndex: 256)) 此功能方便對照原始NC碼與優化後的NC碼，並可追蹤每行NC碼對應的步階資訊。 Note 指令格式 OptEnableSituStepAdjustmentLog = <布林值>; OptEnableEmbeddedLog = <布林值>; 輸出優化NC檔 使用 OptimizeToFiles(API) 方法輸出優化後的NC檔。 Note 指令格式 OptimizeToFiles(<路徑樣板>); <路徑樣板>支援 檔案路徑樣板。 Tip 指令範例 OptEnableFeedrate = true; OptEnableInterpolation = true; OptRapidFeed_mmdmin = 4000; OptMinFeedrate_mmdmin = 100; OptMaxFeedrate_mmdmin = 4000; OptMaxAcceleration_mmds2 = 10; OptExtendedPreDistance_mm = 3; OptExtendedPostDistance_mm = 2; OptSpindlePowerSafetyFactor = 1.5; OptSpindleTorqueSafetyFactor = 1.5; OptThermalYieldSafetyFactor = 0; OptPreferedForce_N = double.PositiveInfinity; PlayNcFile(\"NC/file1.nc\"); OptRapidFeed_mmdmin = 8000; PlayNcFile(\"NC/file2.nc\"); OptimizeToFiles(\"Cache/Opt-[NcName]\"); 組態設定可以穿插在NC仿真間，將會作用在組態設定後的NC仿真。 Warning 在 MachiningStepBuilt(API) 事件內使用 UpdateNcOptOption(API) 時，不能與NC碼內嵌優化指令併用，否則可能因平行計算產生未定義行為。 以上範例為例，優化後的NC程式file1.nc的無切削區域快速進給為4000，file2.nc則為8000。 Tip NC碼中的優化指令範例 ... N0110 X-3.064 Y6.378 (;@OptMaxAcceleration_mmds2=10;) N0120 X-2.411 Y11.712 N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@Preserve();) N0150 G01 X-3.068 Y40.776 (;@OptMaxAcceleration_mmds2=100; OptMaxFeedrate_mmdmin=12000;) N0160 X-3.555 Y43.338 N0170 X-4.125 Y45.875 ... N0110至N0150前，優化區加速度設為10 \\(mm/s^2\\)； N0140單行不做優化； N0150及以後，優化區加速度設為100 \\(mm/s^2\\)； N0150及以後，優化區切削區域最大進給設為12000 \\(mm/min\\)；"
+    "summary": "NC優化 組態在NC仿真前設定，然後執行輸出優化NC檔指令。 可同時參考閱讀說明章節NC優化。 組態 Note 指令格式 OptEnableFeedrate = <布林值>; OptEnableInterpolation = <布林值>; OptRapidFeed_mmdmin = <實數>; OptMinFeedrate_mmdmin = <實數>; OptMaxFeedrate_mmdmin = <實數>; OptMaxAcceleration_mmds2 = <實數>; OptExtendedPreDistance_mm = <實數>; OptExtendedPostDistance_mm = <實數>; OptSpindlePowerSafetyFactor = <實數>; OptSpindleTorqueSafetyFactor = <實數>; OptThermalYieldSafetyFactor = <實數>; OptPreferedForce_N = <實數>; OptEnableFeedrate(API)：啟用順序式(Sequential)進給率優化。 順序式係指該功能從下指令開始作用。與其相對的設定在刀具端，刀具端也能設定進給率優化，但是在裝刀時才會發揮作用。 OptEnableFeedrate(API)與所有其他啟用進給率優化的指令需同時為真，進給率優化才會啟用。 即與刀具設定端必須同時為真(true)，進給率優化才會啟用。 OptEnableFeedrate(API)預設值為真。 OptEnableInterpolation(API)：優化程序用重新插補。 重新插捕後NC碼會增加，可以更好地控制加減速。 OptFeedrateAssignmentRatio(API)：進給賦值倍率。 當優化程序用重新插補並且進給率變化超過進給賦值倍率時，系統會依據OptMaxAcceleration_mmds2(API)插入附帶進給率指令的NC碼。 進給賦值倍率越小，插補點越密集。進給賦值倍率越大，則偏離優化標的的程度越大。 在改進給賦值倍率的同時也要對應加大安全係數。 進給賦值倍率若是0.01，就是1%，每變更1%進給率就會給個新的插補點。 如果改大，比方說10%，可能會變成該處理論值應該是F100，可是優化後卻是F110，所以要配合安全係數修改。 OptRapidFeed_mmdmin(API)：優化程序中的無切削區域進給率。單位mm/min。 沒有切到工件的NC路徑，為無切削區域。優化後該路徑將採用無切削區域進給率。 OptMinFeedrate_mmdmin(API)：優化程序中的有切削區域最小進給。單位mm/min。 OptMaxFeedrate_mmdmin(API)：優化程序中的有切削區域最大進給。單位mm/min。 有切到工件的NC路徑，為有切削區域。有切削區域的最大最小進給的設定通常依據經驗法則。 OptMaxAcceleration_mmds2(API)：優化程序中的加減速限制。優化後NC碼的F值變化在該限制之內。單位 \\(mm/s^2\\)。 OptExtendedPreDistance_mm(API)：優化程序中的有切削區域等效計算的前長度。單位mm。 OptExtendedPostDistance_mm(API)：優化程序中的有切削區域等效計算的後長度。單位mm。 優化程序中的有切削區域等效計算的長度 OptSpindlePowerSafetyFactor(API)：主軸功率安全係數。 於優化後的NC碼，主軸功率將盡可能趨近於目標值。 設為0則忽略此限制。 OptSpindleTorqueSafetyFactor(API)：主軸扭力安全係數。 優化後的NC碼，主軸扭力將盡可能趨近於目標值。 設為0則忽略此限制。 OptThermalYieldSafetyFactor(API)：刀刃熱降伏安全係數。 刀刃表面溫度超過一定值時，刀刃表面會因溫差產生的壓力造成塑性變形。 優化後的NC碼，刀刃表面度將盡可能趨近於目標值。 設為0則忽略此限制。 Note 目標值算法 目標值 = 100% / 安全係數 OptPreferedForce_N(API)：優化程中的目標力。單位N。 在符合所有限制的條件下，優化程序中的加工路徑產生的力會盡可能的趨近目標力。 限制的優先序 在有切削區域中： 進給率的直接限制 優先於 加減速限制(OptMaxAcceleration_mmds2(API)) 優先於 基於物理特性算出的限制。 進給率的直接限制 包含 腳本指令 OptMinFeedrate_mmdmin(API) OptMaxFeedrate_mmdmin(API) 刀具設定 每刃最小進給 每刃最大進給 基於物理特性算出的進給率限制 包含 腳本指令 OptSpindlePowerSafetyFactor(API) OptSpindleTorqueSafetyFactor(API) OptThermalYieldSafetyFactor(API) OptPreferedForce_N(API) 刀具設定 降伏力安全係數 若同級項目中的限制有衝突，則採取其中的最低進給率。 NC碼中的優化腳本指令 於指定NC行不啟用優化 在執行 Preserve(API)() 的NC行中，不啟用優化。 Tip 指令範例 在 N0140 行不啟用優化。 ... N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@Preserve();) N0150 G01 X-3.068 Y40.776 ... 於指定NC範圍不啟用優化 使用BeginPreserve(API)()的NC行及EndPreserve(API)()的NC行及包含的NC範圍，不啟用優化。 Tip 指令範例 在 N0140、N0150、N0160 行不啟用優化。 ... N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@BeginPreserve();) N0150 G01 X-3.068 Y40.776 N0160 X-3.555 Y43.338 (;@EndPreserve();) N0170 X-4.125 Y45.875 ... 優化日誌 優化過程提供兩種日誌功能，方便分析與除錯。 優化過程日誌檔 EnableIndividualStepAdjustmentLog(API)：啟用優化過程日誌檔輸出。預設為真。 啟用後，優化過程會為每個NC檔輸出一個 .flatproc.log 檔案，記錄各步階的優化條件經OptExtendedPreDistance_mm(API)及OptExtendedPostDistance_mm(API)展開後獨立優化計算的資訊（不包含步階間的交互關係，如加減速）。 日誌檔案內容依步階順序輸出（即使平行計算時也會保持順序），每行包含： 原始NC行位置與步階索引 各項優化限制的計算結果，例如： FrtByPreferedForce_mm: 依目標力計算的每刃進給 FrtByYieldingStressRatio_mm: 依降伏應力比計算的每刃進給 FrtBySpindleTorqueRatio_mm: 依主軸扭力比計算的每刃進給 FrtBySpindlePowerRatio_mm: 依主軸功率比計算的每刃進給 FrtByThermalYieldingRatio_mm: 依熱降伏比計算的每刃進給 FrtByReliefAngle_mm: 依餘隙角碰撞計算的每刃進給 嵌入式日誌註解 OptEnableEmbeddedLog(API)：啟用嵌入式日誌註解。預設為真。 啟用後，優化後的NC檔中會在NC行後方加上 (src(...)) 註解，包含： LineNo: 原始NC檔的行號 StepIndex: 對應的步階索引 例如：G01 X10.0 Y20.0 F500 (src(LineNo: 140, StepIndex: 256)) 此功能方便對照原始NC碼與優化後的NC碼，並可追蹤每行NC碼對應的步階資訊。 Note 指令格式 EnableIndividualStepAdjustmentLog = <布林值>; OptEnableEmbeddedLog = <布林值>; 輸出優化NC檔 使用 OptimizeToFiles(API) 方法輸出優化後的NC檔。 Note 指令格式 OptimizeToFiles(<路徑樣板>); <路徑樣板>支援 檔案路徑樣板。 Tip 指令範例 OptEnableFeedrate = true; OptEnableInterpolation = true; OptRapidFeed_mmdmin = 4000; OptMinFeedrate_mmdmin = 100; OptMaxFeedrate_mmdmin = 4000; OptMaxAcceleration_mmds2 = 10; OptExtendedPreDistance_mm = 3; OptExtendedPostDistance_mm = 2; OptSpindlePowerSafetyFactor = 1.5; OptSpindleTorqueSafetyFactor = 1.5; OptThermalYieldSafetyFactor = 0; OptPreferedForce_N = double.PositiveInfinity; PlayNcFile(\"NC/file1.nc\"); OptRapidFeed_mmdmin = 8000; PlayNcFile(\"NC/file2.nc\"); OptimizeToFiles(\"Cache/Opt-[NcName]\"); 組態設定可以穿插在NC仿真間，將會作用在組態設定後的NC仿真。 Warning 在 MachiningStepBuilt(API) 事件內使用 UpdateNcOptOption(API) 時，不能與NC碼內嵌優化指令併用，否則可能因平行計算產生未定義行為。 以上範例為例，優化後的NC程式file1.nc的無切削區域快速進給為4000，file2.nc則為8000。 Tip NC碼中的優化指令範例 ... N0110 X-3.064 Y6.378 (;@OptMaxAcceleration_mmds2=10;) N0120 X-2.411 Y11.712 N0130 X-1.965 Y17.053 N0140 G03 X-2.66 Y38.193 I-103.796 J7.172 (;@Preserve();) N0150 G01 X-3.068 Y40.776 (;@OptMaxAcceleration_mmds2=100; OptMaxFeedrate_mmdmin=12000;) N0160 X-3.555 Y43.338 N0170 X-4.125 Y45.875 ... N0110至N0150前，優化區加速度設為10 \\(mm/s^2\\)； N0140單行不做優化； N0150及以後，優化區加速度設為100 \\(mm/s^2\\)； N0150及以後，優化區切削區域最大進給設為12000 \\(mm/min\\)；"
   },
   "brief/user-guide/zh-Hant/script/Physics/index.html": {
     "href": "brief/user-guide/zh-Hant/script/Physics/index.html",
diff --git a/App/zh-Hans/HiMech.resources.dll b/App/zh-Hans/HiMech.resources.dll
index c2eeb03..39b7c39 100644
Binary files a/App/zh-Hans/HiMech.resources.dll and b/App/zh-Hans/HiMech.resources.dll differ
diff --git a/App/zh-Hans/HiNc.resources.dll b/App/zh-Hans/HiNc.resources.dll
index 3284d2b..8c322c6 100644
Binary files a/App/zh-Hans/HiNc.resources.dll and b/App/zh-Hans/HiNc.resources.dll differ
diff --git a/App/zh-Hant/HiGeom.resources.dll b/App/zh-Hant/HiGeom.resources.dll
index 29ea8ba..85197b2 100644
Binary files a/App/zh-Hant/HiGeom.resources.dll and b/App/zh-Hant/HiGeom.resources.dll differ
diff --git a/App/zh-Hant/HiMech.resources.dll b/App/zh-Hant/HiMech.resources.dll
index 407e47c..8dc609f 100644
Binary files a/App/zh-Hant/HiMech.resources.dll and b/App/zh-Hant/HiMech.resources.dll differ
diff --git a/App/zh-Hant/HiNc.resources.dll b/App/zh-Hant/HiNc.resources.dll
index 2ea6875..38efd72 100644
Binary files a/App/zh-Hant/HiNc.resources.dll and b/App/zh-Hant/HiNc.resources.dll differ