記錄你使用 Auto Counter 的步驟,意味著把一場即時、隨時間推進的計數工作,轉化為一份他人——或未來的你——能夠精確重複的書面紀錄。這個工具會在頁面保持開啟的狀態下,每隔一個固定時間間隔計數一次,然後把每個已完成的間隔寫入一份本機的每日歷史紀錄,並依裝置的行事曆日期分組,因此計數步驟與證據資料已經屬於同一個地方。一份乾淨的程序會依序記錄五個固定決策:一個簡短的標籤,用以說明正在計數的內容;一個介於 1 到 3,600 之間的整數秒間隔;開始的時間點;用於對齊已完成間隔的暫停規則;以及匯出格式(用於視覺化摘要的 PNG,或用於試算表的 CSV)。把這些項目寫下來,就能把一次性的工作階段,轉化為一份可重複的工作流程,讓你可以交給團隊成員、存進你的操作手冊,或貼到專案筆記檔案中。這份程序之所以設計得簡短——通常只有一頁——是因為多出來的每一段文字,都是下一位操作員可能誤讀規則、產生與原始意圖不再相符的紀錄的地方。

how do i document the steps i use to use auto counter
記錄你使用 Auto Counter 的步驟

「記錄你的 Auto Counter 步驟」實際上指的是什麼

一份已記錄下來的 Auto Counter 程序並不是計數器本身;它是環繞在計數器周圍、以人可閱讀方式呈現的一組選擇,目的是讓一場工作階段即使沒有你在旁監督也能重播。大多數計數任務之所以無法重複,是因為操作員把間隔記在腦中、用感覺為這次執行命名、又憑直覺決定是否暫停。這些資訊都撐不過一次交班、一天病假,或距離下次稽核長達六個月的空窗。把步驟寫下來的目的,在於把每一個原本只存在於某人記憶中的選擇外化出來,並把每個選擇連結到它所產生的產出物——一個標籤、一個間隔、一個每日總和,以及一份匯出檔案。

這個頁面刻意設計得很精簡。Auto Counter 只會在瀏覽器分頁保持開啟時運作,會在計時器回呼中使用 Date.now,並把一份小型 JSON 紀錄儲存在 counter:auto-counter 這個鍵值之下。這意味著相關文件也應該讓這條界線一目了然:一份已記錄的程序必須說明工作階段何時開始、何時暫停、當分頁被切到背景時會發生什麼,以及當頁面關閉時該怎麼處理。一份隱藏這些規則的操作手冊並不是程序,而是一張願望清單。

需要寫下來的五個決策

每一場可重複的 Auto Counter 工作階段,都建立於五個決策之上。請在第一次按下 Start 之前,把每一項都寫下來;因為一旦計數器開始運作,間隔控制項就會被鎖定,之後的任何更改都無法重新詮釋已經流逝的時間。

決策需要記錄的內容它會出現在哪裡
標籤一個用來識別此次執行的簡短名稱儲存在本機的紀錄旁;絕不會嵌入匯出檔案中
間隔介於 1 到 3,600 之間的整數秒數驅動每一個已完成間隔的計算
開始時間點按下 Start 時的日期與裝置本地時間作為瀏覽器中經過時間計算的錨點
暫停規則何時對齊並停止加入任何已完成的完整間隔,然後停止
匯出格式PNG 視覺化摘要或 CSV 試算表檔案在瀏覽器中透過 Blob 與 canvas API 產生

一個常見的錯誤,是因為「到時候我就知道該停了」而略過暫停規則。一條已記錄下來的暫停規則,會把模糊的判斷變成明確的觸發條件——水壺煮沸時、最後一個盤子離開產線時、觀察時段結束時——這樣一來,任何依照程序操作的人都會在相同的邏輯時點按下同一個 Pause。

逐步記錄一場 Auto Counter 工作階段

每次都依照這個固定順序進行。遵循相同的順序,正是讓最終紀錄能夠在不同工作階段之間相互比較的原因。

  1. 開啟 Auto Counter 頁面,並輸入一個簡短的標籤,說明你正在計數的內容——例如「B 站循環數」或「番茄鐘區塊」。
  2. 在秒數欄位中輸入一個整數間隔,選擇一個介於 1 到 3,600 之間、符合你作業節奏的值。
  3. 在這次執行應該開始的瞬間按下 Start,並保持分頁開啟;頁面會依據經過時間,每完成一個間隔就累加一次計數。
  4. 工作時請將分頁維持在前景,因為瀏覽器的計時器並不等於節拍器,被隱藏或忙碌的分頁可能延遲下一次回呼。
  5. 在文件中記載的暫停觸發條件出現時按下 Pause;工具會對齊所有已經完成的完整間隔,並停止進一步的自動變更。
  6. 開啟本機每日歷史紀錄區段,確認日期與總和與你所觀察到的結果一致,並且只有在新的工作階段界線明確時才重新開始。
  7. 匯出 PNG 作為視覺化紀錄,或匯出 CSV 作為試算表檔案,並將匯出檔案存放在書面程序旁邊,讓兩者保持成對。

