Google Drive 媒體發布標準程序
定案架構
小世界的照片、影片、聲音與大型文件採「Google Drive 長期保存,GitHub Pages 直接引用 Drive 連結」。不另建網站媒體 R2,不強制轉檔,也不把大型原件複製進 Git。
flowchart LR A[LINE 提供資料] --> B[Cloudflare R2 私人暫存] B --> C[Google Drive 私人案件資料夾] C --> D[AI 整理與提供者確認] D --> E{是否要在網站展示} E -->|否| F[Drive 繼續私人保存] E -->|是| G[只公開該單一媒體檔] G --> H[Markdown 記錄 Drive 連結] H --> I[GitHub Pages 開啟 Drive 預覽] I --> J[案件結案] J --> K[人工確認後清理 R2]
三層分工
| 位置 | 用途 | 保存期間 | 存取狀態 |
|---|---|---|---|
| Cloudflare R2 | LINE 收件與 Drive 備份前的暫存 | 案件完成為止 | 私人 |
| Google Drive | 原始照片、影片、錄音、文件與案件 JSON 的長期正本 | 長期 | 預設私人;網站選用的單檔才開放連結閱覽 |
| GitHub Pages | HTML、JavaScript、JSON、Markdown 及 Drive 連結 | 可重建 | 現行親友禮貌門+noindex |
分享權限的必要規則
- LINE 案件根資料夾、
CASE-LINE-*資料夾與案件 JSON 一律保持「受限制」。 - 只有經提供者確認、資料管理者核准,並實際要在網站顯示的單一媒體檔,才改為「知道連結的任何人/檢視者」。
- 不得把整個案件資料夾改為公開,否則未選用原件與案件 JSON 也會一併暴露。
- Drive 的「知道連結的任何人」不等於受網站 JavaScript 密碼保護;只要知道 Drive 連結就能開啟,因此只能發布已同意給親友閱覽的媒體。
- 若媒體含未經同意的在世人個資、身分文件、地址或其他敏感內容,保持私人,不建立網站連結。
單一媒體的標準欄位
第一版不另建複雜媒體資料庫。在最相關的人物、事件、故事或來源 Markdown 中使用 media_links:
media_links:
- media_id: M000001
kind: image # image | video | audio | document
title: 媒體標題
description: 畫面、人物或內容說明
source_case: CASE-LINE-20260816-000007
source_message_id: 14
storage: google_drive
drive_file_id: Google-Drive-檔案-ID
view_url: https://drive.google.com/file/d/Google-Drive-檔案-ID/view
preview_url: https://drive.google.com/file/d/Google-Drive-檔案-ID/preview
access: anyone_with_link
contributor: 資料提供者姓名或代碼
permission_confirmed: true
review_status: reviewed
published_on: 2026-08-20
last_checked_on: 2026-08-20media_id是小世界內部永久 ID,Drive 檔名、網址或所在資料夾改變時不更換。drive_file_id供日後重建連結與核對。view_url是網站預設的「開啟原件」連結。preview_url可用於 Google Drive 預覽視窗;若瀏覽器或 Drive 限制嵌入,頁面必須仍保留view_url備援。last_checked_on用來記錄最後一次以未登入視窗測試的日期。
網頁引用方式
最穩定、最簡單的第一版是開啟 Drive 預覽頁:
[開啟照片原件](https://drive.google.com/file/d/FILE_ID/view)需要在頁面內預覽影片、聲音、PDF 或照片時,可使用 Drive 預覽視窗:
<iframe
src="https://drive.google.com/file/d/FILE_ID/preview"
title="媒體標題"
loading="lazy"
allow="autoplay"
></iframe>不把 Google Drive 短期縮圖網址當作 Markdown ![]() 圖片來源。縮圖網址可能過期;相片也優先使用 Drive 預覽視窗與「開啟原件」連結。
日常標準程序
- 親友將文字或媒體傳給 LINE 官方帳號。
- Worker 將文字寫入 D1,媒體暫存私人 R2。
- 資料管理者按「接受並建立案件」。
- 有附件的案件按「一鍵備份並核對 Google Drive」,確認檔案大小與案件 JSON 正確。
- AI 整理資料,再由提供者與資料管理者確認。
- 對每一個要放上網站的媒體,先執行
npm.cmd run line:media-consent -- <案件流水號> <訊息流水號> "同意依據" "我已核對提供者同意公開此單檔",把逐檔同意與依據寫入 D1。沒有這筆紀錄時,Worker 不提供公開操作。 - 再執行
npm.cmd run line:publish-media -- <案件流水號> <訊息流水號>;Worker 會確認案件 Drive 資料夾仍為私人、檔案確實位於該案資料夾、位元組數一致,才只將該單檔設為「知道連結的任何人/檢視者」。 - 在對應 Markdown 的
media_links記錄媒體 ID、Drive file ID、連結、來源案件、提供者、同意與檢查日期。 - 開啟未登入 Google 的瀏覽環境,確認原始圖片端點回傳正確 MIME,且
view_url不需 Google 登入也能開啟。 - 執行
npm.cmd run verify:release,檢查網頁連結、來源與網站建置。 - 將 Markdown 與網站改動提交、推送並等待 GitHub Pages 完成。
- 將案件標記為「已發布」再「結案」。
- 最後執行
npm.cmd run line:clear-r2 -- <案件流水號> "清理 R2",或在私人審核頁輸入同樣文字;系統確認 Drive 已核對、網站已發布、案件已結案後,才會刪除 R2 原檔。
R2 清理後的資料
R2 清理後:
- Google Drive 保留所有原始媒體與案件 JSON;
- D1 保留案件編號、檔名、MIME、大小、Drive file ID、備份時間與 R2 清理時間;
- GitHub 保留正式 Markdown 及 Drive 連結;
- R2 不再保留該案件的原始附件。
若 Drive 原檔被移除、改權限或改用新檔,網站連結會失效。修正時保留原 media_id,只更新 Drive file ID、網址與 last_checked_on。
定期檢查
- 新案件發布時:必查本案所有新 Drive 連結。
- 網站改版時:抽查照片、影片、聲音與 PDF 各一筆。
- 每年一次:以無痕視窗開啟所有
media_links.view_url;失效時改為status: broken,不直接刪除歷史記錄。
已知限制
這是為了低流量、家族內部使用而刻意選擇的簡化方案。Google Drive 不是專用 CDN;若日後出現大量瀏覽、預覽限流、嵌入失效或網址不穩,再將「網站顯示用媒體」搬到專用媒體儲存;原始 Drive 檔與 media_id 不需改變。