Skip to content

Repository files navigation

Apple Event Explainers

以繁體中文整理指定 Apple 發表會、五份台灣產品規格快照,以及直接相關的 Apple Developer 文件。這是獨立、非官方的教育專案;所有文章共用一份可追溯的事實庫。

正式網站 · v1.0.0 · GitHub 原始碼

網站頁尾自動顯示該次建置的版本、GitHub commit 永久連結、提交時間與建置時間(台灣 UTC+08:00);不是遠端分支的即時最新版本。內容查核進度另列於來源頁,建置不會改寫來源或查核日期。網站保留 noindex 索引策略,並非存取限制。

閱讀入口 重點
dev.html 開發者版 功能示例、App 動作/資料、影音與文字模型工作流程
ai-user.html AI 使用者版 個人線索、畫面提問、清單與照片等任務,再看設定條件
general.html 普羅大眾版 功能用途、產品差異、日常意義與簡明解說
event.html 發表會總覽 僅由 S01 產生的摘要、時間軸與舊引用
sources.html 來源與證據 來源版本、定位、各版回連、覆蓋與查核紀錄

目前原始碼已增補 22 份 Developer 文件,並依使用者確認將影片價格標示為 USD;目前三受眾正文共用上述來源與價格資料。

首頁 index.html 提供三條路線。每版均有頁內搜尋、目錄、字級、配色、Reading/Audit、同主題切換及證據回連;停用 JavaScript 仍可閱讀正文與原生連結。

本機使用

驗證環境是 Node.js 24.16.0 與 npm;版本記在 .nvmrc。安裝依賴需要套件網路,日常 build 不下載產品來源,也不需要雲端憑證。

npm ci
npx playwright install chromium
npm run build:web
npm run preview

預覽僅監聽 loopback,開啟 本機首頁。這個網址不是線上成果。修改後重新執行 build 或重啟 preview;沒有自動監看。

npm run check
npm test
npm run verify:scaffold
npm run test:release-fixture
npm run check:public-tree
npm run verify:public-tree
npm run check:status
npm run verify:release
  • verify:scaffold:來源結構、名稱/用語、單元反例、build、連結、公開輸出與 Chromium 互動。
  • test:release-fixture:在 OS 暫存副本用合成資料測試正向 release 流程;不核准正式資料。
  • verify:public-tree:只複製公開清單,重新安裝並執行工程驗證和合成 release 流程;不帶原 node_modules、研究素材或登入檔。
  • check:status:產生本機 dist/status.json,重算各模態覆蓋,核對目前來源/產物與驗證紀錄,列出正式內容阻擋。成功只表示報告已產生;不連線、不部署,也不將歷史預覽視為目前驗收。
  • verify:release:另要求完整承諾覆蓋、新的語意核准。目前預期非零退出。

實際命令結果與未測範圍見 QA,發布狀態見 RELEASE_CHECKLIST

內容與來源

事實只修改 content/knowledge-base.md;來源與名稱核定只在 sources/event-manifest.json。S01 為指定發表會,S02–S06 為五份台灣規格,S07–S23 為已登錄的 Developer 原文;依追加範圍,S24–S29 獨立收錄台灣購買頁與首頁的價格/上市資訊。未取得資訊保持未知;影片摘要只使用 S01。其他來源不等於舞台公告或特定新品相容,新來源須逐一核對准入。

文章原稿位於 content/drafts/,三版選材位於 content/audiences/。內容、來源版本、名稱、覆蓋與各版選材都會改變語意摘要;修改後重新審查。ASR 是定位材料,不能當原音核對。詳見 資料契約功能覆蓋貢獻方式

公開與部署邊界

公開原始碼、dist/web 靜態網站與私有研究各自分開。research/.private 保存原影音、完整原文、ASR 和中間工作檔,永不進 Git、Hosting 或 CI artifact;大量 QA 圖片/log 也不在公開清單。公開匯出由 build/public-tree.mjs 的明確清單生成,結果記在本機 dist/public-tree.json

publication_status: published 表示網站正式版;output.profile 則區分保留 noindex 的 preview 與完整內容認證的 production。兩者各自管理,網站正式版不會被寫成全片審查已完成。Firebase project、Hosting site、GitHub repository 與正式 origin 已完成專用目標設定,仍不能使用帳號預設專案或參考站代替。

手機遠端連回同一台 Mac 後,可先執行 npm run check:environment -- --online 唯讀確認工具、登入與專用目標;不會自動公開或部署。

npm run deploy 預設拒絕;npm run deploy:plan -- --channel CHANNEL 只做本機 preflight。日後執行需要目標一致、同一份檔案摘要、未過期計畫與一次性明確確認,詳見 部署操作。published 的 live 部署使用完整工程驗證與已提交的乾淨 checkout;完整內容認證另外記錄。package.jsonprivate: true 保留,避免 npm 誤發布;它不決定 GitHub 可見性。

授權與限制

程式與本專案原創解說採 Apache-2.0,保留 Nick Lian 的原始介面作者歸屬。字型採 SIL OFL 1.1。第三方原文、畫面、商標與媒體權利不因程式開源而改變,見 NOTICE第三方說明

尚未驗證 Safari、Firefox、真機、完整輔助科技或 SDK 編譯。網站是固定官方資料快照,不是即時價格/可用性資料庫。

About

繁體中文 Apple 發表會解說;專用環境準備中,尚未開源發布。

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages