秘密花園網站版本紀錄日誌

v0.1a1-1

修改時間：2026 05/10

建立「開花網站」前身版本。網站核心體驗以八色種子進入花園為主，使用者可選擇不同顏色的種子，讓種子綻放成花。此版本已具備基本的開花互動概念，並以《Welcome to the Secret Garden》作為背景音樂，讓使用者在進入網站時能先感受到秘密花園的世界觀氛圍。每一種顏色的種子亦搭配不同祝福語，形成後續「花語」、「顏色音樂」與「情緒陪伴」架構的原型。

v0.1a2-1

修改時間：2026 05/14

延續 v0.1a1 的開花網站原型，將進入花園前的八色種子改為八色花瓣形式，使視覺更接近花朵與花園意象。新增花朵綻放時播放相應開花音效與顏色音樂的機制，此時紅、橙、黃、綠已具備音效與音樂，藍、靛、紫、灰則仍保留待補素材。每個花朵右下方新增花語圖卡，讓開花互動與花語收藏概念產生連結。

v0.1b-1

修改時間：2026 05/27

建立全新的「秘密花園沉浸式作品入口網站」初版。網站主體從單一開花體驗擴展為完整藝術企劃入口，包含首頁、關於秘密花園、線上花園入口、音樂／專輯宇宙、小花卡圖鑑、團隊與園丁們、活動紀錄、合作與聯絡等區域。首頁被設計為「進入花園的感覺」而非傳統資訊頁，包含花瓣飄落、微風粒子、八色入口、世界觀句子與音樂企劃氛圍。此版本確立網站不是學生作業式介紹頁，而是互動式藝術 IP 入口。

v0.2b1-1

修改時間：2026 05/27

重製「小花卡圖鑑」內容。將原本的小卡替換為八種花與八種顏色對應：山茶花／紅、金盞花／橙、向日葵／黃、鈴蘭／綠、藍繡球／藍、鳶尾／靛、薰衣草／紫、銀葉菊／灰。卡片背面改為使用提供的對應圖片素材，翻面後單純顯示完整圖卡圖片。未翻開時只顯示花朵圖案與顏色文字，移除花種與花語文字，讓正面更像可互動的收藏卡入口。翻卡互動由原本游標懸停自動翻頁，改為點擊後才翻頁；再次點擊則翻回正面。懸停時新增外框選取效果，提示使用者卡片可以互動。

v0.2b1-2

修改時間：2026 05/28

在花卡圖鑑區域右上方新增「翻開全部／關閉全部」按鈕。按鈕位置依照使用者提供的截圖紅框位置放置，靠近右側卡片上方，讓大量瀏覽花卡時可以快速打開或收起所有卡片。按鈕狀態會依目前卡片是否全部打開而切換文字。

v0.2b1-3

修改時間：2026 05/28

修正「翻開全部／關閉全部」按鈕的碰撞箱問題。原先只有特定角度或區域能成功點擊，導致使用者誤以為按鈕失效。此修改擴大可點擊範圍並調整層級與互動區，使按鈕能更容易被選取與觸發。

v0.2b2-1

修改時間：2026 05/28

新增深色／淺色主題切換系統。原先網站以深色花園作為主要視覺，新增淺色模式後，首頁主視覺更換為提供的淺色秘密花園背景圖，並依背景色調重新調整整站主題色。包含導覽列、文字、卡片、按鈕、面板、花瓣與背景對比等，使淺色模式下文字仍可清楚閱讀。新增右下角小花形狀的主題切換按鈕，深色模式時小花顯示淺色主題代表色，淺色模式時小花顯示深色主題代表色，按鈕下方顯示按下後會切換到的「深色／淺色」文字。網站預設顯示模式改為淺色。

v0.2b2-2

修改時間：2026 05/28

修正淺色模式下部分文字背景區域可讀性不足的問題。針對顏色文字或花朵旁的標籤，增加更柔和且適合淺色背景的半透明背景，避免文字與背景照片或花瓣重疊後難以辨識。主題切換時新增交疊式過渡動畫，降低突然換色的硬直感。右下角主題切換小花移除可見外框，改為去背效果並保留微微發光，視覺上更接近首頁下方八色小花朵。

v0.3b1-2

修改時間：2026 05/28

將舊版「開花網站」回歸到新版秘密花園網站中，放在「關於秘密花園」下方，命名為「開花體驗」。使用者可以選擇一種顏色，讓種子綻放成一朵花，並搭配對應的開花音效與顏色音樂。此階段的開花體驗仍是獨立播放系統，由該區右上角按鈕控制音樂播放與停止；藍、靛、紫、灰的開花音效仍未完成，以紅、橙、黃、綠音效暫時代替，且紫色音樂仍缺少。

v0.3b1-3

修改時間：2026 05/28

將「線上花園入口」更名為「種下一些花」。此區域的八色名稱同步改為與「小花卡圖鑑」一致，並將「Blooming Now」改為「Blooming」。這讓線上花園與八色花卡之間的命名系統更一致，也使網站各區域開始朝同一套花色世界觀整合。

v0.3b1-4

修改時間：2026 05/28

將「音樂／專輯宇宙」更名為「專輯聆聽」，並導入十首音樂的播放控制。此版新增上一首、下一首、暫停／播放與播放進度條，也加入作曲者、曲目時長、曲目編號與播放中動畫等資訊。使用者提供的第一首 Welcome to the Secret Garden 與第十首 Secret Flower DEMO 素材也歸入此專輯播放系統。

v0.3b1-5

修改時間：2026 05/28

將右上角「背景音樂」功能接上「專輯聆聽」播放系統，讓全站背景音樂可以透過右上角區域控制上一首、下一首與暫停／播放。不過在 v0.3b1 階段，這套背景音樂系統仍獨立於「開花體驗」播放系統，尚未與花朵綻放選色整合。

v0.3b1-6

修改時間：2026 05/28

將「小花卡圖鑑」更名為「花語圖鑑卡」，並將 Gray｜灰的色號從 #7f877d 調整為 #acbe9a。此版讓花卡名稱與後續網站主選單一致，灰色也更接近秘密花園中較柔和的銀葉菊色彩。

v0.3b1-7

修改時間：2026 05/28

更新「花園的園丁們」頁面內容。將 Music Gardener 改為「李岳鴒｜專案總召」，職位改為「製作人／作曲家／行政／視覺設計／開花網頁設計」，喜歡的花改為鳶尾，喜歡的聲音改為蟲鳴鳥啼，並替換為提供的大頭照。將 Visual Gardener 改為「陳映里｜專案副召」，職位改為「作曲家／聲景錄音／聲音設計／攝影紀錄／網站架設」，喜歡的花改為藍繡球，喜歡的聲音改為風拂大地，並替換大頭照。將 Interactive Gardener 改為「林書磊｜執行長」，職位改為「技術控管／作曲家／聲音設計／聲景錄音／線上展間架設」，喜歡的花改為山茶花，喜歡的聲音改為微雨浸地，並替換大頭照。整體讓團隊介紹從角色代稱轉為真實專案成員資訊。

v0.3b1-8

修改時間：2026 05/28

將「合作與聯絡」中的 Email 按鈕連線至秘密花園信箱，讓使用者可以透過網站直接聯絡團隊。此版確立網站不只是作品展示，也能作為後續合作、展演與聯繫的入口。

v0.3b1-9

修改時間：2026 05/28

v0.3b1 是 2026 05/28 創意專案簡報使用版本。此版主要優化首頁副標題顯示方式，並將首頁下方八色花的色號校準至與花卡色號一致，讓首頁入口、花卡與後續互動體驗的色彩系統開始統一。

v0.3b2-2

修改時間：2026 05/28

設計右上角小音樂播放器。當頁面離開「專輯聆聽」區域時，大型播放控制縮小並移動到右上角，取代原本 Sound 控制區域，但保留播放時起伏的顏色條。小播放器持續顯示曲名，並與專輯聆聽頁面播放狀態連動。使用者在其他頁面操作右上角播放器，也會同步更新專輯聆聽的選曲狀態。

v0.3b2-3

修改時間：2026 05/28

優化右上角小播放器懸浮展開行為。當電腦游標懸浮在右上角曲名區域時，自動展開較精細播放控制介面，包含暫停／開始、上一首、下一首、小型進度條與完整曲名。曲名過長時以滾動顯示。選單只在游標懸浮時開啟，點擊樂曲標題可收合，游標離開超過三秒也自動收合。行動裝置則改為點擊開啟、點擊標題關閉，不自動收合。播放器內新增可捲動至「專輯聆聽」頁面的圖示。

v0.3b2-4

修改時間：2026 05/29

優化專輯聆聽曲目卡的花朵背景。當游標懸浮在某首歌曲按鍵上，按鈕右側空白處浮現對應顏色音樂的花朵，選取後持續顯示。背景花朵使用花語圖鑑卡素材，但只保留花朵本身，不顯示字卡文字。花朵傾斜約 30 度向左擺頭，並保留出現與消失動畫。

v0.3b2-5

修改時間：2026 05/29

修正花朵背景被圓形外框裁切與遮字問題。將原本花語卡片進一步去背，只留下花朵本身。花朵加入按鈕背景後不遮住文字，邊緣以漸層消失處理。選取底色新增淡入與淡出動畫。大型 Now Playing 播放區也加入目前對應的花朵與底色。小播放器刪除 Sound 文字，滑鼠離開控制區域即自動收合，控制器開啟時再按一次正在播放按鈕也會收起。導覽列保持置中，不再被右上角曲名長度推移。

v0.3b2-6

修改時間：2026 05/29

修正右上角播放器互動熱區與導覽列衝突。原本小播放器 hover 觸發區域延伸到 About、Bloom、Garden 等導覽列，導致導覽按鈕無法點擊。重新限制觸發範圍，並依使用者紅框設定可維持選單開啟的安全區域，避免游標從播放按鈕移到控制器途中選單關閉。專輯聆聽中的花瓣起伏效果移到曲目卡右上角，並改為簡化 EQ 直條線條波形。

v0.3b2-7

修改時間：2026 05/29

排查 Chrome 音訊與 EQ 問題。使用者回報 Safari 有聲音且 EQ 會動，但 Chrome 無聲且 EQ 不動。逐步調整音訊與 EQ 串接邏輯，使 Chrome 也能播放背景音樂。後續補上「觸碰以控制音樂」提示，於網站初次載入時在播放器下方以箭頭與文字提示使用者，提示淡入、停留三秒後淡出，並在深色／淺色模式下使用不同的柔邊半透明提示背景。

v0.3b2-8

修改時間：2026 05/29

優化操作提示與 EQ 顯示。放大「觸碰以控制音樂」提示文字，拉開提示與控制器距離，讓箭頭有足夠空間。提示背景改為真正柔邊，不顯示明顯外框。EQ 顏色加深，拿掉 EQ 下方黑框，改為沒有黑框但仍清楚可辨的線條。處理花朵背景與 EQ 重疊問題，裁切花朵避免遮擋 EQ 區域，並使用柔邊切口。

v0.3b2-9

修改時間：2026 05/29

調整曲目卡花朵顯示區域。依使用者紅框，讓花朵顯示區域更大，盡可能填滿指定框內，並延長暈邊漸層，避免使用者看見外框輪廓。操作提示改為只在使用者初次進入網站或重新整理後顯示一次；若三秒後自動消失，或使用者在提示顯示期間開啟控制器使提示關閉，後續都不再自動出現，直到重新整理頁面。

v0.3b2-10

修改時間：2026 05/29

反覆調整花朵背景裁切與暈邊效果。先取消每朵花的暈邊淡出，嘗試完整顯示花朵；後續又依使用者提供的前一版 Archive.zip，將花卉背景恢復為先前版本效果，只處理花的背景圖片與暈邊，其餘新版功能與介面維持不變。

v0.3b2-11

修改時間：2026 05/29

調整音樂淡入淡出邏輯。播放暫停時加入淡出，淡入與淡出皆控制在 0.3 秒。若音檔是從頭開始播放，包括自動播放、使用者選擇歌曲播放、上一首播完後換下一首等，不加入播放淡入效果，以免從頭開始播放時音量起始不自然。後續補上按下一首／上一首時，當前音樂停止處也要 0.3 秒淡出；使用者手動切換音樂時，上一首歌同樣要有淡出效果。

v0.3b3t-1

修改時間：2026 05/29

修正專輯聆聽 EQ 動態顯示。使用者回報 Chrome、手機版或直接開 HTML 時 EQ 顯示與實際播放狀態不一致，因此調整 EQ 分析、顯示顏色、手機支援與黑框移除等細節。此版本主要以測試與修復 EQ 為主，讓播放中視覺回饋更穩定。

v0.3b4-1

修改時間：2026 05/29

修正專輯聆聽曲目背景花朵圖片顯示問題。花朵背景從花語卡素材抽出後，處理去背、柔邊、選取淡入淡出、花朵不遮字、主播放器同步顯示等問題。此版本也優化背景音樂控制器操作提示的水平位置與行為模式，讓提示不再反覆出現或偏離播放框。

v0.3b4-2

修改時間：2026 05/29

優化專輯聆聽播放事件。將暫停、續播、切歌、自動下一首等狀態下的音量變化邏輯整理為一致流程。暫停與切換歌曲會淡出，從頭播放的新曲不淡入，避免啟動瞬間被過度柔化。此修改讓音樂播放器在不同控制入口之間行為一致。

v0.3b5-1

修改時間：2026 05/29

依網站內「活動紀錄」校準：v0.3b5 是「開花體驗」顯示與跳轉的第一輪集中修正。此版處理彩色花瓣被說明文字蓋過、花蕊與花瓣錯位等顯示問題，並將八色種子位置改為置中。這些修正讓開花體驗從功能可用，往視覺更穩定的狀態推進。

v0.3b5-2

修改時間：2026 05/29

新增「開花體驗」右下角花語小卡連結至「花語圖鑑卡」的功能。使用者點擊花朵旁的卡牌後，頁面會跳轉到對應的花語圖鑑卡，並讓對應卡牌自動翻開。後續也調整為延遲翻開，避免跳轉完成時卡牌已經翻好，讓使用者能看見翻頁動作。

v0.3b6-1

修改時間：2026 05/31

新增與調整主頁 Logo 系統。首頁加入大型秘密花園 Logo，右上角導覽品牌也替換為使用者提供的無文字 Logo 圖像。首頁時品牌文字顯示 Welcome，其他頁面顯示 Secret Garden，並加入文字切換動畫。Logo 在後續調整中放大三倍，並重新平衡 Logo、Immersive Experience 與 Secret Garden 標題間距。

v0.3b6-2

修改時間：2026 05/31

新增種子游標。當系統游標進入網站區域，原本游標隱藏，替換為圓形種子游標。每次進入網站會隨機改變顏色，點擊時種子縮小並加深，按壓與恢復都有動畫。當游標碰到可互動元素時，種子會長出小草，離開互動區後小草縮回。此版本也修正淺色模式下播放器進度條仍為深色的問題。

v0.3b6-3

修改時間：2026 05/31

修正種子游標定位與系統手指游標干擾。調整自訂游標實際位置，讓網頁內種子游標與系統游標位置對齊。移除種子游標影子。將整個「種下一些花」種花區設為會讓種子游標長草的互動區。後續關閉系統內建手指游標，確保全站互動時都只顯示自訂種子游標。

v0.3b6-4

修改時間：2026 05/31

重新設計小音樂控制器的跳轉方式。恢復在控制器開啟狀態下，再按一次正在播放欄位即可關閉控制器。移除原本獨立的「跳到專輯聆聽」按鈕，改為點擊樂曲名稱即可跳轉至專輯聆聽位置，並在曲名旁加入可導向的提示圖示，避免使用者不知道曲名可被點擊。此版也修正背景音樂控制器為永恆顯示，讓即使位於專輯聆聽區域時，右上角仍保留正在播放介面與小控制器。

v0.3b6-5

修改時間：2026 05/31

將「開花體驗」更名為「花朵綻放」，並將花朵綻放播放系統與「專輯聆聽」播放系統整合。使用者選擇某一朵花時，先播放對應開花音效，再開始播放該顏色音樂；這首音樂會同步接入右上角正在播放、小音樂控制器與專輯聆聽選取狀態。若音樂自動播放至下一首，花朵會切換至下一個顏色並播放開花動畫，但不重播開花音效。此版也補上藍、靛、紫、灰開花音效素材，並保留「秘密花」音效供後續使用。

v0.3b6-6

修改時間：2026 05/31

優化「花朵綻放」初始彩色花朵的花瓣距離。此版不再重複記錄 v0.3b5 已處理的「提示文字遮住彩色花」與「花蕊花瓣對齊」問題，而是專注於使用者後續提出的彩色花瓣靠近花蕊需求。修改後，未綻放任何花朵時顯示的彩色花朵花瓣更往花蕊中央靠攏，整體結構更接近其他單色花朵。

v0.3b6-7

修改時間：2026 05/31

優化「專輯聆聽」區域。新增作曲家的英文藝名資訊：李岳鴒為 ZEROYUEH，林書磊為 Aries Lin，陳映里為 Osmond Chen。調整樂曲選擇卡片佈局，將作曲者移至右上角、時間獨立顯示，修正文字換行與溢出問題。將每張小卡中的 EQ 移到大型 Now Playing 播放區，並修正淺色模式下主播放器進度條仍是深色的問題。

v0.3b6-8

修改時間：2026 05/31

調整合作與聯絡區 Spotify 行為。點擊 Spotify 按鈕不再直接導向外部連結，而是跳出「Comming Soon」彈窗，提示專輯尚未上架 Spotify。後續修正彈窗圖層與游標層級，使自訂游標在彈窗上方仍可見；再修正游標消失問題，確保彈窗期間仍能辨識游標位置。

v0.3b6-9

修改時間：2026 05/31

調整「關於秘密花園」區域中的關鍵詞排版。將 Music、Emotion、Bloom、Healing、Memory、Color 等字縮小，並增加左右留白，避免右下角主題切換小花與文字卡在一起。此修改讓大型文字列在桌面縮放下更穩定，也避免浮動控制元件遮擋內容。

v0.3b6-10

修改時間：2026 05/31

微調「花園的園丁們」職位文字換行。陳映里的職位中，「攝影紀錄」原本被拆成「攝」在上一行、「影紀錄」在下一行，修正為整個詞一起換到下一行。林書磊的「聲景錄音」也同樣修正，避免「聲」單獨留在上一行。此修改提升中文職稱排版完整性與專業感。

v0.3b7t-1

修改時間：2026 06/01

重新整理專案內音效與音樂檔案對應。使用者重新整理音效與音樂素材後，重新依花朵與顏色資訊將各種音檔對應至所需位置。確保開花音效、顏色音樂與專輯曲目仍能正確連到各自素材。

v0.3b7t-2

修改時間：2026 06/01

重寫與調整 EQ 引擎。使用者指出原本 EQ 對音樂起伏與頻率分配反應不準，要求橫軸由左至右代表低頻到高頻，縱軸由下至上代表音量大小。嘗試建立更接近音訊頻譜的 EQ 顯示方式，使波形不只是裝飾，而能回應實際音訊能量。

v0.3b8-1

修改時間：2026 06/02

修復音樂播放系統癱瘓。使用者回報十首專輯音樂完全無法播放，但開花音效仍正常，判斷問題集中在背景音樂／專輯播放系統。修正音樂播放功能後，曲目可再次正常播放。隨後修復 EQ 沒有動靜的問題，讓播放視覺回饋恢復。

v0.3b8-2

修改時間：2026 06/02

新增「活動紀錄」中的網站版本欄位。於活動紀錄三個項目下方新增「網站版本」頁面項目，副標顯示當前網站版本，最右側以箭頭提示可點擊。點擊後欄位變成「網站版本紀錄」，副標改為「在此處查看網站更新紀錄」，欄位展開並顯示版本紀錄內容。初期建立版本紀錄空位，以便後續自行填寫更新歷史。

