V104 YouTube 影片與縮圖維護指南
社團法人台灣長期照顧家庭關懷協會
文件日期：2026-10-06

一、這次新增什麼
1. /addons/video-config.json：11 個影片位置的集中設定。
2. /addons/video-config-loader-v104.js：讀取設定並更新卡片。
3. /community-videos-v104.html：已載入設定腳本的獨立示範頁。
4. 本說明及 SHA256 比對紀錄。
原有 V102、V103 與其他頁面完全未修改；不宣稱全站已接入。

二、影片 ID 是什麼
網址：https://www.youtube.com/watch?v=t7gt_TKAlK8
影片 ID：t7gt_TKAlK8（v= 後面、下一個 & 前面的 11 個字元）
短網址：https://youtu.be/t7gt_TKAlK8
Shorts：https://www.youtube.com/shorts/YOUR_VIDEO_ID
YOUR_VIDEO_ID 只是示意，請換成真正的 11 字元 ID，不要連 v= 一起貼。

同一個 ID 的對照：
原片：https://www.youtube.com/watch?v=t7gt_TKAlK8
高畫質：https://i.ytimg.com/vi/t7gt_TKAlK8/maxresdefault.jpg
一般畫質：https://i.ytimg.com/vi/t7gt_TKAlK8/hqdefault.jpg
播放器：https://www.youtube-nocookie.com/embed/t7gt_TKAlK8
縮圖不一定是影片開頭第一幀，也不是無版權證明。
V103 外掛優先探測高畫質，失敗、超時或尺寸不足則保留一般畫質。
16:9 裁切可減少外部黑邊，不能保證移除畫面內的黑邊。

三、只做一個動作：換一支影片
打開 addons/video-config.json，找到要更換的 slot，例如 slot: 1。
將 videoId 的值換成已確認的真實 ID，儲存並依原部署方式重新發布。
已接入的頁面會自動產生原片網址、HQ 封面及 HD 探測網址；不用改 HTML。
若是不同影片，請同步修正 title、summary、source、published、license；
checkedDate 填實際人工查核日期，不能保留錯誤署名或舊影片摘要。

一筆設定範例（完整檔案仍需保留其餘 10 筆）：
{
  "slot": 1,
  "videoId": "t7gt_TKAlK8",
  "title": "長照，就交給1966接吧！（國語版）",
  "category": "認識長照",
  "source": "中華民國衛生福利部",
  "published": "2025-01-02",
  "summary": "從一通電話開始，認識長照服務的入口。",
  "license": "未確認 CC 或公眾領域授權；僅提供原平台嵌入及連結"
}

四、JSON 編輯注意
固定保留 11 筆、slot 1–11 不重複。此次支援更換既有位置，不支援只靠 JSON 新增分類或擴增卡片數。
category 可用：家庭陪伴、社區友善、暖心相聚、認識長照、失智理解。
保留半形雙引號、逗號及括號；最後一筆後不要多加逗號。不可放註解。
標題與文字以純文字呈現，不執行其中的 HTML。
無有效設定、網路失敗或格式錯誤時，頁面保留原先 11 張卡片並顯示提示。

五、如何檢查
開啟 /community-videos-v104.html，確認出現「已讀取影片設定」提示。
檢查更換的位置：標題、來源、封面、原片連結是否對應同一支影片。
點播放，確認影片正確；試分類、搜尋、關閉、手機與鍵盤操作。
高畫質不存在時應保留 HQ，不應清空卡片。播放受原作者與 YouTube 限制。
直接用 file:// 開啟 HTML 可能無法讀取 JSON，請透過網站網址查看。

六、全站共用的範圍與接入方式
JSON 不會自行控制所有舊頁；頁面必須載入腳本並具有相容的卡片結構。
目前只有新增的 V104 示範頁已接入，V102 原頁完全未動。
未來若協會授權在相容頁的頁尾加入以下一行，可共用同一設定：
<script src="/addons/video-config-loader-v104.js" defer></script>
這是部署人員一次性的接入工作；接入完成後日常換片只需改 JSON。
其他播放器、3D 藝廊、企劃頁及不同資料結構，需另外做轉接，不能只貼此腳本就保證全站更新。
禁止同時在該頁先掛 V103 再掛設定腳本；設定腳本會在卡片更新完成後載入 V103。

七、版權與隱私
公開影片不等於可任意下載、剪輯或重新上傳；請核對原發布來源與使用條件。
外部影片不能當成本協會服務成果，不加入其他組織的捐款帳號。
封面載入會連線 YouTube 圖片伺服器；播放器只在點擊後載入。
不新增表單、追蹤碼、API 金鑰或個資蒐集。

八、安全比對
原有 986 個追蹤檔案與本次修改前 ZIP 逐一 SHA256 比對一致。
舊檔修改 0、刪除 0；新增 5 個檔案。
比對涵蓋這次可取得的專案來源，不代表外部主機、帳號設定或 YouTube 授權均已驗證。
本次完成設定檔與腳本檢查；實際影片播放、縮圖及跨裝置驗收仍需瀏覽器確認。