第 90 版完整增量專案清單與部署手冊
查核日期：2026-10-06（臺灣）
文件涵蓋第 90 版；發布文件會產生新的網站版本，並非重寫已保存的 V90。

一、可驗證的保全聲明
V87 基準：948 個追蹤檔案；逐位元比對修改 0、遺失 0；提交 1a9075afe6abb62639b0b37961c0bde724ec654d。
V88 基準：950 個追蹤檔案；逐位元比對修改 0、遺失 0；提交 c4ca43c324a6407c1bbd6968bf79ca6b1c343093。
V89 基準：951 個追蹤檔案；逐位元比對修改 0、遺失 0；提交 d33f670a1a8a461658212b0f4ea89514596e5db6。
V90 基準：952 個追蹤檔案；逐位元比對修改 0、遺失 0；提交 d55494f2b346cd384b3af6f9c8f080e868c4baba。
本次新增三個文件，原有 952 個追蹤檔案全部保持逐位元一致，含原有設定、紀錄及 /experience/。安全的 100% 僅指上述來源檔案比對一致；不能表示沒有任何資安漏洞、外部主機設定不變、效能達標或所有裝置皆無瑕。未取得原主機的全部檔案與設定，不能替原主機做全面保證。SHA256 清單可供後續查核，不含 Git 內部資料與未追蹤檔案。

二、新增模組總結（下列路徑均位於 dist/addons/）

基礎外掛入口
檔案：index.html、video-hub.html、story-journeys.html、impact-dashboard.html、assets/addon-core.css、assets/addon.js、assets/youtube-facade.js、data/videos.json、data/impact.json、README.md
功能與限制：既有情境動畫、故事旅程、待核驗指標；共用樣式只供外掛使用

V80 電影故事專區
檔案：cinema.html、cinema-block.html、CINEMA-README.txt
功能與限制：主視覺、卡片與點擊播放既有情境動畫

V81 沉浸互動
檔案：immersive.html、immersive-block.html、IMMERSIVE-README.txt、data/latest-videos.json
功能與限制：本機愛心、待核驗指標、影片資料介面；未接即時頻道

V82 微電影企劃
檔案：microfilm-plans.html、data/microfilm-plans.json
功能與限制：手心的溫度／阿嬤的秘密花園／重拾笑容的餐桌：180 秒腳本，尚非已拍成影片

V83 電影院
檔案：cinema-module.html
功能與限制：YouTube 點擊載入、16:9／9:16、原生彈窗、狀態音波與光暈

V84 生命旅程
檔案：warmth-journey.html
功能與限制：綜合情境時間軸、本機祝福與輪換金句

V85 SEO 與頻道導流
檔案：video-config-v85.js、video-schema-v85.js、youtube-widget-v85.js、video-seo.html、VIDEO-V85-INSTALL.txt
功能與限制：核驗配置後才輸出 VideoObject；可收折影片入口；非自動最新影片串流

V86 聲景與朗讀
檔案：audio-module.html
功能與限制：手動啟動合成鋼琴音、系統語音、音量與滾動淡出；語音服務可能連網

V87 透明儀表板
檔案：impact-transparency-v87.html
功能與限制：核驗數據後計數；85／10／5 僅版面示例，不是實際財務比例；文件待提供

祝福牆 V87（網站 V88）
檔案：warmth-wall-v87.html、WARMTH-WALL-INSTALL.txt
功能與限制：暱稱短句只在本次頁面記憶；PNG 明信片、裝置分享；非多人同步牆

V89 3D 藝廊
檔案：gallery-module-v89.html
功能與限制：六張情境 SVG、拖曳、分類、照片彈窗；並非真人劇照

V90 暖心引導
檔案：ai-warm-guide-v90.html
功能與限制：四類本機規則導引；非生成式 AI、非真人、未送出申請

三、建議完整網站結構
原網站所有頁面保持原狀。新增的 master-guide-v90.html 是文件入口，不會自動注入原首頁。建議正式整合時僅選：一套電影專區、一套祝福牆、一個服務入口、一個透明儀表板；其餘以連結導覽，避免 V79/V80/V83 等相近元件同時載入。

