如何確保正確使用飲水量計數器？

若要正確使用飲水計數器，請只記錄你親自計算的杯子、設定你自己的選填整數每日目標、在意外點擊後復原最新一筆記錄，並在匯出前於每日歷史中確認已儲存的日期、杯子總數與目標。飲水計數器是個人杯子 tally：它不會指示攝取量、計算毫升、匯入穿戴裝置資料或評估水分攝取狀況。它的用途是讓你的記錄保持一致，並顯示你自選目標的達成進度。你可以先加上一個簡短標籤，方便辨識這份計數紀錄；輸入 1 到 9,999 杯的目標，讓頁面顯示百分比以及是否已達成目標；每決定記錄一杯，就按一次「Add a cup」。如果將目標留空，仍然可以計算杯子，但頁面會顯示沒有可顯示的個人進度目標。盡可能在當天第一杯之前設定目標，因為第一杯儲存時會保留該日期的目標，供其歷史與 CSV 使用。在一天結束時，請將顯示的總數與自己的計數相比、確認本機日曆日期；若想在瀏覽器之外保留檔案，請匯出一份副本。

正確使用是什麼意思

正確使用從區分「你記錄的數量」與「你用來比較的目標」開始。計數器只知道你按下了杯子按鈕，並未內建容器量測、健康資料、穿戴裝置資料來源或建議攝取量。以下數值說明介面中的意義，以免將進度百分比誤認為醫療指引。

元素	計數器的運作方式	正確使用檢查
計數單位	按一次「Add a cup」會增加一杯。	每個單位只計算一次，並採用一致的規則。
每日目標	選填；使用時為 1 到 9,999 杯的整數。	選擇自己的計畫，不要將其視為指示的攝取量。
進度顯示	顯示確切的杯子數量，以及相對於所選目標的單純百分比。	將其解讀為相對於個人目標的進度。
目標狀態	顯示是否已達成所選目標。	不要將狀態解讀為水分攝取評估。
無目標	杯子記錄會繼續，但介面會顯示沒有可顯示的個人進度目標。	如果只想計算杯數，不設定目標也是有效的。
日期	每杯已儲存的紀錄都歸屬於裝置所回報的本機日曆日期。	確認日期，尤其是接近午夜時。

設定並執行每日計數

每天使用以下程序，讓計數及其脈絡保持一致：

1. 在之後要返回查看本機歷史的瀏覽器中開啟計數器。記錄會與此網站及裝置關聯，而不是與帳戶關聯。
2. 如果希望更容易辨識這份計數紀錄，可以輸入簡短標籤。標籤是選填的，且不會改變杯子單位。
3. 選擇 1 到 9,999 杯的整數每日目標；如果只想計算杯數，則可留空。打算使用目標時，在當天第一杯之前設定，可讓該日期擁有明確保留的比較基準。
4. 每當你決定記錄一杯時，按一次 Add a cup。畫面接著會顯示今天的杯子總數；若已設定目標，也會顯示確切的杯子數量、百分比，以及是否已達成目標。
5. 如果最近一次按壓是意外造成的，請按 Undo a cup，將最新一杯從總數中移除。繼續記錄更多杯子之前，請重新檢查計數。
6. 開啟每日歷史，確認已儲存的日期、杯子數量，以及目標（若有）都與你原本打算記錄的內容相符。
7. 只有在想要瀏覽器之外的檔案時，才匯出 PNG 或 CSV。CSV 會為每個已儲存且非零的日子提供一列；PNG 則提供總數與近期各日的視覺摘要。

讓每杯的意義保持一致

首先，請決定個人計數規則中的一杯代表什麼。計數器以杯子按壓次數運作，不會將其換算成毫升，因此無法區分容器大小。選擇一個份量單位，並在整天一致套用相同規則。例如，如果你的規則是計算平常容器裝滿的一杯，請記錄一次，而不要將個別啜飲分別算成杯子，也不要期待總數代表經量測的液體體積。

