如何使用 WhiskeyMate 知識庫

總覽

The WhiskeyMate Knowledge Base 是一個應用程式內（iOS/Android）和網頁（瀏覽器）版的幫助文章庫。文章儲存在 Firestore 的 knowledge_articles 集合中，包含格式化的 HTML 內容、標籤/關鍵字以及計數器（瀏覽次數 + 有用投票）。

開啟知識庫

• iOS：開啟個人檔案，然後點擊幫助（在個人檔案選單中）。
• Android：開啟應用程式的漢堡選單 → 幫助與資訊 → 知識庫。
• 網頁版：在瀏覽器中開啟 whiskeymate.net/knowledge_articles.html。

在 iOS 上使用知識庫

• 搜尋：使用搜尋欄位來比對文章的標題、副標題或搜尋關鍵字。
• 排序：切換最新、優先和最多瀏覽。
• 開啟文章：點擊文章以查看其特色圖片（如果可用）、中繼資料（瀏覽次數/作者/平台）和格式化的 HTML 內文。
• 投票有用/無用：您可以對文章進行評分；WhiskeyMate 會相應地更新文章的有用計數器。

在 Android 上使用知識庫

• 搜尋：使用搜尋欄位來比對文章的標題、副標題或搜尋關鍵字。
• 排序：切換最新、優先和最多瀏覽。
• 開啟文章：點擊文章以查看其特色圖片（如果可用）、中繼資料和格式化的 HTML 內文。
• 投票有用/無用：您可以對文章進行評分；WhiskeyMate 會相應地更新文章的有用計數器。

在網頁版上使用知識庫

• 依類別瀏覽：左側邊欄將文章按類別分組。類別可展開/收合以顯示其文章。
• 搜尋（側邊欄）：側邊欄搜尋會根據文章標題篩選文章列表。
• 搜尋（收合/行動版）：當側邊欄收合時，主內容區域的搜尋欄位會使用標題、副標題和內文來尋找符合項目。
• 上一頁/下一頁：使用頁面導覽按鈕，依 internalId 順序逐步瀏覽文章。
• 相關文章：如果文章包含 relatedArticles，頁面會顯示一個相關文章區塊，讓您可以直接跳轉到這些文章。

疑難排解

• 沒有結果？ 嘗試使用較短的搜尋詞。在 iOS/Android 上，搜尋會比對標題/副標題/關鍵字（而非完整的內文）。
• 內容看起來很奇怪？ 文章是從 HTML 渲染的；某些格式取決於平台應用程式內的渲染器。
• 計數未更新？ 瀏覽/有用計數器透過 Firestore 更新，可能需要一些時間才能在所有地方反映。