w-md2docx 1.0.0 → 1.0.2

package/docs/global.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#ApiServer">ApiServer</a></li><li><a href="global.html#WMd2docx">WMd2docx</a></li><li><a href="global.html#checkDocxReady">checkDocxReady</a></li><li><a href="global.html#cleanWorkDir">cleanWorkDir</a></li><li><a href="global.html#cvMdTo">cvMdTo</a></li><li><a href="global.html#cvMdToDocx">cvMdToDocx</a></li><li><a href="global.html#getFpExe">getFpExe</a></li><li><a href="global.html#getQueueSize">getQueueSize</a></li><li><a href="global.html#health">health</a></li><li><a href="global.html#readAssets">readAssets</a></li><li><a href="global.html#resolveAssetPaths">resolveAssetPaths</a></li><li><a href="global.html#retryBusy">retryBusy</a></li><li><a href="global.html#runExclusive">runExclusive</a></li><li><a href="global.html#scanAssetPaths">scanAssetPaths</a></li><li><a href="global.html#toErrText">toErrText</a></li><li><a href="global.html#toSafeName">toSafeName</a></li><li><a href="global.html#transErrAsset">transErrAsset</a></li><li><a href="global.html#writeAssets">writeAssets</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#WMd2docx">WMd2docx</a></li><li><a href="global.html#checkDocxReady">checkDocxReady</a></li><li><a href="global.html#cleanWorkDir">cleanWorkDir</a></li><li><a href="global.html#cvMdTo">cvMdTo</a></li><li><a href="global.html#cvMdToDocx">cvMdToDocx</a></li><li><a href="global.html#getFpExe">getFpExe</a></li><li><a href="global.html#getQueueSize">getQueueSize</a></li><li><a href="global.html#health">health</a></li><li><a href="global.html#readAssets">readAssets</a></li><li><a href="global.html#resolveAssetPaths">resolveAssetPaths</a></li><li><a href="global.html#retryBusy">retryBusy</a></li><li><a href="global.html#rmApiServer">rmApiServer</a></li><li><a href="global.html#runExclusive">runExclusive</a></li><li><a href="global.html#scanAssetPaths">scanAssetPaths</a></li><li><a href="global.html#toErrText">toErrText</a></li><li><a href="global.html#toSafeName">toSafeName</a></li><li><a href="global.html#transErrAsset">transErrAsset</a></li><li><a href="global.html#writeAssets">writeAssets</a></li></ul>
     
 </nav>
 
@@ -135,7 +135,7 @@
     
     <dt class="tag-description">Description:</dt>
     <dd class="tag-description"><ul class="dummy"><li><p>Markdown轉Docx工具集</p>
-<p>匯整四個入口：cvMdToDocx(md檔轉docx檔)、cvMdTo(md內容轉html/docx之base64)、ApiServer(hapi轉檔服務)、ApiClient(呼叫轉檔服務之用戶端)。</p></li></ul></dd>
+<p>匯整四個入口：cvMdToDocx(md檔轉docx檔)、cvMdTo(md內容轉html/docx之base64)、rmApiServer(hapi轉檔服務)、rmApiClient(呼叫轉檔服務之用戶端)。</p></li></ul></dd>
     
 
     
@@ -182,7 +182,7 @@
 
 <div class="description usertext">
     <p>Markdown轉Docx工具集</p>
-<p>匯整四個入口：cvMdToDocx(md檔轉docx檔)、cvMdTo(md內容轉html/docx之base64)、ApiServer(hapi轉檔服務)、ApiClient(呼叫轉檔服務之用戶端)。</p>
+<p>匯整四個入口：cvMdToDocx(md檔轉docx檔)、cvMdTo(md內容轉html/docx之base64)、rmApiServer(hapi轉檔服務)、rmApiClient(呼叫轉檔服務之用戶端)。</p>
 </div>
 
 
@@ -212,7 +212,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="ApiServer"><span class="type-signature type-signature-async">(async) </span>ApiServer<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="checkDocxReady"><span class="type-signature"></span>checkDocxReady<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
 
     
 
@@ -222,14 +222,14 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>建立並啟動Markdown轉Html/Docx之API服務</p>
-<p>以hapi提供三個端點：GET /api/health(健康檢查與環境狀態)、GET /api/selftest(實跑一次最小轉檔驗證本機Word可用)、POST /api/convert(轉檔主端點，JSON參數同cvMdTo，另可用templateName指定服務端模板或templateBase64夾帶模板；query帶download=1時單一格式直接回傳二進位檔)。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>檢查本機是否具備docx轉檔條件(Windows且轉檔器存在)</p>
+<p>注意：僅代表環境條件成立，不代表Word確實可被調用；後者須實際轉一份小檔驗證。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ApiServer.mjs.html">ApiServer.mjs</a>, <a href="ApiServer.mjs.html#line86">line 86</a>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line205">line 205</a>
     </li></ul></dd>
     
 
@@ -276,82 +276,129 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import ApiServer from 'w-md2docx/src/ApiServer.mjs'
+    <pre class="prettyprint"><code>console.log(checkDocxReady())
+// => { platform: 'win32', isWindows: true, cwd: '...', exePath: '...', exeFound: true, ready: true }</code></pre>
+
+
+
+
+
+
+
+
 
-let { server, settings } = await ApiServer({
-    port: 22000,
-    token: '',
-})
-console.log(`listening on ${server.info.uri}`, settings)</code></pre>
 
 
 
 
-    <h5 class="h5-parameters">Parameters:</h5>
-    
 
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
 
-        <th>Type</th>
 
-        
-        <th>Attributes</th>
-        
+
+
+<h5 class="h5-returns">Returns:</h5>
 
         
-        <th>Default</th>
+<div class="param-desc">
+    <p>回傳狀態物件{platform,isWindows,cwd,exePath,exeFound,ready}</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
         
+<span class="param-type">Object</span>
 
-        <th class="last">Description</th>
-    </tr>
-    </thead>
 
-    <tbody>
+
+    </dd>
+</dl>
+
     
 
-        <tr>
-            
-                <td class="name"><code>opt</code></td>
-            
 
-            <td class="type">
+
+        
             
-                
-<span class="param-type">Object</span>
 
+    
 
+    <h4 class="name" id="cleanWorkDir"><span class="type-signature"></span>cleanWorkDir<span class="signature">(dirWork, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Integer}</span></h4>
 
-            
-            </td>
+    
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>清除工作資料夾內逾時未刪之作業夾(前綴job_)</p>
+<p>工作資料夾不存在時自動建立。</p></li></ul></dd>
+    
 
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
-                
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line369">line 369</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>let n = cleanWorkDir('./tmp', { msAge: 3600 * 1000 })
+// => 2</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
 
 <table class="params">
     <thead>
@@ -379,13 +426,13 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
 
         <tr>
             