其次，請避免重複記錄。決定記錄某杯時只計算一次；如果是最近一次按壓出錯，請使用「Undo a cup」。簡短標籤有助於辨識你的個人計數紀錄，但無法讓工具推論你攝取了什麼。計數器也不會將記錄與穿戴裝置、健康資料或背景服務進行核對。

確認日期與保留的目標

每日歷史是已儲存內容的驗證記錄。它會列出每個日期及其杯子數量，以及選用目標時為該日保留的目標。裝置進入新的本機日曆日時，今天的總數會從零開始，而先前非零的日子仍會保留在歷史清單中。深夜才儲存的杯子仍會附屬於該本機日期，不會因 UTC 邊界而被移到其他日期。

此實作使用 Intl.DateTimeFormat 來識別裝置本機日曆日。目標處理遵循類似的保留規則：儲存某個日期的第一杯時，會記住該日期的目標。之後變更偏好不會改寫歷史或 CSV 中較早日期的意義，而有儲存杯子的日子會保留當天用於計算進度的目標。如需詳細瞭解已儲存的資料列，請參閱 如何查看飲水計數器結果。

修正最新記錄

如果不小心記錄了一杯，請先按 Undo a cup 再繼續。它會修正總數中最近的一杯，之後你便能檢查修訂後的計數、百分比與目標狀態。由於這是手動杯子 tally，若出現不一致，應對照你的計數規則、所選目標與已儲存日期進行檢查，而不是將其解釋為隱藏的水分攝取計算。

如果檢查最新記錄後，儲存的結果看起來仍不一致，請遵循 使用飲水計數器後修正錯誤結果中的集中疑難排解程序。

選擇符合檢查需求的匯出格式

格式	包含的內容	最佳用途
CSV	Date、Cups、Daily target cups 和 Goal reached 欄位，每個已儲存且非零的日子各一列。	在試算表中檢視每個已儲存的日子，或逐一檢查欄位中的記錄目標與達成狀態。
PNG	一張 1080 by 1350 的圖片，包含總數與近期各日的資料列。不包含 URL 或自訂標籤。	在不需要標籤及完整的逐日詳細資料時，建立精簡的視覺摘要。

兩種格式都是透過瀏覽器的 Canvas 與 Blob API 在本機產生。計數器及其匯出控制項不會關聯任何帳戶、上傳、伺服器端檔案轉換或隱藏的分析要求。CSV 是選項較詳細的格式，因為它包含每個已儲存且非零的日子；PNG 則旨在提供總數與近期資料列的視覺快照。

確認隱私與持久存取

你的標籤、目標與杯子記錄會依照 WHATWG Web Storage 所描述的瀏覽器儲存模型，儲存在目前裝置的本機瀏覽器儲存空間中。它們不會同步至手機、電腦或帳戶，計數器也不會在背景收集任何資料。清除此網站的瀏覽器資料會移除儲存的記錄，因此若想保留獨立檔案，請先匯出一份副本。

如果無法使用本機儲存空間，目前頁面仍可使用，並會顯示無法保留持久歷史。這個訊息很重要：不要僅因某個日子出現在目前頁面上，就假設之後仍能取得該日資料。

執行最終準確性檢查

• 確認今天的總數等於你刻意選擇要記錄的杯子數量。
• 檢查每個計入的杯子是否都只按了一次「Add a cup」，以及最近一次意外按壓時是否使用了「Undo a cup」。
• 確認任何目標都來自你自己的計畫，並將其百分比與達成狀態視為進度指標，而不是健康結果。
• 檢查正確裝置本機日期的歷史資料列，以及該已儲存日所保留的目標。
• 需要詳細驗證時選擇 CSV，需要視覺摘要時選擇 PNG，並記住 PNG 不包含自訂標籤。
• 如果需要在這個瀏覽器之外使用記錄，請匯出，因為儲存的歷史不會自動同步。

遵循這些檢查，可讓計數器在記錄使用者輸入的杯子數量時保持透明且實用，同時避免對任何人應攝取多少水分作出缺乏依據的說法。