v0.3b8-3

修改時間：2026 06/02

優化網站版本紀錄的視覺與結構。使「網站版本／網站版本紀錄」文字樣式、大小與顏色與活動紀錄前三個欄位一致。版本紀錄格子被包覆在「網站版本紀錄」的大格子中，版本號改用與頂部導覽列相同的 sans 字體。右側箭頭改為更細、開腳約 90 度且無圓形外框。後續又修正發布日期顏色、雙層箭頭錯位、導覽列當前頁判斷，以及內層下拉選單展開時頁面不應抖動或被往上推的問題。

v0.3b9-1

修改時間：2026 06/02

優化網站讀取速度。此版調整初始載入策略，降低過多音訊、圖片或動畫資源在一開始同時載入造成的等待時間，讓網站上傳後的首次開啟更穩定。

v0.3b9-2

修改時間：2026 06/02

優化音樂「紫」的音量平衡。此調整讓專輯聆聽中各曲目之間的音量落差更小，避免使用者切換到紫色曲目時感受到過度突兀的音量差異。

v0.3b9-3

修改時間：2026 06/02

修正「活動紀錄」中目前版本號在下拉式選單收合後會異常回到舊版的錯誤。將目前版本集中為程式碼常數，日後只要修改該常數即可同步更新網頁顯示，不會因收合選單而回到先前版本。

v0.3b9-4

修改時間：2026 06/02

將網站部署來源從 netlify.com 遷移至 github.io。此項為使用者自行更新並寫入網站內「活動紀錄」的內容，本獨立日誌依該來源同步校正時間線。

v0.3b10-1

修改時間：2026 06/02

調整 EQ 偵測與假波動備援邏輯。原本 EQ 在偵測不到波形時會自動切換為假波動，但音樂很小聲仍在播放時，假波動會干擾真實波形。嘗試讓瀏覽器能分析波形時不使用假波動，只在真的無法偵測時才啟用備援。版本歷史新增 v0.3b10 並描述此次 EQ 更新。

v0.3b10-2

修改時間：2026 06/02

移除或回退假波動策略。使用者上傳網站後發現 EQ 一開始正常，幾秒後變成假波動，因此要求刪除假波動，嘗試讓各網站環境、Chrome、Safari、手機版都能顯示真實 EQ。後續因跨瀏覽器限制，使用者要求先改回上一版 EQ，並將低音區靈敏度稍微調低、高音區靈敏度稍微調高，靈敏度由低頻到高頻漸進式增加。

v0.3b10-3

修改時間：2026 06/02

處理長曲名 Welcome to the Secret Garden 的特殊顯示問題。大型播放器中，這首歌的 EQ 被推出畫面外，因此改到歌曲時間旁邊的指定位置。右上角正在播放框在播放此曲時加長，使曲名完整顯示。小音樂控制器中的曲名捲動範圍限制在「連結至專輯播放」按鈕右側，避免疊到按鈕；曲名顯示邊界只在需要捲動時加入暈邊效果，不需要捲動的短曲名則不受暈邊影響。後續再微調 EQ 位置，使其貼近樂曲時長右邊。

v0.3b11-1

修改時間：2026 06/02

優化非 Chrome 瀏覽器動畫效能與網站載入速度。使用者在非 Chrome 瀏覽器中發現右下角深淺切換小花、轉跳頁面等動畫明顯卡頓，且網站載入緩慢。此版本降低部分動畫負擔，減少音訊與圖片初始載入壓力，改善 Safari、Edge 等瀏覽器的效能表現，並更新版本號為 v0.3b11。

v0.3b11-2

修改時間：2026 06/02

修正 Safari 中的新問題。使用者回報 v0.3b11 後，Safari 種子游標卡在左上角、不會跟隨游標移動；右下角深淺色小花動畫仍然很卡；合作與聯絡四個按鈕 hover 時會整個飛走。此修改讓 Safari 路徑下的游標恢復移動，降低主題切換動畫負擔，並在效能輕量模式下停用磁吸按鈕位移，避免聯絡按鈕在 hover 時異常飄走。

v0.3b11-3

修改時間：2026 06/02

繼續修正種子游標抖動與低幀率。使用者指出種子游標雖然會移動，但位置經常亂跳、左右亂閃且幀率低，右下角主題切換小花在切換時甚至卡到不轉。此修改將 Safari／非 Chrome 的種子游標改為更接近系統原生游標圖案，避免 DOM 游標每幀追蹤造成抖動；右下角小花在 performance-lite 模式下改由 CSS 動畫負責，減少 JS 逐幀更新與 Safari 重繪負擔。

v0.3b12-1

修改時間：2026 06/03

優化「活動紀錄」左側的今日花語區域，將原本靜態句子改為可互動功能。根據使用者提供的「今日花語列表.txt」，建立 25 句祝福語資料庫，並集中放在 script.js 的 dailyPhrases 陣列，方便日後新增、刪除與編輯。新增「下一句話」按鈕，可順序切換花語。花語顯示固定為兩行高度，避免不同句長造成版面跳動。深色模式中的「今日花語」標題色先調整為更深的顏色。

v0.3b12-2

修改時間：2026 06/03

改良今日花語資料庫的換行編輯方式。將花語陣列改為反引號樣板字串，使用者可在程式碼中直接按 Enter 輸入換行。網頁顯示端使用保留換行的文字呈現方式，使安排在資料庫中的換行能真正顯示在網站上，同時仍限制在固定兩行。將「今日花語」四個字改為暗一點的白色。於「下一句話」右邊新增「隨機花語」按鈕，可從目前 25 句花語中隨機抽出一句，並避免抽到目前正在顯示的同一句。

v0.3b12-3

修改時間：2026 06/03

讓「活動紀錄」右側欄位內容也支援程式碼換行。針對計畫成立、計畫補助、Hospital Performance 等 timeline 內容文字，加入保留換行的顯示方式。日後使用者可在 index.html 的活動紀錄段落內直接換行，網頁會依照輸入的換行位置顯示，方便撰寫較長、分段清楚的活動紀錄。

v0.3b12-4

修改時間：2026 06/03

建立本獨立「版本紀錄日誌」檔案。依使用者要求，根據先前所有對話與修改內容，整理出詳細版本紀錄。版本命名採用 vX.XbX-X，每次使用者提出的一則修改請求視為一個修改版。檔案以 HTML 文字檔形式建立，使用大字黃色標注主版本，小型修改版使用黑色中等字型，修改時間與詳細敘述使用黑色小型文字。日後若使用者提出新的修改需求，需同步依此格式追加到本檔案中。

v0.3b12-5

修改時間：2026 06/03

整理更新日誌附件資料夾。依使用者要求，在專案根目錄建立「更新日誌」資料夾，將本 HTML 日誌移入其中；並在「更新日誌/assets」中依版本號建立資料夾，將目前仍可從本機路徑讀取的截圖、素材、音檔、壓縮檔與文字檔複製到對應版本。由於部分早期 CleanShot 截圖、暫存截圖與舊卡片素材原始路徑已不存在，這些檔案在附件索引中標示為「來源檔案目前無法存取」。此修改讓更新日誌不只記錄文字，也能回看當時提供的視覺參考與素材來源。

v0.3b12-6

修改時間：2026 06/03

依使用者回饋重新校正本獨立更新日誌的時間線。原本部分項目依對話順序誤歸到較早主版本，例如「開花體驗」彩色花朵被提示文字遮住的修正曾被放在 v0.3b1-4，但依網站本體「活動紀錄」與使用者校正，應歸入 v0.3b5 至 v0.3b6 的開花體驗與花朵綻放優化階段。此修改以網站內版本紀錄為權威來源，重寫 v0.3b1、v0.3b5、v0.3b6、v0.3b8、v0.3b9 等段落，使整體時間線更接近實際版本演進。後續使用者提供的新截圖或檔案，也會直接放入該次修改所對應的「更新日誌/assets/vX.XbX-X」資料夾。

v0.3b12-7

修改時間：2026 06/03

優化「活動紀錄」中的文章顯示區塊。將輔大醫院義演、演出彩排、計畫補助、計畫成立等文章格改為與「網站版本」欄位相近高度的下拉式選單。收合狀態只顯示標題與第一行內文摘要，若摘要超出可視範圍則以省略號結尾；展開後顯示全文並保留原本在 HTML 中輸入的換行。每格右側新增單層箭頭，位置與網站版本欄位一致但尺寸更小，箭頭底部貼近標題文字底部。此修改讓活動紀錄可以容納更長文字，同時維持頁面掃讀時的整齊高度。

v0.3b12-8

修改時間：2026 06/03

修正「活動紀錄」文章下拉選單的展開位移與高度問題。原本收合摘要與展開全文是兩個不同位置的文字區，導致展開後第一行內文會整段往下移。此修改改為同一份內文在收合時被外框裁切成一行並顯示省略號，展開時從同一位置向下延展到完整高度，因此第一行位置不再跳動。同時縮減收合狀態下標題與副標題下方的多餘空間，讓右側活動格整體高度更接近舊版排版，並讓左側「今日花語」卡片比例更接近正方形。

v0.3b12-9

修改時間：2026 06/03

新增「活動紀錄」文章分頁與排序功能。除固定顯示在底部的「網站版本」欄位外，最新資訊一次只顯示三則活動紀錄。原本第四則「計畫成立」的位置改為小型分頁列，提供上一頁、下一頁箭頭與目前頁數，按鈕無外框且不佔用過多高度。第四則與後續新增的活動紀錄會依目前 HTML 中的紀錄數量自動安排到下一頁，不需要手動指定頁面。第一則活動卡右上方新增常駐狀態文字，顯示「正在顯示 XX 則中的第 X ~ X 則」，旁邊提供排序切換，可在「新→舊」與「舊→新」之間切換，預設為新到舊。換頁時加入左右滑入動畫，讓頁面切換更自然。

v0.3b12-10

修改時間：2026 06/03

修正活動紀錄分頁更新後造成全站功能無法載入的初始化錯誤。使用者回報網站停留在快速預覽狀態，首頁背景、導覽列與部分靜態元素可見，但主要互動、動畫與後續功能皆未啟動。排查後確認原因為活動紀錄分頁在頁面初始化早期呼叫導覽列當前區塊同步，而導覽列同步所需的 requestAnimationFrame 狀態尚未完成初始化，導致瀏覽器拋出 ReferenceError 並中斷後續 script.js 執行。此修改為活動紀錄分頁與導覽列同步之間加入初始化保護，讓分頁可以先完成渲染，等導覽列同步準備好後再啟用互相更新，避免單一模組的初始化順序再次使整站腳本停止。

v0.3b12-11

修改時間：2026 06/03

細修「活動紀錄」分頁與文章展開體驗。將「正在顯示...」與「新→舊／舊→新」排序按鈕從第一張活動卡片內移出，改為位於右側活動紀錄區上方的總資訊列。排序功能維持作用於所有活動紀錄，而不是只影響目前頁面的三則紀錄；切換排序時會重新排列整份紀錄再切頁。若目前頁面只顯示一則紀錄，範圍文字改為「第 X 則」，不再顯示「第 X ~ X 則」。最後一頁不足三則時，新增補位提示卡維持與三格紀錄相同的頁面高度，並依排序方向顯示不同文字：新到舊時提示已看完所有紀錄，舊到新時提示敬請期待未來消息。文章下拉展開時，取消為了維持今日花語近似正方形而造成的空間限制，使內容能自然向下展開，降低展開動畫卡頓。此版也整理獨立更新日誌中使用者留在版本號後方的校正備註，移除錯置版本區塊與重複內容，將團隊頁、關鍵詞排版與園丁職位換行等紀錄歸回較合理的版本時間線。

v0.3b12-12

修改時間：2026 06/03

再次優化「活動紀錄」版面與下拉行為。將左側「今日花語」卡片固定為與右側三則活動紀錄區相近的高度，並讓它從第一則活動紀錄的位置開始對齊；任何活動紀錄或網站版本下拉展開，都不再改變今日花語卡片高度。活動紀錄展開後，內文與標題之間維持與收合狀態一致的間距，不再因展開而貼近標題。恢復活動紀錄下拉展開時的柔順高度動畫，使其接近網站版本選單拉開時的感覺。活動紀錄改為手風琴邏輯，同一時間只允許一則活動紀錄展開；若使用者打開新的活動紀錄，其他已展開的活動紀錄會自動收合，但網站版本選單不受此限制。最後一頁補位提示改為無框、無底色，只保留與紀錄內文相同大小的文字，同時維持不足三則時的版面高度。切換新舊排序時，不再固定回到第一頁，而是以目前頁面的第一則活動紀錄為定位，計算它在新排序中的所在頁面並跳轉至該頁。

v0.3b12-13

修改時間：2026 06/03

修正活動紀錄下拉選單展開時內文仍會微幅跳動的問題。依使用者指定，將展開邏輯改為「整張活動卡片高度伸縮」：收合時卡片固定為與其他紀錄一致的高度，只裁切到第一行內文；展開時由 JavaScript 量測該則紀錄完整內容的 scrollHeight，並把卡片高度動畫延展到內文結尾。如此內文仍停留在同一個 DOM 位置，不再以另一個內容高度區塊補償，視覺上更接近原本外框向下展開。此版也讓活動紀錄展開動畫重新接近「網站版本」選單的柔順拉開效果，並在視窗縮放時重新量測已展開卡片高度，維持版面穩定。

v0.3b12a-1

修改時間：2026 06/03

更新「活動紀錄」下拉式選單的互動模式與資訊層級。依使用者最新需求，活動紀錄卡片不再整張都可點擊展開，而是只透過右側箭頭按鈕控制展開與收合，避免使用者瀏覽文字時誤觸。每則活動紀錄新增獨立的關閉狀態簡介文字，與展開後的正式內文分開管理；收合時卡片顯示主標題與簡介，展開時簡介會以淡出與高度收合動畫退場，並由完整內文在同一位置淡入取代。再次點擊箭頭時，內文縮回、簡介回歸，整體仍保留活動卡片高度伸縮動畫與手風琴邏輯，使視覺轉換更柔順。網站版本同步更新為 v0.3b12a。

v0.3b12a-2

修改時間：2026 06/03

細修活動紀錄與今日花語互動。依使用者回饋，將活動紀錄格子區域的翻頁滑入動畫放慢，使切換頁面時不再顯得過快。今日花語改為每次網站刷新時自動隨機抽出一句祝福語，而不是固定依日期顯示；若抽出的祝福語只有單行，文字會自動置中於「今日花語」標題與按鈕列之間，若為雙行則維持原本兩行樣式。刪除原本「下一句話」按鈕，只保留一顆位於左側的白色循環箭頭圖示按鈕，點擊後會隨機抽換花語，讓介面更安靜、也更符合花語卡片的氛圍。

v0.3b12a-3

修改時間：2026 06/03

再次細修活動紀錄與今日花語的動畫節奏。依使用者要求，將活動紀錄格子區域的翻頁滑入動畫延長至 0.80 秒，讓頁面切換更緩、更容易被眼睛跟上。今日花語改為不論單行或雙行祝福，都會置中於「今日花語」標題與底部隨機按鈕之間，使文字重心更穩定。最後一頁出現的補位提示文字，例如「你已經看完全部的紀錄」或「沒有更新的消息」，也改為套用與活動紀錄格子一致的翻頁滑入動畫，避免翻到最後一頁時提示文字突然出現。

v0.3b12a-4

修改時間：2026 06/03

新增網站分頁圖示。依使用者要求，使用 assets 中的 Secret Garden Logo 圖片作為瀏覽器分頁欄位顯示的 favicon，讓使用者在多個瀏覽器分頁之間切換時，可以透過秘密花園的 Logo 更快辨識本網站。此修改在 index.html 的 head 中加入標準 icon、shortcut icon 與 apple-touch-icon 設定，提升 Chrome、Safari、Edge 與行動裝置加入主畫面時的辨識度。

v0.3b12a-5

修改時間：2026 06/03

放大網站分頁圖示。使用者回饋原本的 favicon 在瀏覽器標籤頁中仍然偏小、不易看清楚，因此重新以 Secret Garden Logo 產生一張專用的 assets/favicon-secret-garden.png。新圖示收緊原始 Logo 四周透明留白，讓圖案在固定尺寸的瀏覽器分頁圖示中佔比更高，視覺上接近放大兩倍，並將 index.html 中的 icon、shortcut icon 與 apple-touch-icon 全部改指向此新版圖示。

v0.3b12a-6

修改時間：2026 06/03

再次最大化網站分頁圖示。依使用者要求，改以去背方式處理 Logo，只保留「長出花朵的調色盤」主體，移除周圍音符與裝飾線條，並將圖片邊界精準裁切到主體第一個可見像素。新輸出檔案為 assets/favicon-secret-garden-max.png，並將 index.html 中的 icon、shortcut icon 與 apple-touch-icon 改指向此最大化版本，同時加入 favicon 快取版本參數，降低瀏覽器持續沿用舊圖示的機率。此修改讓瀏覽器標籤頁中的秘密花園 Logo 佔用盡可能大的顯示面積。

v0.4b1-1

修改時間：2026 06/03

進行 v0.4b1 行動裝置版大更新。依使用者要求，這次修改專門針對手機直式螢幕比例建立獨立排版，並將所有主要調整鎖定在窄螢幕 media query 中，避免影響已經調整完成的桌面版排版與功能。手機版導覽改為更適合觸控的固定底部快捷列，頂部保留品牌與音樂播放狀態，右上角小音樂播放器改為手機可讀的尺寸與展開面板。首頁重新整理為手機可完整觀看的節奏，縮放 Logo、標題、按鈕與八色花朵入口，並降低背景動畫造成的負擔。關於、世界觀、開花體驗、線上花園、專輯聆聽、花語圖鑑、園丁介紹、活動紀錄與合作聯絡等區域皆加入手機版的單欄或緊湊式布局，讓卡片、控制列、翻頁區、花語按鈕與聯絡按鈕能在直式手機螢幕中保有可點擊性與可讀性。此版本同步更新網站內「活動紀錄」的目前版本顯示為 v0.4b1，並加入對應版本紀錄。

v0.4b2-1

修改時間：2026 06/04

進行 v0.4b2 行動裝置版第二階段大型優化。本次修改延續 v0.4b1 的手機專用排版原則，所有版面調整皆集中於窄螢幕 media query 與行動裝置互動邏輯中，避免影響桌面版既有排版。首頁底部八色花朵入口改為單行排列，避免手機直式螢幕中被拆成兩排；底部導覽列改為雙行格狀排列，使 About、Bloom、Garden、Music、Flowers、Gardeners、Diary、Contact 能一次看清楚，不再需要左右滑動。全站加入行動裝置觸控優化與 viewport 限制，停用快速雙擊縮放造成的誤觸放大。

音樂播放系統在手機版中進一步調整：播放、暫停、上一首、下一首按鍵改為 CSS 幾何圖示，避免 iOS 或 Android 將控制圖示渲染成系統 emoji；右上角正在播放控制器改為點擊曲名開啟、再次點擊收合，並在手機版中加入 5 秒閒置自動收合邏輯。只要使用者在小播放器內操作按鍵或進度條，計時就會重置；若使用者轉而點擊網站其他位置，播放器會在閒置時間後自動收起。

「花朵綻放」區域在手機版中重新配置八色種子與花朵顯示方式。八色種子按鈕改為單行並依欄位寬度縮放，與其同列的暫停／開始按鍵在手機版隱藏，避免擠壓色彩選擇器。使用者選擇顏色後，花朵本體縮小並放置於左側，祝福語與對應花語卡片則放置於右側上下排列，讓花朵、文字與卡片在直式螢幕中能同時呈現且不再讓頁面過度拉長；花語卡片仍保留點擊後前往「花語圖鑑卡」並開啟對應卡牌的互動。

