tune

App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html

@@ -87,13 +87,24 @@
         <article data-uid="">
           <h1 id="release-note">Release Note</h1>
 
+<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> → &lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*&gt;</li>
+<li><code>OptEnableNcEmbeddedLog</code> → <a class="xref" href="../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableEmbeddedLog_">OptEnableEmbeddedLog</a></li>
+</ul>
+</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>
 <h2 id="hinc-packages-version-3186">HiNc Packages Version 3.1.86</h2>
 <ul>
-<li>Re-build <a class="xref" href="../../../api/Hi.NcOpt.NcOptProc.html">NcOptProc</a> with stricter optimization logics.</li>
+<li>Re-build <a class="xref" href="../../../api/Hi.NcOpt.NcOptProc.html">NcOptProc</a> with stricter optimization logics</li>
 <li>Add optimization logging features (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>.flatproc.log</code> file output for optimization process analysis.</li>
-<li>Embedded log comments in optimized NC file marking source lines with <code>(src)</code> suffix.</li>
+<li><code>.flatproc.log</code> file output for optimization process analysis</li>
+<li>Embedded log comments in optimized NC file marking source lines with <code>(src)</code> suffix</li>
 </ul>
 </li>
 <li>Fix cutting depth and width accuracy by bounding-box method with workpiece surface</li>

App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/NcOptimization/index.html

@@ -242,11 +242,31 @@ N0170 X-4.125 Y45.875
 <h2 id="優化日誌">優化日誌</h2>
 <p>優化過程提供兩種日誌功能，方便分析與除錯。</p>
 <h3 id="優化過程日誌檔">優化過程日誌檔</h3>
-<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog_">OptEnableFlatProcLog</a><small>(API)</small>：啟用優化過程日誌檔輸出。預設為真。</p>
+<p>&lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*&gt;<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>
+<li>原始NC行位置與步階索引</li>
+<li>各項優化限制的計算結果，例如：
+<ul>
+<li><code>FrtByPreferedForce_mm</code>: 依目標力計算的每刃進給</li>
+<li><code>FrtByYieldingStressRatio_mm</code>: 依降伏應力比計算的每刃進給</li>
+<li><code>FrtBySpindleTorqueRatio_mm</code>: 依主軸扭力比計算的每刃進給</li>
+<li><code>FrtBySpindlePowerRatio_mm</code>: 依主軸功率比計算的每刃進給</li>
+<li><code>FrtByThermalYieldingRatio_mm</code>: 依熱降伏比計算的每刃進給</li>
+<li><code>FrtByReliefAngle_mm</code>: 依餘隙角碰撞計算的每刃進給</li>
+</ul>
+</li>
+</ul>
 <h3 id="嵌入式日誌註解">嵌入式日誌註解</h3>
 <p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableEmbeddedLog_">OptEnableEmbeddedLog</a><small>(API)</small>：啟用嵌入式日誌註解。預設為真。</p>
-<p>啟用後，優化後的NC檔中會在原始NC行後方加上 <code>(src)</code> 後綴，方便對照原始NC碼與優化後的NC碼。</p>
+<p>啟用後，優化後的NC檔中會在NC行後方加上 <code>(src(...))</code> 註解，包含：</p>
+<ul>
+<li><code>LineNo</code>: 原始NC檔的行號</li>
+<li><code>StepIndex</code>: 對應的步階索引</li>
+</ul>
+<p>例如：<code>G01 X10.0 Y20.0 F500 (src(LineNo: 140, StepIndex: 256))</code></p>
+<p>此功能方便對照原始NC碼與優化後的NC碼，並可追蹤每行NC碼對應的步階資訊。</p>
 <div class="NOTE">
 <h5>Note</h5>
 <p><strong>指令格式</strong></p>