在 飲水計數器 中記錄你的步驟，代表著保留一份僅存於瀏覽器中的私人紀錄，記下你決定計算的每一杯水，以及你親自選擇的每日整數目標。這個工具會將紀錄儲存在瀏覽器的本機儲存空間中，以單一鍵值作為索引，顯示當日的杯數總計與你選定的目標進行對照，並保留一份簡短的過往非零天數歷史清單。你記錄的每一杯都會成為本機計數中的一筆紀錄，而每次按下移除一杯，就是在同一個計數中往回退一步。文件化的過程中沒有任何自動或隱藏的機制——每一杯都必須由你手動新增，每一杯也都可以由你手動復原，而每次匯出都會根據你輸入的值，在你的瀏覽器中產生。因此你可以得到一份簡單、樸實的紀錄，能在頁面上閱讀、以試算表開啟，或儲存為單一張圖片，全程不需要建立帳號，也無須將任何資料傳送至遠端服務。
這裡的「記錄步驟」看起來是什麼樣子
「記錄我的步驟」這句話，依照工作流程的不同，可能代表好幾種意思。在紙本日誌中，它通常代表每喝完一杯水就畫一道計數記號。在試算表中，它可能代表在下一個空白列中輸入一個數字。在數位計數器中，它通常代表按下單一按鈕來標記一個完成的單位，並信任工具會持續累加計算。飲水計數器採用的是第三種模式：你記錄的每一個步驟，就是按下「新增一杯」；每一次的更正，就是按下「復原一杯」。這裡不會自動偵測你喝了多少，也不會根據體重、天氣或活動量進行估算，更不會從隱藏的感測器匯入資料。你記錄下來的步驟，正是你決定記錄的那些杯數，且完全依照你記錄的順序呈現。
計數器會針對每一杯記錄哪些內容
當你按下「新增一杯」時，計數器會在你的瀏覽器本機儲存空間中寫入一筆小型 JSON 紀錄。根據 WHATWG HTML Web Storage 規範，本機儲存是位於同一來源下、跨頁面載入仍可持續保存的具名鍵值區域。該紀錄會保存這杯水被記錄時的本地日曆日期、該日期的累計杯數，以及（若有設定目標時）該日期儲存第一杯水時你所設定的目標。本地日期是透過 Intl.DateTimeFormat API 所產生，而 ECMA-402 規範定義了這個用於地區感知日期格式的 API；這就是為什麼你在深夜新增的杯子仍會歸屬於當天日期，而不會被 UTC 的界線推移到隔天。
目標欄位的記錄時機，是該日期記錄下第一杯水的當下。如果你之後更改了設定——例如在星期四把目標從 6 杯提高到 8 杯——新數值只會套用至從那一刻起、首次儲存杯數的那些日期。已經儲存杯數的日子，則會保留當初首次寫入時所生效的目標。這個細節讓你的歷史紀錄保持誠實：較早日期的紀錄不會顯示為達成了當時尚未存在的目標。
在開始前先設定你的目標
開始記錄杯數時不一定要設定目標，但設定目標能讓每一筆儲存的杯數，與你自身的計畫產生明確的對照意義。請開啟飲水計數器頁面，在頁面頂部找到選填的標籤欄位與每日目標欄位。標籤欄位可以輸入一個簡短的字詞或片語，用來提醒自己這個計數器的用途——例如專案名稱、訓練週期、平日計畫或任何其他文字。目標欄位接受介於 1 到 9,999 杯之間的整數。這裡沒有預設值、沒有醫療建議，也沒有依體重計算的公式。你輸入的數字，就是頁面用來與你進行對照的數字。
如果你將目標欄位留空，計數器仍會記錄你新增的每一杯；畫面只會顯示「在設定目標前沒有個人進度目標可供顯示」。按下「新增一杯」是將目標鎖定進該日期紀錄的唯一動作。在你於特定日期首次按下之前，計數器並不會凍結任何偏好設定。這個細節對經常改變心意的人來說很重要：你可以跨日期嘗試不同的目標，而每一天的紀錄都會保留當天第一杯被記錄時你所設定的版本。
記錄與更正每一個步驟
逐日記錄你的杯數，是一個簡短的雙按鈕循環，以下步驟就是實際的工作流程。
- 決定要記錄一杯水——例如，喝完一杯水之後。
- 按下「新增一杯」。今日的總計會加一，並在畫面上更新相對於目標的百分比。
- 閱讀總計下方的簡明狀態訊息，確認當天的目標是否已達成。
- 若不小心按到「新增一杯」，請按下「復原一杯」，即可從今日總計中移除最近的一杯。這是單步復原，不會再往前退一步。
- 隨著一天的進行，持續新增或復原杯數。
由於計數器一次只前進一杯，因此單次復原幾乎能涵蓋所有錯誤。若在今日總計為零時按下復原，畫面不會有任何變更；若不小心復原，也可以再按一次「新增一杯」來還原數值。復原並非用來編輯當天較早之前的某一杯，而是用來修正你最後記錄的那一杯。
檢視你已記錄的歷史
一旦你在好幾天內都儲存了杯數，計數器會在當日面板下方顯示一份歷史清單。清單中的每一列代表一個本地日曆日期，該日期至少記錄過一杯水。該列會顯示日期、你為該日期儲存的總杯數，以及該日期所保留的目標——或是註明未設定目標。歷史清單是唯讀的，你無法從中編輯過去的日子。若發現過去某天的總計有誤，正確的做法是在今天新增或復原杯數，並讓明天的列記錄下新的狀態。
歷史清單是你想確認自己實際記錄了哪些內容時的首要查看之處。它不會彙整趨勢、計算平均值，也不會比較不同週次的數據；它是一份逐日逐杯的純粹清單。若需要跨日或跨週的分析，CSV 匯出會是更好的起點，因為它能把同樣的列放進試算表。若想更完整地了解歷史清單中每個欄位的意義，請參閱如何檢視你的飲水計數器結果。
在瀏覽器之外匯出你的記錄
計數器提供兩種匯出方式，讓你可以把記錄下來的步驟帶到其他地方。兩種方式皆完全在你的瀏覽器中執行，使用 canvas 與 Blob API；它們不會上傳任何資料，也不需要帳號。下表摘要說明每種匯出所包含的內容，以及最適合的使用情境。
| 匯出類型 | 產生的內容 | 欄位或版面 | 最適合 |
|---|---|---|---|
| CSV | 可用任何試算表開啟的逗號分隔文字檔 | Date, Cups, Daily target cups, Goal reached | 排序、篩選，以及新增自訂公式 |
| PNG | 在 canvas 上產生的單一 1080 by 1350 圖片 | 總計列加上近日的每日列 | 可直接貼進筆記或附加於訊息中的視覺化摘要 |
每個儲存過的非零日期會在 CSV 中以一列呈現，而「Goal reached」欄位會顯示當天的杯數是否已達到或超過目標。PNG 匯出並不包含你輸入的自訂標籤，也不會內嵌 URL，因此圖片所承載的個人脈絡比 CSV 來得少。如果保留自訂標籤對你很重要，請將標籤保存在計數器中，或另行記錄在其他文件，不要僅依賴這張圖片。
本地日期如何影響你的紀錄
由於每一杯水都會附加在你裝置所回報的本地日曆日期上，因此記錄會跟著你所在的日子走，而不是 UTC 的日子。在週二午夜前記錄的杯數，即使你繼續喝水直到世界時鐘進入週三，仍會歸屬於週二。當新的本地日期開始時，畫面上的總計會重設為零，而前一天則會以截至該時點所儲存的杯數，顯示於歷史清單中。實際上的影響不大，但值得了解：若你跨越時區旅行，歷史中的日期標籤會反映當時各時區所在的日期。這在每日杯數統計上幾乎不會造成問題，而這也是為什麼計數器不會假裝自己在追蹤飲水時間——它追蹤的是每一杯被記錄下來的本地日期。
計數器不會記錄的內容
有幾項限制是為了讓紀錄保持誠實。計數器不會計算建議的飲水量、不會依體重推估需求、不會套用預設的醫療目標、不會診斷水分狀態，也不會做出健康承諾。它不會將杯數轉換為毫升、不會從穿戴式裝置匯入資料、不會要求你填寫健康檔案，也不會與其他裝置同步。它不會在背景執行，也不會蒐集你使用方式的分析資料。你輸入的標籤、你選擇的目標、你記錄的杯數，全都只保存在你目前使用的瀏覽器中。
若你的瀏覽器封鎖了本機儲存，頁面仍能載入，也仍能新增杯數，但畫面上會顯示簡短的訊息，告知無法保留長久的歷史紀錄。在這種情況下，你記錄的步驟只會在該分頁保持開啟的期間存在。清除此網站的瀏覽器資料，或是在稍後關閉的私密視窗中使用本網站，都會移除已儲存的紀錄。如果你想保留文件，請在清除任何資料之前先匯出 CSV 或 PNG。
將工作流程整合起來
只要一個簡短例行程序，就能可靠地記錄你的杯數。以下步驟摘要了從開啟頁面到匯出私人檔案的完整循環。
- 開啟飲水計數器，若有需要可輸入一個簡短的標籤。
- 輸入一個符合自身計畫的每日整數目標（以杯為單位）。
- 每喝完一杯水就按下「新增一杯」；若不慎誤按則按下「復原一杯」。
- 查看百分比與畫面上的狀態，確認當天目標是否已達成。
- 開啟歷史清單，確認你已在多日之間儲存了哪些內容。
- 若想要試算表，請在週末匯出 CSV；若想要單一張圖片，則匯出 PNG。
以上就是完整的記錄循環：設定目標、記錄每一杯、修正偶爾的誤按、檢視清單，並在需要瀏覽器以外的檔案時匯出私人副本。計數器不會超出這六個動作，而正是這樣的克制讓記錄值得信賴。
若你正在比較選項，在動作計數器中記錄你的訓練步驟對此有詳細說明。