「種下一些花」的八色按鈕在手機版改為雙行排列，並同步使用首頁八色花朵的色號，讓 Red、Orange、Yellow、Green、Blue、Indigo、Violet、Gray 的顏色識別一致。「專輯聆聽」中的十首曲目卡在手機版改為雙欄顯示，並調整曲名、中文曲名、作曲者與時間的字級及空間，使曲目資訊能在較窄的卡片中保持可讀。「花語圖鑑卡」在手機版改為雙欄排列，並修正翻開後圖片與卡牌外框之間的空隙，使卡面圖片貼合外框尺寸。

「活動紀錄」中的今日花語加入手機版統一字級測量機制：系統會以所有花語中最長的祝福語作為基準，計算出一個能容納全部祝福語的共同字級，避免短句變得過大、長句被裁切或每句文字大小不一致。網站版本紀錄在手機版收合時，頁面回捲位置改為「網站版本／網站版本紀錄」該列，而非整個活動紀錄區塊開頭。最後，「合作與聯絡」四個按鈕在手機版改為橫向排列，使 Email、Instagram、YouTube、Spotify 能在一列中呈現。本次同步將網站內目前版本更新為 v0.4b2，並收錄使用者提供的九張行動版參考截圖。

v0.4b2-2

修改時間：2026 06/04

針對 v0.4b2 手機版進行第二輪細修。手機版左上角品牌區在隱藏 Welcome／Secret Garden 文字後，原本仍保留過寬背景，本次將背景收斂為只包住 Logo 的小型區塊，避免在窄螢幕中遮住頁面標題。首頁音樂提示文字從「觸碰以控制音樂」改為「點按以控制音樂」，移除上方箭頭，並將提示位置上移到右上角正在播放欄位下方，讓提示更貼近實際互動目標。首頁八色花朵入口也向上移動並縮短可用寬度，降低與右下角深淺色切換小花互相遮擋的機率；手機版底部導覽列則由膠囊形改為帶圓角的方形外框，使雙行導覽更穩定。

重新整理手機版小音樂控制器與播放按鈕。播放、暫停、上一首、下一首按鍵改以更接近桌機版的純 CSS 幾何圖示呈現，並調整中心定位，避免在部分行動裝置上圖示看起來偏移，且不再依賴系統 emoji。花朵綻放區域進一步壓縮手機版高度：標題、副標與彩色花朵位置上移，副標在手機版會於第一個句號後換行；進入花朵綻放後，花朵、祝福語與花語卡片尺寸都更緊湊，減少下方空白，讓整個體驗更容易在一個手機螢幕內被看見。

「種下一些花」區域同步加入手機版與桌機版皆可使用的放大／縮小功能。新按鈕放在 Memory／當前種花字詞旁邊，以全螢幕角落符號表示；點擊後會暫時隱藏該區標題與副標，並把種花舞台放大成主要視覺區域，再次點擊則恢復原本排版。手機版的種花副標同樣在第一個句號後換行，八色種子按鈕縮小並改為未選取時呈現中性外觀，只有選取後才顯示對應顏色，讓目前使用者選擇更明確。本次也收錄使用者提供的八張手機版細修參考截圖至 v0.4b2-2 附件資料夾。

v0.4b3-1

修改時間：2026 06/04

針對 v0.4b3 進行行動裝置版第三輪細修。本次修改仍以手機版為主要範圍，並盡量避免影響桌機版既有排版。手機版右上角正在播放按鈕與展開後的小音樂控制器提高不透明度，底部導覽列也同步提高背景濃度，降低控制器與導覽列在淺色或複雜背景上與文字互相卡住的狀況。右上角正在播放按鈕在小控制器已開啟時，再次點按即可直接收合，讓手機版操作更直覺。手機版右下角深淺色切換小花移除「深色／淺色」文字標籤，首頁八色小花入口則上移到兩個主按鈕下方，避免與深淺色切換小花互相遮擋。

重新整理「花朵綻放」手機版中的花朵顯示邏輯。彩色花朵與綻放後的花朵都改為以整體群組方式縮放，花瓣、花蕊與莖不再依不同手機寬度被單獨拉開或位移，降低花朵在不同螢幕比例下解體的問題。選色後的花朵、祝福語與花語小卡位置調整到框內更接近中央的位置，小花卡尺寸放大，並修正圖片與卡框沒有置中的問題。上方八色種子的選取外框距離也縮小，避免外圈超出控制欄邊界。

「種下一些花」的放大／縮小按鈕移除圓形外框，保留單純的角落圖示，桌機版與手機版皆同步調整。淺色模式中的「今日花語」祝福大字改為與「今日花語」標題相同的深灰綠色，讓淺色背景下的文字更容易閱讀。本次同步將網站目前版本更新為 v0.4b3，並將使用者提供的五張手機版細修參考截圖歸檔至 v0.4b3-1 附件資料夾。

v0.4b4-1

修改時間：2026 06/05

針對行動裝置版進行第四輪細修。右下角深淺色切換小花的位置再次向下微調，讓它比 v0.4b3 更靠近底部，同時仍避開底部導覽列與系統安全區，減少它遮住頁面內容的情況。

修正手機或平板瀏覽器來回捲動時，落下花瓣會突然高速亂飛的問題。原本行動瀏覽器在網址列收合與展開時會連續觸發視窗 resize，而網站每次 resize 都會重新隨機生成全部花瓣，因此視覺上像是花瓣被加速打散。本次改為在 resize 時保留既有花瓣，依照新視窗尺寸平順縮放位置，並透過動畫影格節流 resize 處理，讓捲動期間花瓣維持穩定飄落。

v0.4b4-2

修改時間：2026 06/07

修正網站部分文字在卡片或欄位中靠近邊界時被裁切的問題。依使用者提供的專輯曲目卡截圖，右上角作曲者資訊在某些螢幕寬度下會超出卡片可視範圍，因此本次將曲目卡文字區改為依卡片邊界保留安全範圍：作曲者欄位會在曲目序號與右側邊界之間自動取得可用寬度，必要時允許自然換行；曲名、語言與時間欄位也加入最大寬度與邊界保護，降低其他卡片文字被裁掉的機率。此修改不更動目前主版本號，只作為 v0.4b4 的同版細修紀錄。

v0.4b4-3

修改時間：2026 06/07

修正「種下一些花」放大／縮小按鈕在縮小狀態下，兩個箭頭角標靠得太近、視覺上像是卡在一起的問題。這次將縮小狀態的雙箭頭拉開，讓桌面版與行動裝置版都更容易辨識目前按鈕代表縮回畫面。

調整手機版從首頁八色小花入口跳轉到「花朵綻放」時的捲動定位。原本跳到整個 Bloom 章節頂端，手機直式畫面會被標題與副標題吃掉太多高度，導致使用者看不到互動框下半部。現在手機版會優先定位到花朵互動框本身，讓花朵、花語與卡片區域更快進入視野；桌面版仍維持原本跳到章節開頭的行為。

v0.4b4-4

修改時間：2026 06/07

依使用者提供的新參考圖，重新繪製「種下一些花」放大／縮小按鈕的縮小狀態圖示。原本以裁切邊框與位移做出的縮小圖示，在實際顯示時仍容易變成小方框或兩個角標靠得太近。本次改為兩個真正獨立的 L 型角標：上方角標與下方角標都朝向中間，中央保留可見空隙，讓縮小含義更接近參考圖，同時保留既有的金色、hover 狀態與切換動畫。

v0.4b4-5

修改時間：2026 06/07

再次微調「種下一些花」放大／縮小按鈕的縮小狀態圖示。依使用者最新截圖，兩個 L 型角標雖已朝向中間，但距離仍希望更分開；本次加寬圖示畫布並調整角標定位，使兩個角標之間留出更明顯的空隙，同時保留原本的金色與切換動畫。

針對手機版「花朵綻放」有花狀態進行高度壓縮。使用者標示出互動框上方與下方留白過多，導致手機直式畫面難以一次看清整個 Bloom 區域；本次降低有花狀態的場景最小高度、縮短上下 padding、壓縮格線列高與間距，並小幅縮放花朵與花語卡尺寸，讓花、祝福語與卡片更集中在同一個畫面中。桌面版排版不受此調整影響。

v0.4b4-6

修改時間：2026 06/07

延續前一版手機版 Bloom 區塊的高度壓縮，將尚未進入花園的介紹狀態、以及進入花園後尚未選色的八色花瓣預覽狀態，都同步套用與已開花狀態相近的緊湊高度。這讓手機版「花朵綻放」區域在進入前、預覽中、實際開花後的高度更一致，不會因狀態不同突然變回舊版較高的互動框。

調整手機版首頁八色小花入口的捲動定位。使用者點按首頁底部八色小花後，現在會優先將「花朵綻放」標題對齊到螢幕頂端，讓使用者清楚知道已進入 Bloom 區域，再接續看到下方的種子選擇與花朵互動框。

重新校準手機版「花朵綻放」中的花瓣與花蕊中心。前一輪壓縮互動框高度後，花瓣群組在部分比例下又出現與花蕊錯位的情況；本次微調花瓣的旋轉起點與向外展開距離，讓彩色預覽花與實際綻放花都更穩定地以花蕊為中心排列。

v0.4b4-7

修改時間：2026 06/07

微調手機版首頁八色小花入口跳轉至「花朵綻放」時的捲動位置。上一版已改為對齊 Bloom 標題，但在部分手機瀏覽器中仍可能讓標題貼近螢幕頂端而被切到；本次加入上方安全距離，讓跳轉後的標題位置再低一點，提升可讀性。

v0.4b4-8

修改時間：2026 06/07

將手機版底部導覽列與上方導覽列的章節跳轉邏輯改為由網站統一控制，不再依賴瀏覽器預設錨點定位。所有導覽連結現在都會套用與首頁八色小花跳往「花朵綻放」相同的上方安全距離，避免點擊 About、Bloom、Garden、Music、Flowers、Gardeners、Diary、Contact 後，章節標題或重要內容貼到螢幕頂端而被切掉或看不清楚。

v0.4b4-9

修改時間：2026 06/09

依使用者在手機版提供的截圖，微調導覽列章節跳轉的手機版定位。前一版所有導覽都套用與首頁八色入口相同的安全距離，雖可避免切到標題，但部分頁面會讓標題位置偏低、下方內容較難在同一畫面中閱讀；本次將導覽列專用 offset 與首頁八色入口 offset 分開，讓透過導覽進入各頁時，章節標題更靠近螢幕上方，同時保留首頁八色小花跳往 Bloom 時避免切字的安全距離。

v0.4b4-10

修改時間：2026 06/09

依使用者提供的活動紀錄截圖，重新配置「網站版本」傳送門。原本版本入口以卡片形式固定在右側活動列表與分頁控制器下方，容易占用活動紀錄視覺重心；本次將入口移到左側「今日花語」大卡下方，使其底部與右側分頁控制器對齊。視覺上移除版本入口外框與背景，只保留「網站版本」、目前版本號與細箭頭文字型連結；標題色改為與活動標題相同的金黃色，版本號改為活動簡介使用的灰色，且點擊整個文字列都會以新分頁開啟 version.html。將導覽頁面中的「Garden」改為「Seeds」以避免與「Enter Garden」按鍵混淆。

v0.4b4-11

修改時間：2026 06/09

擴充「種下一些花」舞台的可種植範圍。原本舞台上方一段空白區因點擊座標被限制在較低的範圍內，即使視覺上仍屬於種植區，也無法成功種下花朵；本次放寬種植座標上限，讓紅框標示的上方區域也能正常種花。 手機版「種下一些花」區域整體再縮小約 20%，只作用於行動裝置排版，不影響桌面版與其他區塊。此調整壓縮標題、色彩按鈕、舞台高度、文字與花朵尺寸，讓手機直式畫面更容易一次看清楚種花舞台。 更新 version.html 底部，新增「詳細版本紀錄」文字入口與下拉式箭頭風格的小箭頭，點擊後可前往完整的「更新日誌.html」。 優化「更新日誌」附件索引：附件區會依版本號排序，並且若某個修改版已有對應附件，該修改版文字區會自動出現「查看附件」按鈕，方便從更新說明直接跳到參考截圖或檔案。 網站已開啟後台分析與使用者互動收集（使用平台：Google Analytics、Microsoft Clarity）

v0.4b4a-1

修改時間：2026 06/10

因應輔大醫院合作洽談失敗、並轉由與關渡醫院合作，因此將相關資訊及時修改，並做好配合關渡醫院「器官捐贈」主題之調整，本次更新將用於提供關渡醫院院方參考。詳細調整內容如下：將「專輯聆聽」改為「專輯試聽」、將所有「輔大醫院」資訊改為「醫院」、將「Secret Flower（勿忘我）」改為「Hope Flower（希望之花）」以對應器官捐贈之主題。

v0.5b1-1

修改時間：2026 06/10

新增「留言板」功能，作為 v0.5 系列的第一個主功能更新。新的留言板區域被放置在「花語圖鑑卡」之後、「花園的園丁們」之前，讓使用者可以在瀏覽完花卡之後，直接留下自己想放進秘密花園的一句話，也可以閱讀其他訪客留下的留言。導覽列同步新增 Messages 入口，位置位於 Flowers 與 Gardeners 之間；桌面版與行動裝置版皆可透過導覽列直接跳至留言板。

留言板串接 Supabase 作為資料儲存端，使用公開可發布金鑰透過 REST API 讀取與新增留言。網站目前預設資料表名稱為 garden_messages，留言內容欄位為 content，建立時間欄位為 created_at；前端會一次讀取最新 50 則留言，並依建立時間由新到舊顯示。留言輸入限制同步設定為 1 至 200 字，送出前會先在前端檢查空白留言與超出字數的情況，並提供字數計數、送出中、送出成功、送出失敗與讀取失敗等狀態提示。

新增留言板的視覺與互動介面。左側為留言輸入卡，包含 textarea、字數計數與送出留言按鈕；右側為花園留言列表，包含重新整理按鈕與留言卡片。留言內容以純文字安全插入頁面，保留使用者輸入中的換行顯示，並避免 HTML 被直接解析。深色與淺色主題都新增對應的半透明卡片、柔和邊框、焦點狀態與錯誤／成功文字色彩；手機版則改為單欄堆疊，確保留言輸入與留言列表在窄螢幕中仍能清楚閱讀。

因應「器官捐贈」主題，修改了主頁的文字。將原先的副標題改為「Each blossom is a continuation of hope.」「每一朵花的綻放，都是希望的延續。」，並將原先的副標題移至頁面說明處。

v0.5b2-1

修改時間：2026 06/10

將 v0.5b1 新增的「留言板」整合進「種下一些花」區域，新增「種花／留言花園」雙模式切換。原有的種花功能保留原本操作與視覺；留言花園則改為一塊與種花舞台同尺寸的大草原，讓使用者可以在同一個世界觀裡種下留言花、瀏覽其他訪客留下的花，並透過右下角縮放控制器調整草原視野。

新增留言花園的完整種植流程。初始狀態會顯示「種下你的花」入口；點擊後進入留言編輯介面，左側即時預覽花朵，右側提供色相、明暗度、灰階化三組滑桿與 Hex 色號欄位，讓使用者可以調配自己的花色。下方新增選填的 20 字心情欄位，以及必填的留言欄位，留言上限提高為 500 字，並保留隨機提示文字與字數計數。

新增留言花的定位與送出流程。使用者完成留言後，草原會縮放到 0% 的小點視野，讓使用者點選想種花的位置；點下後會出現「是否將你的花種在這裡？」確認框，若取消則可重新選點，若確認則會將 content、mood、color、pos_x、pos_y 等資料寫入 Supabase。讀取留言時若缺少座標欄位，前端會自動隱藏該筆資料，避免沒有位置的留言出現在草原中。

新增留言花觀看模式與動畫銜接。種下留言花後，網站會先將背景音樂淡出暫停，再隨機播放一個開花音效並呈現使用者所選顏色的綻放動畫，音效結束後再淡入恢復原本背景音樂。動畫完成後會自動切換到查看留言模式，花朵位於畫面左側，右側顯示心情、留言與時間；若心情留空，會以灰色文字隨機顯示一段保留情緒的提示。點擊空白處即可回到草原瀏覽模式。

v0.5b2-2

修改時間：2026 06/11

修正留言花園的種植與查看流程。開始種花後，草原頂部原本「種下你的花」的入口會替換成置中的「取消」按鈕，使用者可沿用先前設計的取消確認彈窗中止正在編輯或定位中的留言花，避免誤觸造成資料遺失。

將留言草原由偏正方形的大畫布調整為更接近「種下一些花」原始舞台的長方形比例，並同步修正世界座標、縮放比例、點擊定位與確認框位置計算，使留言花可種植的區域與畫面中的草原邊界一致。

重寫查看留言花的聚焦方式。現在點擊草原中的任一留言花時，不再額外生成一朵複製花作為查看畫面，而是直接將地圖上原本那朵真實留言花放大至 150% 並聚焦到視野中；右側同步顯示該留言花的心情、留言內容與時間。

查看留言狀態下會暫時關閉草原捲動，避免使用者滑動時把聚焦花朵與留言內容移出畫面。退出查看狀態後，草原會恢復到進入查看前的縮放比例與捲動位置，例如使用者在 46% 縮放時點開留言，關閉後仍會回到 46% 的瀏覽狀態。

v0.5b2-3

修改時間：2026 06/12

修正版本顯示規則：網站本體與使用者用 version.html 只顯示主版本 v0.5b2；含修改次數的小版本號改為只保留在開發者用的「更新日誌」中。同步移除 version.html 內原先獨立列出的 v0.5b2-2 項目，避免使用者看到過細的開發修補紀錄。

在「更新日誌」左側新增固定顯示的大版本快捷欄，列出每個大版本號並可點擊跳轉到對應區塊。桌面版會固定在左側，行動或較窄螢幕則改為上方橫向快捷列，避免遮擋版本內容。

建立後續素材歸檔規則：未來每一次修改若包含使用者提供的照片或其他附件，需依照完整細版本號複製到「更新日誌/assets」對應資料夾；其中照片需先經過壓縮處理後再歸檔，以降低專案體積。

壓縮「更新日誌/assets」既有圖片附件，保留足夠閱讀與檢查的畫質，同時降低專案總容量。此次壓縮屬於開發紀錄維護，不新增使用者版 version.html 的主功能說明。

v0.5b2-4

修改時間：2026 06/12

修正開發者版本日誌中 v0.5b1 與 v0.5b2 的排列順序，改為先顯示 v0.5b1、再顯示 v0.5b2，左側大版本快捷欄也同步調整為相同順序。

重寫留言草原縮放邏輯。原本使用 CSS transform 縮放草原，視覺雖然變小，但可捲動區域仍保留原本尺寸，因此 0% 縮放仍可能需要捲動才能看完整張草原。現在 0% 會依照目前留言草原視窗寬高計算實際縮放比例，使使用者在 0% 時一定能綜覽整個區域。

新增留言花最小顯示閾值。當視窗很小、草原為了完整顯示而縮得更小時，留言花不會跟著縮到不可辨識，而是維持目前小點檢視的最小尺寸，保留全局瀏覽時的可見性與可點擊辨識度。

調整留言花編輯與定位流程。使用者正在編輯花朵顏色、心情與留言時，草原捲動會被鎖定；送出編輯並進入選擇種植位置後，視角會預設切到 0% 全局視野，但使用者仍可自行縮放與捲動來選擇更精準的位置。

新增紅色小箭頭作為種植位置提示。使用者在草原上點下預計種植的位置後，該座標會出現紅色箭頭標記，並顯示確認框；若選擇「否」或取消流程，箭頭會同步移除。

修正桌機版確認種植後可能只捲動視角、沒有完成種植的問題。確認種植時不再先強制放大並捲動到目標位置，而是先送出資料、重新渲染草原花朵，再播放綻放動畫並進入查看留言狀態。

v0.5b2-5

修改時間：2026 06/12

調整留言草原 0% 縮放的總覽倍率。原本 0% 是剛好依視窗塞入整片草原，若要讓草原容納更多留言花仍顯得偏近；現在新增總覽縮放係數，讓 0% 會比剛好塞滿再退遠一些，保留更多整體空間感。

修正草原縮放時視角偏移的問題。縮放前會先記錄目前視窗中心對應到草原上的百分比座標，套用新縮放尺寸後再把同一個座標放回畫面中心，使使用者拖曳縮放滑桿時視角固定在目前觀看區域，而不是跳到其他位置。

維持留言花的最小顯示閾值。即使 0% 縮放比上一版更小，留言花仍會保留既有的小點顯示尺寸，避免因總覽倍率降低而變得難以辨識或點選。

縮減留言撰寫面板的間距、內距與 textarea 高度，手機版也同步降低最小高度，避免在編輯留言時因草原捲動被鎖定而讓底部送出／選擇種植位置按鈕被畫面切到。

v0.5b2-6

修改時間：2026 06/12

根據使用者提供的三張留言草原截圖，修正點選留言花後的觀看構圖。原本花朵會被放大到畫面正中央，右側留言卡可能未能清楚出現；現在點選留言花會將該花定位在畫面左側，並讓右側留言卡以較高圖層顯示心情、留言內容與時間。

擴大留言草原的可種植座標世界。草原內部可種植範圍由 1800 × 900 擴大為 3600 × 1800，相當於原本兩倍寬與兩倍高；縮放邏輯同步改為 0% 顯示完整加大後的草原輪廓，100% 則維持原本視覺大小，使可縮放範圍更廣，也讓留言花能分散種植在更大的區域。

調整種植完成後的動畫流程。使用者按下確認種植後，若背景音樂正在播放會先淡出暫停；資料寫入後，鏡頭會放大並移動到新花即將長出的位置，構圖維持左側花朵、右側留言卡，接著先啟動開花音效，再播放開花動畫，讓使用者能看見自己的留言花在所選位置附近長出來。

修正開花動畫位置。原本動畫固定顯示在畫面中央，容易形成突兀的大色塊；現在動畫位置改到觀看模式的左側花朵焦點附近，與新種下的花及留言卡構圖一致。

將「是否將你的花種在這裡？」確認框往上抬，並提高定位計算的上緣保護距離，避免提示框壓到紅色位置提示箭頭。

已將本次使用者提供的三張問題截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-6/，作為後續回溯留言草原觀看模式、可種植範圍與開花動畫問題的參考素材。

v0.5b2-7

修改時間：2026 06/12

根據使用者提供的新截圖，修正查看留言花時花朵與留言卡仍會亂跑的問題。上一版仍依賴草原內原本的留言花 marker 放大顯示，因此當該花位於草原邊緣或視角被捲動限制時，花朵會被擠到左下、右側或畫面外，留言卡也可能跑到非預期位置。

改寫觀看模式呈現方式。點選留言花後，草原中的原始 marker 只作為資料來源與狀態標記，不再放大成主要視覺；系統會在固定的 viewer overlay 左欄建立一朵相同顏色的留言花複製預覽，右欄固定顯示留言卡，使構圖永遠維持左側看花、右側看留言。

修正 viewer overlay 跟著草原捲動內容位移的根因。由於留言查看層位於可捲動的 meadow viewport 內，當草原被捲動到某個座標時，absolute overlay 會跟著內容座標偏移；現在會同步 meadow viewport 的 scrollLeft / scrollTop 到 CSS 變數，讓 viewer overlay 與開花動畫反向補償捲動量，固定在目前可視框內。

調整 viewing 狀態 CSS。原本 .meadow-flower-marker.is-viewing 會直接改變原始 marker 的寬高，造成世界座標、捲動位置與視窗邊界互相影響；現在 viewing 狀態會隱藏原始 marker，並由 .meadow-viewer-flower 負責固定展示花朵。手機版覆蓋規則也同步移除放大 marker 的寬高設定。

已將本次三張「查看留言花位置飄移」回報截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-7/，作為本次修正的對照素材。

v0.5b2-8

修改時間：2026 06/12

依照使用者進一步指定，調整留言花查看模式的視覺邏輯。上一版為了穩定左右構圖，使用 viewer overlay 生成一朵複製花；本版改回使用草原上被點擊的原始留言花，讓使用者看到的左側花朵就是實際點選的那一朵。

保留整片草原的放大聚焦行為。點選留言花後，草原仍會縮放到 100% 並將目標座標聚焦到畫面左側，因此其他花也會隨整個草原一起放大；目標花則以 active marker 的方式加大尺寸並提高圖層，形成明確焦點。

新增 meadow-focus-backdrop 背景層。該背景層位於其他花朵之上、目標花朵與留言卡之下，並跟 viewer overlay 一樣使用 scrollLeft / scrollTop 反向補償，固定在目前可視框中。這讓畫面能壓暗其他花朵，同時凸顯目標花與右側留言板。

移除 viewer overlay 中的複製花展示。showMeadowMessage 現在只清空 meadow-viewer-flower，不再插入 meadow-viewer-flower-shape；實際花朵由原始 .meadow-flower-marker.is-viewing 呈現。手機版 viewing 規則也同步改回顯示原始 active marker。

v0.5b2-9

修改時間：2026 06/12

調整留言草原縮放倍率定義。使用者指出目前滑桿字面上的 100% 視覺上仍偏小，希望查看留言時的目標花大小可視為 120%，而使用者手動可放大的最大倍率仍維持為真正的 100%。

新增 MEADOW_VIEW_ZOOM = 120 作為查看留言專用倍率。一般瀏覽與使用者縮放滑桿仍限制在 0% 至 100%；showMeadowMessage 進入查看模式時則使用 120% 進行草原放大與左側聚焦，使目標花在查看留言時比使用者可手動放大的最大比例再大 20%。

調整 getMeadowScale 與 setMeadowZoom 的內部上限，使程式可以接受 120% 的查看模式縮放，但滑桿控制值與輸出文字仍會 clamp 在 0% 至 100%，避免使用者介面出現 120% 這個開發用狀態。

v0.5b2-10

修改時間：2026 06/12

重新調整留言草原縮放範圍。0% 不再只是剛好塞進加大的草原，而是使用 MEADOW_OVERVIEW_SCALE_FACTOR = 0.42 進一步拉遠視角，使畫面能容納更多留言花；使用者可操作的 100% 則提高至 MEADOW_MAX_SCALE = 0.82，讓最大放大程度更接近查看留言時的 120% 聚焦倍率。

調整小圓點與花形的切換規則。新增 MEADOW_DOT_ZOOM_LIMIT = 20，當縮放小於 20% 時，留言花統一顯示為彩色小圓點；約 20% 起恢復一般花朵造型，之後再隨縮放比例線性放大，讓整體縮放過程更連續、可預期。

將草原縮放公式維持為線性區間，並把 meadow-world 與 meadow-flower-marker 的寬高轉場改為較短的 linear transition，避免拖曳縮放滑桿時在某些比例後產生明顯放慢或延遲的感覺。

重寫草原平移方式。新增 pointer drag 狀態，使用者可在草地空白處按住拖移來移動畫面；草原 viewport 改為 overflow hidden、touch-action none、overscroll-behavior none，並攔截 wheel 事件，停用原生捲動以避免觸控板或瀏覽器左右滑導致返回上一頁。

拖移時會以程式控制 scrollLeft / scrollTop，並持續同步 meadow overlay 的 scroll 變數；點擊花朵、留言卡、確認框、輸入欄與按鈕時不會啟動拖移，拖移結束後也會抑制誤觸 click，避免拖動草原時意外種花或關閉留言。

v0.5b2-11

修改時間：2026 06/12

修正留言草原 0% 縮放時可種植世界只集中在左上角的問題。上一版為了讓 0% 看見更多花，將實際 meadow world 縮得過小，導致背景雖然填滿面板，但真正可種植的座標區域只是一塊小矩形。本版將留言草原座標世界擴大為 7200 × 3600，並改用覆蓋面板的 base scale，使 0% 時可種植世界至少鋪滿整個可視面板。

調整小圓點模式的尺寸變化。新增 MEADOW_DOT_MIN_SIZE = 9 與 MEADOW_DOT_MAX_SIZE = 18，並在 setMeadowZoom 時輸出 --meadow-dot-size。當縮放位於 0% 至 19% 的 dot-view 階段時，小圓點會從 9px 線性放大到接近 18px，使小圓點模式本身也能看見縮放效果。

同步更新 CSS 初始 meadow world 與 dot size 變數，並讓 .meadow-viewport.is-dot-view .meadow-flower-marker 使用 --meadow-dot-size 控制寬高，不再固定為 18px。

已將本次使用者提供的 0% 縮放截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-11/，作為可種植世界偏向左上角問題的修正參考。

v0.5b2-12

修改時間：2026 06/12

修正 0% 縮放時仍需要左右拖移的問題。上一版為了讓可種植世界覆蓋面板，使用 max(width ratio, height ratio) 計算 base scale，當面板比例與 meadow world 比例略有差異時會產生橫向溢出。本版改為在 getMeadowWorldSize 中直接以目前 meadow viewport 的 clientWidth / clientHeight 作為 0% 的 world 寬高，使 0% 的可種植邊界精準等於當前框框邊界。

重寫 world size 插值方式。0% 使用 viewport 實際尺寸，100% 使用 MEADOW_WORLD_WIDTH / MEADOW_WORLD_HEIGHT 乘以最大縮放倍率，120% 查看模式則沿同一條線性區間繼續延伸，讓整個縮放過程仍保持平滑線性。

修正縮放錨點與動畫時序。一般縮放會以目前可視框的中心點作為 zoomCenter；setMeadowZoom 套用新尺寸後會先讀取 meadowWorld layout，再立即執行 focusMeadowPoint，使尺寸轉場與 scrollLeft / scrollTop 修正更接近同時啟動，改善點選留言花時先水平移動再放大的卡頓感。

調整 meadow-world 與 meadow-flower-marker 的轉場為 520ms cubic-bezier(0.22, 1, 0.36, 1)，讓點選留言花後從原始花朵放大到 120% 聚焦狀態，以及關閉留言後縮回瀏覽狀態時，都更接近同時修正位置與尺寸。

v0.5b2-13

修改時間：2026 06/12

修正留言草原縮放仍像從左上角放大的問題。上一版仍依賴 meadow-world 的 CSS width / height transition，瀏覽器會以元素左上角作為尺寸變化基準；同時 JS 又更新 scrollLeft / scrollTop，因此容易出現花朵先飛出框外、再被拉回目標位置的視覺抖動。

將草原縮放動畫改由 JS 統一控制。新增 meadowZoomAnimation、cancelMeadowZoomAnimation、applyMeadowZoomFrame 與 animateMeadowZoom，每一個動畫 frame 都會同時計算目前縮放倍率、meadow world 寬高、marker scale、dot size，以及對應的 scrollLeft / scrollTop，讓尺寸變化與視角修正同步發生。

調整目前視窗中心的偵測方式。getMeadowViewportCenterPoint 現在使用與 scrollLeft / clientWidth 相同座標系的 meadowWorld.offsetWidth / offsetHeight，再換算目前可視框中心位於整片草原中的百分比座標，使手動縮放能以目前視線中心作為錨點，而不是以草原左上角作為放大基準。

點選留言花時，showMeadowMessage 會以目標花的座標呼叫 setMeadowZoom(MEADOW_VIEW_ZOOM, center, { animate: true })，讓花朵從原本位置一路平滑放大並移動到左側聚焦位置。關閉留言時，restoreMeadowBrowseView 也會把原先瀏覽 scroll 轉換為中心座標，再用同一套動畫縮回瀏覽狀態。

移除 meadow-world 與 meadow-flower-marker 的寬高 CSS transition，避免 CSS 與 JS 同時控制尺寸造成動畫競爭；保留較短的 hover / opacity / filter 視覺轉場。

v0.5b2-14

修改時間：2026 06/12

補回點選留言花時目標花朵本身的拉近與拉遠動畫。上一版為了修正草原世界從左上角縮放造成的飛出框框問題，移除了 meadow-flower-marker 的寬高 transition；雖然中心縮放與定位變穩定，但 active 花朵切換大小時變成瞬間跳到查看尺寸，缺少原本的拉近過渡。

本版維持 meadow-world 寬高由 JS 逐幀同步控制，不恢復世界尺寸的 CSS transition，避免再度產生左上角基準與 scroll 定位互相拉扯。僅在 .meadow-flower-marker 上補回 width / height / transform 的 680ms cubic-bezier 轉場，讓目標花從原本大小平滑變成查看模式尺寸，關閉留言時也能平滑縮回。

v0.5b2-15

修改時間：2026 06/12

修正點選留言花時，花朵會先在原位放大、再瞬間跳到左側聚焦位置的動畫斷裂感。問題原因是上一版的 animateMeadowZoom 每一幀都直接用目標花座標重新對齊視角，因此動畫第一幀就已經把 scrollLeft / scrollTop 跳到「完成後」的位置，只有縮放倍率還在慢慢變化。

本次新增 getMeadowTargetScroll 與 applyMeadowZoomMetrics，將「更新草原世界尺寸」和「移動視角」拆開處理。點擊花朵時會先記錄目前視窗的 scroll 位置，再計算目標花在 120% 聚焦倍率下應該抵達的左側位置，動畫過程中同時補間縮放倍率、草原尺寸、scrollLeft 與 scrollTop，讓目標花從點擊當下的位置一路平滑移動並放大到左側。

另外新增 animateMeadowMarkerToViewing，點擊時會先讀取目標花朵當下的實際寬高，將其設為動畫起點，再於下一個 frame 補間到查看模式尺寸。這可以避免套用 .is-viewing 樣式時花朵尺寸被瀏覽器直接重算，確保「移動到左側」與「逐漸放大」同步發生。

此修正同時保留前幾版完成的中心縮放行為。手動縮放仍會以目前視窗中央為錨點，關閉留言回到瀏覽狀態時也會使用同一套 scroll 補間邏輯，避免拉近與拉遠時出現先橫移、再放大的不連續感。

v0.5b2-16

修改時間：2026 06/12

修正開發者用「更新日誌」中 v0.5b2 小版本的排列方向。依照後續維護規則，更新日誌中的同一大版本細項需由低到高排列，也就是由舊至新顯示，方便開發者順著修改歷程閱讀；使用者用 version.html 則維持由高到低排列，也就是由新至舊顯示，方便一般訪客先看到最新版本。

v0.5b2-17

修改時間：2026 06/12

修正快速拖曳留言草原縮放滑桿時，花朵尺寸會跟不上目前縮放百分比的問題。上一版在 .meadow-flower-marker 上保留 680ms 的 width / height transition，因此當使用者快速縮小時，草原世界已經縮小，但花朵寬高仍在前一個 transition 中追趕，會短暫看見花朵過大；快速放大時也可能因花朵尺寸延遲而產生一瞬間找不到花的感覺。

本版將一般留言花 marker 的寬高轉場移除，讓花朵尺寸直接依照目前 --meadow-marker-scale、--meadow-dot-size 與縮放百分比即時更新。保留較短的 hover、filter 與 opacity 過渡，避免一般瀏覽縮放時被 CSS 動畫拖慢。

查看留言花時的 .is-viewing 狀態仍保留拉近聚焦動畫，但寬高與 transform 過渡縮短為 320ms，讓點選留言花時仍有必要的視覺過渡，同時降低快速縮放或狀態切換時動畫尚未跑完造成的延遲感。

v0.5b2-18

修改時間：2026 06/12

補上關閉留言花查看模式時的文字卡離場動畫。原本 closeMeadowViewer 會立即將 meadow-viewer 設為 hidden，因此開啟時雖然能看到留言文字卡淡入，但關閉時文字卡會直接消失，沒有淡出過渡。

本版新增 meadowViewerCloseTimer、hideMeadowViewerImmediately 與 .meadow-viewer.is-closing 狀態。關閉留言時會先套用 closing class，讓 .meadow-viewer-card 播放 meadowViewerCardOut 淡出與微位移動畫，約 260ms 後才真正 hidden；重新開啟留言時會清除 closing 狀態，避免快速切換造成卡片被殘留隱藏。

新增 meadowViewerCardIn / meadowViewerCardOut keyframes，使文字卡開啟與關閉都有相對應的淡入淡出、輕微位移與縮放過渡。同時將留言草原的預設瀏覽縮放 meadowZoomValue 與 meadowBrowseView.zoom 從 45% 改為 0%，取消留言花編輯回到瀏覽狀態時也改回 0% 總覽視野。

v0.5b2-19

修改時間：2026 06/12

補上關閉留言花時從 120% 查看比例縮回 100% 的花朵動畫。原本 closeMeadowViewer 會立即移除 active marker 的 .is-viewing 狀態，接著直接呼叫 restoreMeadowBrowseView，因此 120% 查看比例到 100% 一般最大比例之間缺少獨立的縮回過渡，只剩 100% 回到原本瀏覽縮放的動畫。

新增 meadowViewerRestoreTimer、getMeadowMarkerSizeAtZoom 與 animateMeadowMarkerFromViewing。關閉留言時若目前仍在 120% 查看比例，會先保留目標花的 is-viewing 狀態，將花朵尺寸從查看模式逐步縮到 100% 一般花尺寸，同時把草原視角從 120% 動畫縮回 100%；約 300ms 後才移除 is-viewing 並接續原本的 restoreMeadowBrowseView，完成 100% 回到使用者原先縮放比例的第二段動畫。

調整留言花文字卡排版。將情緒欄位與留言正文改為相同字級與行高，避免情緒文字像標題一樣過大；留言卡外框改為固定寬高，內容過長時在卡片內捲動，不再因留言長短或情緒文字大小改變外框尺寸。手機版也同步套用相同字級邏輯與固定卡片高度。

v0.5b2-20

修改時間：2026 06/12

調整留言花查看關閉動畫。上一版仍保留 120% 查看比例先縮到 100%、再回復原本瀏覽視角的分段流程，因此關閉時會感覺花朵先縮小，之後視角才移動。本版改為關閉時直接保留 active 花並呼叫 restoreMeadowBrowseView，讓花朵尺寸從查看大小縮回原本瀏覽倍率該有的大小，同時視角也移回使用者關閉前的瀏覽位置；動畫結束後才移除 is-viewing 狀態。

重新調整留言草原 0% 到 100% 的縮放幅度。MEADOW_MAX_SCALE 由 0.82 提高為 1.08，使 100% 時草原世界更接近放大查看狀態；同時新增 MEADOW_MARKER_MAX_SCALE 與 getMeadowMarkerScale，讓一般留言花的視覺尺寸依 0% 到 100% 線性斜坡放大，100% 時花朵只比查看留言時小一點，而不是像先前明顯偏小。

新增留言草原位置控制條。草原可視框底部新增水平控制條，右側新增垂直控制條，兩者直接控制 meadowViewport 的 scrollLeft / scrollTop，並會在拖移草原、縮放或程式聚焦時同步更新。控制條使用與 viewer 相同的 scroll 補償，固定在目前可視框邊緣。

調整草原滾輪行為。水平 wheel 仍會被攔截，避免觸控板左右滑導致瀏覽器返回上一頁；垂直 wheel 不再被強制禁用，讓使用者在草原區域上方也可以繼續捲動整個網站的上下位置。觸控行為也改為允許 pan-y，保留網站垂直捲動能力。

v0.5b2-21

修改時間：2026 06/12