-                <td class="name"><code>port</code></td>
+                <td class="name"><code>dirWork</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Integer</span>
+<span class="param-type">String</span>
 
 
 
@@ -395,8 +442,6 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="attributes">
                 
-                    &lt;optional><br>
-                
 
                 
 
@@ -407,25 +452,23 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>22000</code>
-                
                 </td>
             
 
-            <td class="description last"><p>輸入服務埠號整數，給0則由系統自動配置(實際埠號見回傳之server.info.port)，預設22000</p></td>
+            <td class="description last"><p>輸入工作資料夾位置字串</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>host</code></td>
+                <td class="name"><code>opt</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -447,25 +490,48 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>'0.0.0.0'</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入監聽位址字串，預設'0.0.0.0'</p></td>
-        </tr>
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>token</code></td>
+                <td class="name"><code>msAge</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Number</span>
 
 
 
@@ -487,78 +553,198 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>''</code>
+                    <code>21600000</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入權杖字串，非空時所有/api/*須帶x-api-token標頭，預設''</p></td>
+            <td class="description last"><p>輸入視為逾時之毫秒數，預設6小時(21600000)</p></td>
         </tr>
 
     
+    </tbody>
+</table>
 
-        <tr>
-            
-                <td class="name"><code>maxMb</code></td>
-            
+            </td>
+        </tr>
 
-            <td class="type">
-            
-                
-<span class="param-type">Number</span>
+    
+    </tbody>
+</table>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>256</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入請求大小上限數字，單位MB，預設256</p></td>
-        </tr>
 
-    
 
-        <tr>
-            
-                <td class="name"><code>dirTemplates</code></td>
-            
 
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳刪除之作業夾數整數</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Integer</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="cvMdTo"><span class="type-signature type-signature-async">(async) </span>cvMdTo<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>Markdown內容轉Html與Docx內容</p>
+<p>與cvMdToDocx之差異：本函數接收Markdown「內容」與其引用之資產(圖片等)，於獨立工作資料夾內還原後轉檔，完成後回傳產物之base64內容並清除工作資料夾。適用於服務端等無實體來源檔之情境；有實體md檔者請直接用cvMdToDocx。</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="cvMdTo.mjs.html">cvMdTo.mjs</a>, <a href="cvMdTo.mjs.html#line46">line 46</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+    <h5 class="h5-examples">Example</h5>
+    
+    <pre class="prettyprint"><code>import cvMdTo from 'w-md2docx/src/cvMdTo.mjs'
+
+let r = await cvMdTo({
+    md: '# 標題\n\n&lt;img src="pics/圖.png" />',
+    name: '報告R00.01',
+    out: 'docx',
+    assets: [{ path: 'pics/圖.png', base64: '…' }],
+})
+console.log(r)
+// => { name: '報告R00.01', out: 'docx', ms: 8342, nAssets: 1, msDocx: 8300, docx: { fileName: '報告R00.01.docx', mime: '…', size: 39856, base64: '…' } }</code></pre>
+
+
+
+
+    <h5 class="h5-parameters">Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>opt</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Object</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
 
                 
                 </td>
@@ -567,19 +753,42 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>''</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入docx模板資料夾位置字串，未給則用本套件src/templates，預設''</p></td>
-        </tr>
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>dirWork</code></td>
+                <td class="name"><code>md</code></td>
             
 
             <td class="type">
@@ -612,14 +821,14 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
                 </td>
             
 
-            <td class="description last"><p>輸入工作資料夾位置字串，未給則用系統暫存夾下之w-md2docx，預設''</p></td>
+            <td class="description last"><p>輸入Markdown內容字串，與mdBase64二擇一</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>templateDef</code></td>
+                <td class="name"><code>mdBase64</code></td>
             
 
             <td class="type">
@@ -647,25 +856,25 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>'temp_tpc.docx'</code>
+                    <code>''</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入預設模板檔名字串，預設'temp_tpc.docx'</p></td>
+            <td class="description last"><p>輸入Markdown內容之base64字串，與md二擇一</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>autoStart</code></td>
+                <td class="name"><code>name</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Boolean</span>
+<span class="param-type">String</span>
 
 
 
@@ -687,286 +896,139 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>true</code>
+                    <code>'output'</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入是否立即啟動服務布林值，預設true</p></td>
+            <td class="description last"><p>輸入輸出檔名主體字串(不含副檔名)，將自動移除路徑成分與非法字元，預設'output'</p></td>
         </tr>
 
     
-    </tbody>
-</table>
 
-            </td>
-        </tr>
+        <tr>
+            
+                <td class="name"><code>out</code></td>
+            
 
-    
-    </tbody>
-</table>
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
 
+            
+            </td>
 
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
+                
 
+                
+                </td>
+            
 
+            
+                <td class="default">
+                
+                    <code>'docx'</code>
+                
+                </td>
+            
 
+            <td class="description last"><p>輸入產出類型字串，可為'html'、'docx'、'both'，預設'docx'</p></td>
+        </tr>
 
+    
 
+        <tr>
+            
+                <td class="name"><code>assets</code></td>
+            
 
+            <td class="type">
+            
+                
+<span class="param-type">Array</span>
 
 
 
+            
+            </td>
 
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
-<h5 class="h5-returns">Returns:</h5>
-
-        
-<div class="param-desc">
-    <p>回傳Promise，resolve回傳{server,settings,getState,stop}，其中server為hapi實例，getState為取環境狀態之async函數，stop為停止服務之async函數，reject回傳錯誤訊息</p>
-</div>
-
-
-
-<dl class="param-type">
-    <dt>
-        Type
-    </dt>
-    <dd>
-        
-<span class="param-type">Promise</span>
-
-
-
-    </dd>
-</dl>
-
-    
-
-
+                
 
-        
+                
+                </td>
             
 
-    
-
-    <h4 class="name" id="checkDocxReady"><span class="type-signature"></span>checkDocxReady<span class="signature">()</span><span class="type-signature"> &rarr; {Object}</span></h4>
-
-    
-
-
-
-
-<dl class="details">
-    
-    <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>檢查本機是否具備docx轉檔條件(Windows且轉檔器存在)</p>
-<p>注意：僅代表環境條件成立，不代表Word確實可被調用；後者須實際轉一份小檔驗證。</p></li></ul></dd>
-    
-
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line205">line 205</a>
-    </li></ul></dd>
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-</dl>
-
-
-
-
-
-
-
-
-
-
-
-    <h5 class="h5-examples">Example</h5>
-    
-    <pre class="prettyprint"><code>console.log(checkDocxReady())
-// => { platform: 'win32', isWindows: true, cwd: '...', exePath: '...', exeFound: true, ready: true }</code></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<h5 class="h5-returns">Returns:</h5>
-
-        
-<div class="param-desc">
-    <p>回傳狀態物件{platform,isWindows,cwd,exePath,exeFound,ready}</p>
-</div>
-
-
-
-<dl class="param-type">
-    <dt>
-        Type
-    </dt>
-    <dd>
-        
-<span class="param-type">Object</span>
-
-
-
-    </dd>
-</dl>
-
-    
-
-
-
-        
+            
+                <td class="default">
+                
+                    <code>[]</code>
+                
+                </td>
             
 
-    
-
-    <h4 class="name" id="cleanWorkDir"><span class="type-signature"></span>cleanWorkDir<span class="signature">(dirWork, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Integer}</span></h4>
-
-    
-
-
-
-
-<dl class="details">
-    
-    <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>清除工作資料夾內逾時未刪之作業夾(前綴job_)</p>
-<p>工作資料夾不存在時自動建立。</p></li></ul></dd>
-    
-
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line369">line 369</a>
-    </li></ul></dd>
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
+            <td class="description last"><p>輸入md內引用之相對路徑資產陣列，格式[{path,base64}]，預設[]</p></td>
+        </tr>
 
     
-</dl>
-
-
-
-
-
-
-
-
-
-
 
-    <h5 class="h5-examples">Example</h5>
-    
-    <pre class="prettyprint"><code>let n = cleanWorkDir('./tmp', { msAge: 3600 * 1000 })
-// => 2</code></pre>
+        <tr>
+            
+                <td class="name"><code>dirWork</code></td>
+            
 
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
 
-    <h5 class="h5-parameters">Parameters:</h5>
-    
+            
+            </td>
 
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
-        <th>Type</th>
+                
 
-        
-        <th>Attributes</th>
-        
+                
+                </td>
+            
 
-        
-        <th>Default</th>
-        
+            
+                <td class="default">
+                
+                    <code>''</code>
+                
+                </td>
+            
 
-        <th class="last">Description</th>
-    </tr>
-    </thead>
+            <td class="description last"><p>輸入工作資料夾根位置字串，未給則用系統暫存夾下之w-md2docx，預設''</p></td>
+        </tr>
 
-    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>dirWork</code></td>
+                <td class="name"><code>fpInTemp</code></td>
             
 
             <td class="type">
@@ -982,6 +1044,8 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="attributes">
                 
+                    &lt;optional><br>
+                
 
                 
 
@@ -992,17 +1056,19 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
+                    <code>''</code>
+                
                 </td>
             
 
-            <td class="description last"><p>輸入工作資料夾位置字串</p></td>
+            <td class="description last"><p>輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>opt</code></td>
+                <td class="name"><code>optMd2html</code></td>
             
 
             <td class="type">
@@ -1035,43 +1101,60 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
                 </td>
             
 
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
+            <td class="description last"><p>輸入傳予w-md2html之設定物件，預設{}</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>optHtml2docx</code></td>
+            
+
+            <td class="type">
+            
                 
+<span class="param-type">Object</span>
 
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
 
-        <th>Type</th>
 
-        
-        <th>Attributes</th>
-        
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
 
-        
-        <th>Default</th>
-        
+                
+                </td>
+            
 
-        <th class="last">Description</th>
-    </tr>
-    </thead>
+            
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入傳予w-html2docx之設定物件，預設{}</p></td>
+        </tr>
 
-    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>msAge</code></td>
+                <td class="name"><code>keepWork</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Number</span>
+<span class="param-type">Boolean</span>
 
 
 
@@ -1093,12 +1176,12 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
             
                 <td class="default">
                 
-                    <code>21600000</code>
+                    <code>false</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入視為逾時之毫秒數，預設6小時(21600000)</p></td>
+            <td class="description last"><p>輸入是否保留工作資料夾供除錯布林值，預設false</p></td>
         </tr>
 
     
@@ -1131,7 +1214,7 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
 
         
 <div class="param-desc">
-    <p>回傳刪除之作業夾數整數</p>
+    <p>回傳Promise，resolve回傳結果物件{name,out,ms,nAssets,[msDocx],[html],[docx]}，其中html與docx為{fileName,mime,size,base64}，reject回傳錯誤訊息</p>
 </div>
 
 
@@ -1142,7 +1225,7 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
     </dt>
     <dd>
         
-<span class="param-type">Integer</span>
+<span class="param-type">Promise</span>
 
 
 
@@ -1169,13 +1252,13 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
     
     <dt class="tag-description">Description:</dt>
     <dd class="tag-description"><ul class="dummy"><li><p>將本機Markdown檔送至轉檔服務，取回並寫出Html與(或)Docx</p>
-<p>供無Microsoft Word之機器產製docx：讀取本機md與其引用之圖片，送至ApiServer轉檔後寫回本機。連線層失敗會自動重試；逾時與HTTP錯誤不重試。</p></li></ul></dd>
+<p>供無Microsoft Word之機器產製docx：讀取本機md與其引用之圖片，送至rmApiServer轉檔後寫回本機。連線層失敗會自動重試；逾時與HTTP錯誤不重試。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ApiClient.mjs.html">ApiClient.mjs</a>, <a href="ApiClient.mjs.html#line216">line 216</a>
+        <a href="rmApiClient.mjs.html">rmApiClient.mjs</a>, <a href="rmApiClient.mjs.html#line216">line 216</a>
     </li></ul></dd>
     
 
@@ -1222,7 +1305,7 @@ console.log(`listening on ${server.info.uri}`, settings)</code></pre>
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import { cvMdTo } from 'w-md2docx/src/ApiClient.mjs'
+    <pre class="prettyprint"><code>import { cvMdTo } from 'w-md2docx/src/rmApiClient.mjs'
 
 let r = await cvMdTo({
     host: '127.0.0.1',
@@ -1973,7 +2056,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="cvMdTo"><span class="type-signature type-signature-async">(async) </span>cvMdTo<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="cvMdToDocx"><span class="type-signature type-signature-async">(async) </span>cvMdToDocx<span class="signature">(fpInMd, fpOutDocx, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -1983,14 +2066,15 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>Markdown內容轉Html與Docx內容</p>
-<p>與cvMdToDocx之差異：本函數接收Markdown「內容」與其引用之資產(圖片等)，於獨立工作資料夾內還原後轉檔，完成後回傳產物之base64內容並清除工作資料夾。適用於服務端等無實體來源檔之情境；有實體md檔者請直接用cvMdToDocx。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>Markdown檔轉Docx檔</p>
+<p>內部流程為md -&gt; html -&gt; docx。docx階段係調用本機Microsoft Word(win32com)，故僅能於已安裝Word之Windows執行，且同時間僅一份轉檔作業(內部佇列自動排隊)。</p>
+<p>注意：底層w-html2docx於Word未安裝或COM呼叫失敗時「仍回傳ok」，本函數一律以產物實體檔之存在與大小驗證成敗，失敗即reject，不會回報假成功。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="cvMdTo.mjs.html">cvMdTo.mjs</a>, <a href="cvMdTo.mjs.html#line46">line 46</a>
+        <a href="cvMdToDocx.mjs.html">cvMdToDocx.mjs</a>, <a href="cvMdToDocx.mjs.html#line42">line 42</a>
     </li></ul></dd>
     
 
@@ -2037,16 +2121,16 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import cvMdTo from 'w-md2docx/src/cvMdTo.mjs'
+    <pre class="prettyprint"><code>import cvMdToDocx from 'w-md2docx/src/cvMdToDocx.mjs'
 
-let r = await cvMdTo({
-    md: '# 標題\n\n&lt;img src="pics/圖.png" />',
-    name: '報告R00.01',
-    out: 'docx',
-    assets: [{ path: 'pics/圖.png', base64: '…' }],
+let r = await cvMdToDocx('./test/report.md', './test/report.docx', {
+    fpInTemp: './src/templates/temp_tpc.docx',
+    optMd2html: {
+        imgWidthMax: '500px',
+    },
 })
 console.log(r)
-// => { name: '報告R00.01', out: 'docx', ms: 8342, nAssets: 1, msDocx: 8300, docx: { fileName: '報告R00.01.docx', mime: '…', size: 39856, base64: '…' } }</code></pre>
+// => { fpOutDocx: '…', sizeDocx: 39856, sizeHtml: 12345, ms: 8342 }</code></pre>
 
 
 
@@ -2078,6 +2162,78 @@ console.log(r)
     <tbody>
     
 
+        <tr>
+            
+                <td class="name"><code>fpInMd</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入來源Markdown檔位置字串</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>fpOutDocx</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入轉出Docx檔位置字串</p></td>
+        </tr>
+
+    
+
         <tr>
             
                 <td class="name"><code>opt</code></td>
@@ -2143,7 +2299,7 @@ console.log(r)
 
         <tr>
             
-                <td class="name"><code>md</code></td>
+                <td class="name"><code>fpInTemp</code></td>
             
 
             <td class="type">
@@ -2176,14 +2332,14 @@ console.log(r)
                 </td>
             
 
-            <td class="description last"><p>輸入Markdown內容字串，與mdBase64二擇一</p></td>
+            <td class="description last"><p>輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>mdBase64</code></td>
+                <td class="name"><code>fpOutHtml</code></td>
             
 
             <td class="type">
@@ -2216,20 +2372,20 @@ console.log(r)
                 </td>
             
 
-            <td class="description last"><p>輸入Markdown內容之base64字串，與md二擇一</p></td>
+            <td class="description last"><p>輸入另存中介Html檔位置字串，未給則中介檔產於系統暫存夾並於轉檔後刪除，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>name</code></td>
+                <td class="name"><code>optMd2html</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -2251,25 +2407,25 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>'output'</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入輸出檔名主體字串(不含副檔名)，將自動移除路徑成分與非法字元，預設'output'</p></td>
+            <td class="description last"><p>輸入傳予w-md2html之設定物件(如imgWidthMax、fontSizeScale等)，預設{}</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>out</code></td>
+                <td class="name"><code>optHtml2docx</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -2291,264 +2447,253 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>'docx'</code>
+                    <code>{}</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入產出類型字串，可為'html'、'docx'、'both'，預設'docx'</p></td>
+            <td class="description last"><p>輸入傳予w-html2docx之設定物件(如imgRatioWidthMax、fontFamilies等)，預設{}</p></td>
         </tr>
+
+    
+    </tbody>
+</table>
+
+            </td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5 class="h5-returns">Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>回傳Promise，resolve回傳結果物件{fpOutDocx,sizeDocx,sizeHtml,ms,[fpOutHtml]}，reject回傳錯誤訊息</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">Promise</span>
+
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="getFpExe"><span class="type-signature"></span>getFpExe<span class="signature">()</span><span class="type-signature"> &rarr; {String}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>取w-html2docx之htmlToDocx.exe位置</p>
+<p>注意：w-html2docx內部以「模組載入當下之工作目錄(cwd)」推導exe位置，故此處以同一規則檢查，使事前檢查與實際轉檔行為一致；查無即代表由此cwd執行必定轉檔失敗。</p></li></ul></dd>
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line178">line 178</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
 
     
 
-        <tr>
-            
-                <td class="name"><code>assets</code></td>
-            
+    
+</dl>
 
-            <td class="type">
-            
-                
-<span class="param-type">Array</span>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>[]</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入md內引用之相對路徑資產陣列，格式[{path,base64}]，預設[]</p></td>
-        </tr>
 
+
+    <h5 class="h5-examples">Example</h5>
     
+    <pre class="prettyprint"><code>console.log(getFpExe())
+// => 'C:\\proj\\node_modules\\w-html2docx\\src\\htmlToDocx.exe'</code></pre>
 
-        <tr>
-            
-                <td class="name"><code>dirWork</code></td>
-            
 
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>''</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入工作資料夾根位置字串，未給則用系統暫存夾下之w-md2docx，預設''</p></td>
-        </tr>
 
-    
 
-        <tr>
-            
-                <td class="name"><code>fpInTemp</code></td>
-            
 
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
+<h5 class="h5-returns">Returns:</h5>
 
-                
-                </td>
-            
+        
+<div class="param-desc">
+    <p>回傳exe位置字串，查無則回傳空字串</p>
+</div>
 
-            
-                <td class="default">
-                
-                    <code>''</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''</p></td>
-        </tr>
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+
+    </dd>
+</dl>
 
     
 
-        <tr>
-            
-                <td class="name"><code>optMd2html</code></td>
-            
 
-            <td class="type">
+
+        
             
-                
-<span class="param-type">Object</span>
 
+    
 
+    <h4 class="name" id="getQueueSize"><span class="type-signature"></span>getQueueSize<span class="signature">()</span><span class="type-signature"> &rarr; {Integer}</span></h4>
 
-            
-            </td>
+    
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
+<dl class="details">
+    
+    <dt class="tag-description">Description:</dt>
+    <dd class="tag-description"><ul class="dummy"><li><p>取當前排隊中(含執行中)之docx轉檔數</p></li></ul></dd>
+    
 
-            <td class="description last"><p>輸入傳予w-md2html之設定物件，預設{}</p></td>
-        </tr>
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line161">line 161</a>
+    </li></ul></dd>
+    
 
     
 
-        <tr>
-            
-                <td class="name"><code>optHtml2docx</code></td>
-            
+    
 
-            <td class="type">
-            
-                
-<span class="param-type">Object</span>
+    
 
+    
 
+    
 
-            
-            </td>
+    
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
+    
 
-                
+    
 
-                
-                </td>
-            
+    
 
-            
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
+    
 
-            <td class="description last"><p>輸入傳予w-html2docx之設定物件，預設{}</p></td>
-        </tr>
+    
 
     
 
-        <tr>
-            
-                <td class="name"><code>keepWork</code></td>
-            
+    
 
-            <td class="type">
-            
-                
-<span class="param-type">Boolean</span>
+    
+
+    
+</dl>
 
 
 
-            
-            </td>
 
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
 
-                
 
-                
-                </td>
-            
 
-            
-                <td class="default">
-                
-                    <code>false</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入是否保留工作資料夾供除錯布林值，預設false</p></td>
-        </tr>
 
-    
-    </tbody>
-</table>
 
-            </td>
-        </tr>
 
+    <h5 class="h5-examples">Example</h5>
     
-    </tbody>
-</table>
+    <pre class="prettyprint"><code>console.log(getQueueSize())
+// => 0</code></pre>
+
+
 
 
 
@@ -2569,7 +2714,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳結果物件{name,out,ms,nAssets,[msDocx],[html],[docx]}，其中html與docx為{fileName,mime,size,base64}，reject回傳錯誤訊息</p>
+    <p>回傳排隊數整數</p>
 </div>
 
 
@@ -2580,7 +2725,7 @@ console.log(r)
     </dt>
     <dd>
         
-<span class="param-type">Promise</span>
+<span class="param-type">Integer</span>
 
 
 
@@ -2596,7 +2741,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="cvMdToDocx"><span class="type-signature type-signature-async">(async) </span>cvMdToDocx<span class="signature">(fpInMd, fpOutDocx, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="health"><span class="type-signature type-signature-async">(async) </span>health<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -2606,15 +2751,13 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>Markdown檔轉Docx檔</p>
-<p>內部流程為md -&gt; html -&gt; docx。docx階段係調用本機Microsoft Word(win32com)，故僅能於已安裝Word之Windows執行，且同時間僅一份轉檔作業(內部佇列自動排隊)。</p>
-<p>注意：底層w-html2docx於Word未安裝或COM呼叫失敗時「仍回傳ok」，本函數一律以產物實體檔之存在與大小驗證成敗，失敗即reject，不會回報假成功。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>查詢轉檔服務之健康狀態</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="cvMdToDocx.mjs.html">cvMdToDocx.mjs</a>, <a href="cvMdToDocx.mjs.html#line42">line 42</a>
+        <a href="rmApiClient.mjs.html">rmApiClient.mjs</a>, <a href="rmApiClient.mjs.html#line420">line 420</a>
     </li></ul></dd>
     
 
@@ -2661,16 +2804,11 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import cvMdToDocx from 'w-md2docx/src/cvMdToDocx.mjs'
+    <pre class="prettyprint"><code>import { health } from 'w-md2docx/src/rmApiClient.mjs'
 
-let r = await cvMdToDocx('./test/report.md', './test/report.docx', {
-    fpInTemp: './src/templates/temp_tpc.docx',
-    optMd2html: {
-        imgWidthMax: '500px',
-    },
-})
+let r = await health({ host: '127.0.0.1', port: 22000 })
 console.log(r)
-// => { fpOutDocx: '…', sizeDocx: 39856, sizeHtml: 12345, ms: 8342 }</code></pre>
+// => { success: true, platform: 'win32', docxReady: true, … }</code></pre>
 
 
 
@@ -2704,13 +2842,13 @@ console.log(r)
 
         <tr>
             
-                <td class="name"><code>fpInMd</code></td>
+                <td class="name"><code>opt</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -2720,6 +2858,8 @@ console.log(r)
             
                 <td class="attributes">
                 
+                    &lt;optional><br>
+                
 
                 
 
@@ -2730,59 +2870,48 @@ console.log(r)
             
                 <td class="default">
                 
+                    <code>{}</code>
+                
                 </td>
             
 
-            <td class="description last"><p>輸入來源Markdown檔位置字串</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>fpOutDocx</code></td>
-            
-
-            <td class="type">
-            
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
                 
-<span class="param-type">String</span>
-
 
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
 
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-
-                
+        <th>Type</th>
 
-                
-                </td>
-            
+        
+        <th>Attributes</th>
+        
 
-            
-                <td class="default">
-                
-                </td>
-            
+        
+        <th>Default</th>
+        
 
-            <td class="description last"><p>輸入轉出Docx檔位置字串</p></td>
-        </tr>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>opt</code></td>
+                <td class="name"><code>host</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">String</span>
 
 
 
@@ -2804,48 +2933,25 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>{}</code>
+                    <code>'127.0.0.1'</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
-                
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
-
-        <th>Type</th>
-
-        
-        <th>Attributes</th>
-        
-
-        
-        <th>Default</th>
-        
-
-        <th class="last">Description</th>
-    </tr>
-    </thead>
+            <td class="description last"><p>輸入服務主機位址(ip或網域)字串，未給則取環境變數WMD2DOCX_HOST，再無則用'127.0.0.1'，預設'127.0.0.1'</p></td>
+        </tr>
 
-    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>fpInTemp</code></td>
+                <td class="name"><code>port</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Integer</span>
 
 
 
@@ -2867,19 +2973,19 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>''</code>
+                    <code>22000</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''</p></td>
+            <td class="description last"><p>輸入服務埠號整數，未給則取環境變數WMD2DOCX_PORT，再無則用22000，預設22000</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>fpOutHtml</code></td>
+                <td class="name"><code>url</code></td>
             
 
             <td class="type">
@@ -2912,20 +3018,20 @@ console.log(r)
                 </td>
             
 
-            <td class="description last"><p>輸入另存中介Html檔位置字串，未給則中介檔產於系統暫存夾並於轉檔後刪除，預設''</p></td>
+            <td class="description last"><p>輸入服務完整位址字串，給予時覆寫host與port，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>optMd2html</code></td>
+                <td class="name"><code>token</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">String</span>
 
 
 
@@ -2947,25 +3053,25 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>{}</code>
+                    <code>''</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入傳予w-md2html之設定物件(如imgWidthMax、fontSizeScale等)，預設{}</p></td>
+            <td class="description last"><p>輸入x-api-token字串，未給則取環境變數WMD2DOCX_TOKEN，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>optHtml2docx</code></td>
+                <td class="name"><code>timeoutMs</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">Number</span>
 
 
 
@@ -2987,12 +3093,12 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>{}</code>
+                    <code>20000</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入傳予w-html2docx之設定物件(如imgRatioWidthMax、fontFamilies等)，預設{}</p></td>
+            <td class="description last"><p>輸入逾時毫秒數，預設20000</p></td>
         </tr>
 
     
@@ -3025,7 +3131,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳結果物件{fpOutDocx,sizeDocx,sizeHtml,ms,[fpOutHtml]}，reject回傳錯誤訊息</p>
+    <p>回傳Promise，resolve回傳服務端回傳之狀態物件，reject回傳錯誤訊息</p>
 </div>
 
 
@@ -3052,7 +3158,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="getFpExe"><span class="type-signature"></span>getFpExe<span class="signature">()</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id="readAssets"><span class="type-signature"></span>readAssets<span class="signature">(md, dirMd)</span><span class="type-signature"> &rarr; {Object}</span></h4>
 
     
 
@@ -3062,14 +3168,14 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取w-html2docx之htmlToDocx.exe位置</p>
-<p>注意：w-html2docx內部以「模組載入當下之工作目錄(cwd)」推導exe位置，故此處以同一規則檢查，使事前檢查與實際轉檔行為一致；查無即代表由此cwd執行必定轉檔失敗。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>讀取Markdown引用之資產檔並轉base64</p>
+<p>path一律回傳md內之原字串(服務端據以還原相對路徑)；實體檔則原字串與URL解碼後字串皆嘗試。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line178">line 178</a>
+        <a href="rmApiClient.mjs.html">rmApiClient.mjs</a>, <a href="rmApiClient.mjs.html#line134">line 134</a>
     </li></ul></dd>
     
 
@@ -3116,124 +3222,84 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>console.log(getFpExe())
-// => 'C:\\proj\\node_modules\\w-html2docx\\src\\htmlToDocx.exe'</code></pre>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+    <pre class="prettyprint"><code>let { assets, missing } = readAssets('![a](pics/a.png)', './report')
+// => { assets: [ { path: 'pics/a.png', base64: '…' } ], missing: [] }</code></pre>
 
 
 
 
-<h5 class="h5-returns">Returns:</h5>
+    <h5 class="h5-parameters">Parameters:</h5>
+    
 
+<table class="params">
+    <thead>
+    <tr>
         
-<div class="param-desc">
-    <p>回傳exe位置字串，查無則回傳空字串</p>
-</div>
-
-
-
-<dl class="param-type">
-    <dt>
-        Type
-    </dt>
-    <dd>
+        <th>Name</th>
         
-<span class="param-type">String</span>
-
-
-
-    </dd>
-</dl>
-
-    
-
 
+        <th>Type</th>
 
         
-            
-
-    
-
-    <h4 class="name" id="getQueueSize"><span class="type-signature"></span>getQueueSize<span class="signature">()</span><span class="type-signature"> &rarr; {Integer}</span></h4>
-
-    
-
-
-
-
-<dl class="details">
-    
-    <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>取當前排隊中(含執行中)之docx轉檔數</p></li></ul></dd>
-    
-
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line161">line 161</a>
-    </li></ul></dd>
-    
-
-    
 
-    
-
-    
-
-    
+        
 
-    
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
     
 
-    
+        <tr>
+            
+                <td class="name"><code>md</code></td>
+            
 
-    
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
-    
 
-    
 
-    
+            
+            </td>
 
-    
+            
 
-    
+            
 
-    
+            <td class="description last"><p>輸入Markdown內容字串</p></td>
+        </tr>
 
     
-</dl>
-
-
 
+        <tr>
+            
+                <td class="name"><code>dirMd</code></td>
+            
 
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
 
+            
+            </td>
 
+            
 
+            
 
+            <td class="description last"><p>輸入Markdown所在資料夾位置字串，相對路徑以此為基準</p></td>
+        </tr>
 
-    <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>console.log(getQueueSize())
-// => 0</code></pre>
-
-
+    </tbody>
+</table>
 
 
 
@@ -3254,7 +3320,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳排隊數整數</p>
+    <p>回傳{assets,missing}，assets為[{path,base64}]，missing為找不到之相對路徑陣列</p>
 </div>
 
 
@@ -3265,7 +3331,7 @@ console.log(r)
     </dt>
     <dd>
         
-<span class="param-type">Integer</span>
+<span class="param-type">Object</span>
 
 
 
@@ -3281,7 +3347,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="health"><span class="type-signature type-signature-async">(async) </span>health<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
+    <h4 class="name" id="resolveAssetPaths"><span class="type-signature"></span>resolveAssetPaths<span class="signature">(dirJob, p)</span><span class="type-signature"> &rarr; {Array}</span></h4>
 
     
 
@@ -3291,13 +3357,14 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>查詢轉檔服務之健康狀態</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>解析資產之相對路徑並防護路徑穿越</p>
+<p>md內之圖片路徑可能為URL編碼(中文或空白)，而轉檔器係以md內之原字串組路徑取圖；故原字串與解碼後字串不同時回傳兩者，供呼叫端寫入同一內容確保圖片必能被解析。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ApiClient.mjs.html">ApiClient.mjs</a>, <a href="ApiClient.mjs.html#line420">line 420</a>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line288">line 288</a>
     </li></ul></dd>
     
 
@@ -3344,11 +3411,8 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import { health } from 'w-md2docx/src/ApiClient.mjs'
-
-let r = await health({ host: '127.0.0.1', port: 22000 })
-console.log(r)
-// => { success: true, platform: 'win32', docxReady: true, … }</code></pre>
+    <pre class="prettyprint"><code>console.log(resolveAssetPaths('C:\\job', 'pics/%E5%9C%96.png'))
+// => [ 'C:\\job\\pics\\%E5%9C%96.png', 'C:\\job\\pics\\圖.png' ]</code></pre>
 
 
 
@@ -3366,75 +3430,8 @@ console.log(r)
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
-
-        
-        <th>Default</th>
-        
-
-        <th class="last">Description</th>
-    </tr>
-    </thead>
-
-    <tbody>
-    
-
-        <tr>
-            
-                <td class="name"><code>opt</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Object</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>{}</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
-                
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
-
-        <th>Type</th>
-
-        
-        <th>Attributes</th>
-        
 
         
-        <th>Default</th>
-        
 
         <th class="last">Description</th>
     </tr>
@@ -3445,87 +3442,7 @@ console.log(r)
 
         <tr>
             
-                <td class="name"><code>host</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>'127.0.0.1'</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入服務主機位址(ip或網域)字串，未給則取環境變數WMD2DOCX_HOST，再無則用'127.0.0.1'，預設'127.0.0.1'</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>port</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Integer</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>22000</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入服務埠號整數，未給則取環境變數WMD2DOCX_PORT，再無則用22000，預設22000</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>url</code></td>
+                <td class="name"><code>dirJob</code></td>
             
 
             <td class="type">
@@ -3539,33 +3456,17 @@ console.log(r)
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
 
             
-                <td class="default">
-                
-                    <code>''</code>
-                
-                </td>
-            
 
-            <td class="description last"><p>輸入服務完整位址字串，給予時覆寫host與port，預設''</p></td>
+            <td class="description last"><p>輸入工作資料夾位置字串</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>token</code></td>
+                <td class="name"><code>p</code></td>
             
 
             <td class="type">
@@ -3575,77 +3476,14 @@ console.log(r)
 
 
 
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>''</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入x-api-token字串，未給則取環境變數WMD2DOCX_TOKEN，預設''</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>timeoutMs</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Number</span>
-
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    <code>20000</code>
-                
-                </td>
-            
-
-            <td class="description last"><p>輸入逾時毫秒數，預設20000</p></td>
-        </tr>
-
-    
-    </tbody>
-</table>
-
+            
             </td>
+
+            
+
+            
+
+            <td class="description last"><p>輸入資產相對路徑字串</p></td>
         </tr>
 
     
@@ -3671,7 +3509,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳服務端回傳之狀態物件，reject回傳錯誤訊息</p>
+    <p>回傳實際寫入之絕對路徑陣列</p>
 </div>
 
 
@@ -3682,7 +3520,7 @@ console.log(r)
     </dt>
     <dd>
         
-<span class="param-type">Promise</span>
+<span class="param-type">Array</span>
 
 
 
@@ -3698,7 +3536,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="readAssets"><span class="type-signature"></span>readAssets<span class="signature">(md, dirMd)</span><span class="type-signature"> &rarr; {Object}</span></h4>
+    <h4 class="name" id="retryBusy"><span class="type-signature type-signature-async">(async) </span>retryBusy<span class="signature">(fun, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -3708,14 +3546,14 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>讀取Markdown引用之資產檔並轉base64</p>
-<p>path一律回傳md內之原字串(服務端據以還原相對路徑)；實體檔則原字串與URL解碼後字串皆嘗試。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>重試短暫被鎖定之檔案操作</p>
+<p>Windows下新建檔案常被防毒或索引器即時掃描而短暫鎖定(EBUSY/EPERM)，遇此類錯誤時延遲後重試以提高穩定性，其餘錯誤直接拋出。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ApiClient.mjs.html">ApiClient.mjs</a>, <a href="ApiClient.mjs.html#line134">line 134</a>
+        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line73">line 73</a>
     </li></ul></dd>
     
 
@@ -3762,8 +3600,7 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>let { assets, missing } = readAssets('![a](pics/a.png)', './report')
-// => { assets: [ { path: 'pics/a.png', base64: '…' } ], missing: [] }</code></pre>
+    <pre class="prettyprint"><code>let r = await retryBusy(() => fs.promises.readFile('./a.txt', 'utf8'), { tries: 3 })</code></pre>
 
 
 
@@ -3781,8 +3618,12 @@ console.log(r)
         <th>Type</th>
 
         
+        <th>Attributes</th>
+        
 
         
+        <th>Default</th>
+        
 
         <th class="last">Description</th>
     </tr>
@@ -3793,13 +3634,13 @@ console.log(r)
 
         <tr>
             
-                <td class="name"><code>md</code></td>
+                <td class="name"><code>fun</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">function</span>
 
 
 
@@ -3807,23 +3648,35 @@ console.log(r)
             </td>
 
             
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
 
             
+                <td class="default">
+                
+                </td>
+            
 
-            <td class="description last"><p>輸入Markdown內容字串</p></td>
+            <td class="description last"><p>輸入欲執行之函數，可回傳Promise</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>dirMd</code></td>
+                <td class="name"><code>opt</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -3831,10 +3684,136 @@ console.log(r)
             </td>
 
             
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
 
             
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
+            
 
-            <td class="description last"><p>輸入Markdown所在資料夾位置字串，相對路徑以此為基準</p></td>
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>tries</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Integer</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>6</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入最多嘗試次數整數，預設6</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>delayMs</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>400</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入每次重試前延遲毫秒數，預設400</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+            </td>
         </tr>
 
     
@@ -3860,7 +3839,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳{assets,missing}，assets為[{path,base64}]，missing為找不到之相對路徑陣列</p>
+    <p>回傳Promise，resolve回傳fun之結果，reject回傳錯誤</p>
 </div>
 
 
@@ -3871,7 +3850,7 @@ console.log(r)
     </dt>
     <dd>
         
-<span class="param-type">Object</span>
+<span class="param-type">Promise</span>
 
 
 
@@ -3887,7 +3866,7 @@ console.log(r)
 
     
 
-    <h4 class="name" id="resolveAssetPaths"><span class="type-signature"></span>resolveAssetPaths<span class="signature">(dirJob, p)</span><span class="type-signature"> &rarr; {Array}</span></h4>
+    <h4 class="name" id="rmApiServer"><span class="type-signature type-signature-async">(async) </span>rmApiServer<span class="signature">(opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
 
     
 
@@ -3897,14 +3876,14 @@ console.log(r)
 <dl class="details">
     
     <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>解析資產之相對路徑並防護路徑穿越</p>
-<p>md內之圖片路徑可能為URL編碼(中文或空白)，而轉檔器係以md內之原字串組路徑取圖；故原字串與解碼後字串不同時回傳兩者，供呼叫端寫入同一內容確保圖片必能被解析。</p></li></ul></dd>
+    <dd class="tag-description"><ul class="dummy"><li><p>建立並啟動Markdown轉Html/Docx之API服務</p>
+<p>以hapi提供三個端點：GET /api/health(健康檢查與環境狀態)、GET /api/selftest(實跑一次最小轉檔驗證本機Word可用)、POST /api/convert(轉檔主端點，JSON參數同cvMdTo，另可用templateName指定服務端模板或templateBase64夾帶模板；query帶download=1時單一格式直接回傳二進位檔)。</p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line288">line 288</a>
+        <a href="rmApiServer.mjs.html">rmApiServer.mjs</a>, <a href="rmApiServer.mjs.html#line86">line 86</a>
     </li></ul></dd>
     
 
@@ -3951,8 +3930,13 @@ console.log(r)
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>console.log(resolveAssetPaths('C:\\job', 'pics/%E5%9C%96.png'))
-// => [ 'C:\\job\\pics\\%E5%9C%96.png', 'C:\\job\\pics\\圖.png' ]</code></pre>
+    <pre class="prettyprint"><code>import rmApiServer from 'w-md2docx/src/rmApiServer.mjs'
+
+let { server, settings } = await rmApiServer({
+    port: 22000,
+    token: '',
+})
+console.log(`listening on ${server.info.uri}`, settings)</code></pre>
 
 
 
@@ -3970,8 +3954,12 @@ console.log(r)
         <th>Type</th>
 
         
+        <th>Attributes</th>
+        
 
         
+        <th>Default</th>
+        
 
         <th class="last">Description</th>
     </tr>
@@ -3982,13 +3970,13 @@ console.log(r)
 
         <tr>
             
-                <td class="name"><code>dirJob</code></td>
+                <td class="name"><code>opt</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
 
@@ -3996,191 +3984,222 @@ console.log(r)
             </td>
 
             
-
-            
-
-            <td class="description last"><p>輸入工作資料夾位置字串</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>p</code></td>
-            
-
-            <td class="type">
-            
+                <td class="attributes">
+                
+                    &lt;optional><br>
                 
-<span class="param-type">String</span>
-
 
+                
 
+                
+                </td>
             
-            </td>
 
             
-
+                <td class="default">
+                
+                    <code>{}</code>
+                
+                </td>
             
 
-            <td class="description last"><p>輸入資產相對路徑字串</p></td>
-        </tr>
-
-    
-    </tbody>
-</table>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<h5 class="h5-returns">Returns:</h5>
+            <td class="description last"><p>輸入設定物件，預設{}</p>
+                <h6>Properties</h6>
+                
 
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
         
-<div class="param-desc">
-    <p>回傳實際寫入之絕對路徑陣列</p>
-</div>
-
 
+        <th>Type</th>
 
-<dl class="param-type">
-    <dt>
-        Type
-    </dt>
-    <dd>
         
-<span class="param-type">Array</span>
-
+        <th>Attributes</th>
+        
 
+        
+        <th>Default</th>
+        
 
-    </dd>
-</dl>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
     
 
-
-
-        
+        <tr>
+            
+                <td class="name"><code>port</code></td>
             
 
-    
-
-    <h4 class="name" id="retryBusy"><span class="type-signature type-signature-async">(async) </span>retryBusy<span class="signature">(fun, opt<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
-
-    
+            <td class="type">
+            
+                
+<span class="param-type">Integer</span>
 
 
 
+            
+            </td>
 
-<dl class="details">
-    
-    <dt class="tag-description">Description:</dt>
-    <dd class="tag-description"><ul class="dummy"><li><p>重試短暫被鎖定之檔案操作</p>
-<p>Windows下新建檔案常被防毒或索引器即時掃描而短暫鎖定(EBUSY/EPERM)，遇此類錯誤時延遲後重試以提高穩定性，其餘錯誤直接拋出。</p></li></ul></dd>
-    
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="utils.mjs.html">utils.mjs</a>, <a href="utils.mjs.html#line73">line 73</a>
-    </li></ul></dd>
-    
+                
 
-    
+                
+                </td>
+            
 
-    
+            
+                <td class="default">
+                
+                    <code>22000</code>
+                
+                </td>
+            
 
-    
+            <td class="description last"><p>輸入服務埠號整數，給0則由系統自動配置(實際埠號見回傳之server.info.port)，預設22000</p></td>
+        </tr>
 
     
 
-    
+        <tr>
+            
+                <td class="name"><code>host</code></td>
+            
 
-    
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
-    
 
-    
 
-    
+            
+            </td>
 
-    
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
-    
+                
 
-    
+                
+                </td>
+            
 
-    
+            
+                <td class="default">
+                
+                    <code>'0.0.0.0'</code>
+                
+                </td>
+            
 
-    
+            <td class="description last"><p>輸入監聽位址字串，預設'0.0.0.0'</p></td>
+        </tr>
 
     
-</dl>
 
+        <tr>
+            
+                <td class="name"><code>token</code></td>
+            
 
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
 
+            
+            </td>
 
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
+                
 
+                
+                </td>
+            
 
+            
+                <td class="default">
+                
+                    <code>''</code>
+                
+                </td>
+            
 
+            <td class="description last"><p>輸入權杖字串，非空時所有/api/*須帶x-api-token標頭，預設''</p></td>
+        </tr>
 
-    <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>let r = await retryBusy(() => fs.promises.readFile('./a.txt', 'utf8'), { tries: 3 })</code></pre>
 
+        <tr>
+            
+                <td class="name"><code>maxMb</code></td>
+            
 
+            <td class="type">
+            
+                
+<span class="param-type">Number</span>
 
 
-    <h5 class="h5-parameters">Parameters:</h5>
-    
 
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
+            
+            </td>
 
-        <th>Type</th>
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
 
-        
-        <th>Attributes</th>
-        
+                
 
-        
-        <th>Default</th>
-        
+                
+                </td>
+            
 
-        <th class="last">Description</th>
-    </tr>
-    </thead>
+            
+                <td class="default">
+                
+                    <code>256</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入請求大小上限數字，單位MB，預設256</p></td>
+        </tr>
 
-    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>fun</code></td>
+                <td class="name"><code>dirTemplates</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">function</span>
+<span class="param-type">String</span>
 
 
 
@@ -4190,6 +4209,8 @@ console.log(r)
             
                 <td class="attributes">
                 
+                    &lt;optional><br>
+                
 
                 
 
@@ -4200,23 +4221,25 @@ console.log(r)
             
                 <td class="default">
                 
+                    <code>''</code>
+                
                 </td>
             
 
-            <td class="description last"><p>輸入欲執行之函數，可回傳Promise</p></td>
+            <td class="description last"><p>輸入docx模板資料夾位置字串，未給則用本套件src/templates，預設''</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>opt</code></td>
+                <td class="name"><code>dirWork</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type">String</span>
 
 
 
@@ -4238,48 +4261,25 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>{}</code>
+                    <code>''</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入設定物件，預設{}</p>
-                <h6>Properties</h6>
-                
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Name</th>
-        
-
-        <th>Type</th>
-
-        
-        <th>Attributes</th>
-        
-
-        
-        <th>Default</th>
-        
-
-        <th class="last">Description</th>
-    </tr>
-    </thead>
+            <td class="description last"><p>輸入工作資料夾位置字串，未給則用系統暫存夾下之w-md2docx，預設''</p></td>
+        </tr>
 
-    <tbody>
     
 
         <tr>
             
-                <td class="name"><code>tries</code></td>
+                <td class="name"><code>templateDef</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Integer</span>
+<span class="param-type">String</span>
 
 
 
@@ -4301,25 +4301,25 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>6</code>
+                    <code>'temp_tpc.docx'</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入最多嘗試次數整數，預設6</p></td>
+            <td class="description last"><p>輸入預設模板檔名字串，預設'temp_tpc.docx'</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>delayMs</code></td>
+                <td class="name"><code>autoStart</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">Number</span>
+<span class="param-type">Boolean</span>
 
 
 
@@ -4341,12 +4341,12 @@ console.log(r)
             
                 <td class="default">
                 
-                    <code>400</code>
+                    <code>true</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入每次重試前延遲毫秒數，預設400</p></td>
+            <td class="description last"><p>輸入是否立即啟動服務布林值，預設true</p></td>
         </tr>
 
     
@@ -4379,7 +4379,7 @@ console.log(r)
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳fun之結果，reject回傳錯誤</p>
+    <p>回傳Promise，resolve回傳{server,settings,getState,stop}，其中server為hapi實例，getState為取環境狀態之async函數，stop為停止服務之async函數，reject回傳錯誤訊息</p>
 </div>
 
 
@@ -4587,7 +4587,7 @@ console.log(r)
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ApiClient.mjs.html">ApiClient.mjs</a>, <a href="ApiClient.mjs.html#line81">line 81</a>
+        <a href="rmApiClient.mjs.html">rmApiClient.mjs</a>, <a href="rmApiClient.mjs.html#line81">line 81</a>
     </li></ul></dd>
     
 
@@ -5440,7 +5440,7 @@ console.log(toSafeName(''))
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Sep 01 2026 16:40:03 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 16:38:11 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>