如果某個延遲的回呼在分頁長時間處於非作用狀態後終於執行,Auto Counter 會直接停止,而不會重播過去的滴答;因此文件中記載的程序也應該說明在這種情況下該怎麼處理——通常是在執行紀錄中註記這段空檔,並重新開始一場新的工作階段。

把每日歷史紀錄與匯出檔案當作紀錄本身使用

Auto Counter 在簡單計數器中是少見的,因為它會產生兩份可以附加在程序中的產出物:頁面內的每日歷史檢視,以及一份可下載的檔案。兩者都是在用戶端產生,這意味著計數與你磁碟上的檔案之間,不存在上傳佇列、帳號或任何外部 API。歷史紀錄會依裝置的本地行事曆日期分組,因此跨越午夜的回呼會把其已完成的間隔歸入正確的那一天,而不會強制使用單一的 UTC 日期。這個細節值得寫進程序中,讓一週後閱讀檔案的審核者能夠理解日期的界線。

CSV 匯出檔案是一份包含兩欄(Date 與 Automatic increments)的檔案,簡單到可以直接放進試算表、附加到每月工作簿,或與上個月的執行結果進行比對。PNG 匯出檔案是一張 1080 × 1350 的分享圖片,包含總計與近期逐日紀錄;它刻意不包含任何網址或自訂計數器標籤,這對於一份文件化的紀錄來說是一項有用的特性,因為視覺化摘要不會洩漏內部註記。如果你的程序需要讓標籤出現在產出物中,請把它寫進你替匯出檔案命名的檔案名稱中,而不是要求工具將它嵌入。

若要更深入地驗證已完成執行中的數字,請把程序與一份簡短的結果檢查逐步指南搭配使用,讓日後閱讀檔案的人能在信任匯出檔案之前,先確認每日總和與他們親手計算的結果一致。

撰寫讓新使用者也能遵循的程序

一份只有原撰寫者自己才讀得懂的文件,並不是一份文件;那只是一段被寫下來的個人習慣。為了讓從未開啟過這個工具的人也能使用你的操作手冊,請把每個步驟都寫成讀者能驗證的指示。「看著頁面」不是一個步驟;而「在水壺放上爐子加熱時,讓 Auto Counter 分頁維持在前景」才是。請把每一個代名詞替換為它所指的名詞、每一個時間參考替換為具體的鐘點時間、每一個判斷(「一段時間」、「不久」、「大部分」)替換為數字或可見的觸發條件。

一份精簡的書面範本看起來像這樣:開啟 Auto Counter 頁面,將標籤設為 [執行名稱],將間隔設為 [秒數] 秒,在 [鐘點時間] 按下 Start,將分頁維持開啟直到 [停止觸發條件] 出現,按下 Pause,然後以 [檔案名稱] 匯出 CSV。方括號中的欄位,是新操作員唯一需要做決策的地方,而每一個方括號也都是原作者在程序針對已知週期性任務時可以預先填入的位置。WHATWG HTML Timers 規格說明了瀏覽器如何節流背景計時器,這也是為什麼已記錄的程序必須明確指出「保持分頁開啟」,而不能預設它會持續運作。

請把程序保存在與匯出檔案相同的資料夾中。當說明放在 wiki,而證據檔案放在 Downloads,操作手冊與執行結果之間的連結就會斷開;把它們放在一起,能讓下一次工作階段只需複製貼上即可進行。

PNG、CSV 與書面紀錄各自適合的位置

並非每一場已記錄的 Auto Counter 工作階段都需要同一種產出物。選擇取決於誰會閱讀這份紀錄,以及他們會拿它來做什麼。

產出物最適合的用途需要在程序中註記的限制
PNG 圖片(1080 × 1350)視覺化摘要、簡報投影片、在聊天串中快速瀏覽不會嵌入網址或自訂標籤,因此請以外部方式註記
CSV 檔案(Date、Automatic increments)試算表樞紐分析、每月彙總、跨月份比較只會顯示有儲存的日期;零的日子會被省略,而不會補上零
操作手冊中的書面紀錄捕捉工具無法記錄的決策——為什麼選擇這個間隔、什麼算作暫停觸發條件無法證明計數本身;請與其中一種匯出檔案搭配使用

對大多數團隊而言,CSV 是正式的紀錄,因為它可以被加總、篩選與稽核;而 PNG 是友善的摘要,書面紀錄則是人的脈絡。記錄你使用 Auto Counter 的步驟,真正的意義在於把這三種產出物繫結到一組固定的決策順序上,讓下一個人無須再詢問你,就能同時產出這三項成果。

一個簡短的操作範例可以釐清程序應該描述的計算。假設間隔設為 45 秒,且執行持續 7 分鐘,則經過時間為 7 × 60 = 420 秒。已完成的間隔數為 floor(420 / 45) = 9,餘數為 420 − (9 × 45) = 420 − 405 = 15 秒。程序應該記錄此次執行有 9 次增量,並註記有 15 秒未完成的時間被帶入下一次回呼,而不是悄悄地被捨棄——這正是 Auto Counter 在瀏覽器延遲滴答時避免少計的方式。

若想更深入了解,請參閱《你該使用每日習慣計數器嗎?一份決策指南》。