依照使用者回報截圖，移除上一版新增在留言草原右側與底部的位置控制拉桿，避免草原控制介面過度複雜。同步移除 meadow-pan-x / meadow-pan-y 的 HTML、事件監聽與 CSS。

將 100% 縮放時的留言花視覺尺寸稍微縮小，MEADOW_MARKER_MAX_SCALE 由 2.85 調整為 2.38，保留比早期版本更大的最大瀏覽尺寸，但避免 100% 時花朵過度佔滿畫面。

修正使用者在非 0% 縮放或草原已被拖移後點擊「種下一朵花」時，留言撰寫介面會跟著草原內容座標偏移、導致整個介面跑掉的問題。meadow-compose 現在和 viewer overlay 一樣使用 --meadow-scroll-left / --meadow-scroll-top 補償，固定在目前可視框內，因此任意縮放比例下都能正常顯示。

調整建立留言時的「留言板」文字框。textarea 改為不可手動調整大小，固定為兩行高度；若輸入內容超過兩行，會在文字框內自動捲動。字數計數移到較高位置，選擇種植位置按鈕下移以對齊使用者截圖標示區域。

在「留言板」標籤旁新增放大／縮小按鈕，樣式延續「種下一些花」放大按鈕的角標語彙。點擊後右側撰寫面板會切換為幾乎整面文字框，保留使用者原先輸入內容；放大狀態下縮小按鈕位於文字框右下角，再次點擊可平滑恢復原本表單。

已將本次使用者提供的留言撰寫介面截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-21/，作為本次修正與排版調整的參考素材。

v0.5b2-22

修改時間：2026 06/12

調整留言草原小圓點模式門檻。MEADOW_DOT_ZOOM_LIMIT 由 20 改為 10，讓草原縮放到 10% 以下才會切換成彩色小圓點；0% 到 10% 之間仍保留點的大小變化，10% 以上回到一般花朵形狀。

再次縮小 100% 縮放時的留言花視覺尺寸。MEADOW_MARKER_MAX_SCALE 由 2.38 調整為 2.05，保留近距離瀏覽感，但避免使用者將縮放拉到 100% 時花朵仍顯得過大。

修正選擇種植位置後「是否將你的花種在這裡」確認提示框在非 0% 縮放下明顯偏移的問題。showMeadowPlaceConfirm 改以草原內容座標計算提示框位置，並用目前 meadowViewport 的 scrollLeft / scrollTop 與可視框尺寸作為邊界，避免將視窗座標誤放進可捲動內容座標中。

修正關閉留言板並縮回草原時，目標花朵會比其他花朵更早縮小到瀏覽尺寸的不同步問題。關閉過程新增 is-restoring 狀態，讓 is-viewing 花朵的尺寸與 transform 過渡時間延長到 620ms，和草原視角 restoreMeadowBrowseView 的移動／縮放時間一致。

重做留言花園新種花後的第一次綻放動畫。confirmMeadowPlanting 不再呼叫 meadow-bloom-focus 中央覆蓋動畫，而是在新留言插入、重新渲染、並自動開啟該留言後，直接對同一個實際 meadow-flower-marker 加上 is-new-bloom，讓花莖、八片花瓣與花蕊從目標花本體長出來；動畫結束後移除暫時 class，該花會保留在草原原位。

抽出 playRandomBloomSfx 與 waitForBloomSfxOrTimeout，讓原本 overlay 綻放音效與新留言花本體綻放共用同一組隨機開花音效流程，維持先播放音效、再播放花朵長出動畫的節奏。

已將本次使用者提供的留言花開啟後白色方塊覆蓋問題截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-22/，作為本次動畫修正的參考素材。

v0.5b2-23

修改時間：2026 06/13

優化留言花製作介面的三組顏色控制桿。新增 updateMeadowSliderGradients，會依目前色相、明暗度與灰階值動態設定 --range-gradient：色相控制桿顯示完整彩虹漸層，明暗度控制桿顯示目前色相從暗到亮的漸層，灰階化控制桿顯示目前鮮豔顏色到灰階顏色的漸層。

調整 range input 的 CSS，改為使用自訂軌道與圓形 thumb，讓控制桿能穩定呈現對應顏色漸層，同時保留原有的金色操作重點。

修正新種下留言花第一次開啟留言板時，花朵會先瞬間出現、再消失並開始綻放動畫的問題。新插入的 marker 現在會先加上 is-awaiting-bloom，讓實際花朵在聚焦定位與音效準備期間保持不可見，直到 playMeadowMarkerBloom 開始時才移除等待狀態並播放長出動畫。

調整開花音效與背景音樂銜接。waitForBloomSfxOrTimeout 現在支援不使用 timeout 的完整音效等待；playMeadowMarkerBloom 會同時等待開花音效結束與至少 1900ms 的動畫時間，兩者都完成後才讓外層恢復背景音樂，避免背景音樂過早淡入並與開花音效重疊。

v0.5b2-24

修改時間：2026 06/14

調整留言花製作介面的顏色控制預設值。新增 setMeadowColorControls，重置或開始製作留言花時會讓色相控制桿隨機落點、明暗度控制桿固定為 50、灰階化程度控制桿固定為 0，並同步更新 Hex 與預覽花顏色。

在「顏色控制」標籤旁新增無外框隨機調色圖示按鈕 meadow-color-random，圖示語彙沿用「今日花語」的旋轉隨機按鈕。按下後會隨機排列色相、明暗度與灰階化三支控制桿的位置，並立即更新三支控制桿的漸層與預覽花色。

調整「留言板」標籤旁的展開按鈕。一般狀態改為無外框、貼近「留言板」文字，按鈕點擊範圍收斂到圖示本身；展開狀態的縮小圖示改為兩個箭頭朝內的角標樣式，與「種下一些花」區域縮小按鈕一致。

修正留言板展開後右下角縮小按鈕遮擋文字框內容的問題。展開模式下，文字框高度會扣除底部 42px 操作區，右下角保留縮小按鈕位置，左側保留目前字數顯示；提交按鈕在展開模式下隱藏，不會與縮小按鈕或字數重疊。

調整留言草原 10% 以下的縮放手感。新增 getMeadowWorldProgress，讓 0% 到 10% 的草原世界尺寸使用 1.65 次方緩入曲線，降低遠距離總覽時的感受速度；10% 以上仍維持既有線性縮放銜接。

將留言草原小圓點整體縮小 20%。MEADOW_DOT_MIN_SIZE 由 9 調整為 7.2，MEADOW_DOT_MAX_SIZE 由 18 調整為 14.4，讓 0% 到 9% 的點狀顯示更適合總覽大量花朵。

v0.5b2-25

修改時間：2026 06/14

調整留言板放大撰寫模式的底部操作區。展開後的字數顯示改為與文字輸入框左側對齊，並與右下角縮小按鈕垂直置中；底部操作列保留 40px 右側空間給縮小按鈕，避免文字框、字數與按鈕互相遮擋。

修正留言板放大／縮小按鈕的點擊範圍。留言板區塊由包住按鈕的 label 改為普通容器，文字標籤改用 label for="meadow-content"；展開狀態的整條 row 設為 pointer-events: none，只有 meadow-content-expand 按鈕本體保留 pointer-events: auto，避免同一水平線空白區誤觸。

補強留言文字框展開與收合動畫。textarea 與 meadow-content-label 現在都使用 420ms cubic-bezier 的 height / min-height / max-height 過渡，讓放大與縮小時更像文字框上下邊緣向外或向內延展。

新增隨機調色滑桿動畫。新增 cancelMeadowColorAnimation、animateMeadowColorControls 與 randomizeMeadowColorControlsAnimated；按下隨機按鈕時，色相、明暗度與灰階三支控制桿會在同一段 560ms 動畫中從原位置滑到新位置，不同距離會自動以不同速度完成同一時間的移動。

讓花朵顏色跟隨滑桿動畫漸變。隨機調色動畫每一幀都會重新計算 Hex、滑桿漸層與預覽花色，並補上花莖、花瓣與花蕊的 background / box-shadow 過渡，避免花色瞬間跳變。

調整留言草原在 0% 到 9% 點擊留言花時的放大速度。showMeadowMessage 會在目前縮放低於 MEADOW_DOT_ZOOM_LIMIT 時，把查看留言的視角動畫 duration 由 680ms 放慢 40% 至 952ms；同時透過 --meadow-view-transition-duration 同步放慢目標花放大的尺寸過渡。關閉留言時的縮小動畫不受影響。

已將本次使用者提供的留言板放大撰寫模式截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-25/，作為字數位置與縮小按鈕對齊修正的參考素材。

v0.5b2-26

修改時間：2026 06/14

重新整理留言板放大撰寫模式的底部佈局。meadow-compose-panel 新增 --meadow-expanded-footer-height 與 --meadow-expanded-panel-height，展開狀態下文字框高度改為面板高度扣除底部操作區，讓左下字數與右下縮小按鈕共用同一條底部軌道並垂直置中。

修正展開模式中字數顯示偏低、縮小按鈕偏下的問題。meadow-content-label-row 改為使用底部操作區高度置中縮小按鈕，meadow-content-expand 不再以 absolute bottom 貼底，meadow-compose-actions 也改為貼齊同一個 footer 區域，避免不同裝置上的高度偏移。

調整留言文字框放大與縮小動畫。textarea 與 meadow-content-label 的 height / min-height / max-height / transform 過渡由 420ms 放慢到 620ms，並加入 transform-origin，讓展開與收合更接近從原本文字框本體逐步縮放。

將留言花隨機顏色滑桿動畫加快 20%。animateMeadowColorControls 預設 duration 由 560ms 調整為 448ms，保留三支滑桿同時抵達新隨機位置、並讓花朵顏色逐幀漸變的效果。

已將本次使用者提供的留言板放大撰寫模式底部對齊截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-26/，作為字數與縮小按鈕位置修正的參考素材。

v0.5b2-27

修改時間：2026 06/14

修正留言花隨機顏色動畫節奏不一致的問題。花莖、花瓣與花蕊的 background / box-shadow / border-color 過渡由 260ms 調整為 448ms cubic-bezier，與 animateMeadowColorControls 的滑桿動畫時間同步，避免滑桿已完成但左側預覽花顏色仍慢半拍。

調整「種下一些花」的預設顯示模式。HTML 初始狀態改為留言花園啟用，garden-stage 預設加上 is-message-mode，garden-plant-mode 初始 hidden，garden-meadow-panel 初始顯示；initGardenMeadow 也會讀取目前 active 按鈕作為初始模式，避免初始化時回到舊的種花預設。

對調「留言花園」與「種花」切換按鈕位置，讓留言花園作為第一個選項並預設 active，種花移至第二個選項。

依使用者標示位置上移「種花／留言花園」切換列與主框。桌機版 garden-mode-switch margin 調整為 -64px auto 10px，窄版覆蓋規則同步調整為更小的負 margin，讓整個互動面板更靠近上方標示位置。

已將本次使用者提供的「種下一些花」面板位置與切換按鈕位置參考截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b2-27/。

v0.5b2-28

修改時間：2026 06/14

補上取消製作留言花時的退出動畫。新增 meadowComposeCloseTimer 與 meadow-compose.is-closing 狀態；使用者在頂部「取消」並確認取消後，會先保留製作面板 420ms 播放 meadowPanelOut，完成後才 resetMeadowForm、清除目標花與切回 browse。

讓留言花製作面板的出現與消失動畫成對。meadowPanelIn 與新增的 meadowPanelOut 都使用同一組 --meadow-scroll-left / --meadow-scroll-top 作為基準，避免動畫時因草原 scroll offset 不同而產生跳動。

優化關閉留言卡時目標花縮回與視角恢復的同步。animateMeadowMarkerFromViewing 新增 duration 參數，closeMeadowViewer 會把同一個 620ms duration 同時傳給目標花尺寸過渡與 restoreMeadowBrowseView，讓水平／垂直視角移動與花朵大小縮放使用一致節奏。

恢復留言花園區域的整頁滾輪捲動。handleMeadowWheel 不再 preventDefault，wheel 監聽改為 passive；meadow-viewport 改為 overscroll-behavior-y: auto、overscroll-behavior-x: contain，讓垂直滾輪交回整個網站頁面，同時保留草原內按住拖曳移動視線。

v0.5b3-1

修改時間：2026 06/14

新增「專輯聆聽」各曲目的獨立播放次數功能。albumTracks 現在為 10 首曲目補上 id 與 songId，對應 Supabase song_plays 資料表中的 id、song_id、played_at 與 plays 欄位；網站載入時會讀取 song_plays 並更新本機 songPlayStats。

新增播放滿 10 秒才計入一次播放的流程。playBackground 與 backgroundAudio 的 play、pause、ended、seeking、seeked 事件會共同管理 songPlayTimer；切歌或重新載入音源會重設計數門檻，暫停、結束或拖動進度會取消等待中的計數，同一個音源載入期間已計過就不會每 10 秒重複增加。

完成 Supabase 寫入流程。incrementSongPlay 會先讀取目前曲目的 plays，再以帶有目前 plays 條件的 PATCH 更新 song_id、played_at 與 plays；若同時有其他訪客更新導致條件失效，會重新讀取並最多重試 3 次，降低多人同時播放時少算的機率。更新成功後同步更新畫面上的播放次數，若讀取或寫入失敗則只輸出 console error，不阻擋播放器本身操作。

新增曲目卡播放次數顯示。ensureTrackPlayBadges 會在每個 .track-number 後插入 .track-plays，預設顯示 0 次，Supabase 讀取完成後改為實際次數；樣式採用與分鐘數一致的小字，並以絕對定位放在曲目編號旁，避免擠壓曲名、分鐘與作曲者資訊。

調整小曲目卡的作曲者換行規則。原本 track-composer 使用 overflow-wrap: anywhere，容易在還有空間時過早斷行；本次改為 normal 搭配 word-break: keep-all，讓作曲者姓名在真正接近其他資訊時才自然換行。

同步將網站目前版本提升為 v0.5b3，更新 index.html、version.html 的資源快取參數與使用者版本紀錄。

v0.5b3-2

修改時間：2026 06/15

修正專輯曲目卡中播放次數與曲序重疊的問題。track-number 新增穩定 line-height，track-plays 改為曲序下方的灰色小字，並在淺色模式套用較低彩度的灰色文字，避免視覺上被曲目主色誤認為曲序的一部分。

修正作曲者姓名仍可能提早換行的問題。track-composer 改為 white-space: nowrap，並搭配 overflow hidden 與 text-overflow ellipsis，讓作曲者資訊維持單行；空間不足時以省略號處理，而不是拆成兩行壓縮曲目卡。

強化 Supabase song_plays 串接。新增 normalizeSongPlayRow 統一處理 plays 為 text 或數字的情況；incrementSongPlay 若查不到對應曲目的資料列，會自動 POST 建立 id、song_id、played_at、plays，再更新畫面。既有資料列則維持帶 plays 條件的 PATCH 重試流程。

依使用者提供的 Supabase 截圖判斷，目前 song_plays 僅有 id 0 / song_id test 的測試列，與正式曲目 id 1 到 10 不相符；本次程式已能在權限允許時自動補正式曲目列，但仍建議資料表預先建立 10 首曲目的資料列並將 plays 欄位改為數值型別。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-2，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的曲目播放次數重疊截圖與 Supabase 設定截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-2/。

v0.5b3-3

修改時間：2026 06/15

依使用者已在 Supabase SQL Editor 建立的原子遞增函式調整播放次數寫入方式。incrementSongPlay 不再由前端讀取、INSERT 或 PATCH song_plays，而是 POST 到 /rest/v1/rpc/increment_song_play，並以 p_song_id 傳入目前曲目的 songId；完成後重新 fetchSongPlayStats 更新畫面，避免多人同時播放同一首歌時發生遞增覆蓋。

調整專輯曲目卡播放次數位置。track-number 右移讓出左側空間，track-plays 改到曲序左邊並維持灰色小字，避免播放次數卡在曲序下方或與曲名重疊。

調整作曲者顯示方式。index.html 的 track-composer 內容改為兩個 span，第一行顯示中文姓名，第二行顯示英文名稱；CSS 讓兩行各自 block 顯示，保留右上角資訊區的穩定排版。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-3，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的曲目卡播放次數位置參考截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-3/。

v0.5b3-4

修改時間：2026 06/15

修正播放次數累加的 Supabase RPC 接法。index.html 新增 Supabase JS SDK，script.js 透過 createSongPlaySupabaseClient 在 incrementSongPlay 內建立區域 supabase 物件，並呼叫 supabase.rpc("increment_song_play", { p_song_id: track.songId })；若 SDK 未載入，該物件會以同名 rpc 方法退回正確的 REST RPC endpoint /rest/v1/rpc/increment_song_play。同步修掉先前誤寫成 /rpc/song_plays 的錯誤，並避免全域 supabase 名稱衝突讓主程式中斷。

調整專輯曲目卡頂部資訊排列。曲序恢復在最左側，播放次數移到曲序右邊，作曲者維持最右側；播放次數與作曲者文字都改為灰色系，降低和曲序主色混淆的可能。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-4，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的曲目卡頂部排版參考截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-4/。

v0.5b3-5

修改時間：2026 06/15

將播放次數顯示位置從小曲目卡移至大播放器右上角。index.html 新增 album-play-count，script.js 讓 updateSongPlayUI 只更新目前曲目的「播放次數：X」，並讓 ensureTrackPlayBadges 移除舊的小曲目卡 .track-plays，避免小卡重複顯示播放次數。

調整大播放器作曲者資訊顏色。#album-now-meta 與 album-play-count 使用灰色系文字，淺色模式也改用低彩度灰色，讓大播放器右上角資訊與作曲者資訊更一致。

確認目前 EQ 動態顯示器的分析頻率範圍：程式以 minHz = 32、maxHz = Math.min(18000, Nyquist * 0.92) 做對數分段；一般 44.1kHz 或 48kHz 音訊下顯示範圍約為 32Hz 到 18000Hz。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-5，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的大播放器播放次數位置參考截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-5/。

v0.5b3-6

修改時間：2026 06/15

微調大播放器右上角播放次數。index.html 將 Now Playing 與 album-play-count 包進 album-top-row；CSS 以 flex align-items: flex-end 讓播放次數與 Now Playing 底部齊平，並將播放次數字級由 14px 降為 11px。

修正作曲者文字仍可能顯示為黃色的問題。#album-now-meta 與 .album-player .track .track-composer 的灰色 color 規則加入 !important，淺色模式覆蓋規則也同步提高優先級，避免被曲目主色或金色樣式蓋回。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-6，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的大播放器播放次數對齊與作曲者顏色參考截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-6/。

v0.5b3-7

修改時間：2026 06/15

修正小曲目卡作曲者姓名仍顯示為黃色的問題。原因是舊版 .track span 通用規則會直接套用 color: var(--gold) 到 track-composer 內部的中文與英文 span，導致父層 track-composer 的灰色設定被子元素覆蓋；本次改為直接指定 .album-player .track .track-composer span 的灰色 color，並在淺色模式同步覆蓋。

同步更新 index.html 與 version.html 的資源快取參數為 20260615-b3-7，並在使用者版 version.html 的 v0.5b3 條目補充本次修正。

已將本次使用者提供的小曲目卡作曲者仍為黃色的截圖壓縮為 JPG，保存於 更新日誌/assets/v0.5b3-7/。

v0.5b4-1

修改時間：2026 06/16

新增「花朵綻放」區域的八色花朵深連結功能。script.js 加入 bloom hash 解析與開啟流程，支援 #red_bloom、#orange_bloom、#yellow_bloom、#green_bloom、#blue_bloom、#indigo_bloom、#purple_bloom、#violet_bloom 與 #gray_bloom；其中 violet 會對應既有 purple 花色資料。

