w-dwdata-hub 1.0.13 → 1.0.15

package/docs/parseIntComma.mjs.html

@@ -87,7 +87,7 @@ export default parseIntComma
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sun Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/safeFilename.mjs.html

@@ -89,7 +89,7 @@ export default safeFilename
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sun Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/stripHtml.mjs.html

@@ -117,7 +117,7 @@ export default stripHtml
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sun Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/toDatetimeUTC8.mjs.html

@@ -147,7 +147,7 @@ export default toDatetimeUTC8
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sun Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/toRocDate.mjs.html

@@ -94,7 +94,7 @@ export default toRocDate
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sun Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g.mjs

@@ -4,67 +4,67 @@ import wi from './src/WDwdataHub.mjs'
 let test = async () => {
 
     //綜合新聞: RSS訂閱源, 回傳統一格式{url,time,title,description,from}
-    let r1 = await wi.fetchRSS('https://www.ptt.cc/atom/Gossiping.xml', { showLog: false })
+    let r1 = await wi.fetchRSS('https://www.ptt.cc/atom/Gossiping.xml', { useShowLog: false })
     console.log('rss:', r1.length, r1[0].time, r1[0].title)
     // => rss: 19 2026-08-07 09:30:19 [問卦] 公視是怎麼走到今天這一步的？
 
     //綜合新聞: 擋node fetch之站台(403)改走curl抓取, 並以withContent附feed內嵌全文(去標籤純文字)
-    let r1b = await wi.fetchRSS('https://alphaarchitect.com/feed', { method: 'curl', withContent: true, showLog: false })
+    let r1b = await wi.fetchRSS('https://alphaarchitect.com/feed', { method: 'curl', withContent: true, useShowLog: false })
     console.log('rss(curl):', r1b.length, r1b[0].content.length, r1b[0].description.length)
     // => rss(curl): 5 6339 545
 
     //綜合新聞: Hacker News最新文章, 可指定取回篇數
-    let r2 = await wi.fetchHackerNews(5, { showLog: false })
+    let r2 = await wi.fetchHackerNews(5, { useShowLog: false })
     console.log('hackerNews:', r2.length, r2[0].from, r2[0].title)
     // => hackerNews: 5 Hacker News Romania blasts rock to divert water from drought-hit Danube to nuclear reactor
 
     //綜合新聞: AI News Aggregator近24小時彙整
-    let r3 = await wi.fetchAiNewsAggregator({ showLog: false })
+    let r3 = await wi.fetchAiNewsAggregator({ useShowLog: false })
     console.log('aiNews:', r3.length, r3[0].from)
     // => aiNews: 914 夕小瑶科技说
 
     //台股新聞: 鉅亨網, 逐頁抓至targetTotal則
-    let r4 = await wi.fetchCnyes({ targetTotal: 30, showLog: false })
+    let r4 = await wi.fetchCnyes({ targetTotal: 30, useShowLog: false })
     console.log('cnyes:', r4.length, r4[0].time, r4[0].link)
     // => cnyes: 30 2026-08-07 09:20:46 https://news.cnyes.com/news/id/6563766
 
     //台股資料: 證交所上市個股日成交資訊, 指定日期會由整月資料過濾為當日單筆
-    let r5 = await wi.fetchTwseStock('20260806', '2330', { showLog: false })
+    let r5 = await wi.fetchTwseStock('20260806', '2330', { useShowLog: false })
     console.log('twseStock:', r5.stat, r5.data.length, r5.data[0][6])
     // => twseStock: OK 1 2,365.00
 
     //台股資料: 櫃買中心上櫃融資融券, 未指定個股則回全市場
-    let r6 = await wi.fetchTpexMargin('20260806', ['6488'], { showLog: false })
+    let r6 = await wi.fetchTpexMargin('20260806', ['6488'], { useShowLog: false })
     console.log('tpexMargin:', r6.source, r6.count, r6.data[0].marginChange)
     // => tpexMargin: tpex_margin 1 -694
 
     //台股資料: 期交所台指期、三大法人未平倉與Put/Call Ratio, 單支失敗僅記於errors
-    let r7 = await wi.fetchTaifex('20260806', { showLog: false })
+    let r7 = await wi.fetchTaifex('20260806', { useShowLog: false })
     console.log('taifex:', r7.futures.tx.close, r7.pcRatio.ratio, r7.errors)
     // => taifex: 44280 109.14 []
 
     //台股資料: 證交所休市日期, 給定日期則另回傳該日是否休市
-    let r8 = await wi.fetchTwDataHoliday('20260101', { showLog: false })
+    let r8 = await wi.fetchTwDataHoliday('20260101', { useShowLog: false })
     console.log('holiday:', r8.dataYear, r8.totalHolidays, r8.isHoliday, r8.holidayName)
     // => holiday: 2026 22 true 中華民國開國紀念日
 
     //中文評論網站: 愛思想, 依作者中文名查專欄文章清單
-    let r9 = await wi.fetchAisixiang.fetchAuthorArticles({ name: '葛兆光', showLog: false })
+    let r9 = await wi.fetchAisixiang.fetchAuthorArticles({ name: '葛兆光', useShowLog: false })
     console.log('aisixiang:', r9.status, r9.resolved.slug, r9.count)
     // => aisixiang: success gezhaoguang 170
 
     //中文評論網站: 愛思想, 抓單篇文章轉為含frontmatter之Markdown
-    let r10 = await wi.fetchAisixiang.fetchArticle({ aid: '146669', showLog: false })
+    let r10 = await wi.fetchAisixiang.fetchArticle({ aid: '146669', useShowLog: false })
     console.log('aisixiang:', r10.status, r10.title, r10.chars)
     // => aisixiang: success 葛兆光：禅宗与中国文化 16986
 
     //中文評論網站: 觀察者網, 依主題中文名查文章清單, 自動選用可翻頁之欄目slug
-    let r11 = await wi.fetchGuancha.fetchTopicArticles({ name: '财经', maxPages: 1, showLog: false })
+    let r11 = await wi.fetchGuancha.fetchTopicArticles({ name: '财经', maxPages: 1, useShowLog: false })
     console.log('guancha:', r11.status, r11.resolved.slug, r11.count)
     // => guancha: success CaiJing 30
 
     //查無資料時回status為success且count為0, 抓取失敗才回status為error, 兩者可明確區分
-    let r12 = await wi.fetchGuancha.fetchAuthorArticles({ name: '不存在的作者XYZ', showLog: false })
+    let r12 = await wi.fetchGuancha.fetchAuthorArticles({ name: '不存在的作者XYZ', useShowLog: false })
     console.log('guancha:', r12.status, r12.count, r12.message)
     // => guancha: success 0 "不存在的作者XYZ" 不在觀察者網作者索引中（共 641 位）。尚無此作者文章。提醒：本函數不轉繁簡，呼叫端負責用站方登錄字形（簡體）。
 

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "w-dwdata-hub",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "main": "dist/w-dwdata-hub.umd.js",
   "dependencies": {
     "cheerio": "^1.2.0",
     "rss-parser": "^3.13.0",
-    "w-fetch-web": "^1.0.14",
-    "wsemi": "^1.8.84"
+    "w-fetch-web": "^1.0.19",
+    "wsemi": "^1.8.92"
   },
   "devDependencies": {
-    "w-package-tools": "^1.1.15"
+    "w-package-tools": "^1.1.16"
   },
   "scripts": {
-    "test": "mocha --parallel --timeout 180000",
+    "test": "mocha --parallel \"test/*.test.mjs\" --timeout 180000",
     "deploy": "gh-pages -d docs"
   },
   "repository": {

package/src/fetchAiNewsAggregator.mjs

@@ -32,7 +32,7 @@ let DFLT = {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設5
  * @param {Integer} [opt.baseDelayMs=3000] 輸入重試之線性退避基礎毫秒整數，預設3000
  * @param {Integer} [opt.maxDelayMs=15000] 輸入重試之線性退避上限毫秒整數，預設15000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{url,time,title,description,from}，抓取失敗時reject回傳錯誤物件
  * @example
  *

package/src/fetchAisixiang.mjs

@@ -77,7 +77,7 @@ function getCfg(opt = {}) {
         maxPages = Math.min(cint(maxPages), MAX_PAGES)
     }
 
-    return { baseUrl, showLog: optFetch.showLog, pageDelayMs, maxPages, optFetch }
+    return { baseUrl, useShowLog: optFetch.useShowLog, pageDelayMs, maxPages, optFetch }
 }
 
 
@@ -255,7 +255,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
     for (let page = 1; page <= cfg.maxPages; page++) {
 
         let url = buildUrl(page)
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write(`[info] fetching page ${page}${totalPages > 1 ? `/${totalPages}` : ''} ...\n`)
         }
         let html = await fetchWithRetry(url, cfg.optFetch)
@@ -268,7 +268,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
         let items = parser(html, cfg.baseUrl)
         let fresh = items.filter((it) => !seen.has(it.aid))
         if (fresh.length === 0) {
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 無新項目，停止翻頁\n`)
             }
             break
@@ -301,7 +301,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳作者物件陣列，各物件為{slug,name}
  * @example
  *
@@ -381,7 +381,7 @@ function lookupAuthor(authors, name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳主題物件陣列，各物件為{id,name,category}
  * @example
  *
@@ -474,7 +474,7 @@ function lookupTopic(topics, name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -516,7 +516,7 @@ async function fetchAuthorArticles(opt = {}) {
 
     if (!usedSlug) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching authors list from /thinktank/ ...\n')
         }
         let authors = await fetchAuthorsList(opt)
@@ -584,7 +584,7 @@ async function fetchAuthorArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword非有效字串時reject回傳錯誤物件
  * @example
  *
@@ -656,7 +656,7 @@ async function fetchKeywordArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword非有效字串時reject回傳錯誤物件
  * @example
  *
@@ -730,7 +730,7 @@ async function fetchTitleArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword與id皆未給時reject回傳錯誤物件
  * @example
  *
@@ -772,7 +772,7 @@ async function fetchTopicArticles(opt = {}) {
 
     if (!topicId) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching topics list from /zhuanti/ ...\n')
         }
         let topics = await fetchTopicsList(opt)
@@ -847,7 +847,7 @@ async function fetchTopicArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,url,title,chars,markdown}，aid與url皆未給或解析失敗時reject回傳錯誤物件
  * @example
  *

package/src/fetchCnyes.mjs

@@ -52,7 +52,7 @@ let DEFAULT_DAYS_BACK = 10
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
  * @param {Integer} [opt.baseDelayMs=5000] 輸入重試之線性退避基礎毫秒整數，預設5000
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試之線性退避上限毫秒整數，預設30000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取失敗時reject回傳錯誤物件
  * @example
  *
@@ -117,13 +117,13 @@ async function fetchCnyes(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //now, startAt
     let now = Math.floor(Date.now() / 1000)
     let startAt = now - 86400 * daysBack
 
-    if (showLog) {
+    if (useShowLog) {
         console.log('Starting to fetch Anue (tw_stock) news...')
     }
 
@@ -146,14 +146,14 @@ async function fetchCnyes(opt = {}) {
         //items
         let items = get(data, 'items.data')
         if (!isearr(items)) {
-            if (showLog) {
+            if (useShowLog) {
                 console.log('No more items found.')
             }
             break
         }
 
         allItems = allItems.concat(items)
-        if (showLog) {
+        if (useShowLog) {
             console.log(`Page ${page}: Fetched ${items.length} items. Total so far: ${allItems.length}`)
         }
         page++
@@ -164,7 +164,7 @@ async function fetchCnyes(opt = {}) {
 
     //finalItems
     let finalItems = allItems.slice(0, targetTotal)
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Total items collected: ${finalItems.length}`)
     }
 
@@ -172,7 +172,7 @@ async function fetchCnyes(opt = {}) {
 
         //time, 單筆publishAt缺漏或異常時退回空字串並記錄, 保留title與link避免拖垮其餘正常新聞
         let time = toDatetimeUTC8(get(item, 'publishAt', 0))
-        if (time === '' && showLog) {
+        if (time === '' && useShowLog) {
             console.warn(`[fetch-cnyes] 時間格式化失敗(newsId=${get(item, 'newsId', '')}, publishAt=${get(item, 'publishAt', '')}) — 該筆time退回空字串`)
         }
 

package/src/fetchGuancha.mjs

@@ -113,10 +113,10 @@ function getCfg(opt = {}) {
         timeoutMs = cint(timeoutMs)
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = true
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     //optFetch
@@ -143,7 +143,7 @@ function getCfg(opt = {}) {
         maxPages = Math.min(cint(maxPages), MAX_PAGES)
     }
 
-    return { baseUrl, showLog, pageDelayMs, maxPages, optFetch }
+    return { baseUrl, useShowLog, pageDelayMs, maxPages, optFetch }
 }
 
 
@@ -316,7 +316,7 @@ async function fetchAllListPages(slug, cfg) {
     for (let page = 1; page <= cfg.maxPages; page++) {
 
         let url = `${cfg.baseUrl}/${slug}/list_${page}.shtml`
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write(`[info] fetching ${slug} list_${page} ...\n`)
         }
 
@@ -329,7 +329,7 @@ async function fetchAllListPages(slug, cfg) {
             if (page === 1) {
                 throw err
             }
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} fetch error (assumed end of list): ${err.message}\n`)
             }
             break
@@ -342,7 +342,7 @@ async function fetchAllListPages(slug, cfg) {
                 err.reason = 'redirected-to-homepage'
                 throw err
             }
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 被導向首頁，視為到底，停止翻頁\n`)
             }
             break
@@ -353,7 +353,7 @@ async function fetchAllListPages(slug, cfg) {
         let items = parseListPage(html, cfg.baseUrl)
         let fresh = items.filter((it) => !seen.has(it.url))
         if (fresh.length === 0) {
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 無新項目，停止翻頁\n`)
             }
             break
@@ -384,7 +384,7 @@ async function fetchAllListPages(slug, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳作者物件陣列，各物件為{slug,name,letter}
  * @example
  *
@@ -477,7 +477,7 @@ function lookupTopic(name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -518,7 +518,7 @@ async function fetchAuthorArticles(opt = {}) {
 
     if (!resolvedSlug) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching authors index from / ...\n')
         }
         let authors = await fetchAuthorsList(opt)
@@ -685,7 +685,7 @@ async function fetchTitleArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -790,7 +790,7 @@ async function fetchTopicArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,url,title,author,published,chars,markdown}，url非有效字串時reject回傳錯誤物件
  * @example
  *

package/src/fetchHackerNews.mjs

@@ -41,7 +41,7 @@ let CONCURRENCY = 10
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設5
  * @param {Integer} [opt.baseDelayMs=3000] 輸入重試之線性退避基礎毫秒整數，預設3000
  * @param {Integer} [opt.maxDelayMs=15000] 輸入重試之線性退避上限毫秒整數，預設15000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳文章物件陣列，各物件為{url,time,title,description,from}，抓取ID清單失敗時reject回傳錯誤物件
  * @example
  *

package/src/fetchMoneydj.mjs

@@ -53,7 +53,7 @@ let REG_TIME = /^(\d{2}\/\d{2}\s+\d{2}:\d{2}|\d{2}:\d{2}|昨\s*\d{2}:\d{2})$/
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試最大延遲毫秒整數，預設30000
  * @param {Integer} [opt.pageDelayMs] 輸入頁間延遲毫秒整數，未給時採隨機1000至3000毫秒
  * @param {Function} [opt.onPageDone] 輸入每頁完成時之回呼函數，傳入(pageIndex,itemCount,totalPages)
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取到0筆時reject回傳錯誤物件
  * @example
  *
@@ -97,7 +97,7 @@ async function fetchMoneydj(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //pageDelayMs, 頁間隨機延遲毫秒
     let pageDelayMs = get(opt, 'pageDelayMs')
@@ -151,7 +151,7 @@ async function fetchMoneydj(opt = {}) {
             items = await fetchPage(i)
         }
         catch (err) {
-            if (showLog) {
+            if (useShowLog) {
                 console.warn(`[Page ${i}] 抓取失敗，已跳過：${err.message}`)
             }
             continue

package/src/fetchMops.mjs

@@ -119,7 +119,7 @@ async function fetchTargetWithRetry(page, target, cfg) {
         }
 
         let ms = Math.min(cfg.baseDelayMs * attempt, cfg.maxDelayMs)
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             console.warn(`[${target.name}][Retry ${attempt}/${cfg.maxRetries}] ${data.error} — 等待 ${ms / 1000}s 後重試...`)
         }
         await delay(ms)
@@ -141,7 +141,7 @@ async function fetchTargetWithRetry(page, target, cfg) {
  * @param {String} [opt.pageUrl='https://mops.twse.com.tw/mops/#/web/t146sb10'] 輸入MOPS重大訊息頁網址字串，供測試或改指向鏡像時覆寫
  * @param {String} [opt.apiUrl='https://mops.twse.com.tw/mops/api/t146sb10'] 輸入MOPS查詢API網址字串，供測試或改指向鏡像時覆寫
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{results,hasError}，results各筆為{market,marketKind,data,error,timestamp}，瀏覽器啟動失敗時reject回傳錯誤物件
  * @example
  *
@@ -183,10 +183,10 @@ async function fetchMops(opt = {}) {
         maxRetries = cint(maxRetries)
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = true
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     //cfg
@@ -194,7 +194,7 @@ async function fetchMops(opt = {}) {
         maxRetries,
         baseDelayMs: DEFAULT_BASE_DELAY_MS,
         maxDelayMs: DEFAULT_MAX_DELAY_MS,
-        showLog,
+        useShowLog,
     }
 
     //targets
@@ -207,7 +207,7 @@ async function fetchMops(opt = {}) {
         }
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log('啟動瀏覽器...')
     }
 
@@ -232,7 +232,7 @@ async function fetchMops(opt = {}) {
                 throw new Error(`瀏覽器啟動失敗（已重試 ${maxRetries} 次）: ${err.message}`)
             }
             let ms = Math.min(DEFAULT_BASE_DELAY_MS * attempt, DEFAULT_MAX_DELAY_MS)
-            if (showLog) {
+            if (useShowLog) {
                 console.warn(`[browser.launch][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
             }
             await delay(ms)
@@ -244,7 +244,7 @@ async function fetchMops(opt = {}) {
         let page = await browser.newPage()
 
         //帶重試之頁面導航
-        if (showLog) {
+        if (useShowLog) {
             console.log('前往 MOPS 重大訊息頁面 (t146sb10)...')
         }
         for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
@@ -258,7 +258,7 @@ async function fetchMops(opt = {}) {
                     throw err
                 }
                 let ms = Math.min(DEFAULT_BASE_DELAY_MS * attempt, DEFAULT_MAX_DELAY_MS)
-                if (showLog) {
+                if (useShowLog) {
                     console.warn(`[page.goto][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
                 }
                 await delay(ms)
@@ -271,7 +271,7 @@ async function fetchMops(opt = {}) {
         let results = []
         for (let target of targets) {
 
-            if (showLog) {
+            if (useShowLog) {
                 console.log(`正在抓取 [${target.name}] 資料...`)
             }
 
@@ -288,7 +288,7 @@ async function fetchMops(opt = {}) {
             await page.waitForTimeout(1000)
         }
 
-        if (showLog) {
+        if (useShowLog) {
             let summary = results.map((r) => {
                 let resultData = get(r, 'data.result', get(r, 'data'))
                 let count = Array.isArray(resultData) ? resultData.length : 0

package/src/fetchRSS.mjs

@@ -98,7 +98,7 @@ async function getXml(rssUrl, method, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設5
  * @param {Integer} [opt.baseDelayMs=3000] 輸入重試之線性退避基礎毫秒整數(僅fetch模式生效)，預設3000
  * @param {Integer} [opt.maxDelayMs=15000] 輸入重試之線性退避上限毫秒整數(僅fetch模式生效)，預設15000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳項目物件陣列，各物件為{url,time,title,description,from}，withContent為true時另含content欄，網址無效或抓取失敗時reject回傳錯誤物件
  * @example
  *

package/src/fetchStatementdog.mjs

@@ -47,7 +47,7 @@ let FALLBACK_DATE = 'time, [class*="date"], [class*="time"]'
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
  * @param {Integer} [opt.baseDelayMs=5000] 輸入重試之線性退避基礎毫秒整數，預設5000
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試之線性退避上限毫秒整數，預設30000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取失敗或解析到0筆時reject回傳錯誤物件
  * @example
  *
@@ -76,9 +76,9 @@ async function fetchStatementdog(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching ${url}...`)
     }
 
@@ -97,7 +97,7 @@ async function fetchStatementdog(opt = {}) {
     let titleSel = usePrimary ? PRIMARY_TITLE : FALLBACK_TITLE
     let linkSel = usePrimary ? PRIMARY_LINK : FALLBACK_LINK
     let dateSel = usePrimary ? PRIMARY_DATE : FALLBACK_DATE
-    if (!usePrimary && showLog) {
+    if (!usePrimary && useShowLog) {
         console.warn('主要 CSS selector 未匹配，嘗試 fallback selector...')
     }
 
@@ -125,7 +125,7 @@ async function fetchStatementdog(opt = {}) {
         newsItems.push({ time, title, link })
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Extracted News Items: ${newsItems.length}`)
     }