四、非工程師安裝步驟（一次只做一個動作）
1. 先下載主機完整網站與設定備份，確認能解壓及還原；另保存目前來源提交。公開頁面下載不等於完整主機備份。
2. 在測試副本新增 addons/ 資料夾，複製 dist/addons/ 的完整內容；保留相對路徑。原頁面不要覆蓋。
3. 原動畫仍依賴 assets/v46-care-films/ 等現有資產；部署必須保留整個原 dist/，不能只上傳 addons/ 後取代根目錄。
4. 先開 /addons/master-guide-v90.html，逐一開模組；未整合原頁時仍是獨立頁。
5. 若只要零修改原始碼，以獨立入口連結或外部導航到模組；純靜態 HTML 沒有自動 include。
6. 若要嵌入原頁，先取得允許新增引用的確認。建立 staging 副本，只在選定區域新增模組完整 section（含其 style/script），依個別安裝檔操作；不得把整個 html/head/body 嵌入 body。這一步會新增原 HTML 的引用，因此不屬於原檔逐位元不變，應另做差異審核。
7. iframe 是另一種隔離方法：可嵌獨立模組網址並給 title；但跨框架浮動定位、焦點與高度必須測試，不能保證所有模組無痛套用 iframe。
8. 每次只整合一個模組，核對相對連結、data-site-base 或 data-asset-base。根目錄部署通常用 /；子目錄部署須寫真實前綴。
9. 避免浮動按鈕互遮：V90 可設定 --tlfca-companion-bottom；音訊左下、服務右下，影音小工具建議改放普通區塊或取消重複入口。手機底部導航、安全區與大字級都要實測。
10. 測試通過後才部署完整 dist/ 的增量檔案；不執行清空目錄、不使用會刪除遠端的同步參數、不改 /experience/ 存取方式。

五、上線前內容配置
YouTube：由協會提供正式頻道與影片 ID；空白不得假裝可播放。V83/89 使用各卡片的資料欄位；V85 集中在 video-config-v85.js，確認縮圖、真實上架時間、影片頁網址與說明。VideoObject 只對符合核驗條件及指定影片頁輸出，不保證 Google 收錄或富摘要。
影響力：保留盤點中，待協會提供期間、統計口徑、核驗來源與值，再依各模組配置 verified。不得以本機點擊數冒充服務人次。
財務：85/10/5 示意圖在取得正式財務資料前須維持醒目示例標示；建議公開首頁先只用待提供表格。
文件：未提供正式授權文件前，下載按鈕保持待提供；不能連空檔或捏造理監事紀錄。
素材：取得真人影像、姓名及影片授權才替換情境插畫；持續保留情境示例標示。
諮詢：V90 不送出個資，不代表報名已完成。若日後接表單或 AI，需另建接收服務、告知與同意、保存/刪除政策；API 金鑰不得放前端。
分享：PNG 下載可用；裝置支援 Web Share 才能叫出分享面板，無法保證一鍵直接發到 Facebook、LINE 或 Instagram；不支援時手動上傳。
聲景：預設不播放，由使用者按鈕啟動。原朗讀工具與新系統朗讀避免同時播放；尊重減少動態效果。

六、正式整合驗收
□ 320/375/390/768px、iPhone 與 Android：無橫向溢出、44px 觸控目標、200% 字級、不遮導航。
□ 鍵盤 Tab/Shift+Tab、Enter、Escape、彈窗關閉回焦、螢幕閱讀器、對比與減少動態效果。
□ 沒有影片 ID、網路失敗、未提供文件時：誠實提示，不顯示成功送出。
□ 載入前無 YouTube 播放器請求、聲景無自動播放；整合後檢查實際網路請求與主機 CSP。
□ HTTPS、子目錄路徑、iframe/YouTube 權限及系統朗讀支援逐項測試。
□ 手機 PageSpeed 在正式整合後測量；未實測不得聲稱 90 分或零延遲。
□ 確認所有原故事、倫理文字、政府專線、捐款聲明、/experience/ 及 SEO 原設定保留。
□ 若未能通過，回退到備份來源；只卸載新增模組引用與新增檔案，不刪原資料。

七、目前完成與未完成
已完成：獨立模組檔案、來源比對、各模組先前語法與部分邏輯檢查、本部署手冊及檔案雜湊清單。
未完成：全站原頁整合、真人影片拍攝、正式頻道串接、核驗財務數據、正式文件、接收表單、多人祝福後端、完整手機/無障礙/效能實測。不可把本手冊當作全部已上線證明。

八、本次新增文件
DEPLOY-MASTER-GUIDE.txt：部署與模組清單。
master-guide-v90.html：可閱讀的文件與模組入口。
V90-ORIGINAL-FILES-SHA256.json：第 90 版 952 個原檔雜湊與比對結果。