訪客透過上述網址進入網站時，頁面會自動捲動至「花朵綻放」區域，進入花園狀態，並呼叫既有 setBloomChoice() 播放對應顏色的綻放動畫、祝福文字、花卡與音效流程。若瀏覽器因自動播放限制阻擋音效，綻放動畫仍會正常顯示。

首頁八色小花入口與「花朵綻放」區域內的八色種子現在會同步更新網址 hash，方便直接複製對應花色網址製作 QR-Code。

同步將網站目前版本提升為 v0.5b4，更新 index.html、version.html 的資源快取參數為 20260616-b4-1，並在使用者版 version.html 新增 v0.5b4 條目。

v0.5b4-2

修改時間：2026 06/16

強化八色花朵深連結的開花音效播放。openBloomDeepLink 現在呼叫 setBloomChoice 時會帶入 queueSfxOnBlocked，讓 #red_bloom、#orange_bloom 等網址進入時明確嘗試播放對應 bloom 音效。

新增 pendingBloomDeepLinkSfxKey 與 playPendingBloomDeepLinkSfx。若瀏覽器因未互動而阻擋自動播放，系統會記住目前深連結花色，並在使用者第一次 pointerdown、keydown 或 touchstart 時補播同一個開花音效，同時以 toast 提醒「點一下花園，播放開花聲音」。

同步更新 index.html 與 version.html 的資源快取參數為 20260616-b4-2，並在使用者版 version.html 的 v0.5b4 條目補充本次音效修正。

v0.5b4-3

修改時間：2026 06/16

依使用者希望讓 #red_bloom 等深連結更全自動播放開花音效的需求，新增 simulateBloomDeepLinkGesture。openBloomDeepLink 會在自動捲動前先對 ambient-layer 或 body 的左上空白位置送出 pointerdown、mouseup 與 click 事件，避免命中種子、卡片或其他互動元件。

暖身點擊同時會嘗試呼叫 ensureAudio 並 resume AudioContext，提升行動裝置在深連結開花時播放 bloom 音效的成功率。需注意部分瀏覽器只承認真實使用者手勢，程式模擬事件可能仍無法完全解除自動播放限制；既有的第一次互動補播機制仍保留作為後援。

同步更新 index.html 與 version.html 的資源快取參數為 20260616-b4-3，並在使用者版 version.html 的 v0.5b4 條目補充本次深連結音訊暖身修正。

v0.5b4-4

修改時間：2026 06/16

依使用者要求暫時取消 v0.5b4 的「花朵綻放」八色直連網址功能，將網站本體退回新增 #red_bloom 等深連結之前的 v0.5b3 狀態。

script.js 移除 bloom hash 解析、#色名_bloom 初始自動開花、hashchange 監聽、種子點擊同步改寫網址、深連結音效補播 pending 機制，以及 simulateBloomDeepLinkGesture 暖身點擊。手動點擊首頁八色小花與花朵綻放區種子仍維持原本的捲動、綻放動畫與音效流程。

index.html、script.js 與 version.html 的網站版本顯示回復為 v0.5b3，資源快取參數回復為 20260615-b3-7；使用者版 version.html 移除 v0.5b4 條目，只保留到 v0.5b3。

v0.5b4-5

修改時間：2026 06/16

重新啟用「花朵綻放」八色直連網址功能，但改為符合行動裝置音訊政策的入口流程。#red_bloom、#orange_bloom、#yellow_bloom、#green_bloom、#blue_bloom、#indigo_bloom、#purple_bloom、#violet_bloom 與 #gray_bloom 會先導向花朵綻放區，並停留在「歡迎來到秘密花園」與「進入花園」卡片。

script.js 新增 pendingBloomEntryKey、getBloomKeyFromHash、getBloomHashForKey、updateBloomHash 與 prepareBloomDeepLinkEntry。深連結載入時只預選對應花色、清除既有開花狀態並顯示進入卡；真正播放開花音效、背景音樂與綻放動畫的 setBloomChoice 會等使用者點擊「進入花園」後才執行。

「進入花園」按鈕現在會判斷 pendingBloomEntryKey：若存在深連結預選花色，就在使用者點擊事件當下直接播放該色綻放動畫，不需使用者再選種子；若沒有深連結，仍維持原本只是進入花園的行為。種子點擊也會同步更新網址 hash，方便複製花色網址。

同步將網站目前版本重新提升為 v0.5b4，更新 index.html、script.js 與 version.html 的資源快取參數為 20260616-b4-5，並在使用者版 version.html 新增新版 v0.5b4 說明。

v0.5b4-6

修改時間：2026 06/17

新增隱藏版 Hope Flower。一般使用者第一次進入「花朵綻放」後，彩色初始花改為只顯示中央花蕊；點擊花蕊時會依序露出八片迷你彩色花瓣，第九次點擊才會觸發隱藏版希望之花綻放。其祝福語為「只要還有呼吸，一切都還有希望」。

新增 #hope_bloom 深連結，與八色深連結一樣會先停在「歡迎來到秘密花園」與「進入花園」卡片；點擊「進入花園」後會直接播放 Hope Flower 的開花音效、背景音樂與八色花瓣綻放動畫。

新增 Hope Flower 花卡素材流程：原始 hope.png 複製至 assets/cards/hope.png，網站使用的壓縮版輸出至 assets/cards/web/hope.jpg 與 hope.png；主花去背圖輸出為 assets/cards/flowers/hope-flower.png，供「專輯聆聽」第 10 首 Hope Flower 小曲目卡與大播放器背景使用。

「花語圖鑑卡」新增隱藏 Hope 卡，預設不顯示；只有從 Hope Flower 綻放後右下角花卡入口前往圖鑑時才會解除 hidden 並翻開。正面文字為 Hope｜希望，四瓣圖示分別使用紅、黃、藍、紫，底色為對應位置的四色漸層暈染。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-6，並在使用者版 version.html 的 v0.5b4 條目補充本次隱藏花功能。

已將本次使用者提供的 Hope Flower 花卡壓縮為 JPG，保存於 更新日誌/assets/v0.5b4-6/。

v0.5b4-7

修改時間：2026 06/17

修正隱藏 Hope Flower 花蕊的點擊範圍。原本整個 bloom-palette 外層都會接收點擊，導致碰撞箱與視覺上的黃色花蕊不一致；現在改由中央花蕊 i 元素接收滑鼠、觸控與鍵盤操作，外層只保留花瓣定位與動畫。

優化「花朵綻放」右下角花卡入口的跳轉行為。點擊花卡後會直接定位到「花語圖鑑卡」中對應的花卡本身，並在翻開後再次置中，避免較後排序或隱藏解鎖後的花卡只跳到圖鑑區頂部而看不見。

同步更新 index.html 與 version.html 的資源快取參數為 20260617-b4-7。

v0.5b4-8

修改時間：2026 06/17

細修 Hope Flower 彩色花的花瓣疊放順序。原本灰色花瓣因為是最後一片而顯得最高、最突出；現在將灰色花瓣調整為高於紫色、低於紅色，讓八色花瓣形成更接近循環的視覺層次。

在「花朵綻放」顏色種子列最左側新增回到入口按鈕，圖示沿用隨機按鈕的旋轉箭頭風格。點擊後會清除目前花朵、花卡、花瓣進度、花朵音效與花朵背景音樂，回到「歡迎來到秘密花園」與「進入花園」頁面。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-8，並在使用者版 version.html 的 v0.5b4 條目補充本次新增的入口重置功能。

已將本次使用者提供的兩張參考截圖壓縮保存於 更新日誌/assets/v0.5b4-8/。

v0.5b4-9

修改時間：2026 06/17

重新調整 Hope Flower 彩色花的循環疊放邏輯。紅色完整花瓣改回底層，另新增一片只覆蓋左半部的紅色補片，讓紅色右半可被橘色遮住、紅色左半可遮住灰色，形成順時鐘每瓣高於上一瓣、又被下一瓣壓住的閉環。

同步將花蕊圖層提高到所有花瓣之上，避免彩色花綻放後中央花蕊被花瓣遮住；同時補齊行動版各斷點的紅色補片尺寸與動畫定位。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-9。

已將本次使用者提供的參考截圖壓縮保存於 更新日誌/assets/v0.5b4-9/。

v0.5b4-10

修改時間：2026 06/17

細修 Hope Flower 彩色花的紅色花瓣拼接。底層紅色花瓣改為只保留右半部，上層紅色補片則只保留左半部，避免左側因上下兩層紅色重疊而出現透明度變深與可見分界線。

新增單次瀏覽的 Hope Flower 解鎖狀態 hopeBloomUnlocked。未觸發彩色花綻放前，即使專輯播放系統切到 Hope Flower，也不會自動把「花朵綻放」區域切成彩色花，會停留在上一朵花，保留彩蛋的隱藏性；刷新網站後狀態會重置。

手動點擊花蕊九次觸發 Hope Flower 時，網址會同步更新為 #hope_bloom。只要 Hope Flower 被觸發，隱藏的希望花卡就會自動解除 hidden 並出現在「花語圖鑑卡」區域，不再需要先點擊綻放區右下角小花卡才解鎖。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-10，並在使用者版 version.html 的 v0.5b4 條目補充本次彩蛋解鎖規則。

已將本次使用者提供的參考截圖壓縮保存於 更新日誌/assets/v0.5b4-10/。

v0.5b4-11

修改時間：2026 06/17

修正專輯播放系統換歌時「花朵綻放」區域不再重播換花動畫的問題。setBloomChoice 現在會先讓既有花朵進入退場狀態，等待退場完成後再套用下一首歌對應的花色、祝福與花卡，接著重新觸發長花動畫。

修正右下角小花卡內容過早切換的 Bug。原本程式在退卡動畫前就更新圖片 src 與 alt，造成卡片尚未退場時已顯示下一張內容；現在會等舊卡退場後才替換成下一張卡，再播放入場動畫。

新增 bloomCardRevealTimer 與 bloom-plant.is-changing 狀態，避免連續切歌時舊計時器誤觸發卡片顯示，並讓花朵淡出與新花長出維持穩定時序。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-11，並在使用者版 version.html 的 v0.5b4 條目補充本次換花動畫修正。

v0.5b4-12

修改時間：2026 06/17

調整手機版「花朵綻放」重啟花園按鈕的位置。原本按鈕位於顏色種子列最左側，在窄螢幕會與紅色種子卡在一起；現在手機版將按鈕往下移到同一個花朵綻放面板的左上角，種子列則恢復平均排列。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-12，並在使用者版 version.html 的 v0.5b4 條目補充本次手機版位置修正。

已將本次使用者提供的手機版參考截圖壓縮保存於 更新日誌/assets/v0.5b4-12/。

v0.5b4-13

修改時間：2026 06/17

修正手機版底部導覽列的八項目排列。自從移除 Messages 頁面後，底部導覽重新回到八個項目，但手機版 CSS 仍保留五欄格線，導致排列變成上五下三；本次將手機版導覽列改回四欄格線，使八個入口穩定呈現為上四個、下四個。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-13，並在使用者版 version.html 的 v0.5b4 條目補充本次手機版底部導覽修正。

v0.5b4-14

修改時間：2026 06/17

調整「專輯聆聽」中的 Hope Flower 圖片載入規則。原本 Hope Flower 曲目卡會在 HTML inline style 中直接載入 hope-flower.png，大播放器也會在播放 Hope Flower 時直接套用 hope-flower-player.png；本次改為共用彩色希望之花的解鎖狀態，未觸發彩色花綻放前不設定這兩張圖片來源。

新增 getTrackFlower 與 updateHopeAlbumArtworkVisibility 流程。使用者觸發 Hope Flower 綻放後，系統才會把 hope-flower.png 注入曲目卡、並允許大播放器在 Hope Flower 曲目中使用 hope-flower-player.png；若尚未解鎖，即使播放到 Hope Flower，也只保留曲目顏色與文字，不顯示隱藏花圖片。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260617-b4-14，並在使用者版 version.html 的 v0.5b4 條目補充本次 Hope Flower 專輯圖片隱藏規則。

v0.5b5-1

修改時間：2026 06/18

啟動「專輯聆聽」播放系統重大更新。新增可展開的「音效控制」區域，預設隱藏，點擊專輯區標題下方按鈕後展開，內含九條音效控制器與一條 Music 控制器。控制器支援 Mute、Solo、dB 音量推桿；Music 軌額外提供獨立暫停按鈕。

將八色曲目的主要音訊來源改為 assets/audio/Album 中的純音樂檔，並新增 Music SFX 同步播放流程。Red 會借用 Violet／雨滴控制器，Blue 同時播放 Wave 與 Bell 兩條 SFX，Gray 同時播放 Birds 與 Wind 兩條 SFX，Indigo 沒有 SFX；播放前會等待純音樂與需要的 SFX 準備完成後再一起啟動，降低音樂先出、音效延遲的情況。

新增九條循環 Ambience 軌道，對應雷雨、餐廳、窗戶、海浪、葉子、雨滴、小鳥、風與篝火。Ambience 音量若為負無限 dB、被 Mute、或正在被當前 Music SFX 佔用，會自動暫停以節省資源；當推桿大於負無限且未被佔用時，會開始循環播放。

新增 Web Audio GainNode 混音流程，以支援 -∞ dB 到 +6 dB 的推桿範圍。右上角迷你播放器與專輯播放器的播放／暫停仍控制整體聲音；若只剩循環 Ambience 在播放，播放器會顯示「音效」與目前有聲的音效軌道，背景顏色會依播放中的 Ambience 色彩呈現。

新增本機音檔選擇功能。使用者可在控制面板中選擇本機 audio 檔案，網站會使用瀏覽器產生的臨時 object URL 播放，不會上傳檔案；該音檔會以第十條 Music 控制器調整音量，播放器曲名顯示為檔案名稱。

目前 assets/audio/Album 中尚未包含 Welcome to the Secret Garden 與 Hope Flower 的新版純音樂檔，因此這兩首暫時沿用既有音檔來源；八色曲目則已接入新的 Album 純音樂檔。

同步將網站目前版本提升為 v0.5b5，更新 index.html、script.js 與 version.html 的資源快取參數為 20260618-b5-1，並在使用者版 version.html 新增 v0.5b5 條目。

v0.5b5-2

修改時間：2026 06/19

修正 Music SFX 音量基準。Music SFX 推桿仍預設顯示 -15 dB，但此位置現在代表音檔原始音量；使用者往上推時會從原始音量繼續增益，而不是先被實際衰減 15 dB。

修正部分循環 Ambience 拉起音量後偶爾無聲的問題。Ambience 啟動時會確認音訊節點、音檔來源與瀏覽器 AudioContext 狀態，並在第一次播放時一樣走淡入流程。

重接 EQ 動態顯示來源，改為分析實際送到輸出的混合訊號。純音樂、Music SFX、Ambience 的 Mute、Solo 與音量推桿現在都會影響 EQ 顯示，不再使用獨立複製的音樂分析音源。

右上角迷你播放器與「專輯聆聽」大播放器新增圓形「音效」按鈕，可獨立開關循環 Ambience。若尚未開過 Ambience，按下時會隨機啟動一到兩軌未被 Music SFX 佔用的循環音效；再次按下會以淡出暫停。

播放／暫停按鈕改為只控制純音樂與 Music SFX；音效按鈕控制 Ambience。音樂或音效按鈕快速連點兩次時，若目前有任何聲音，會一次暫停全部音樂、Music SFX、Ambience 與花朵綻放音效；若目前沒有任何聲音，會一次啟動音樂與循環音效。

新增專輯循環、單曲循環、隨機播放模式按鈕，預設維持專輯循環。上一首按鍵新增判斷：曲目播放超過 3 秒時回到該曲開頭，3 秒內才跳到上一首。

花朵綻放音效現在也會接入音樂控制器，顯示為「紅色花朵綻放音效」等名稱，並可透過播放器暫停與拖曳進度條。切換曲目與展開音效控制面板也補上轉場動畫。

補回 Welcome to the Secret Garden 與 Hope Flower 的 Album 音檔路徑，改讀取 assets/audio/Album/welcome-secret-garden.mp3 與 assets/audio/Album/secret-flower-demo.mp3。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260619-b5-2，並在使用者版 version.html 補充 v0.5b5 的播放控制更新摘要。

v0.5b5-3

修改時間：2026 06/21

修正花朵綻放音效狀態判斷。先前播放器使用 bloomSfxAudio.ended 判斷是否正在播放開花音效，但瀏覽器在剛切換 src、尚未開始播放時可能回報 ended，導致點擊八色種子後開花音效被跳過、或播放器卡在「XX花朵綻放音效」狀態。本次新增 bloomSfxTransportActive 明確旗標，統一由 setBloomSfxTransport 與 clearBloomSfxTransport 控制。

修正開花音效播放流程。setBloomChoice 現在會在指定 bloomSfxAudio.src 後立即於使用者點擊流程中嘗試播放，避免等待音檔 ready 時錯過瀏覽器允許音訊播放的使用者手勢；若播放失敗，會立即清除 Bloom SFX transport 狀態、恢復目前曲目顯示，避免播放器殘留錯誤標題、背景色與進度條。

修正循環 Ambience 音量調整時被重新淡入的問題。updateAmbiencePlayback 現在只有在 Ambience audio 原本處於 paused 狀態、需要從停到播時才呼叫 fadeResume；若使用者只是調整 Fader，會只更新 GainNode 音量，不再把音量拉回 0 後重新淡入。

