第一次用這個系統？看完這幾點就能開始記錄了，其他功能之後用到再查下面的詳細章節。
想深入了解特定功能？下面的目錄依主題分類，點連結直接跳過去看。
1. 開啟系統網址（管理員會提供）。
2. 輸入你的「代號」與「密碼」（管理員事先建立好的帳號，不能自行註冊）。
3. 忘記密碼請找管理員重建帳號；要「修改」密碼（記得舊密碼、只是想換一組新的），登入後點左側「修改密碼」自行處理。
4. 閒置 30 分鐘沒有任何操作會自動登出（安全性考量），內容會先自動存檔才登出。
5. 登入後，如果今天已經有日誌，會直接開啟；如果今天還沒有日誌，一般成員／管理員會跳出提示詢問「要不要現在新增」，選擇不要的話會停留在空白畫面，可以從側邊欄選擇要瀏覽的過去日期（不會每次登入就強制生出一篇空白日誌，畢竟不是每天都需要記錄，有時候只是想檢視過去內容）。操作員／檢視員因為本來就不能新增，只會看到「今天還沒有日誌」的提示，不會跳出詢問。
6. 側邊欄「🌓 自動」按鈕可以切換深色/淺色模式，點一下依序循環：自動（跟隨系統設定）→ 淺色 → 深色 → 自動。選擇的狀態會記在這個瀏覽器裡，下次打開沿用；換一台電腦或手機是各自獨立的設定，不會互相同步。列印、PDF、PNG匯出、預覽畫面，不管畫面選了深色還是淺色，一律維持淺色，不受個人畫面偏好影響。
系統分四種角色，登入後會顯示在左側名字旁邊：
系統用「大修」把整段大修期間的里程碑日期（停爐／交出／預計開爐／PSSR）統一管理起來，避免每天各自填、容易漏改或不一致。
側邊欄「+ 新增日誌」上方有一列「大修」，點「管理 ▾」可以：
打開任何一篇日誌，天數計算列下方會有「所屬大修」選單，這是唯一決定這篇日誌歸屬哪一次大修的地方。可以隨時切換，切換後會立即存檔，其他人也會看到更新後的結果。
新增日誌時，系統會自動帶入「最近建立的大修」作為預設歸屬與里程碑日期，不用每次手動選。之後若在日誌裡改了里程碑日期（跟所屬大修的設定不同），畫面上會出現紅色「✎ 已個別調整」標記提醒你這天被個別調整過。
側邊欄點「📊 總覽」開啟，一次看到五種摘要資訊，不用點進任何一篇日誌：
適合需要「正式列管到結案」的問題或工程進度，跟日常用的「追蹤編號＋搜尋」是互補關係——搜尋是臨時查資料，議題追蹤板則是持續掌握「這件事現在的狀態、還沒結束」。
側邊欄點「📋 議題追蹤」開啟。運作原理：議題本身只是一個「追蹤編號」的容器，不用另外去每篇日誌裡「連結」——只要日誌裡的項目填了跟議題相同的追蹤編號（🏷️欄位），系統就會自動把它抓進這個議題的時間軸，依日期排序呈現。
左側清單顯示所有日期的日誌，點選任一筆可切換查看/編輯；可用清單上方的搜尋框快速找日誌。
「+ 新增日誌」跳出彈窗讓你選擇日期後建立；「📅 回到今天」單純跳到今天的日誌。日期選擇器只能瀏覽已存在的日誌，選到還沒建立的日期會先跳提示問你要不要新增，不會悄悄產生空白日誌。
每篇日誌上方可切換「格式一」「格式二」，兩種格式的內容各自獨立保存，同一天可以視需要切換使用。
側邊欄每篇日誌右上角有 🗑 刪除按鈕（僅管理員可見），點下去會跳出確認視窗，需二次確認才會真的刪除。
欄位：時間、班別、工作紀要、備註。整篇分為三段：工作紀要（依日期/班別分組）、預計工作項目、今日檢討及注意事項。表格上方會顯示標題、日期，以及跟格式二一樣的大修天數計算列（大修開始／交承商／PSSR／開爐，依實際時間先後順序排列，兩排兩欄呈現），依這篇日誌本身的日期計算，會一併出現在畫面、預覽、以及匯出的 DOCX/XLSX/PDF/PNG 檔案裡。天數會依「還沒到／當天／已過」自動切換文字（例如「還有3天交承商」→「交承商第1天」→「交承商第4天」），不會出現不合理的負數。
830 會自動變成 08:30）；系統會依照該區塊的班別（一班00:00-08:00／二班08:00-16:00／三班16:00-24:00，前後各容許1小時緩衝）自動判斷，如果填的時刻明顯不在班別範圍內，欄位會變成紅色提醒，但不會強制擋住輸入。按鈕會變成「✕ 時刻」，點一下即可整個清空上方會自動計算「大修第X天」「交承商第Y天」「離PSSR還有Z天」「還有N天開爐」，只需在「設定里程碑日期」設定一次停爐日、交出日、預計開爐日、PSSR日期，之後每天只要選報告日期即可，天數自動算好。
格式一「今日檢討及注意事項」、格式二「每日檢討及注意事項」的區塊標題旁邊，都有一個「納入匯出」勾選框（僅畫面編輯時看得到，不會出現在匯出結果裡）。這個設定只影響匯出結果，不影響畫面編輯——不管有沒有勾選，這個區塊在編輯畫面永遠正常顯示、可以照樣編輯。
格式一每個項目、格式二每個項目清單項目，都有一個選填的「🏷️ 追蹤編號」欄位，呈現方式類似筆記軟體常見的標籤：填好的編號會變成一顆顆膠囊狀標籤，點標籤旁的✕可以直接移除。
輸入方式：在輸入框打字，打完按 Enter 或逗號（,）就會變成一顆標籤，可以繼續打下一個。輸入時下方會跳出「之前用過的編號」建議清單，點一下就能直接套用，不用每次手動打完整編號。
一筆記錄可以同時歸屬多個追蹤編號（例如同時涉及設備維修跟外部協調兩件事），填多顆標籤即可；之後可以直接用搜尋框搜任一組編號，快速找出過去幾天所有相關記錄，方便追蹤一個問題橫跨多天的處理過程。
點「⤴ 從昨天延續」，系統會列出前一天同格式的所有項目，勾選還沒完成、想接續到今天的項目，選擇要加入今天的哪個區塊，確認後會複製成新項目加進今天，並自動加註「（延續自 YYYY-MM-DD）」方便追溯，紅字/★涉外標記也會一併保留。複製過來的是獨立新項目，可自由編輯，不會綁定原項目。
點「匯入工作許可證 CSV」，選擇檔案後，系統會抓取「承攬商、內容、危險等級、案號、工作許可證號、工作日期」等欄位，整批放進目前這篇日誌的「待分類項目」：格式一放在最下方「今日工作許可證」區塊的待分類區，按「加入今日工作許可證」；格式二放在 A/B 等分組的待分類區，再手動選分組（或直接捨棄）。不會再強制切換格式。
匯入規則（兩種格式相同）：①同一天的日誌內，以「工作許可證號」判斷重複，已在待分類或已加入追蹤表／今日工作許可證的會自動跳過（沒有許可證號時，以承攬商＋內容＋案號判斷）；②若 CSV 的「工作日期」和日誌日期不同，會跳出視窗讓你選「取消匯入／全部匯入／只匯入符合日期的」；③承攬商空白時，用「施工單位」名稱補上（去掉代碼與「桃園煉油廠」字樣）；④保持 CSV 原順序；⑤匯入完成會顯示「新增、跳過重複、日期不符未匯入」各幾筆。案號會寫進備註（「案號 XXX」）。
格式一的「今日工作許可證」區塊：位於「今日檢討及注意事項」之後，欄位為項次／危險等級／承攬商／工作項目／進度／備註／附圖（每列 1 張圖），項次自動編號（01、02…），操作方式與格式二追蹤表相同。區塊沒有內容時，預覽與匯出都不會出現。
格式一每個工作項目、格式二每個項目，都能點「+ 附圖」附加照片，每個項目最多4張，用2×2排列顯示（3張時右下角留空）。手機上通常會直接跳出「拍照」選項。選圖後系統會自動壓縮（縮小到最長邊約960px、轉為JPEG），並顯示壓縮前後的檔案大小提示。每張縮圖旁邊有「✕」可以單獨移除那一張，還有「◀▶」可以調整順序（例如「作業前、作業中、作業後」這種需要照順序排列的情況）。追蹤表（承攬商/危險等級那張表）維持每列限附一張照片，不支援多張。
格式一、格式二的工作項目文字框旁邊，如果瀏覽器支援，會出現一顆麥克風圖示按鈕。點一下開始說話，再點一下（或停頓一下）結束，辨識出來的文字會直接插入游標所在位置。第一次使用會跳出「允許使用麥克風」的授權請求，需要點允許。
點「💬 常用片語」，先點一下要輸入的文字框，再點片語清單裡的句子，會直接插入到游標所在位置。片語清單是團隊共用的，任何一般成員以上都能新增/刪除，即時同步給所有人。
一次要加很多句時，可以用「📋 批次匯入」——把整批片語貼進文字框（一行一句，例如從Excel或備忘錄複製過來），按「分析內容」會先顯示摘要（總行數、空白行/重複片語各略過幾行、實際會新增幾筆），確認沒問題再按「確定新增」才會真的寫入；跟現有清單重複、或貼上內容裡自己重複的句子，都會自動略過不重複新增。
側邊欄搜尋框可以搜日期、標題，或任何內容文字（含工作項目、備註、承攬商、追蹤編號等），即時篩選左側日誌清單，不用一天一天翻找。
搜尋框下方有「日期區間」篩選（從～到），可單獨使用、也可以跟關鍵字搜尋一起用（例如「搜某個追蹤編號 + 限定在某段時間內」）。點旁邊的「✕」可清除區間篩選。
再下面「📷 只顯示有附圖的日誌」勾選後，只留下這一天至少有一個項目附了照片的日誌，可以跟關鍵字、日期區間一起疊加使用；這個篩選是「日」的顆粒度（這一天有沒有附圖），不會標示出是哪一個項目有圖，找到日期後還是要自己點進去找。
管理員登入後，左上角會多一顆「👥 誰在線上」按鈕，點下去可以看到目前整個團隊誰在線上（最近2分鐘內有操作視為線上），以及其他人最近登入的時間。這跟「正在編輯」提示是不同的機制——「正在編輯」只顯示同一篇日誌裡的人，「誰在線上」則是不限於當下這篇日誌，涵蓋整個系統。
上方「🔒 檢視模式 / ✏️ 編輯模式」按鈕可切換畫面是否可編輯。非當天的日誌預設是檢視模式（唯讀，避免誤點修改到舊紀錄），今天的日誌預設可編輯，隨時可手動切換。操作員、檢視員帳號永遠鎖定檢視模式。
點「👁 預覽（表格式）」可以看到整篇日誌的唯讀表格式版面，跟正式排版、匯出的PDF/圖片一致，適合手機用卡片式編輯後確認整體格式。
| 格式 | 用途 | 可再匯入嗎？ |
|---|---|---|
| JSON | 完整備份，換裝置/救回資料 | 可以，完全還原（含圖片） |
| 列印 / PDF | 分享、留存、列印紙本 | 不行（僅供閱讀） |
| 格式一 DOCX / XLSX | 對外分享的Word/Excel檔 | DOCX可以匯入，含紅字/圖片；XLSX僅供閱讀與列印（含紅字顏色與圖片，不支援匯入） |
| 格式二 DOCX / XLSX | 對外分享的Word/Excel檔 | 可以匯入（XLSX不含圖片）；XLSX含紅字顏色、條列項目與追蹤表的圖片 |
| 議題清單 XLSX | 本次大修全部議題（含時間軸明細） | 不行（僅供閱讀與篩選） |
| PNG | 圖檔，方便在通訊軟體上直接傳送分享，不論裝置永遠是表格式排版 | 不行（僅供閱讀） |
點「📦 批次匯出」，選擇開始/結束日期，把範圍內每一天的日誌依序合併輸出：
彈窗裡有一個「是否包含每日/今日檢討及注意事項」的勾選框，PDF、DOCX、XLSX三種批次匯出都會依這個統一設定，不受各天各自原本勾選的狀態影響（JSON備份不受此設定影響，永遠完整）。
另外，在「大修管理」裡點選某次大修後，也能直接按「📦 匯出這次大修的所有日誌」，不用自己找日期範圍，會自動抓取所有標記歸屬該次大修的日誌一起打包。
點「🕓 編輯歷史」，左側列出這篇日誌過去的快照，點一筆可預覽當時內容，確認後可按「還原到這個版本」整篇換回該時間點的狀態。
每個版本旁邊有「與目前比較」按鈕，可快速看該版本跟目前畫面差在哪；也可以勾選任兩個版本比較。差異會用類似 Git 的方式顯示：綠色新增、紅色刪除線標示被移除的內容。
同一天的日誌大家可以一起編輯，內容會定期自動同步，畫面上方會顯示「● XXX 正在編輯」的徽章提示（有人新加入編輯時，右上角還會跳出短暫的提示卡片）。系統打字仍會自動存檔（避免斷網/當機遺失工作），不用擔心忘記存。
工具列新增「💾 存檔」按鈕，可以隨時手動點一下確認已經存好。如果你的分頁曾經切到背景很久、或網路曾經中斷過（系統會自動偵測），這時候點「存檔」會先跟資料庫核對一次最新內容，如果對方在這段期間也存過檔、而且內容真的有差異，會跳出比較畫面，列出雙方差異，讓你選擇「採用對方的版本」或「用我的版本覆蓋」。
斷線時仍可繼續瀏覽已載入過的內容、繼續編輯，畫面上方會出現紅色「📡 離線中」提示，內容會先存在本機，恢復連線後自動同步上傳。部分瀏覽器（如無痕模式）不支援此機制，會自動改用一般連線模式，不影響基本功能。
Q：忘記密碼怎麼辦？
A：找管理員重建帳號並設定新密碼；只是想主動更換密碼，自己在系統內「修改密碼」即可。
Q：畫面顯示「儲存中」很久沒變成「已同步」？
A：請確認網路連線正常；若持續無法儲存，重新整理頁面再試一次。
Q：可以離線使用嗎？
A：可以短暫離線繼續編輯，但仍需要偶爾連線才能跟團隊同步，詳見「離線使用」章節。
Q：誤刪了項目怎麼辦？
A：可透過「編輯歷史」還原到刪除之前的版本。
Q：為什麼我看不到新增/刪除/匯入按鈕？
A：你的帳號角色是「操作員」或「檢視員」，這些功能對你隱藏；如果需要編輯權限，請找管理員調整角色。
| 版本 | 日期 | 修訂內容 |
|---|---|---|
| v1.22 | 2026-10-17 | 【新功能】總覽的記錄狀況熱力圖新增「最近100天」，並把原本的「展開看過去60天」單一按鈕改成「30天／60天／100天」三段切換（目前選中的會反白，預設仍是30天）。資料來自已載入的日誌，不增加資料庫查詢。匯出PDF會依目前選的天數截圖。部署：index.html 與 style.css 有異動（utils.js、docx-export.js 未動），請四個程式檔一起放入部署資料夾 |
| v1.21.1 | 2026-10-16 | 【調整】格式選單的名稱「格式一（大修前準備）」改為「格式一（大修前/開爐前準備）」，使用說明裡的對應文字同步修改。只改文字，功能與資料都不受影響。部署：只有 index.html 有異動，請維持四個程式檔一起放入部署資料夾 |
| v1.21 | 2026-10-13 | 【功能升級】批次 JSON 備份納入常用片語。批次匯出（日期區間、大修一鍵匯出）的 zip 內新增 phrases.json（與本機版 zip 格式相同），manifest 新增 phraseCount；還原時摘要顯示片語句數與系統內沒有的句數，可選「合併（只新增系統內沒有的，預設）／覆蓋（整份清單以備份為準）／不還原」。舊版備份（沒有 phrases.json）照常還原。部署：只有 index.html 有異動，請維持四個程式檔一起放入部署資料夾 |
| v1.20 | 2026-10-12 | 【新功能】格式一新增「今日工作許可證」區塊，工作許可證 CSV 匯入改為兩種格式共用的新規則。①格式一最下方（今日檢討及注意事項之後）新增「今日工作許可證」表，欄位與格式二追蹤表相同（項次／危險等級／承攬商／工作項目／進度／備註／附圖），項次自動編號；案號寫入備註。②CSV 先進入目前日誌的「待分類項目」（格式一→今日工作許可證待分類區；格式二→A/B 待分類區），不再強制切換成格式二。③重複判斷：同一天日誌內以工作許可證號去重（含已分類的列）；④CSV 工作日期與日誌日期不符時跳出選擇視窗（取消／全部匯入／只匯入符合日期的）；⑤承攬商空白以施工單位名稱補上；⑥匯入結果顯示新增／跳過／日期不符筆數。許可證號、案號另存為隱藏欄位，不顯示也不匯出。匯出：預覽、列印、PNG（可併入最後一張圖）、XLSX、DOCX 都包含此區塊，無內容則不出現；批次匯出亦同。已知限制：格式一 XLSX 在有許可證時，跨頁不重複表頭列。部署：index.html、style.css、docx-export.js 三個有異動（utils.js 未動），請四個程式檔一起放入部署資料夾 |
| v1.19 | 2026-10-12 | 【功能升級】批次 JSON 備份納入議題清單，並加強還原流程（為日後本機版開 zip 看到議題做準備）。備份：批次匯出視窗新增勾選「JSON備份是否一併包含議題清單」（預設勾選，議題不分日期，一律備份全部）；大修一鍵匯出則包含該大修的議題；zip 內新增 issues/<議題ID>.json，manifest 新增 backupFormat、issueCount；議題所屬的大修也會一併打包。還原：選檔後先讀取備份並與系統內現有資料比對，顯示摘要（備份內容與已存在筆數），已存在的日誌、議題各自選「跳過（預設，保留系統現有的）」或「覆蓋（以備份為準）」，可取消；議題以文件ID判斷是否已存在，建立時間／結案時間原樣還原，所屬大修依名稱對應（對應不到則為未歸屬）。向下相容：沒有議題的舊版備份照常還原。注意：先前版本的還原是「日誌一律覆蓋」，現在預設改為跳過。部署：只有 index.html 有異動，請維持四個程式檔一起放入部署資料夾 |
| v1.18 | 2026-10-11 | 【功能升級】XLSX 匯出全面美化（格式一、格式二、議題清單），視覺語言沿用先前定案的DOCX設計：白底、深墨色文字、紅色強調、灰階表頭、細格線、斑馬紋、微軟正黑體，並設定A4直式（議題清單為橫式）、寬度符合頁面、每頁重複表頭、頁首（名稱＋日期）與頁尾（頁碼）。格式二：版面重新設計——去掉間隔欄（備註改在G欄）、A欄縮窄，里程碑日期從左側欄位改成標題下方獨立一行（10pt深色），天數紅字在下一列；轄區工作、各分組、明日預計各自加外框，條列項目合併C:G並依字數估算列高，不會被截斷；條列項目的附圖（原本格式二XLSX完全不匯出）改成每項最多4張、橫向一列排在文字下方；追蹤表單張圖片放在H欄。格式一：新增里程碑日期一行，附圖改成每項最多4張橫向一列並用精確定位（舊版小數定位誤差大，是圖片重疊的原因），文字列依字數估算列高。議題清單：兩張工作表都套用新外觀，加入篩選與凍結首列。所有XLSX日期統一為YYYY/MM/DD。匯入調整：格式二XLSX匯入改成依追蹤表表頭「備註」找欄位、里程碑日期由標題下方文字抓取（同時支援YYYY/MM/DD與舊的M/D/YYYY），新舊版面都能讀；順便修好P-16（系統自己匯出的格式二匯回來會漏掉各組條列項目，現在可正確還原，且支援任意組數）；改用原始日期序號換算，不再因時區差一天。測試：用同一份資料匯出後轉PDF視覺比對，匯入以新版樣本、使用者調整版、舊式A/B並排檔案三種版面驗證，並在UTC、台北、洛杉磯三個時區確認日期。部署注意事項：這次index.html有改，style.css、utils.js、docx-export.js沒有變動，但請維持四個檔案一起放進部署資料夾 |
| v1.18.1 | 2026-10-11 | 【新功能】批次匯出新增 XLSX——批次匯出視窗多了「XLSX」按鈕，把選定日期範圍內每一天的日誌匯出成「一個活頁簿、一天一張工作表」，每天依自己實際的格式（格式一或格式二）排版，跟單日匯出完全一樣；活頁簿第一張是「目錄」工作表，列出日期、格式、標題、照片數，點日期可以直接跳到該天的工作表，目錄也有篩選與凍結首列。「是否包含每日/今日檢討及注意事項」勾選框現在也統一套用到整批 XLSX（跟 PDF/DOCX 相同，不影響資料庫裡各天原本的設定）。容量提醒：範圍超過 31 天，或要嵌入的照片超過 40 張時，會先跳出確認視窗說明檔案可能很大（只提醒、不阻擋，可選擇繼續），產生過程中會顯示「第幾天／共幾天」的進度。批次 XLSX 跟單日 XLSX 一樣僅供閱讀與列印，不支援匯入；要整包還原仍用批次 JSON 備份。內部調整：把格式一、格式二的工作表排版各抽成獨立函式（xlsxBuildFormat1Sheet、xlsxBuildFormat2Sheet），單日與批次匯出共用同一份，確保兩邊輸出一致。測試：用同一份資料（含多張照片）比對重構前後的單日匯出，格式一、格式二的檔案內容逐位元相同（含圖片位置）；批次匯出以格式二、格式一、格式二三天混合驗證工作表順序、目錄連結與頁面設定，並驗證容量提醒（取消時不產生檔案、確認後才產生）。部署注意事項：這次只有 index.html 有改，style.css、utils.js、docx-export.js 沒有變動，但請維持四個檔案一起放進部署資料夾 |
| v1.18.2 | 2026-10-11 | 【修正】XLSX 匯出裡「附圖的列」，照片會稍微蓋到文字的問題（使用者提供批次匯出的實際檔案，9/26、9/28、10/9 三天為例）。原因：估算列高時，我把微軟正黑體10pt的一行文字高度抓成13.5pt，但 Excel 裡實際一行約16pt；單行文字誤差不明顯，文字行數越多，累積的誤差越大，照片是依估算位置放在文字下方，就會蓋到自己項目的最後一兩行字（有些列的最後一行也會被切掉一點）。修正：一行高度改為16pt，格式一、格式二的條列文字、追蹤表與附圖列高、圖片起始位置都套用同一個數值（多行列會變高一些，單行列差異很小）；順便修好格式二「每日檢討及注意事項」標籤折成兩行時下半行被切掉的問題。測試：以多行文字加附圖的資料轉PDF確認照片位置在文字下方且不超出該列；重構共用的排版函式沒有其他變動。部署注意事項：這次只有 index.html 有改，style.css、utils.js、docx-export.js 沒有變動，但請維持四個檔案一起放進部署資料夾 |
| v1.17.4 | 2026-10-04 | 格式二追蹤表不再擋下「刪到剩零列」，改成永遠留一列空白等著填（使用者回報：項目已排入追蹤表後想清除，卻因為「至少需保留一列」無法清掉最後一筆）。查證：追蹤表移除列有三個入口，「✕ 刪除最後一列」與「🗑 刪除已選取」會擋下，但「↩ 回待分類」沒有限制、可以退光，也就是空表格本來就是系統可以走到的狀態，規則不一致；另確認空表格在重新編號、XLSX匯出、DOCX匯出、待分類分配（先找空白列填、找不到才新增）、資料載入（只有舊格式轉換才會補預設列）等處都能處理，沒有任何地方假設第一列一定存在。討論後定案「留一列空白等著填」（而非讓表格完全沒有資料列），並統一三個入口的結果：①「✕ 刪除最後一列」只剩一列時，把這一列清成空白（承攬商/工作項目/進度/備註清空、危險等級回到預設B、附圖移除，項次與id保留），已經是空白則提示「這一列已經是空白」、不重複存檔；②「🗑 刪除已選取」全選時，刪完自動補一列空白；③「↩ 回待分類」全選時，退完同樣自動補一列空白。新增isTrackRowBlank2、blankTrackRow2、ensureTrackBlankRow2三個輔助函式，只改動handleF2Click裡這三個分支。舊資料若已經存成零列（先前用「回待分類」退光的）不會被追溯補列，維持表頭加「+ 新增一列」，按「✕ 刪除最後一列」會提示「目前沒有可刪除的列」。測試方式：用真實程式碼建立測試副本（Firebase改用空的替身模組、存檔函式改為只計次數、其餘不動），在瀏覽器環境實際點擊按鈕，共28項檢查全數通過，涵蓋三個入口、延時表（項次格式不同）、多列時原行為不變、部分刪除會重新編號、零列舊資料、清空後從待分類分配項目會填進空白列而不是多出新列；另外用舊版（v1.17.3）程式碼跑同一份測試作為對照，15項失敗（包含原本的「至少需保留一列」alert），證明測試確實能抓出舊行為。測試限制：沙盒無法連線Firebase，因此實際寫入Firestore這一段沒有被執行到，但存檔路徑沒有改動（仍是呼叫同一個scheduleSave）；也沒有在實際手機上測過，建議部署後實際操作一次三個按鈕。部署：這次只有index.html有異動（style.css、utils.js、docx-export.js沒變）；更新後請先強制重新整理（Ctrl+Shift+R）再測試 |
| v1.17.3 | 2026-09-22 | 【架構調整，第3批】檔案拆分重構繼續——這次範圍比原計畫更精細，追查依賴鏈後拆成兩部分處理。新增docx-export.js：把DOCX匯出的共用常數/輔助函式（DOCX_INK等顏色常數、docxTextRuns、docxMilestoneRuns、docxHeaderFooter、docxStyles、docxPageProps）、buildFormat1DocxTable、buildFormat2DocxChildren搬過去；過程中發現原本以為連續的DOCX區塊，中間其實夾了一個不相關的函式（showManualDownloadList，批次下載用的通用工具，跟DOCX無關），改用逐一精確定位每個函式邊界的方式處理，避免誤搬。刻意不搬parseLegacyDocx（匯入解析）：追查發現它依賴mostRecentTurnaround()這類讀取即時應用程式狀態（turnaroundsCache）的函式，耦合較深，留到之後評估，避免這批風險擴大。同時把6個純函式（dayDiff、milestoneCounterText、MILESTONE_LABELS、buildFourCounterTexts、getRowImages、ensureImagesArray）從原本跟DOCX放在一起，改移進utils.js——這幾個函式雖然一開始跟DOCX邏輯放在同個區塊，但實際上被畫面上的里程碑顯示、格式一/格式二渲染、儀表板等多處廣泛共用，歸類進共用小工具更合適，這次順勢一併修正第2批的範圍界定。測試方式：語法檢查三個檔案皆通過；用本地HTTP伺服器做完整頁面整合測試，確認零JS錯誤、畫面渲染正確；最關鍵的測試是實際呼叫搬移後的buildFormat1DocxTable、buildFormat2DocxChildren產生真正的DOCX檔案（用docx套件的絕對路徑匯入解決Node環境找不到套件的問題），轉成PDF後視覺比對，確認表格灰階、多行文字換行、頁首頁尾、章節分隔線等全部跟搬移前的行為一致。部署注意事項：這次開始，部署需要同時複製index.html、style.css、utils.js、docx-export.js四個檔案 |
| v1.17.2 | 2026-09-22 | 【架構調整，第2批】檔案拆分重構繼續——把8個完全獨立、不依賴系統其他狀態的小工具函式（todayStr、mdLabel、mdSlash、uid、autoGrow、escapeHtml、formatBytes、tagListIncludes），從index.html抽成獨立的utils.js檔案，用ES模組的import/export引用。這是規劃中5個階段的第二批，延續第1批（v1.17.1，CSS拆分）的順序，繼續由風險低的部分往核心邏輯推進。抽取前逐一確認這8個函式的完整原始碼在檔案裡恰好只出現一次，避免誤刪到其他地方。純技術性調整，不涉及任何功能異動、使用者操作方式完全不變。測試方式：先發現file://協定本身會阻擋ES模組跨檔案載入（瀏覽器CORS安全限制，不是程式碼問題），改用本地HTTP伺服器測試；獨立測試utils.js模組本身的8個匯出函式，逐一驗證輸出結果正確（例如mdLabel/mdSlash用今天日期驗證格式正確、escapeHtml正確跳脫特殊字元、formatBytes三種量級單位正確換算、tagListIncludes正確判斷有無比對到）；另外用完整檔案（疊加第1批的style.css與這批的utils.js）透過HTTP伺服器實際載入，確認zero JS錯誤、畫面渲染正確。部署注意事項：這次開始，部署需要同時複製index.html、style.css、utils.js三個檔案到同一個目錄，缺一個都會導致功能異常或畫面跑版 |
| v1.17.1 | 2026-09-21 | 【架構調整，第1批】開始進行檔案拆分重構——把原本內嵌在index.html裡的CSS，抽成獨立的style.css檔案，用<link rel="stylesheet">引用。這是規劃中5個階段（CSS→小工具函式→匯出邏輯→格式一/格式二渲染→Firebase存取層，由風險最低往風險最高推進）裡的第一批，先從風險最低、跟JavaScript邏輯完全沒有相依關係的部分開始。純技術性調整，不涉及任何功能異動、使用者操作方式完全不變。測試方式：逐像素比對「CSS內嵌」與「CSS外部連結」兩種版本，針對登入畫面實際截圖比對，確認零差異（PIL的ImageChops像素級比對，bbox為None代表完全一致）；另外用完整檔案（非抽取片段）在真實檔案結構下實際渲染，確認style.css成功載入無404、且實際生效的CSS屬性（寬度320px、內距36px 34px、邊框1px solid）都正確套用到畫面上，過程中發現一次自己的驗證疏失（誤用「border-radius」這個原本就沒設定的屬性去驗證，一度誤判CSS沒套用成功，改用確實有設定的屬性重新驗證後排除）。部署注意事項：這次開始，部署不能只複製index.html，需要同時複製style.css到同一個目錄，否則畫面會完全跑版（沒有任何樣式） |
| v1.17 | 2026-09-20 | 【重要修正】圖片容量機制從「軟性提醒」改成「即時估算文件大小、超過安全門檻直接擋下」，防止存檔真正失敗（累積兩次使用者已知回報：Firestore文件大小超過1,048,576 bytes上限導致存檔失敗，錯誤代碼invalid-argument）。查證過程：透過逐步釐清兩次實際錯誤訊息（分別為1,504,917、1,184,369 bytes），確認問題發生在使用者對單一項目附加第3張照片時，且使用者實測前2張照片各約300KB（遠高於先前用合成測試圖估算的150-200KB），推算後確認：v1.14/v1.16.3設計的「達4張軟性提醒」門檻本身已經不安全——3張300KB的照片加上正常份量的文字內容，就足以超過1MB硬上限，提醒機制根本還沒觸發、存檔就已經失敗。過程中也查證釐清多個可能原因（iOS Safari canvas記憶體限制、v1.13.5舊功能殘留圖片、Firestore是否有「累計額度」機制）皆一一排除，最後確認根本原因是「純粹用張數判斷，沒有反映照片內容複雜度、文字份量差異」這個機制性缺口——查證發現室內光線不足環境拍攝的照片，因感光度提高、雜訊增加，即使解析度相同也會比明亮環境拍攝的照片更難壓縮、檔案更大，這正好對應到工場大修現場常見的拍攝條件。修法：新增estimateDocSize()即時估算目前文件的實際位元組大小（JSON.stringify後取UTF-8位元組數，不是JS字串.length，避免中文字元造成低估）；附加圖片當下，先估算「加了這張之後」的總大小，超過安全門檻900KB（留約150KB緩衝到1MB硬上限）就直接擋下、不執行附加，並用showToast明確告知目前用量與建議做法；移除原本的countTodayImages()軟性提醒函式（已無呼叫點，改為死程式碼予以清除）。同時把壓縮最長邊從1024px調整為960px（討論多組級距後決定，配合這次實測300KB基準重新校正）。另外查證了JPEG品質參數（目前0.72）的額外壓縮空間：固定解析度下，品質降到30%只能再省約25%，效益遠不如調整解析度，且品質30%已出現可見的壓縮瑕疵，故此次不調整品質參數，僅調整解析度與新增強制容量檢查。已用Node.js測試驗證兩種情境：模擬真實案例數值(2張300KB圖片+文字，加第3張300KB圖片)正確判定應擋下；模擬空間充足情境(1張100KB圖片)正確判定不應誤擋，兩種情境皆符合預期 |
| v1.16.3 | 2026-09-19 | 圖片壓縮的最長邊設定，從1280px調整為1024px（討論後決定，有具體樣本比對依據）。討論過程：先前確認維持1280px不降低，這次用系統實際的壓縮邏輯（compressImage函式相同的縮放/品質參數）產生模擬工地儀表/標籤照片的測試圖，分別輸出1280px、1024px兩種版本實際比對，發現一般放大程度下兩者幾乎看不出差異，只有放大到接近像素邊界的極限程度，才看得出1024px版本的細紋理稍微柔和，但主要文字內容依然清晰可辨；實測檔案大小比例約68%（1024px約為1280px的68%），換算單一日誌可容納的照片數量，從約5張提升到8-9張左右。修法：compressImage()的maxDim參數預設值從1280改為1024，只有一個呼叫點且未覆寫參數，改預設值即完整生效；使用說明「圖片附件」章節的「最長邊約1280px」文字同步更新為1024px，v1.14修訂紀錄裡提到1280px的部分維持原樣（歷史紀錄，當時的數值本來就是1280px，不追溯修改）。已用瀏覽器實際測試壓縮函式，確認2560×1920的來源圖片正確輸出為1024×768（最長邊精準壓到1024px，長寬比例正確維持）；此次調整只影響「之後新上傳的照片」，已存在資料庫裡、先前用1280px壓縮的舊照片不受影響、不會被追溯調整 |
| v1.16.2 | 2026-09-19 | 儀表板PDF快照優化，解決兩個使用者回報的可讀性問題：字級偏小、橫式列印時內容被拉伸變形。查證後確認：字級偏小是因為儀表板畫面上的字級（區塊標題10px、進度標籤9.5px等，全系統類似的小字級超過30處）是為了螢幕上緊湊呈現設計的，印到紙上偏小；橫式拉伸則是v1.16那次新增列印CSS時，為了讓內容撐滿頁面寬度而把寬度上限拿掉（max-width:none），但熱力圖用的是自動填滿容器寬度的格線寫法（1fr），橫式紙張較寬時容器跟著變寬，格線就被拉得更寬更扁。修法：①新增@page{size:portrait}建議列印對話框預設選中直式（多數瀏覽器會採用，但使用者仍可手動改成橫式，非強制鎖死）；②恢復合理的寬度上限（640px，不是完全不設限），即使使用者手動選了橫式，內容也維持原本比例、兩側留白，不會被撐開變形；③新增列印專屬的字級放大規則，只在dashboard-printing模式下生效，不影響畫面上平常看到的樣子。已用瀏覽器列印模擬測試驗證：寬螢幕情境下，卡片寬度確實維持640px上限、熱力圖格線沒有被拉伸至填滿寬螢幕、字級正確放大；用橫式A4實際產生PDF確認視覺效果，內容維持原本比例、正確靠左側顯示、右側留白，不是撐滿整張寬紙 |
| v1.16.1 | 2026-09-19 | 議題追蹤板「匯出XLSX」新增第二張「時間軸明細」工作表（使用者回報：原本匯出只有摘要欄位，看不到議題最有內容的「時間軸」部分）。討論後確認做法：主要摘要維持獨立一張「議題清單」工作表，另外加一張「時間軸明細」工作表，依追蹤編號分組、每筆時間軸記錄各自一列展開（同一議題若有好幾筆時間軸記錄，議題基本資料重複顯示在每一列，方便篩選），欄位為追蹤編號/議題標題/日期/區塊/內容，重用既有的findItemsByTag()邏輯，紅字強調的項目在明細裡同樣以紅字呈現；沒有任何日誌項目使用該追蹤編號的議題，會在明細裡顯示提示文字，不會整筆消失不見。已用Node.js實際產生XLSX檔案、讀回確認兩種情境（有時間軸記錄、沒有時間軸記錄）皆正確呈現 |
| v1.16 | 2026-09-19 | 議題追蹤板新增「匯出XLSX」、儀表板總覽新增「匯出PDF」，經過完整討論定案後實作（範圍/欄位/排序/檔案格式皆與使用者逐項確認）。前置調整：議題新增「所屬大修」欄位，建立議題時自動帶入最近建立的大修（mostRecentTurnaround），議題詳細畫面新增下拉選單可事後修改或改回「（未歸屬）」；這次上線前建立的舊議題一律視為未歸屬，不會被任何大修的匯出範圍抓到，除非使用者事後手動指定。議題匯出XLSX：範圍限定「目前最近建立的大修」全部議題，依追蹤編號自然排序（數字部分正確排序，例如A2排在A05前面），欄位為追蹤編號/議題標題/狀態（中文顯示：待處理/進行中/已結案）/建立人/建立時間/解決時間，標題列沿用DOCX美化定案的灰階視覺語言。儀表板匯出PDF：技術做法改為沿用瀏覽器內建列印機制（跟日誌PDF匯出同一套window.print()，不是原本設想的html2canvas——查證後發現系統裡「PDF」向來都是走瀏覽器列印，html2canvas只用在PNG匯出），新增dashboard-printing專屬列印CSS，只在按下按鈕時生效、不影響其他彈窗，把儀表板從position:fixed疊加彈窗改成一般文件流，避免先前查證過的「疊加彈窗列印時容易跑版」問題；快照內容反映使用者當下實際看到的畫面狀態（例如熱力圖展開狀態）。實作過程中的品管：過程中不慎誤刪deleteIssueBtn事件監聽的開頭行，已即時發現並修正；測試時額外發現printOnlyStage會跟儀表板內容一起意外印出的潛在衝突，已在beforeprint處理跟專屬列印CSS雙重防範。已用瀏覽器列印模擬（8項檢查：側邊欄/工具列/printOnlyStage隱藏、儀表板正確顯示且改為一般文件流、按鈕列印時隱藏）與實際PDF視覺輸出驗證儀表板快照效果乾淨無跑版；已用Node.js測試驗證議題篩選（正確排除其他大修）與自然數字排序邏輯 |
| v1.15.3 | 2026-09-18 | 修正「匯入舊檔（docx/xlsx）」的使用說明文字，避免使用者誤解成是可以拿空白範本自由填寫的「範本匯入」功能（討論後決定）。原本文字「把舊格式的日誌檔案直接轉換進系統」語意模糊，沒有講清楚「僅限系統自己匯出的檔案、或結構完全一致的舊格式檔案」這個關鍵限制——這個功能的解析邏輯會精確比對固定結構（例如「表格第一列有沒有『時間』兩個字」），結構被更動過就可能解析錯誤，v1.15.1那次回歸問題已經證明了這一點。修正後的文字明確標示「這不是給空白範本填寫用的」，並提醒「請避免手動調整格式後再匯入」。純文字修正，不涉及程式邏輯異動 |
| v1.15.2 | 2026-09-14 | 移除格式二DOCX/XLSX匯出裡一行沒有說明文字、讀起來不知所云的贅字（使用者回報：「每日檢討及注意事項」跟第一個追蹤表章節之間，莫名出現一行純粹列出各組名稱的文字，例如「A組塔槽組，B組檢修(動火)組」）。查證後確認這行不是意外殘留，變數名稱是legendRow（圖例列），原本似乎是想在進入各組追蹤表前，先列出「接下來有哪些組別」當索引，但沒有搭配任何引導文字（例如「以下依序為：」），單獨看起來就是不明所以的重複資訊——各組名稱本來就會在各自的「XX組（追蹤表）」章節標題裡出現過，不會漏掉。已先產出移除後的DOCX樣本供確認，確認格式沒問題後，DOCX、XLSX兩處一併移除（XLSX原本是legendRow那一列的儲存格內容，移除後把cursor起始位置從legendRow+2調整為afterReview+1，避免留下多餘空白列）。測試說明：DOCX已用實際產生檔案、轉PDF確認章節銜接正常；XLSX這次因為牽涉的函式規模大、前面有一長串相依的欄位位置計算，只做了語法檢查跟邏輯手動推演（單純行數位移的簡單算術，風險低），沒有另外產生實際檔案視覺驗證，請於部署後實際匯出XLSX確認版面銜接正常 |
| v1.15.1 | 2026-09-13 | 【重要修正】修復v1.15上線後，既有的「匯入舊檔（docx/xlsx）」功能失效的問題（這次是在討論另一個不相關的功能時，主動回頭查證既有功能才發現的回歸，不是使用者回報）。根本原因：v1.15把格式一的DOCX匯出標題從表格第一列移到表格外面（獨立段落），但既有的匯入解析邏輯（parseLegacyDocx）仍然假設「表格第一列固定是標題」，導致用v1.15匯出的檔案再匯入回系統時，會把「時間」這個欄位標題誤判成日誌標題，後續每一列的判斷也會跟著錯位一格。修法：改用「偵測」方式同時相容新舊兩種結構——如果表格第一列本來就長得像欄位標題列（有「時間」、且有3欄以上），代表是v1.15後的新版結構，標題改成從表格前面的段落抓取；否則維持原行為，把第一列當標題（相容v1.15之前匯出的舊檔案）。查證過程中額外發現並一併修正一個相關的換行bug：cellParagraphs（匯入時讀取儲存格文字的函式）原本沒有辨識v1.15新增的<w:br/>換行標記，導致多行文字（例如備註欄位）讀回來會直接黏成一行、換行消失；修法是偵測到<w:br/>時换回\n字元，確保匯出匯入是對稱的往返轉換。已用瀏覽器端對端測試驗證：實際用整合後的程式碼產生一份v1.15格式的DOCX檔案，再用修正後的解析邏輯讀回來，確認標題、日期、分組數量、多行備註（含換行）都正確還原 |
| v1.15 | 2026-09-13 | 【重大更新】格式一、格式二的DOCX匯出全面美化，經過多輪樣本來回討論定案後正式整合進系統（過程含使用者實際在Word裡動手修改、上傳回饋檔案，逐一比對XML精確數值套用）。共用視覺語言：白底（不用系統網頁的米色紙質感背景，省墨水）、深藍墨水色搭配紅色強調、中文微軟正黑體與英數字Arial自動分開套用、頁首（工場名稱＋日期或批次匯出的日期區間）與頁尾（頁碼）、標題移到表格外並加大字級＋粗底線、里程碑資訊併成一行以「｜」分隔且數字放大14號文字維持11號。格式二專屬：章節標題下方細灰分隔線、追蹤表標題列灰階底色（D9D9D9）、資料列灰階斑馬紋（F9F9F9，從每個表格第2列開始上色）、欄寬經實測調整避免超出頁面邊界。格式一專屬：表格標題列與3種提示列（★表示涉外單位/預計工作項目/今日檢討及注意事項）統一11號字＋95%白底色（F2F2F2，刻意比格式二淺，兩者是分別定案、不同數值）、資料列不用斑馬紋。額外修復一個影響兩種格式的資料正確性bug：多行文字（例如備註欄位換行）原本用純文字內嵌\n字元，但Word不會把這個字元當作真正換行、只會顯示成空格，導致內容被壓成一行；改用docx-js的break屬性正確產生Word的換行標記，已用實際整合後的程式碼產生文件、轉PDF、逐項比對視覺效果驗證（非僅語法檢查）。整合過程中額外發現並修正一個自己引入的錯誤：一開始誤用同一個共用常數處理格式一格式二的標題列底色，導致格式二原本定案的D9D9D9會被格式一的F2F2F2覆蓋掉，經實際測試比對顏色深淺後抓到並拆成兩個獨立常數修正 |
| v1.14.2 | 2026-09-13 | 修復格式二匯出Word時，內容較長的欄位會把表格撐開、不會自動換行的問題（使用者回報，並提供實際匯出檔案協助查證）。查證確認：檔案裡表格雖然有設定欄寬（columnWidths/tcW），但完全沒有明確設定「固定版面」（<w:tblLayout w:type="fixed"/>），Word預設用「自動調整」版面配置，遇到內容較長、又沒有明顯換行點的文字（例如檔案裡B07列的備註欄位，是一長串用句點分隔、沒有空白的儀表編號清單），可能會撐開儲存格因應，而不是在指定欄寬內換行。修法：docx-js的Table建構加上layout:TableLayoutType.FIXED，格式一、格式二的DOCX匯出表格都一併修正（原本回報的是格式二，但格式一有同樣的程式碼寫法，一併處理維持一致）。測試說明：用實際回報的長文字內容產生測試文件，確認XML正確包含<w:tblLayout w:type="fixed"/>設定；但用LibreOffice轉換PDF比對「有無這個設定」兩個版本時，畫面呈現一致，可能是LibreOffice的渲染引擎比實際Word寬容，沒辦法在本次查證過程中重現使用者回報的確切撐開情形——這個修正符合docx-js官方文件明確提到的最佳實務、風險低，但誠實記錄這個驗證上的limitations，請使用者部署後在實際Word環境用長文字內容重新測試確認 |
| v1.14.1 | 2026-09-13 | 側邊欄搜尋新增「📷 只顯示有附圖的日誌」核取方塊（使用者回報需求），放在日期區間篩選下方，可單獨使用、也可以跟關鍵字搜尋、日期區間一起疊加使用。這次先做「日層級」的篩選（這一天有沒有附圖），不做「項目層級」（標示出是哪個項目有圖並跳轉）——後者需要額外設計標示/跳轉機制、還可能牽涉格式一格式二切換的邊界情況，評估後工作量跟風險明顯較高，故先從日層級著手。技術做法：新增entryHasAnyImage()函式，沿用跟既有extractSearchableText()同樣「針對entry物件操作」的模式，找到第一張圖片就提早回傳，不用像v1.14的countTodayImages那樣算出總數；同時處理新格式(images陣列)與v1.14前的舊格式(單一image欄位)相容，涵蓋格式一工作紀要、格式二分組項目清單、追蹤表三種資料來源。已用Node.js測試驗證7種情境（無圖片/格式一新舊格式相容/格式二分組項目/追蹤表/review區塊/有資料但無圖片皆正確判斷），已用瀏覽器測試驗證篩選單獨使用、跟關鍵字疊加使用、取消勾選後正確恢復 |
| v1.14 | 2026-09-09 | 【功能升級】格式一工作紀要、格式二分組項目清單，圖片附件從「每項限一張」改成「每項最多4張、2×2排列顯示」（取代v1.13.5的「延續加照片」變通做法，正式上線同一刻移除該按鈕）。規格：新增圖片是「累加」不是「覆蓋」（每點一次+附圖都是加進清單）；每張縮圖旁邊有獨立的「✕」可單獨移除、「◀▶」可調整順序（例如作業前/中/後需要照順序的情況）；3張時右下角留空；追蹤表（承攬商/危險等級那張表）維持原本單張邏輯不受影響。舊資料相容：新增getRowImages()/ensureImagesArray()做「延遲轉換」，讀取舊格式的單一row.image欄位時自動視為陣列裡的第一張，真正寫入(附加/移除/排序)時才轉換成新格式，不用逐一修改9個不同的資料載入點，範圍集中、風險低；v1.13.5「延續加照片」產生的舊項目維持原樣不主動合併。容量提醒：附加圖片的當下，計算今天這篇日誌總張數（格式一+格式二+追蹤表一起算），達4張跳出提醒（軟性門檻，技術硬上限約5張，來自Firestore單一文件1MB容量估算），壓縮品質維持原本1280px不降低。匯出：DOCX、XLSX（格式一）都更新為支援多張圖片，XLSX採垂直疊放、依張數動態調整列高；格式二分組項目清單原本就未支援DOCX/XLSX圖片匯出，此次不新增這個能力，維持既有範圍。已用Node.js測試驗證新舊格式相容（6種情境）、2×2網格HTML輸出正確性（含4張/1張邊界情況）、整篇日誌總數計算（涵蓋三種資料來源）；已用瀏覽器測試驗證2×2排版視覺效果（4張完整排列、3張右下留空） |
| v1.13.5 | 2026-09-09 | 格式一工作紀要、格式二分組項目清單，新增「📷 延續加照片」快速按鈕（使用者回報手機端需求，目前每個項目限附一張照片，此前只能靠手動新增下一項目來變通插入第二張照片）：只有項目已經附圖時才會出現這顆按鈕，點擊後緊接在來源項目後面插入一個新項目（不是加到清單最後），內文自動帶入「（接續上一項）」方便辨識這兩項是相關的。原本設想比照追蹤表做「編號-數字」的接續標示（例如A05-2），但格式一、格式二的顯示編號只是即時排序位置、不是像追蹤表那樣固定存住的編號，技術上無法穩定接續，改用「緊鄰插入＋內文提示」雙重輔助辨識取代；技術做法重用既有的插入模式（跟Enter快速新增下一筆用的是同一套array.splice(idx+1,...)邏輯），追蹤表本身不在這次範圍內；已用Node.js測試驗證兩種項目類型的插入位置正確、新項目正確帶入提示文字且不含圖片欄位 |
| v1.13.4 | 2026-09-09 | 議題追蹤板新增「🏷️ 查看所有標籤」按鈕：建立議題前可以先瀏覽本次大修範圍內已經用過的所有追蹤編號（附使用次數，依名稱排序，可搜尋篩選），幫助確認有沒有已經存在的相近編號，避免不同使用者各自新增標籤時，因為忘記已有類似的存在，把本該連貫的時間軸拆成好幾個不同標籤各自記錄。技術做法：把儀表板「追蹤編號活躍度」背後的統計邏輯抽成獨立可重用函式（getTagCountsInCurrentTurnaround），兩處共用同一份邏輯，不是重新設計；已用瀏覽器測試驗證排序、不分大小寫搜尋（能同時抓到HS0204跟hs0204b這種容易被忽略的相近寫法）、空結果狀態 |
| v1.13.3 | 2026-09-09 | 修正修訂紀錄本身的順序錯誤（使用者回報）：v1.11.8被誤植在v1.12.5跟v1.12.4中間，正確順序應該排在所有v1.12.x之後、v1.11.7之前。查證是先前某次用腳本移動收合區塊項目時的操作失誤，累積了好幾個版本沒被發現，這次單純調整這一筆的位置，不影響任何實際內容或功能，已用瀏覽器測試驗證展開後56筆順序正確、v1.12.1排在v1.11.8之前、v1.11.7緊接在v1.11.8之後 |
| v1.13.2 | 2026-09-09 | 回饋機制統一（4層級架構第二階段，第一階段的錯誤橫幅已於v1.12.7完成）：查證後盤點系統裡9種回饋機制，發現「層級2：輕量通知」這一層最不統一——工具列文字提示（showIoMsg，容易被忽略的小字）跟「有人加入編輯」提示（獨立浮動卡片），是同一種性質（剛發生的事，看到就好）卻用完全不同的視覺呈現，而且各自為政的做法還有一個潛在缺陷：如果多則提示同時出現，會直接疊在同一個位置互相重疊，只是先前presence-toast使用頻率低才沒被注意到。修法：新增統一的showToast()機制，兩者都改用同一套（固定顯示在畫面右上角、正確垂直堆疊不重疊、自動淡出消失），showIoMsg()呼叫方式維持不變（不影響其他呼叫這個函式的地方），只是內部改用新機制。另外查證「層級3：需要決定」（確認彈窗、衝突處理彈窗）已經透過既有的.confirm-overlay/.confirm-card共用樣式統一，不需額外處理；「層級1：環境狀態」（存檔狀態、正在編輯徽章、議題狀態徽章等）用不同顏色/形狀對應不同語意，屬於合理的設計差異，不算真正的不統一，暫不處理。已用瀏覽器測試驗證：單一訊息正確顯示、疊加3則訊息正確垂直堆疊不重疊、一般/錯誤兩種語氣的深色模式對比度皆正常 |
| v1.13.1 | 2026-09-09 | 儀表板新增「許可證數量」統計：統計各分組追蹤表（承攬商/危險等級那張表）裡的有效筆數，跟既有的「分組工作量分佈」（統計分組項目清單）是各自獨立的兩份資料，互不影響；有效筆數判斷標準是承攬商跟工作項目都要填，系統預留或使用者手動新增的空白列不計入；組別名稱依實際設定動態解析（沿用系統裡既有的追蹤表key對應回組別名稱的邏輯），正確處理不同天數的日誌分組數量可能不一樣的情況。使用說明優化：目錄從28個連結攤平的一整面牆，改成依主題分成7個分類（入門必讀/記錄內容/管理與追蹤/搜尋與檢視/匯出與備份/協作與環境/其他）；新增全文搜尋，搜尋章節內容（不只標題），符合的章節反白標示關鍵字並自動捲動到第一個命中處，不符合的章節與對應目錄連結暫時隱藏，安全處理文字節點反白不會破壞既有的巢狀HTML標籤，清空搜尋恢復顯示全部章節；測試過程中額外發現一個互動細節：修訂紀錄本身有獨立的收合機制（v1.11.7加入），如果搜尋比對到收合區塊裡的舊版本內容，反白標示了但畫面上因為收合而看不到，容易讓人誤以為系統壞了，已修正為搜尋時自動展開收合區塊、清空搜尋時恢復收合，已用瀏覽器測試驗證兩種狀態切換都正確 |
| v1.13 | 2026-09-08 | 【重要修正】修復多人同時編輯同一天日誌時，正在打字的內容可能被別人較舊版本靜默覆蓋的問題（使用者回報）。根本原因：原本的「60秒安全上限」機制，設計初衷是避免游標一直沒離開導致別人的更新永遠進不來，但觸發時是直接用對方的資料整個覆蓋本地畫面，完全沒有檢查本地是否有還沒存檔的新內容——如果兩人都持續編輯超過60秒，其中一人的更新最終會被觸發覆蓋，蓋掉另一人正在打的內容，且是靜默發生、沒有任何提示。修法：完全移除「超過時間強制套用」的概念，改成安全上限觸發時不覆蓋畫面，只記錄為「待處理更新」並在畫面顯示不打斷輸入的輕量徽章提示；等使用者離開輸入框時（沿用v1.12.4已加入的focusout事件），才重新向資料庫核對最新狀態（不使用暫存的舊資料，避免比對到過期版本），如果確認真的有落差，才跳出既有的差異比對畫面讓使用者自己選擇，選擇保留自己的版本時，對方版本會先存成歷史紀錄再覆蓋，不會真的遺失。已用Node.js測試驗證4種決策情境（含關鍵情境：正在編輯時收到別人更新，確認不會覆蓋畫面）、瀏覽器測試驗證3種focusout範圍過濾情境（編輯區域/標題欄位觸發、彈窗等無關欄位不誤觸發）。機制修正完成後，一併校正登入頁與使用說明3處「即時」「安全」等用詞過於肯定的敘述，改為準確反映系統實際保證的行為；已知殘餘限制（不在此次修正範圍）：自動存檔本身約0.7秒的延遲窗口，屬於「定期存檔」架構本身的極限，需要換成即時同步等級的技術架構才能徹底消除，經評估投入產出比不合理，暫不處理 |
| v1.12.8 | 2026-09-06 | 修復深色模式下，登入畫面輸入帳號密碼看不清楚的問題（使用者回報）。根本原因跟先前幾次深色模式修正不同：這次不是「CSS繼承沒接住」，是瀏覽器對<input>這種表單元素本身有預設的文字顏色（黑色），不會單純跟著頁面的顏色繼承走；.login-card input原本只設定了背景色（正確跟著深色模式變深），完全沒有明確指定文字顏色，於是套用瀏覽器預設的黑色，深色背景配黑色文字幾乎看不見。修法：明確加上color:var(--ink)，不依賴瀏覽器預設值。順便查證系統裡其他輸入框，確認常用片語相關的兩個欄位雖然也沒有明確設定顏色，但因為完全沒有設定背景色，維持瀏覽器預設的白底黑字組合，本身仍然清楚可讀，只是深色模式下視覺不協調，不屬於看不清楚這個等級的問題，這次不在處理範圍內 |
| v1.12.7 | 2026-09-06 | 「未預期的錯誤」紅色橫幅新增「關閉」跟「重新整理頁面」兩顆按鈕。這是回饋機制統一討論裡最優先處理的一塊：原本這個橫幅一旦出現，完全沒有任何出路，只能顯示、無法關閉，使用者只能自己想到要重新整理頁面，跟系統裡其他回饋機制（例如工具列文字提示5秒自動消失、確認彈窗都能選擇取消）比起來，這是唯一一個「卡住沒有出路」的例外。已用瀏覽器測試驗證按鈕正確顯示、關閉按鈕能正確隱藏橫幅、重新整理按鈕能正確觸發（點擊事件跟按鈕id比對邏輯確認無誤，location.reload()是標準瀏覽器API不需額外驗證） |
| v1.12.6 | 2026-09-06 | 修復v1.12.5「使用說明搬到側邊欄」後，admin/editor角色空間變擠的問題（使用者回報）。根本原因：側邊欄按鈕原本是2欄網格排列，v1.12.5把使用說明加進去變成3個項目，第3個項目在2欄網格裡會自動換到下一行，導致admin/editor角色（能看到誰在線上）整體高度從108px增加到138px，抵銷了v1.12.1當初改2x2排列省下的部分空間。修法：改成3欄網格，讓自動/誰在線上/使用說明三個項目擠在同一排，不再換行；已用瀏覽器測試驗證高度確實恢復到108px，且文字沒有擠壓變形 |
| v1.12.5 | 2026-09-06 | 「更多功能」選單重新整理：原本「進階」分組混雜了5種不同性質的功能（編輯歷史、使用說明、常用片語、批次匯出、從昨天延續），拆分成「輔助工具」（常用片語、從昨天延續）跟「資料管理」（編輯歷史、批次匯出）兩組，加上原本就有的「匯入」組，共3組分類清楚呈現；「使用說明」搬出更多功能選單，改放到側邊欄（跟修改密碼、登出同一層級），因為使用說明性質上是「跟哪篇日誌都無關的通用資源」，不像其他功能是針對單篇日誌的操作，放在更多功能這個原本設計給單篇操作的抽屜裡並不合適 |
| v1.12.4 | 2026-09-04 | 【重要修正】修復iPhone注音輸入法打完字、離開輸入框後，內容變成稍早版本的問題（使用者回報，補充在v1.12.3之後的追蹤情境）。這是比v1.12.3更根本的問題：v1.12.3修的是「打字打到一半被打斷」，但這次使用者確認是「已經打完、確實離開輸入框」才發生，代表問題不是畫面被打斷，是打完的文字可能從一開始就沒有正確寫進系統的資料模型——瀏覽器對注音這類「組字型」輸入法，標準行為是使用者選字確定之前，input事件不會觸發，如果組字完成、離開欄位那個瞬間，input事件沒有正確觸發或沒帶到最新的值，系統就完全不知道使用者打了什麼，之後任何原因觸發重新整理畫面，都會用「沒收到最新內容」的舊資料重畫，看起來就像「恢復稍早版本」。修法：在原本的input事件之外，額外加上focusout事件（離開欄位時觸發，不受輸入法組字狀態影響）當作保險，離開欄位的當下，不管中間input事件有沒有正確觸發，都會再次確認讀取目前欄位的實際值寫入資料模型；已用瀏覽器測試模擬「刻意不觸發input事件」的情境，驗證focusout保險機制能正確補上遺漏的資料 |
| v1.12.3 | 2026-09-04 | 修復手機上打字到一半被無預期中斷、內容恢復到稍早狀態或變空白的問題（使用者回報）。查證確認使用者當下完全沒有離開網頁、沒有切換App，排除了「手機作業系統回收背景分頁」這個可能性，鎖定是v1.11.1修正的判斷機制（游標是否真的還聚焦在編輯區）本身還有破口：手機虛擬鍵盤在特定切換情境下（例如選字、表情符號鍵盤切換、鍵盤收合展開動畫過程中），瀏覽器回報「目前聚焦位置」偶爾會有極短暫的空窗期，桌機沒有虛擬鍵盤、不會遇到這個現象；如果這個空窗期剛好跟別人的存檔更新同時發生，系統就會誤判「使用者現在沒在編輯」而套用更新，蓋掉還沒存檔的內容。修法：不再只看「這一瞬間」的聚焦狀態，改成額外參考「最近3秒內有沒有打過字」，只要符合其中一項就視為仍在編輯，即使瞬間偵測不到聚焦也不會被打斷；已用Node.js測試驗證6種情境（含邊界值2999ms/3001ms） |
| v1.12.2 | 2026-09-03 | 常用片語新增「批次匯入」功能：一次貼上多句片語（一行一句），按「分析內容」先顯示摘要（總行數、空白行/重複片語各略過幾行、實際會新增幾筆），確認無誤才按「確定新增」真正寫入，避免貼錯內容毫無預警就整批寫進資料庫；重複偵測同時涵蓋「跟現有清單重複」跟「貼上內容裡自己重複」兩種情況；已用Node.js測試驗證解析/去重邏輯（一般情況、全部重複、空輸入三種情境） |
| v1.12.1 | 2026-09-03 | 儀表板「最近30天記錄狀況」熱力圖新增「展開看過去60天」切換連結，預設維持30天精簡顯示，需要回顧整個大修週期時再展開，展開/收合不影響其他人、純畫面選擇；側邊欄「深淺切換／誰在線上／修改密碼／登出」4顆按鈕從垂直堆疊改成2x2網格排列，維持v1.12剛加大的間距（避免誤按），但整體垂直高度省下約一半，釋放更多空間給日誌清單捲動區——這是v1.12把按鈕間距加大之後，連帶壓縮到清單空間的直接改善 |
| v1.12 | 2026-09-03 | 格式一「今日檢討」、格式二「每日檢討」改名為「今日檢討及注意事項」「每日檢討及注意事項」，全站（畫面標籤、使用說明、DOCX/XLSX/JSON匯出、批次列印延續來源選單等）共14+17處一併更新，歷史版本紀錄維持原名不回溯修改；「納入匯出」勾選框的預設值改為預設不勾選（原本是預設勾選），這是回溯性的變更，包含過去所有已存在、從沒動過這個設定的舊日誌，匯出行為都會一併改變，需要自己手動勾選才會出現在匯出結果裡（使用說明已補充提醒）；查證過程中發現並修正一處原本會因改名而失效的嚴格字串比對（XLSX匯入解析每日檢討區塊的判斷邏輯）；深色模式下原生日期輸入框（含最上方日期選擇器、里程碑日期、批次匯出日期範圍等）的日曆圖示看不清楚，補上color-scheme屬性讓瀏覽器改用淺色圖示；側邊欄「深淺切換／誰在線上／修改密碼／登出」這4顆按鈕間距太窄容易誤按，加大間距並讓「登出」額外拉開距離＋加分隔線，降低誤點影響較大動作的機率 |
| v1.11.8 | 2026-09-03 | 修復修訂紀錄「顯示更多」按鈕沒有展開完整歷史的問題（使用者回報）。根本原因：v1.11.7新增當時，不小心複製出了兩個id相同的收合容器標籤，導致HTML結構錯誤（重複id、巢狀tbody），瀏覽器解析時只有第一個容器（僅含1筆）能被正確控制展開，第二個容器（含其餘37筆）變成無法被程式控制的孤兒節點，永遠維持隱藏。修法：移除多餘的重複標籤，合併成單一正確的收合容器，已用瀏覽器測試驗證展開後全部43筆從最新到最早完整顯示 |
| v1.11.7 | 2026-09-03 | 今天還沒有日誌、停留在空白畫面時，格式一/格式二切換選單改為直接隱藏（先前只確認了根本原因跟修法方向，這次拍板採用「隱藏選單、從源頭避免點到」的做法，比照系統裡唯讀模式下隱藏存檔按鈕的一貫處理方式），避免使用者手動切換觸發對null資料的渲染而出錯；使用說明文件優化：修訂紀錄改為預設只顯示最新5筆，其餘點「顯示更多」展開；新增「回到最上」浮動按鈕，捲動超過一定距離才出現在畫面右下角，深色模式配色沿用這次系列修正驗證過的「成對變數」做法，不會有文字看不清楚的問題 |
| v1.11.6 | 2026-09-03 | 修復匯出圖片確認按鈕文字看不清楚的問題（使用者回報）。根本原因：這類「實心強調按鈕」故意拿--ink當背景色、搭配寫死的白色文字，淺色模式下--ink是深色，白字沒問題；深色模式下--ink變成淺色，白字配淺色背景幾乎看不見。查證後發現同樣手法還有另外3個按鈕（延續已選項目、批次匯出DOCX、建立日誌，皆透過行內樣式覆蓋背景色），一併修正：深色模式下這幾顆按鈕改用固定的深色背景（不隨--ink翻轉），維持「實心強調按鈕」該有的高對比，不隨主題變化 |
| v1.11.5 | 2026-09-03 | 修復預覽時日誌標題文字太淺、看不清楚的問題（使用者回報）。這次找到的是比先前幾次更根本的架構性缺口：日誌標題（h2）本身沒有自己寫color屬性，是靠「繼承」父層的文字顏色；但CSS繼承拿到的是「已經算好的顏色值」，不是「var(--ink)這個參照本身」——先前的「強制淺色」機制，只重新定義了變數，沒有明確在容器本身寫出color/background屬性，導致「單純靠繼承拿顏色、沒有自己寫color:var(--ink)」的元素（例如標題），會直接繼承到外層（深色模式下的body）已經算好的淺色文字，而不會因為子層重新定義了變數就重新計算一次。修法：在#printOnlyStage、#batchPrintStage、.preview-stage、.export-force-light這幾個容器本身，明確加上color:var(--ink)、background:var(--paper)，讓繼承鏈從容器本身就是正確的淺色版本，往下傳遞才會對。這個修正範圍比標題本身更廣，理論上也會一併修好其他還沒被回報、但同樣屬於「單純繼承顏色」的元素 |
| v1.11.4 | 2026-09-03 | 【緊急修正】修復PNG圖片匯出被深色模式污染的問題（使用者回報）。根本原因：PNG匯出用的離屏容器，是JS動態建立、完全沒有ID或class的一般div，先前設計「預覽/列印強制淺色」的保護機制時，選擇器只涵蓋了#printOnlyStage、#batchPrintStage、.preview-stage這三個，完全沒想到PNG匯出用的是另一個沒有任何識別標記的容器，導致這個保護機制從一開始就沒有涵蓋到PNG匯出——容器本身的背景雖然有寫死白色，但裡面的文字、表格底色等元件顏色，仍然照著當下的深色模式解析，變成白底配深色元件的混亂畫面。修法：幫PNG匯出用到的所有離屏容器（含分段匯出用的個別小容器）統一加上export-force-light這個class，並把先前所有「強制淺色」的保護規則（含變數鎖定、區塊標題列、追蹤表交替底色、延時表、追蹤編號標籤）都補上這個class，已用瀏覽器測試逐一驗證全部正確恢復淺色 |
| v1.11.3 | 2026-09-03 | 修復「所屬大修」選單在深色模式下看不清楚的問題（使用者回報）。查證後發現這個色碼（金色系提示底色）在系統裡總共被8個地方共用，包含大修管理列表中目前作用中項目、議題狀態徽章、片語按鈕hover、檢視/編輯模式按鈕、里程碑編輯提示框等，先前只個別修過2處（議題徽章、追蹤編號標籤），其餘6處都還是寫死淺色。這次改成統一的CSS變數管理（--gold-tint-bg），一次覆蓋全部8處，並同步補上預覽/列印畫面的保護，避免以後再有共用同一色碼的地方被個別遺漏 |
| v1.11.2 | 2026-09-03 | 修復深色模式的3個顯示問題（使用者回報）：(1)格式一/格式二選單文字看不清楚——選單原本只設定了背景色，文字顏色靠瀏覽器自動繼承，改為明確指定文字顏色；(2)分組追蹤表交替底色在深色模式下對比不夠、難以分辨各組——4種顏色改用更明顯的色調差異；(3)延時表底色仍是淺色——延時表其實是用獨立的CSS規則（不是跟A/B/C/D組共用同一套機制），先前做深色模式時完全漏掉這條規則，這次補上深色版本，並確認預覽/列印畫面的保護機制有正確涵蓋到這條新補上的規則 |
| v1.11.1 | 2026-09-03 | 【緊急修正】修復v1.10.7造成的回歸問題：電腦打字時被無預期踢出輸入框。v1.10.7修正「別人的更新打斷正在打字的使用者」這個問題時，誤把「自己剛存的回音」也一併改成「一律套用、觸發重新渲染」，但這樣會導致單純自己一個人打字，只要自動存檔完成、收到自己剛存的回音，畫面就會被整個重畫一次、輸入框失焦，發生頻率遠比原本要修的問題更高（不需要多人同時編輯就會踩到）。修法：自己的回音改回不觸發重新渲染（恢復v1.10.7之前本來就正確的行為），因為自己本地畫面內容本來就是最新的，不需要為了確認而重畫；別人的更新則維持v1.10.7的游標感知判斷不變 |
| v1.11 | 2026-09-03 | 新增深色模式：側邊欄新增切換按鈕，三態循環（自動跟隨系統設定／強制淺色／強制深色），選擇會記在瀏覽器本機，換裝置各自獨立不同步。列印、PDF、PNG匯出、預覽畫面一律維持淺色，不受個人畫面偏好影響——開發過程中測試時發現，部分新增的深色配色是直接寫死色碼（不是走CSS變數），沒有被「匯出強制淺色」的既有保護機制涵蓋到，會導致這些元件（區塊標題列、追蹤表交替底色、追蹤編號標籤）在深色模式下，連匯出結果都被誤染成深色，已在交付前發現並修正，用瀏覽器測試雙向驗證一般編輯畫面與匯出/預覽畫面的顏色互不干擾 |
| v1.10.7 | 2026-09-02 | 修復手機/平板使用者打字時，畫面被無預期重新整理、輸入框失去焦點、螢幕鍵盤突然收起的問題。根本原因：系統原本判斷「能不能套用其他人更新」的邏輯，是用「停止打字超過1.5秒」去猜測使用者是否還在編輯，只要猜測失準（例如打字中停頓思考），就可能被別人的更新打斷畫面；改為直接判斷「游標實際上是否還聚焦在編輯區域裡」，不再用時間去猜，並加上安全上限（60秒），避免游標長時間停留導致更新一直進不來；「複製到延時」功能，補上跟先前「待分類指派」同樣的修正，複製時優先填進延時表現有的空白列，不再無條件新增；CSV匯入新增「工作日期」欄位，顯示在待分類清單方便參考，分類到追蹤表後不會保留；追蹤表「工作項目」欄位加上最小寬度，預覽視窗縮小時不會被壓縮得比「進度」欄位明顯窄很多 |
| v1.10.6 | 2026-09-02 | 徹底修復PDF列印文字被欄位高度限制截斷的問題：v1.10.2、v1.10.4兩次修正都是想辦法把textarea的高度算準，但這個做法依賴「準確抓到瀏覽器套用列印樣式的時間點」，沒有100%保證，實測仍會被截斷。這次改為根本做法：列印時不再直接印互動畫面本身，改成比照PNG匯出的做法，先把所有輸入框轉成純文字（天生「有多少內容長多高」，不需要用JS計算高度），完全避開這個問題；批次列印原本只是把輸入框設為唯讀（不是轉純文字），也一併發現並修正同樣的潛在風險；危險等級下拉選單的裝飾性箭頭圖示，也改用CSS隱藏，不再出現在列印結果裡；待分類項目指派到追蹤表時，改為優先填進現有的空白列（例如新分組預設留的那一列），不再無條件只在最後面新增，避免第一列一直空著 |
| v1.10.5 | 2026-09-02 | 修復PNG匯出在電腦（尤其Windows 11搭配新版瀏覽器）誤觸發Web Share系統分享面板、無法直接下載的問題。v1.10.4新增Web Share功能時，只檢查瀏覽器技術上支不支援分享，沒有限定只在手機裝置上啟用；但Windows 11新版瀏覽器技術上也支援這個功能，導致電腦端也被導去跳分享面板，而非原本規劃「電腦端維持直接下載」的行為。修法：新增手機裝置判斷，Web Share僅在確認是手機時才啟用，電腦（含Windows/Mac）一律維持直接下載 |
| v1.10.4 | 2026-09-02 | 修復PDF列印文字仍被欄位高度限制、內容超出被裁切看不到的問題：改為列印前重新計算每個文字框該有的高度（確保用列印當下真正的欄寬去算，而不是沿用打字/載入資料當下可能已經對不上的舊高度），並將原本會直接裁切內容的樣式規則拿掉作為保險，即使高度仍算得不夠精準，文字也只會超出邊框顯示、不會整個消失；PNG圖片匯出改用Web Share API交付，手機（或支援的瀏覽器）會直接跳出系統分享面板一次分享所有圖片到LINE/微信等應用程式，不支援時單張直接下載、多張則顯示清單逐張手動下載，避免部分手機瀏覽器對連續自動下載的限制導致只有第一張成功 |
| v1.10.3 | 2026-09-02 | 追蹤表「選取/排序」欄位（含表頭）在PDF與PNG匯出時完全移除，不再留一個空欄佔版面；PDF透過CSS隱藏整欄，PNG匯出則是在重組表格時直接排除該欄位，兩者皆已測試確認欄位對齊、其餘內容不受影響 |
| v1.10.2 | 2026-09-02 | 修復PDF匯出時，追蹤表「承攬商」「工作項目」等欄位文字被截斷、顯示不完整的問題。根本原因有兩個：一是列印CSS沒有套用跟預覽畫面一樣的table-layout:auto修正，導致欄位寬度計算跟文字高度對不上；二是「承攬商」欄位原本用單行的input元素，不像旁邊的進度/備註欄位是能自動換行的textarea，內容較長時會被截斷。兩處都已修正，承攬商欄位改為textarea並支援自動換行 |
| v1.10.1 | 2026-09-02 | 修復格式二PNG/PDF匯出的4個問題：(1)追蹤表勾選框在PDF被印出、PNG匯出誤顯示"on"文字，已改為直接排除；(2)【嚴重】分段PNG匯出時，A/B組的項目內容大範圍消失、出現大片空白——根本原因是重組區塊時，分組標籤沒有補上原本該有的寬度限制，導致排版計算失控（實測異常撐高到3354px，正常應為285px），已修正；(3)待分類項目在PDF匯出時被印出，已排除在匯出範圍外；(4)分組內容文字未呈現與問題(2)同一根源，一併修復。此次修復經過實際截圖比對與多輪端對端測試（含真實html2canvas引擎）才定位到根本原因 |
| v1.10 | 2026-09-01 | 新增多人協作衝突處理機制：工具列新增「存檔」按鈕，可手動確認存檔狀態；系統會偵測分頁切背景過久/網路中斷等「可能跟資料庫脫節」的訊號，存檔時如果偵測到風險且對方確實存過有差異的內容，會跳出比較畫面讓使用者選擇採用對方版本或用自己的版本覆蓋，覆蓋前會自動把對方版本存成歷史紀錄避免真的遺失資料；正常連線不中斷的情況下，多人同時編輯不會被誤判、不受干擾；「誰在線上」總覽開放給editor查看（原本只有admin）；單篇日誌內「正在編輯」提示改為徽章樣式含呼吸動畫，新加入編輯時額外跳出浮動提示；格式二A組/B組追蹤表新增「回待分類」「複製到延時」，對應誤分類修正與延時額外追蹤兩種實際工作情境 |
| v1.9.8 | 2026-08-30 | 修復今天還沒有日誌、畫面停留在空白提示狀態時，背景的「誰在線上」心跳機制每4秒嘗試用空值組出無效資料路徑、跳出「未預期的錯誤」訊息的問題；根本原因是v1.9.6/v1.9.7刻意拉長了「今天還沒建立日誌」這個畫面停留的時間，意外讓這個原本就存在、但很少被觸發的舊漏洞有機會被踩到；修法沿用同一函式裡另外兩處早已存在的防呆寫法 |
| v1.9.7 | 2026-08-30 | 修復刪除「今天」的日誌後，會被自動重新建立一篇空白日誌的問題；同時修正「跳到今天」按鈕，一般成員/管理員點擊時如果今天還沒有日誌，改為跳出確認提示詢問要不要新增，不再直接自動建立（v1.9.6只修正了登入時的入口，這兩處是後續盤點時發現同樣繞過保護的另外兩個入口，修法沿用同一套已測試過的邏輯） |
| v1.9.6 | 2026-08-30 | 登入時不再自動建立今天的空白日誌：一般成員/管理員登入時，如果今天還沒有日誌，改為跳出確認提示詢問要不要新增，選擇不要則停留在空白畫面（可從側邊欄選擇瀏覽過去日期），避免單純登入查看，就順手產生不一定會用到的空白日誌；操作員/檢視員行為不受影響 |
| v1.9.5 | 2026-08-29 | 修復操作員/檢視員角色在檢視「今天」日期的日誌時，唯讀限制失效、變成可以編輯的問題（根本原因：切換日期時，畫面唯讀狀態的判斷式只看日期是不是今天，沒有一併考慮角色，導致每次載入今天的日誌都會把角色本該有的唯讀限制覆蓋掉；過去日期則因為日期判斷本身就是唯讀，剛好沒有暴露這個問題）；同時把角色唯讀判斷整理成共用函式，避免多處各自定義、日後修改容易遺漏 |
| v1.9.4 | 2026-08-29 | 修復唯讀模式（含檢視員角色、檢視過去日期）下，部分較新的互動功能沒有正確檢查唯讀狀態、仍會嘗試觸發存檔導致跳出permission-denied錯誤訊息的問題：班別建議選項點擊、電腦端Enter快速新增下一筆（格式一/格式二）、時刻欄位失焦自動格式化，共4處補上唯讀防護；根本原因是這些功能繞過瀏覽器原生的readOnly屬性保護（直接用程式碼操作欄位值並觸發存檔），不受原本「輸入框設成readOnly」這層防護涵蓋 |
| v1.9.3 | 2026-08-29 | 修復操作員/檢視員可以進入「大修管理」畫面編輯的問題（先前遺漏未納入唯讀角色隱藏清單，資料庫規則本身已擋下實際寫入，此為畫面體驗修正）；格式二分組數量上限預設值從4組調整為6組（下限維持2組），適用於新建立的大修 |
| v1.9.2 | 2026-08-29 | 修復確認彈窗文字不對題的問題：分段匯出圖片、新增日誌的確認提示，原本誤用了「刪除」專用的紅色警示按鈕與「確定刪除」文字（借用共用彈窗時沒有調整），改為可自訂按鈕文字與樣式，非破壞性動作（新增、匯出）改用中性深色樣式與對應文字，真正的刪除動作維持原本紅色警示樣式不變 |
| v1.9.1 | 2026-08-29 | 修復PNG匯出時，時刻欄位轉純文字後被強制撐成滿版寬度、排擠旁邊工作項目文字的問題（純文字轉換邏輯原本一律套用寬度100%，改為保留元件原本實際寬度）；PNG匯出解析度從300dpi調整為200dpi |
| v1.9 | 2026-08-29 | PNG圖片匯出改為分段輸出多張圖，取代先前「內容長就降低解析度」的做法，改成內容長時自動切成好幾張圖片依序下載，每張都維持同樣的高畫質不打折；分段點對齊項目/表格列的自然邊界，不會切斷任何內容；表格/清單表頭每張重複、標題與天數計算列只在第一張；每張圖片印上日誌名稱與頁碼（例如1/3）方便辨識順序；下載前會先提示將分成幾張圖片，確認後才開始下載；格式一、格式二皆支援，過程中修正了兩個影響匯出正確性的計算問題（迷你圖片留白高度未列入預算、CSS版面排版特性導致部分標題高度被誤判過大） |
| v1.8.2 | 2026-08-28 | 修復班別欄位下拉選單在iOS/Android與部分電腦瀏覽器上無法正常顯示選項的問題（原本用瀏覽器原生datalist功能，改為自製下拉選單，不依賴瀏覽器原生支援）；PNG圖片匯出改為依內容長度動態調整解析度，內容短維持高畫質、內容長自動降低解析度，避免超過瀏覽器畫布限制被裁切；內容過長時不勉強產生圖片，改為提示改用列印/PDF或DOCX |
| v1.8.1 | 2026-08-28 | 修復檢視模式/預覽/PNG匯出時，空白追蹤編號仍殘留虛線框的問題；修復列印時「更多功能」展開面板未被隱藏的問題；四個里程碑天數（大修開始/交承商/PSSR/開爐）顯示順序統一調整為符合實際時間先後順序（原本PSSR跟開爐順序顛倒）；格式一時刻欄位改為純文字輸入，可直接打數字自動格式化成HH:MM，不用再處理瀏覽器原生上午/下午格式；班別欄位改為下拉建議（一班/二班/三班）+可自訂輸入，新增區塊預設值改為二班；電腦端工作項目文字框支援Enter快速新增下一筆、Shift+Enter換行（手機不受影響） |
| v1.8 | 2026-08-28 | 新增「儀表板總覽」（大修進度、最近30天記錄狀況熱力圖、未結案議題快覽、分組工作量分佈、追蹤編號活躍度）；新增日誌依所屬大修的交承商日期自動決定預設格式；操作員/檢視員可自由切換格式一/格式二顯示，純畫面選擇不影響資料庫與其他人；修復格式一PDF/PNG/XLSX匯出的標題重複、缺外框、缺標題問題；里程碑日期未填時改為完全空白；統一單篇匯出檔名加上日期；工具列分層，常用功能保留顯眼位置，進階功能收進「更多功能」；使用說明新增「5分鐘上手」摘要；登入頁新增可展開的系統簡短介紹 |
| v1.7.2 | 2026-08-28 | 修復列印/預覽會印出空白項目提示文字的問題（格式一、格式二）；修復登出時偶爾出現permission-denied錯誤訊息的問題（背景監聽未正確關閉）；操作員/檢視員角色補上隱藏「從昨天延續」按鈕與修正「匯入」殘留標籤文字；格式二項目清單（轄區工作/分組項目/明日預計/每日檢討）新增↑↓上下移動功能；每日/今日檢討新增「納入匯出」勾選，可個別控制單篇匯出結果是否包含，批次匯出另有統一設定覆蓋各天設定，JSON備份不受影響 |
| v1.7.1 | 2026-08-27 | 使用說明裡描述語音輸入按鈕的文字，改成不使用表情符號，避免跟實際已改為線條圖示的按鈕視覺不一致 |
| v1.7 | 2026-08-27 | 正式整合語音輸入功能：格式一/格式二工作項目文字框旁新增麥克風按鈕，點擊即可語音輸入、辨識文字自動插入游標位置；已實測iPhone/Android的一般瀏覽器皆可運作；瀏覽器不支援時按鈕不會出現；僅在編輯畫面顯示，不影響預覽/匯出結果 |
| v1.6 | 2026-08-26 | 格式二分組數量上下限改為可由「大修管理」設定（預設2~4組），跟著每次大修各自調整；達到上/下限時「+新增分組」「✕刪除分組」按鈕會自動隱藏，並附有防呆檢查 |
| v1.5.1 | 2026-08-26 | 議題追蹤板的「建立議題」追蹤編號輸入框，加入自動建議功能（重用既有的已知編號清單），輸入時會篩選出符合的既有編號供點選，跟日常項目輸入的體驗一致 |
| v1.5 | 2026-08-26 | 格式二分組數量改為可自訂（原本固定A/B兩組，現在可新增/刪除，不限數量），分組由左右並排改為由上到下依序排列；新增日誌內部資料結構調整，舊格式日誌開啟時自動於背景轉換，資料不受影響；DOCX/XLSX匯出、CSV分類按鈕、追蹤編號搜尋、議題追蹤板、從昨天延續、編輯歷史差異比對等功能同步更新支援任意分組數量；修復追蹤表交替底色因分組ID改變而失效的問題 |
| v1.4.2 | 2026-08-26 | 追蹤編號改為標籤式輸入介面（類似筆記軟體），已填的編號變成可個別刪除的膠囊標籤；輸入時會自動建議系統裡出現過的編號，不用每次手動打完整文字 |
| v1.4.1 | 2026-08-26 | 追蹤編號欄位改為支援填多個（逗號分隔），一筆記錄可以同時歸進多個議題的時間軸，不再限制只能對應單一議題 |
| v1.4 | 2026-08-26 | 新增「議題追蹤板」：可正式列管需要追到結案的問題或工程進度，狀態分待處理/進行中/已結案；不需要額外的「連結」操作，直接沿用既有的追蹤編號機制，日誌項目填了相同編號就會自動彙整進時間軸；移除先前無實際作用的語音輸入提示圖示（使用說明保留相關小技巧文字） |
| v1.3.1 | 2026-08-26 | 格式一時刻欄位改為所見即所得（預設不佔位置、有值才顯示在文字最前面、可一鍵清空）；天數計算列全面修正為「還沒到/當天/已過」三態文字，避免出現不合理的負數，新增「開爐」欄位，版面改兩排兩欄（格式一/格式二/DOCX/XLSX皆同步）；新增「操作員」角色（唯讀但可匯出）；「檢視員」重新定義為唯讀且不可匯出（demo/展示用）；工作項目文字框旁新增語音輸入提示；里程碑編輯面板加入不影響大修設定的提示文字；版權宣告更新為 CCHBase |
| v1.3 | 2026-08-26 | 新增批次 JSON 匯出／匯入（異地備份完整閉環），可依日期區間打包多篇日誌與對應大修資料成 zip，之後可整包還原；大修管理新增「一鍵匯出這次大修的所有日誌」捷徑；格式一工作項目新增選填的「時刻」欄位，超出所屬班別時段（含前後1小時緩衝）會變色提醒 |
| v1.2.1 | 2026-08-26 | 大修管理架構調整：每篇日誌新增「所屬大修」選單，改為唯一決定日誌歸屬的地方；側邊欄的大修列收斂為純管理用途（新增大修／編輯里程碑），不再影響新日誌的歸屬；新增日誌預設帶入「最近建立的大修」 |
| v1.2 | 2026-08-26 | 新增「大修」實體管理（可命名、可切換、里程碑日期統一管理）；格式一新增大修天數計算列與標題區塊（僅畫面/含匯出，依版本逐步調整）；修復格式二 A/B 組名稱分散於4處、各自不同步的問題；修復預覽/匯出標題重複顯示的問題 |
| v1.1 | 2026-08-25 | 預覽在手機窄螢幕下的欄寬修復（格式一/格式二）；匯出時空白追蹤編號不再顯示；管理員可查看目前團隊誰在線上；側邊欄日誌清單支援日期區間篩選 |
| v1.0 | 2026-08-25 | 首次正式發布：雙格式日誌、多人協作、角色權限、多格式匯出入、批次匯出、編輯歷史與差異比對、離線容錯、常用片語、追蹤編號與延續昨天等完整功能集 |
這個瀏覽器不支援一次分享多張圖片，麻煩點擊下方每一個連結分別下載：
你的畫面曾經有一段時間可能沒有跟資料庫保持同步（例如切到背景太久、或網路曾經中斷），而資料庫上已經有其他人存過檔。以下是差異內容，請確認要保留哪一邊：
議題會自動彙整所有日誌裡用了相同「追蹤編號」的項目，適合正式列管需要追到結案的問題或工程進度。
建立議題前先看看有沒有已經在用的相近編號，避免同一件事被拆成好幾個不同標籤。
新增大修、或點選下方項目檢視/編輯該次大修的里程碑日期。日誌本身要歸屬哪一次大修，請在該篇日誌上方的「所屬大修」選單設定。
+ 新增一次大修：
這裡設定的是這次大修本身的里程碑日期。日誌要歸屬哪一次大修，請到該篇日誌上方的「所屬大修」選單指定；新增日誌時會自動帶入「最近建立的大修」的設定。已建立的日誌不受追溯影響。
格式二「分組」（例如A組/B組）的數量上下限，套用在所屬這次大修的日誌上：
最近 2 分鐘內有活動的帳號：
勾選昨天還沒完成、想接續到今天的項目：
選擇日期範圍，把範圍內每一天的日誌依序合併成一份報告。
先點一下要輸入的文字框，再點下方片語插入到游標位置。
把整批片語貼進下方文字框，一行一句（例如從Excel或備忘錄複製過來）。
選擇要建立日誌的日期：
多人協作的線上工作日誌系統，用來記錄每日工作紀要、追蹤大修進度。
帳號請洽管理員申請