修正文件脫節內容 + 加入無人管理自動化（排程刷新／PR 建置檢查）

[toomore]

背景

文件網站 src/site_docs 是 OSCVPass 對外主要介面，但已脫節一段時間，且部署其實處於「無聲壞掉」狀態。本 PR 先修正內容、再加上網站與資料層自動化，讓網站即使無人主動維護也能維持正確、不會無聲壞掉。

🔴 最重要：修好被卡住的部署

license.md 嵌入的 3 張 yurenju.blog 圖片，在對方遷站到 Astro 後全部 404（新檔名是會變動的內容雜湊）。這會讓 mkdocs build 直接崩潰，因此自從對方遷站後，任何重建／部署都失敗、正式站凍結在舊版——這正是脫節的根因，也是所有自動化的前提。

本 PR 將 3 張原圖存入 src/site_docs/zh-tw/assets/images/license/ 本機引用（保留原出處連結與標註），build 不再因此崩潰。

A. 內容修正

• apply.md：移除寫死的 2023/06/15 範例日期 → 改為「自申請當日往前回推一年」的相對說法（永不過時）；頂端加 2.0 轉型提示
• README.md：2023 實習舊連結 → 現行志工招募頁；hi@ocf.tw → oscvpass@ocf.tw；簡介補 2.0 說明
• internship.md：開頭改為封存說明並指向志工頁；修正 2024 段落誤植的 2023/07
• approved/index.md：「約 297 件」→「數百件」（移除需人工維護的數字）

B. 自動化（網站 + 資料層）

• .github/workflows/refresh-approved.yml：每週（+ 手動 workflow_dispatch）執行 update_approved_from_vcs.py --write，自動刷新已核准專案的 star/fork/日期/授權並重新排序，有變更才提交並推 mkdoc 觸發既有部署。
• .github/workflows/ci-build.yml：PR 改到 src/site_docs 時跑 mkdocs build，用 exit code 擋下會崩潰的內容，並 grep build log 把「指向不存在頁面的內部連結」升級為失敗。
  • 不用 --strict：此站的 social 卡圖（Cairo）與 git-authors（自動產生的 blog 封存／分類頁）會固定產生警告，--strict 會誤擋。
• .gitignore：忽略 site/ 與 .cache/。

⚠️ 合併前請確認

1. B1 推送權限：refresh-approved.yml 用內建 GITHUB_TOKEN 直接 push main 與 mkdoc。若 main 有分支保護（要求 PR/review），自動 push 會被擋；屆時需放行 actions bot 或改用 PAT。
2. 合併後：請照現行流程把 main 推到 mkdoc 觸發一次部署，確認修好的 build 能成功上線；接著可用 workflow_dispatch 手動跑一次 refresh-approved.yml 驗證整條自動化。

本機驗證

• mkdocs build：exit 0、0 斷連結、license 圖片正確產出 ✅
• update_approved_from_vcs.py --sort-only dry-run：解析／排序正常 ✅

已知（本次未處理，建議另案）

• social 卡圖在 CI 缺 Cairo 系統套件，社群分享預覽圖可能未生成（純美觀，不影響頁面）。
• 審核 → AWS SES 通知信流程的自動化（牽涉 mails/ 與 repo 外私有名單）。

🤖 Generated with Claude Code