修正八色與 Hope 開花音效路徑。bloomChoices 原本指向 assets/audio/red_bloom.mp3 等舊位置，但實際檔案位於 assets/audio/Bloom/，造成點擊種子時開花音效 404 並直接進入歌曲播放；本次已統一改為 assets/audio/Bloom/*.mp3。

同步更新 index.html 與 version.html 的資源快取參數為 20260621-b5-3a，並在使用者版 version.html 的 v0.5b5 條目補充本次音訊狀態修正摘要。

v0.5b5-4

修改時間：2026 06/21

修正播放音樂或拉起循環 Ambience 時偶爾沒有聲音、過很久才開始播放的問題。先前 playBackground 會等待 backgroundAudio 與 Music SFX 進入 canplay/canplaythrough 後才呼叫 play，但在部分瀏覽器中這會錯過使用者點擊或拖曳所提供的音訊播放手勢，導致 play 被延遲或拒絕。

調整曲目啟動流程。backgroundAudio 在切換 src 後會立即 load，prepareAlbumSfx 也會建立並 load 對應 SFX，但不再阻塞主播放流程；playAlbumGroup 會在同一次使用者操作中立即對純音樂與 Music SFX 呼叫 play，讓瀏覽器自行處理緩衝並提高啟動可靠性。

調整循環 Ambience 啟動流程。九條 Ambience audio 改為 preload="auto" 並在初始化時 load；updateAmbiencePlayback 不再等待 AudioContext.resume 的 Promise 完成才呼叫 fadeResume，而是在使用者操作當下直接送出 play 請求，減少 Fader 已拉高但音效未啟動的情況。

同步將 backgroundAudio preload 從 metadata 改為 auto，並更新 index.html 與 version.html 的資源快取參數為 20260621-b5-4。

v0.5b5-5

修改時間：2026 06/22

修正專輯 EQ 在沒有任何聲音時仍進入備用動態模式的問題。updateTrackWaves 現在會先檢查 hasAnyAudibleAudio；若沒有可聽聲音，會直接把所有 EQ bar 寫成 0，不再因為 analyser 尚未建立而呼叫 fallbackEqLevels 產生自動波形。

調整 Ambience 播放控制責任。applyMixerGains 新增 options，updateAmbiencePlayback 只有在 ambienceTransition 為 true 時才對循環音效執行 fadeResume／fadePause；一般 Fader、Mute、Solo 或 Music SFX 佔用釋放只會立即更新 GainNode 或立即暫停/恢復，不再淡入淡出。

修正 Ambience 被 mixer 操作自行喚醒的問題。handleMixerInput 不再於調整循環音效的音量、Mute 或 Solo 時自動把 ambienceWanted 設為 true；只有專門的「音效」按鈕或全啟動流程會啟動循環音效。若 Ambience 已經由音效按鈕開啟，Fader、Mute、Solo 仍會即時影響既有播放狀態。

同步更新 index.html 與 version.html 的資源快取參數為 20260622-b5-5，並在使用者版 version.html 的 v0.5b5 條目補充本次 EQ 與 Ambience 控制修正。

v0.5b5-6

修改時間：2026 06/22

修正循環 Ambience 在調整音量、Solo 時會短暫中斷再繼續播放的問題。updateAmbiencePlayback 不再於每次 Mixer 更新時對既有 Ambience audio 呼叫 load()，避免正在播放的音檔被重新載入而產生斷續。

重新定義 Ambience 的播放生命週期：只有專門的音效播放/暫停流程會執行淡入淡出；Fader 與 Solo 只更新 GainNode，不會暫停或重啟音檔；Mute 則會立即暫停該軌，解除 Mute 時若音效播放狀態仍開啟，會立即接回播放。

在「音樂與音效控制」標題旁新增無框隨機樣式按鈕，可在使用者自訂 Mixer 狀態與預設狀態之間切換。預設狀態為 Music 0 dB、未 Mute、未 Solo，當前曲目的 Music SFX 維持 -15 dB，其餘循環 Ambience 回到 -∞ dB 並停止播放。

同步更新 index.html 與 version.html 的資源快取參數為 20260622-b5-6，並在使用者版 version.html 的 v0.5b5 條目補充本次 Ambience 播放連續性與 Mixer 預設切換功能。

v0.5b5-7

修改時間：2026 06/22

重新定義播放器中的「音效」按鈕為 Effect Bus 總開關，同時納入 Music SFX 與循環 Ambience。只要目前曲目存在未靜音、音量大於 -∞ 的 Music SFX，或有已啟用的 Ambience，音效按鈕就會顯示為開始狀態。

調整音效暫停流程。按下音效按鈕關閉時，Music SFX 不再暫停音檔，而是把對應 Mixer 軌設為 Mute，讓 Music SFX 繼續跟著音樂時間軸前進；循環 Ambience 則將音量緩降到 -∞，緩降時間約 0.2 秒。

補上手動啟動規則。若音效按鈕處於暫停狀態，使用者拉起任一循環 Ambience 或 Music SFX 的音量、或解除 Mute，系統會自動把音效按鈕切回開始狀態；若所有 Music SFX 與 Ambience 都為 -∞ 或 Mute，音效按鈕會自動回到暫停狀態。

同步更新 index.html 與 version.html 的資源快取參數為 20260622-b5-7，並在使用者版 version.html 的 v0.5b5 條目補充本次 Effect Bus 音效總開關修正。

v0.5b5-8

修改時間：2026 06/23

為目前被曲目 Music SFX 佔用的 Mixer 軌道新增「暫停」按鈕。按下總音樂暫停後，Music 軌與所有當前 Music SFX 軌的暫停按鈕會一起亮起，讓使用者能看見純音樂與 Music SFX 都已停在同一時間點。

新增 Music SFX 暫停覆寫狀態。當音樂暫停時，若使用者再次點擊某條 Music SFX 的暫停按鈕使其變成開始狀態，系統會記住該 Music SFX 的暫停時間，暫時改用同一 Mixer 軌道播放對應的循環 Ambience；音樂恢復播放時，該軌會停止 Ambience 並回到原 Music SFX，從剛才記住的時間點繼續。

調整進度同步。當使用者拖曳進度或回到曲首時，若 Music SFX 處於暫停狀態，也會同步更新記憶中的暫停時間，避免下一次恢復時跳回舊位置。

重繪播放器「音效」按鈕圖示，改為白色 speaker 與圓弧造型，並增加白色光暈；按鈕底色仍沿用目前曲目或狀態色。

同步更新 index.html 與 version.html 的資源快取參數為 20260623-b5-8，並在使用者版 version.html 的 v0.5b5 條目補充本次 Music SFX 暫停與音效圖示更新。

v0.5b5-9

修改時間：2026 06/23

補上本機音檔的播放次數計算。使用者瀏覽本機音檔後，若播放滿 10 秒，網站會在前端記憶體中累加一次播放次數並更新播放器右上角顯示；此計數不會寫入 Supabase，重新整理頁面後會重置。

新增本機長檔名的自動捲動顯示。當本機音檔名稱過長時，大播放器與迷你播放器會依照實際文字寬度捲動，頭尾帶有淡出遮罩，且每次回到開頭會停留一段時間再繼續。

拆分播放模式按鈕。原先「專輯循環／單曲循環／隨機播放」三態按鈕改為「循環模式」與「隨機播放」兩顆小型無框按鈕，底部與上一首、開始、音效、下一首按鈕齊平；未啟用時為灰色，啟用時跟隨目前曲目顏色加深。

同步更新 index.html 與 version.html 的資源快取參數為 20260623-b5-9，並在使用者版 version.html 的 v0.5b5 條目補充本次本機音檔顯示與播放模式按鈕更新。

v0.5b5-10

修改時間：2026 06/23

優化專輯播放音訊預載。系統會優先預熱目前曲目、上一首與下一首的純音樂與 Music SFX，並在瀏覽器空閒時逐步預載整張專輯相關音檔，減少使用者切歌時的等待時間。

調整 Music SFX 與純音樂的起播流程。播放新曲或恢復播放時，系統會先等待主音樂與目前所有 Music SFX 都達到可播放狀態，再同步校正 Music SFX 的 currentTime，最後才一起呼叫 play，降低兩路音訊分開起跑的機率。

新增全站音訊讀取提示。若播放時音檔尚未讀取完成，畫面會暫時顯示「正在讀取網站」的大字遮罩，並播放一朵花從地上長出的循環 CSS 動畫；音檔 ready 後遮罩會淡出。

為音訊等待加入錯誤與逾時保底。若瀏覽器未回報 canplay 或某個音檔發生錯誤，等待流程會在保底時間後解除，避免網站永久停在讀取畫面。

同步更新 index.html 與 version.html 的資源快取參數為 20260623-b5-10，並在使用者版 version.html 的 v0.5b5 條目補充本次音訊讀取與同步起播優化。

v0.5b5-11

修改時間：2026 06/23

調整背景音檔預載策略。使用者進入網站後，系統會延後約 3.6 秒才開始悄悄預載音檔，先讀取目前曲目、上一首與下一首，再利用瀏覽器空閒時間分批預載整張專輯，避免一進站就造成介面卡住。

修復讀取畫面的花瓣顯示。讀取花朵改為四瓣循環綻放動畫，每次顯示時會從八色與希望色中隨機抽取花瓣色彩組合，並在「正在讀取網站」下方新增「今日花語：XXXX」文字區。

讀取遮罩現在會阻擋底層網站操作，避免使用者在音檔等待期間誤觸；同時把自訂滑鼠層級提高到遮罩之上，讓游標仍可正常顯示。

新增「或是先不播放這首音樂」按鈕。當新曲尚未讀取完成時，使用者可略過該曲並離開讀取畫面；系統會取消目前播放請求，並依照最近一次暫停或切歌前記錄的播放參數回到上一個曲目與時間點。若是自動下一首造成等待，則回到上一首曲目開頭。

加入隱藏式 Console Log。系統會記錄使用者互動、播放請求、音檔等待與 ready、背景預載、讀取畫面顯示與取消等流程；預設隱藏，連點左上角 Welcome / Secret Garden 品牌七次才會在左下角顯示，並可用面板內叉叉關閉。

同步更新 index.html 與 version.html 的資源快取參數為 20260623-b5-11，並在使用者版 version.html 的 v0.5b5 條目補充本次讀取畫面、略過按鈕與 Console Log 更新。

v0.5b5-12

修改時間：2026 06/24

新增音檔來源 ready 記憶。當背景預載 Audio 或實際播放器曾成功收到 canplay、canplaythrough 或足夠 readyState 時，系統會以完整 URL 記錄該音檔已經讀取完成。

調整快速切歌的讀取畫面判斷。音樂與 Music SFX 仍會等待整組 Audio 元件 ready 並校正時間後同步起播，但若所有來源 URL 都已有成功預載紀錄，等待會在背景靜默完成，不再重複顯示全螢幕讀取頁。

重新製作讀取花朵。花朵改為與「花朵綻放」相同概念的八瓣橢圓花瓣與中央花蕊造型，每次長出來時整朵花只使用同一個隨機顏色，下一輪生長動畫再切換另一個顏色。

同步更新 index.html 與 version.html 的資源快取參數為 20260624-b5-12，並在使用者版 version.html 的 v0.5b5 條目補充本次預載判斷與讀取花造型修正。

v0.5b5-13

修改時間：2026 06/24

為九條循環 Ambience 軌道新增獨立讀取狀態。當使用者拉起音量並啟動尚未 ready 的循環音效時，該軌原本顯示 dB 數值的位置會暫時改為轉圈 Loading 圖示。

循環音效收到 canplay、playing 或 error 事件後會結束讀取狀態並重新渲染 Mixer，Loading 圖示隨即恢復為該軌目前的正常 dB 數值；調整音量期間若仍在讀取，也不會提前覆蓋轉圈圖示。

修正總音樂恢復播放後 Mixer 暫停按鈕未同步更新的問題。純音樂與 Music SFX 在開始播放前清除暫停狀態後，現在會立即重新渲染 Mixer，讓 Music 軌與目前被佔用的 Music SFX 軌道一併取消暫停顯示。

同步更新 index.html 與 version.html 的資源快取參數為 20260624-b5-13，並在使用者版 version.html 的 v0.5b5 條目補充本次循環音效讀取提示與暫停狀態連動修正。

v0.5b5-14

修改時間：2026 06/24

修正循環 Ambience 偶發「推桿已有音量、Audio 也不是 paused、但實際沒有聲音」的競態。一般音量調整現在會先取消 GainNode 上尚未完成的舊 automation，再從目前 gain 值套用新的音量，避免先前 0.2 秒淡出排程在使用者拉起推桿後仍把音量拉回 0。

新增循環音效播放 watchdog。每條已啟用的 Ambience 在起播後會檢查 currentTime 是否真的前進，以及 AudioContext 是否維持 running；若媒體元素停滯、play 被拒絕或 AudioContext suspended，系統會顯示該軌 Loading、恢復 AudioContext 並重新送出播放。

若同一軌持續停滯，第二次自動恢復會保留原本播放時間，視需要重新 load 音檔後再播放；恢復期間不會任意跳回開頭。修復結果與失敗原因也會寫入隱藏式 Console Log，方便後續辨識瀏覽器層級問題。

保留音效總開關的淡入／淡出行為；一般推桿、Mute 與 Solo 操作仍直接改變 gain，不會因為新增自動恢復而重新觸發淡入動畫。

同步更新 index.html 與 version.html 的資源快取參數為 20260624-b5-14，並在使用者版 version.html 的 v0.5b5 條目補充本次循環音效無聲自動修復。

v0.5b6-1

修改時間：2026 06/24

將使用者提供的 Album、Single、Random 三個透明 PNG 圖示複製至 assets/icons/playback，並套用到專輯循環／不循環、單曲循環與隨機播放按鈕。圖示未啟用時以灰色無框顯示，啟用時才出現跟隨當前曲目顏色的圓形底色。

將循環模式改為三態切換：專輯循環播放、單曲循環播放、專輯不循環播放。專輯不循環會依目前播放清單順序播放至最後一首後自動停止；加入本機音檔時，順序播放會先播放所有本機曲目，再銜接原本十首專輯曲目。

重構隨機播放佇列。隨機播放會記錄本輪已播放曲目，確保整輪清單尚未耗盡前不會重複；專輯不循環模式下會在整輪結束後停止，專輯循環模式下則會在耗盡後重新洗牌。本機曲目加入後也會納入目前可播放清單。

本機音檔選擇器改為支援一次加入多個檔案。新增專用本機播放清單，顯示曲名、順序與讀取到的時長；使用者可以點擊播放、拖曳更換順序，或按叉叉刪除。刪除時會同步釋放 Object URL、預載 Audio 與網站內播放次數資料。

新增播放計時器。使用者可輸入 1 至 280 分鐘，啟動後顯示剩餘倒數並可隨時取消；倒數完成時會呼叫既有總播放暫停流程，停止純音樂、Music SFX 與循環音效。

修正本機曲目插入播放清單前方後可能造成的索引偏移。花朵綻放選曲、Hope Flower 圖片解鎖、專輯卡片 active 狀態與換歌花朵動畫，改為依實際曲目物件與 albumIndex 尋址。

三個圖示原檔已依規則備份至更新日誌/assets/v0.5b6-1。依使用者要求，本次重大播放功能更新重新歸檔為 v0.5b6-1，並在使用者版 version.html 新增 v0.5b6 條目。

v0.5b6-2

修改時間：2026 06/24

重新定義播放器音效控制開關的 active 狀態。若目前沒有 Music SFX 以外的循環 Ambience，當音樂與 Music SFX 一起暫停時，音效開關會自動切為暫停顯示，不再因 Mixer 中仍保留 Music SFX 音量而錯誤亮起。

新增暫停期間的 Music SFX 軌道 Ambience override。音樂暫停且沒有其他循環音效時，使用者再次點擊音效開關，會將目前曲目所佔用的 Music SFX 軌道暫時改播對應循環 Ambience；Blue 與 Gray 等雙 Music SFX 曲目會同時啟動兩條對應循環音效。

恢復音樂時會先停止上述 Ambience override，將 Music SFX 時間軸復原至剛才和音樂一起暫停的位置，再讓純音樂與 Music SFX 同步開始。若使用者在暫停期間再次關閉音效開關，只會停止 override 並保留 Music SFX 暫停位置。

將播放計時器與「匯入本機音檔」移出 Mixer 面板，改與「音效控制」按鈕排列在專輯標題下方同一工具列；本機播放清單則移至原本十首專輯曲目選擇器下方，即使不展開音效控制器也能管理本機曲目。

將 Album、Single、Random 三個播放模式圖示放大約 1.3 倍，但維持按鈕與啟用圓形色框原尺寸，讓圖示更清楚而不改變控制列佈局。

同步將網站目前版本提升為 v0.5b6，更新 index.html、script.js 與 version.html 的資源快取參數為 20260624-b6-2。

v0.5b6-3

修改時間：2026 06/24

修正快速連續切歌時，舊曲目的 Music SFX 可能在較晚完成讀取後重新播放，形成上一首或上上首音效殘留且無法由目前 Mixer 控制的競態。新的曲目讀取權杖建立前會取消上一個權杖，避免舊非同步播放流程繼續取得控制權。

新增 Music SFX 世代識別與全域播放實例登記。每次更換曲目都會立即停止所有舊世代 Music SFX；即使舊 Audio 的 play() 在切歌後才完成，播放流程也會再次檢查權杖與世代並立刻暫停。此掃除範圍僅包含專輯 Music SFX，不會停止或重置獨立的循環 Ambience 音效。

重新排列專輯工具列：將「音效控制」固定在標題區中央，播放計時器與「匯入本機音檔」集中排列在右側；行動裝置仍維持等寬直向排列，避免工具互相擠壓。

為「Welcome to the Secret Garden」等長曲名套用較小的專用字級與行高，避免標題超出播放器；同時固定右上角播放次數為不可壓縮項目並靠右對齊，使其維持與其他曲目一致的位置。

將使用者提供的 Secret Garden Vol. I 正式專輯封面套用至大播放器左側，移除舊版 Secret／Garden 疊字與旋轉唱片標示。保留原始封面檔，另產生 1800 × 1800、約 1.6 MB 的網站用壓縮 JPG。

使用者提供的播放器排版截圖與專輯封面原檔已收錄至更新日誌/assets/v0.5b6-3；同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260624-b6-3。

v0.5b6-4

修改時間：2026 06/24

配合正方形專輯封面重新整理大播放器垂直構圖。Now Playing、曲名、藝人與 EQ 改為靠近面板上方並保留舒適內距；播放控制與進度條則使用獨立 transport 群組固定靠近底部，避免播放器增高後所有內容仍擠在中央。

將大播放器進度條縮短至面板寬度約 60%，避開右側曲目花朵背景的主要顯示範圍，降低花朵遮住或穿過進度條的情況；行動裝置維持 100% 寬度以保留可操作性。

精簡專輯工具列文字與尺寸：「播放計時器」改為「計時」、分鐘輸入欄縮短，「匯入本機音檔」改為「本機音檔」。桌面版計時器與本機音檔按鈕維持同一水平列，手機版則延續直向排列。

重構 Web Audio 輸出路徑。純音樂、Music SFX 與九條循環 Ambience 不再各自直接連接輸出，而是先匯入共同 Master Bus，再由 Master Bus 同時送往實際音訊輸出、EQ 與新增的雙聲道 Master Meter，讓量表反映使用者最後真正聽到的混音總和。

在 Mixer 標題右側新增橫向左右聲道 Meter。量表使用 Master Bus 的即時 time-domain peak 計算音量，具備快速上升與較慢回落；0 dB 位置設有參考線，混音突破 0 dBFS 時會立即顯示「音量過大」。

新增過載 Peak Hold：突破 0 dBFS 後，Meter 最右側會鎖定一條具厚度的紅色直線；它會保留至換歌、暫停或使用者直接點擊紅線。即時過載文字會在音量回到安全範圍一秒後淡出；大播放器右上角也會同步淡入／淡出「音量過大」提示。

三張使用者提供的版面與 Meter 位置參考截圖已壓縮收錄至更新日誌/assets/v0.5b6-4；同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260624-b6-4。

v0.5b6-5

修改時間：2026 06/25

留言花園的留言檢視卡新增花朵色號資訊，在時間旁顯示對應色票與大寫 Hex 色碼，方便使用者確認該朵留言花的實際顏色。

將 Mixer 的純音樂軌最大音量限制為 0 dB，九條音效軌仍維持最高 +6 dB；純音樂既有超過 0 dB 的狀態也會在輸出增益與控制介面中被安全限制。

補齊 Master 過載警示至右上角迷你播放器。混音突破 0 dBFS 時會立即顯示「音量過大」，回到安全範圍一秒後再淡出，與大播放器和 Mixer Meter 共用同一套判定。

調整 Mixer 標題列的 Master Meter 垂直位置，使雙聲道量表與「音樂與音效控制」主標題置中對齊；淺色模式移除 Mixer 上方過深的覆蓋底色，並補強播放器標題、曲目卡、Mixer、播放清單等文字顏色，避免切換淺色模式後文字與背景融在一起。

恢復右上角迷你播放器長曲名的自動跑馬燈與頭尾淡出遮罩；修正大播放器曲名行高過緊造成 g、y 等下伸字母被裁切的問題。

將九條音效與純音樂 Mixer 軌道原本的單字圓形圖示，替換為 assets/icons/playback/SFX icon 中的圖片資產；為避免中文檔名與空白路徑造成瀏覽器相容問題，另建立 assets/icons/playback/sfx 的 ASCII 網站用檔名版本。

保留原本三位核心園丁卡片不變，於下方新增獨立協力人員 Credits 區，依「表演者、聲音技術執行、互動引導、攝影」分類顯示較小的圓形頭像、人名與職務。Helpers 中文原檔保留於原資料夾，網站實際引用改用 assets/gardeners/helpers-web 內的羅馬拼音 ASCII 檔名與壓縮 JPG。

五張使用者提供的留言／Mixer／淺色模式／曲名裁切參考截圖已壓縮收錄至更新日誌/assets/v0.5b6-5；同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260625-b6-5。

v0.5b6-6

修改時間：2026 06/25

統一 sfxChannelDefinitions 的 icon 與 iconSrc 欄位，九種循環音效全部改為指向 assets/icons/playback/sfx 中的實際 PNG 圖示，不再保留「雷、餐、窗、浪」等舊版單字圖示資料。

主專輯播放器在僅播放循環音效時，音效摘要由舊版「文字圖示＋名稱」改為真正的圓形音效圖片＋音效名稱；多軌同時播放時仍保留清楚的分隔與自動換行。

園丁 Credits 的「互動引導」改為專用單列版面。桌面版固定九欄平均排列，窄螢幕保持同一橫列並可水平滑動；每位成員保留最小欄寬，避免新增人員後換行或頭像、姓名彼此重疊。

同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260625-b6-6。

v0.5b6-7

修改時間：2026 06/25

重新校準 Master Meter 色彩分段。-10 dB 以下維持綠色，從 -10 dB 起漸變為黃色；-3 dB 起再漸變為紅色，0 dB 至 +6 dB 全段固定為紅色。色彩節點依目前 Meter 的 -60 至 +6 dB 顯示範圍精準換算。

僅播放循環音效時，大音樂控制器的曲目資訊列改為只顯示正在發聲軌道的音效圖片圖示，不再重複顯示「雷雨、餐廳」等文字；每個圖示仍保留 title 與無障礙名稱。

重做 Mixer 音量推桿的跨瀏覽器外觀與即時填色。淺色模式改用淺灰軌道、金色已調整區段與清楚的圓形滑塊，不再沿用瀏覽器深色原生控制樣式；拖動時填色會同步更新。

補強淺色模式 Master Meter 的雙聲道小外框與 0 dB 參考刻度，使其在白色面板上保持可辨識的灰色線條。

將專輯大播放器與右上角迷你播放器的音效開關圖示替換為 assets/icons/playback/sfx/sound.png。深色模式自動將黑色線條反相為白色並保留光暈，淺色模式使用原始黑色線條。

使用者提供的淺色 Mixer 參考截圖已壓縮收錄至更新日誌/assets/v0.5b6-7；同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260625-b6-7。

v0.6b1-1

修改時間：2026 06/25

重新設計聯網音訊資源排程。九條循環 Ambience 不再於網站初始化時同時 preload 與 load，只有使用者實際啟用該軌時才開始讀取，避免約數十 MB 的背景音效在首頁階段與專輯播放競爭頻寬。

建立可重用的 Music SFX 預載 Audio 元素池。背景已完成或正在進行預載的 Music SFX，在使用者真正播放對應曲目時會直接交由播放系統接管，不再另建一個 Audio 元素並重新要求相同來源；停止曲目後則歸還元素池供後續再次使用。

背景專輯預載改為網路感知的循序佇列。首頁先延後準備目前曲目，再處理下一首；只有在未開啟節省流量且網路品質足夠時才繼續預載其餘曲目。每組音樂與 Music SFX 必須到達 canplay 或逾時後才會進入下一組，避免慢網路下逐步堆疊成大量並行下載。

低優先序預載會在使用者正在讀取／播放曲目或頁面位於背景時暫停排程，待播放停止且頁面回到前景後再繼續；使用者成功起播後僅延後準備下一首曲目，確保播放操作永遠優先於背景下載。

使用者手動選曲時會立即取消其他尚未完成、且不屬於目前音樂／Music SFX 的背景預載請求；已經完成的快取與正在被播放流程接管的 Audio 不受影響，避免切歌當下仍被無關的 8 至 12 MB 音檔占用頻寬。

手機版音效控制器由十軌單欄改為雙欄卡片。每張軌道卡將圖示與名稱、暫停／Mute／Solo、音量推桿與 dB 數值分層排列，並縮整圖示、文字與間距；經 320px 與 390px 直式畫面測試，十張卡片均沒有文字或控制項重疊，也不會造成面板水平溢出。

完成手機版主要區域排版稽核，檢查頂部品牌與迷你播放器、八格底部導覽、首頁八色入口、花朵綻放、種花區、專輯工具列、大播放器、十張曲目卡、花卡、園丁 Credits、活動紀錄與聯絡按鈕。加高底部導覽觸控列、擴大八色入口並同步增加各區底部安全距離，避免內容被固定導覽遮住。

同步將網站目前版本提升為 v0.6b1，更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260625-06b1-1。

v0.6b1-2

修改時間：2026 06/25

修正 v0.6b1 首版在聯網環境中可能出現的音訊卡死：停止將背景預載用的 Audio 元素直接交給 Music SFX 正式播放，也移除切歌時會取消非優先預載元素的競態流程。Music SFX 現在一律使用獨立播放元素，預載僅負責暖機瀏覽器快取；主音樂與 Music SFX 仍會等待同組音檔可播放後同步啟動，若任一音檔逾時或讀取失敗，會結束讀取狀態並留下 Console 紀錄，不再讓播放流程永久停住。

補強八色花朵綻放音效：音效改為 auto preload，並在使用者點擊種子的同一個互動事件中立即送出播放請求，讓 Safari 等瀏覽器保留聲音播放授權，再由瀏覽器等待緩衝完成；若瀏覽器回報錯誤、逾時或播放事件未正常結束，會由安全計時器完成收尾並接續對應專輯曲目，避免播放器卡在「花朵綻放音效」。背景暖機順序改為先循序準備體積較小的九種開花音效，再準備目前專輯曲目；其餘曲目只在實際播放後按需準備，不再於初始階段載完整張專輯。讀取遮罩改為不攔截下層控制操作，使用者在等待期間仍可調整 Mixer Fader，右上角略過按鈕仍保留獨立點擊能力。

修正手機版「種下一些花」標題說明與「留言花園／種花」按鈕重疊，移除模式切換列的負邊距並保留穩定間隔。手機草原在縮放大於 0% 且未查看留言時，草原範圍內的手勢不再帶動整頁捲動；0% 總覽與查看花朵留言時則恢復頁面捲動。

重整手機版花朵留言聚焦構圖：目標花朵縮小並定位於左側，留言卡固定在右側且縮窄；情緒、留言內容、色號與時間資訊支援自動換行，避免花朵與文字卡重疊。更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260625-06b1-2。

v0.6b2-1

修改時間：2026 06/25

依使用者要求暫時拔除複雜音效控制播放引擎。專輯聆聽回到單一 HTMLAudioElement 播放模式，十首專輯曲目改讀取 assets/audio/Music 內的完整音樂檔，不再建立 Music SFX、Ambience 或 Mixer 相關播放隊列。

保留原有專輯播放器 UI、播放次數、本機音檔、計時器、專輯循環、單曲循環、專輯不循環與隨機播放等主要功能；音效控制器入口與音效開關暫時隱藏／停用，避免使用者再進入已拔除的 Mixer 流程。

播放流程改為只等待 backgroundAudio 本身，切歌、暫停、恢復與播放結束都不再呼叫 Music SFX group 同步起播。背景預載也只處理專輯單一音檔與 Bloom 開花音效，降低聯網環境中多音檔同步等待造成的卡死風險。

同步將網站目前版本提升為 v0.6b2，更新 index.html、script.js 與 version.html 的資源快取參數為 20260625-06b2-1，並在使用者版 version.html 新增 v0.6b2 條目。

v0.6b2-2

修改時間：2026 06/25

修復 v0.6b2 首版中花朵綻放音效消失的問題。setBloomChoice 不再將 bloomSfxAudio 登記為舊播放器運輸音訊，也不再等待 Mixer/可拖曳播放狀態；改為在使用者點擊種子或深連結入口後，直接讀取並播放 assets/audio/Bloom 對應音檔。

開花音效現在會先送出 play() 請求並記錄 Console Log，接著播放開花動畫；若瀏覽器允許播放，會等待音效播完或安全逾時後再啟動對應專輯曲目。若瀏覽器阻擋音效，動畫與專輯播放仍會繼續，不會造成整個 Bloom 流程停住。

v0.6b3-1

修改時間：2026 06/30

依使用者要求回到 v0.5b6 的音效控制版本。script.js 將 CURRENT_SITE_VERSION 提升為 v0.6b3，並重新啟用 MIXER_AUDIO_ENABLED，使專輯聆聽恢復 Music SFX、循環 Ambience、音效開關與 Mixer 控制器流程。

十首專輯曲目的 src 從 v0.6b2 的 assets/audio/Music 單檔回復為 assets/audio/Album 中的純音樂檔，並恢復各曲對應 Music SFX：Red 借用 Violet 雨滴軌，Orange、Yellow、Green、Violet 各自使用單一 SFX，Blue 使用 Wave 與 Bell 雙軌，Gray 使用 Birds 與 Wind 雙軌，Indigo 維持無 Music SFX。

恢復播放流程中的 prepareAlbumSfx 接點：手動選曲、切歌、回復等待前播放位置與起播時，會重新建立當前曲目的 Music SFX 播放隊列並交由 Mixer 控制；總播放／暫停雙擊邏輯也重新納入 Ambience 循環音效。

重新顯示專輯播放器與右上角迷你播放器的音效按鈕，並解除音效控制器入口的隱藏狀態。同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260630-06b3-1，並在使用者版 version.html 新增 v0.6b3 條目。

v0.6b3-2

修改時間：2026 06/30

修正 v0.6b3 恢復音效控制後，專輯音樂、Music SFX 與循環 Ambience 可能沒有正確發聲的問題。waitForMediaReady 不再於等待過程中反覆呼叫 audio.load()，避免正在準備或已啟動的 HTMLAudioElement 被重載中斷；playAlbumGroup 現在會先恢復 AudioContext，並將主音樂與 Music SFX 的 play() 結果寫入 Console Log，方便後續追查瀏覽器拒播或讀取失敗。

調整循環 Ambience 拉桿從 -∞ 啟動時的讀取狀態顯示。原本 ambienceLoading 變化會重新 render 整個 Mixer，導致使用者拖曳中的 range input 被移除重建，出現拉到 -58 dB 左右就卡住的手感；現在改為只局部更新該軌道的 dB 顯示與 loading spinner，不再打斷拖曳。

開花音效重新接入播放器 transport。當八色或隱藏花播放 Bloom 音效時，專輯播放器與右上角迷你播放器會顯示對應的「XX花朵綻放音效」，進度條與時間顯示會跟隨 bloomSfxAudio，使用者可暫停、恢復與拖曳音效時間軸；音效結束後會自動回到原本播放狀態。

修正「專輯循環／單曲循環／隨機播放」三個圖示空白。播放模式按鈕不再依賴 CSS mask 讀取白色 PNG，而改用直接 background-image 顯示，並在深色與淺色模式下分別調整 opacity/filter，降低瀏覽器對 mask 與透明 PNG 支援差異造成的顯示問題。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260630-06b3-2，並在使用者版 version.html 的 v0.6b3 條目補充本次音訊與圖示修復。

v0.6b3-3

修改時間：2026 06/30

修正實測中專輯播放器可能停在「準備播放曲目」但沒有進入 audio.play() 的情況。playAlbumGroup 原本會 await AudioContext.resume()，在部分瀏覽器或本地測試情境中 resume promise 可能不會立即 resolve，導致後續主音樂與 Music SFX 的起播流程被阻塞。

AudioContext 恢復改為非阻塞呼叫，若失敗會寫入 Console Log，但不再阻止 HTMLAudioElement 的 play() 流程繼續執行。這讓專輯音樂與 Music SFX 能先取得使用者點擊所提供的播放權，再由 AudioContext 於背景恢復 Mixer、EQ 與 Meter 的 Web Audio 路徑。

同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260630-06b3-3，避免瀏覽器沿用 v0.6b3-2 的舊腳本。

v0.6b3-4

修改時間：2026 06/30

修正實測中 Music SFX 已經讀取完成，但播放流程仍沒有寫出「同步起播音樂與 Music SFX」並停在暫停狀態的問題。原因是第一批 audio.play() promise 可能在瀏覽器等待緩衝或播放權時長時間 pending，導致後續同步校正與重試流程被卡住。

現在 playAlbumGroup 會在使用者點擊當下發出主音樂與 Music SFX 的 play request，但不再等待這批 promise settle；等待音檔 ready 後會立即同步 Music SFX 時間軸，並針對仍處於 paused 的音訊執行重試起播。這讓讀取完成後的收尾流程不會被單一 pending play request 卡死。

同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260630-06b3-4，避免瀏覽器沿用 v0.6b3-3 的舊腳本。

v0.6b3-5

修改時間：2026 06/30

調整 Master Meter 顯示邏輯。原本量表填滿條本身使用完整綠黃紅漸層，導致即使音量尚未進入黃色或紅色區域，填滿條最尖端仍會顯示黃紅色；現在改為量表背景固定為 dB 標尺色，並以右側遮罩裁切未填滿區域，讓顏色只在音量實際抵達對應 dB 位置時顯示。

將色彩標尺固定為 -60 dB 至 0 dB 對齊畫面 91% 的白色基準線：-10 dB 後開始進入黃色，-3 dB 後進入紅色，0 dB 以上維持紅色。若音量條未到達 -10 dB，整段可見量表會保持綠色。

音量過大警示改為依照畫面表頭是否超過 0 dB 白線判斷，而不是直接用瞬間 raw peak 觸發。這讓 Meter 右側紅線、Mixer 區「音量過大」、大播放器與迷你播放器警示都與實際表頭位置一致。

同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260630-06b3-5，避免瀏覽器沿用 v0.6b3-4 的舊腳本與樣式。

v0.6b3-6

修改時間：2026 06/30

修正 Master Meter 在播放任何正常聲音時都接近破表的問題。先前 Meter 長條使用 getFloatTimeDomainData 的瞬間 peak 作為顯示長度，mastering 後的音樂峰值常接近 0 dB，因此視覺上會長時間貼近紅色區域。

將 Meter 長條改為使用 RMS 平均能量計算，並加入快速上升、較慢下降的平滑係數，讓量表顯示更接近使用者聽到的整體音量動態；原本的 peak 仍保留用於判斷是否真的超過 0 dB，以避免正常音樂峰值接近 0 dB 時誤觸「音量過大」。

同步更新 index.html、script.js 與 version.html 的資源快取參數為 20260630-06b3-6，避免瀏覽器沿用 v0.6b3-5 的舊 Meter 邏輯。

v0.6b3-7

修改時間：2026 06/30

續修 Master Meter 仍持續顯示破表的問題。追查後發現 v0.6b3-5 雖然已將量表底層改為固定 dB 標尺，但用來遮住未填滿區段的遮罩仍是半透明背景，導致右側尚未抵達的黃色與紅色區域會透出來，視覺上看起來像整條量表一直滿格。

將深色與淺色模式的 Meter 未填滿區段改為實色遮罩，讓固定 dB 標尺只在目前音量實際抵達的位置以前顯示；未抵達的區域會呈現空軌道，不再透出紅黃漸層。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260630-06b3-7，避免瀏覽器沿用 v0.6b3-6 的舊 Meter 樣式。

v0.6b3-8

修改時間：2026 06/30

修正 Master Meter 表頭刻度與音量過大判斷沒有使用同一標準的問題。前一版 Meter 長條已改用 RMS 顯示整體音量，但過載警示仍以瞬間 peak 超過 1.0 判斷，因此會出現表頭仍在量表約三分之二處，卻已跳出「音量過大」的矛盾狀態。

新增統一的 dB 與百分比換算函式，讓 Meter 表頭、-10 dB 黃區、-3 dB 紅區、0 dB 白線位置，以及「音量過大」警示全都使用同一套 MASTER_METER 常數。現在只有當實際顯示的表頭抵達或超過 0 dB 白線時，才會觸發過載提示與紅色鎖定線。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260630-06b3-8，避免瀏覽器沿用 v0.6b3-7 的舊 Meter 判斷。

v0.6b3-9

修改時間：2026 07/01

依使用者要求在 Master Meter 上方新增跳格 dB 數字刻度。刻度目前標示 -60、-40、-24、-12、-3、0，且每個數字都透過 dbToMeterPercent() 與 Meter 表頭、顏色區段及 0 dB 白線共用同一套換算標準。

將 Master Meter 開始漸層變黃的基準從 -10 dB 調整為 -12 dB，並同步更新 CSS 變數 --meter-yellow-position，避免視覺標尺與警示判斷分離。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260701-06b3-9，避免瀏覽器沿用 v0.6b3-8 的舊 Meter 樣式與刻度。

v0.6b3-10

修改時間：2026 07/01

依 DAW 實測結果校準 Master Meter 顯示。新增 MASTER_METER_CALIBRATION_DB = 8，讓 Meter 讀取到的 RMS 波形在轉換為 dB 顯示前加上 8 dB 補償；此補償只影響 Meter 表頭與音量過大警示，不改變實際播放音量與 Mixer 增益。

新增 Mixer 便利用法：雙擊任一軌 dB 數字會回到該軌當前情境的預設音量。Music 軌回到 0 dB；Music SFX 軌回到 -15 dB；循環音效軌回到 0 dB，若原本已是 0 dB 則切回 -∞ dB。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260701-06b3-10，避免瀏覽器沿用 v0.6b3-9 的舊 Meter 校準與 Mixer 操作。

v0.6b3-11

修改時間：2026 07/01

依使用者實測將 Master Meter 顯示校準補償由 +8 dB 微調為 +7 dB。此調整仍只套用於 Meter dB 顯示與過載警示判斷，不改變實際播放音量或 Mixer 推桿增益。

修正 Master Meter 右側紅色過載鎖定標示的垂直位置。過載標示現在對齊 Stereo 雙聲道量表本體，而不是跟包含上方 dB 數字刻度的整個 Meter 區塊置中。

同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260701-06b3-11，避免瀏覽器沿用 v0.6b3-10 的舊 Meter 校準與樣式。

v0.6b3-12

修改時間：2026 07/01

依使用者要求重新校準 Master Meter 顏色分段。新增 -14 dB 開始轉黃、-12 dB 完全黃色、-4 dB 開始轉紅、0 dB 完全紅色四個節點，並透過 dbToMeterPercent() 統一換算為 CSS 變數，讓顏色、刻度與表頭位置仍共用同一標準。

調整音量過大警示判斷，改為表頭明確越過 0 dB 白線後才觸發，並加入 0.5% 視覺安全邊界，避免音量條尚未碰到或尚未越過 0 dB 線時就亮起警示。

再次微調右側紅色過載鎖定標示的位置，讓它比 v0.6b3-11 再往下對齊 Stereo 雙聲道 Meter 本體。同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260701-06b3-12。

v0.6b3-13

修改時間：2026 07/01

依使用者要求再次校準 Master Meter 顏色分段：黃色漸層改為 -12 dB 開始、-8 dB 完全黃色；紅色漸層維持 -4 dB 開始、0 dB 完全紅色。CSS fallback 與 JS 變數同步更新，避免載入瞬間使用舊標尺。

修正音量過大警示與 0 dB 白線可能看起來不同步的問題。新增 --meter-overload-position，讓白線位置直接使用與過載判斷相同的 getMasterMeterOverloadThresholdPercent()；過載門檻回到精準 0 dB，不再另加 0.5% 邊界。

右側紅色過載標示不再永久鎖住；當表頭回到 0 dB 以下並經過原本的一秒淡出時間後，紅色標示會一起消失，避免「目前沒有超過 0 dB 線卻仍顯示音量過大」的誤判。同步更新 index.html、styles.css、script.js 與 version.html 的資源快取參數為 20260701-06b3-13。

v0.6b3-14

修改時間：2026 07/01

依使用者要求將 Master Meter 顯示校準補償由 +7 dB 降為 +6 dB。此次僅調整 MASTER_METER_CALIBRATION_DB 常數，不更動 Meter 顏色分段、0 dB 白線或警示邏輯。

同步更新 index.html、script.js、styles.css 與 version.html 的資源快取參數為 20260701-06b3-14，避免瀏覽器沿用 v0.6b3-13 的舊校準值。