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 R2LINE 收件與 Drive 備份前的暫存案件完成為止私人
Google Drive原始照片、影片、錄音、文件與案件 JSON 的長期正本長期預設私人;網站選用的單檔才開放連結閱覽
GitHub PagesHTML、JavaScript、JSON、Markdown 及 Drive 連結可重建現行親友禮貌門+noindex

分享權限的必要規則

  1. LINE 案件根資料夾、CASE-LINE-* 資料夾與案件 JSON 一律保持「受限制」。
  2. 只有經提供者確認、資料管理者核准,並實際要在網站顯示的單一媒體檔,才改為「知道連結的任何人/檢視者」。
  3. 不得把整個案件資料夾改為公開,否則未選用原件與案件 JSON 也會一併暴露。
  4. Drive 的「知道連結的任何人」不等於受網站 JavaScript 密碼保護;只要知道 Drive 連結就能開啟,因此只能發布已同意給親友閱覽的媒體。
  5. 若媒體含未經同意的在世人個資、身分文件、地址或其他敏感內容,保持私人,不建立網站連結。

單一媒體的標準欄位

第一版不另建複雜媒體資料庫。在最相關的人物、事件、故事或來源 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-20
  • media_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 預覽視窗與「開啟原件」連結。

日常標準程序

  1. 親友將文字或媒體傳給 LINE 官方帳號。
  2. Worker 將文字寫入 D1,媒體暫存私人 R2。
  3. 資料管理者按「接受並建立案件」。
  4. 有附件的案件按「一鍵備份並核對 Google Drive」,確認檔案大小與案件 JSON 正確。
  5. AI 整理資料,再由提供者與資料管理者確認。
  6. 對每一個要放上網站的媒體,先執行 npm.cmd run line:media-consent -- <案件流水號> <訊息流水號> "同意依據" "我已核對提供者同意公開此單檔",把逐檔同意與依據寫入 D1。沒有這筆紀錄時,Worker 不提供公開操作。
  7. 再執行 npm.cmd run line:publish-media -- <案件流水號> <訊息流水號>;Worker 會確認案件 Drive 資料夾仍為私人、檔案確實位於該案資料夾、位元組數一致,才只將該單檔設為「知道連結的任何人/檢視者」。
  8. 在對應 Markdown 的 media_links 記錄媒體 ID、Drive file ID、連結、來源案件、提供者、同意與檢查日期。
  9. 開啟未登入 Google 的瀏覽環境,確認原始圖片端點回傳正確 MIME,且 view_url 不需 Google 登入也能開啟。
  10. 執行 npm.cmd run verify:release,檢查網頁連結、來源與網站建置。
  11. 將 Markdown 與網站改動提交、推送並等待 GitHub Pages 完成。
  12. 將案件標記為「已發布」再「結案」。
  13. 最後執行 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 不需改變。