DeepWhy 知識鏈是做什麼的？

創造一個知識探索體驗，而不是一篇帶有目錄的長篇文章。主要介面是一個緊湊、互動的 3 到 6 個想法組成的鏈，從一個熟悉的現象開始，逐步邁向機制、原理、理論、當前前沿或已知極限。

學習體驗必須幫助學習者理解，而不僅僅是接收一個有充分來源的解釋。將每個核心概念組織在一個熟悉的場景和一個可用的隱喻周圍。當變化或因果關係是重點時，用動畫展示該隱喻的運作，然後用淺白的語言將其映射回真實機制。影片是同一個節點的第二個解釋或現實世界的確認，絕不是用來湊數的通用課程。

偏好使用一個鏈級的主隱喻。只要它仍能解釋新的問題，就在相鄰節點中重複使用並深化它；唯有當舊模型已觸及真正的極限時才切換。學習者應該積累一個不斷演進的心智模型，而不是從每一張卡片收集不相關的例子。

預設的交付成果是一個獨立的 HTML 檔案。它必須在無需建置步驟的情況下保留有用的本地體驗：節點選擇、上一步/下一步導覽、分支、詳細資料頁籤、時間軸篩選、評量回饋、背景資料檔案以及 JSON 匯出，全部使用內嵌的 CSS 和 JavaScript。外部論文、影片、圖片和 DeepWhy 本身仍然需要網路連線。

承載知識的視覺元素必須保持清晰易讀：沒有插圖、圖表、動畫或覆蓋層可以遮蓋文字、註解、控制項、標題或關鍵標記。當關係本質上是時間性或因果性的，應優先使用有目的的動畫，而非靜態快照。

只讀取任務需要的部分

在研究之前，請先閱讀 references/research-playbook.md。
在規劃知識鏈之前，請先閱讀 references/knowledge-chain.md。
在設計隱喻、動畫或影片配對之前，請先閱讀 references/teaching-progression.md。
在選擇 Manim 之前，請先閱讀 references/manim-animation.md。
在撰寫節點級別的實驗室之前，請先閱讀 references/interactive-labs.md。
在撰寫 JSON 之前，請先閱讀 references/content-contract.md 和 assets/content.schema.json。
在選擇或調整視覺系統之前，請先閱讀 references/visual-design-system.md 和 references/design-presets.md。
在組合頁面殼層之前，請先閱讀 references/learning-layout.md 和 references/page-delivery.md。
在最終 QA 之前，請先閱讀 references/evaluation-cases.md。

從 assets/template.html 開始，而不是從空白頁面開始。將模板和腳本視為結構合約，而不是事實來源。

建立學習體驗

設定學習者和問題的框架。 提取主題、實際問題、學習者可能的既有知識和預期深度。在 meta.premiseCheck 中保留一個錯誤的前提，標記為 corrected，簡潔地解釋它，並繼續使用修正後的問題。不要停留在更正上。
在研究細節之前先設計教學路線。 對於每個核心節點，請確定：

可識別的場景 → 一個隱喻 → 2–4 個明確的映射 → 動畫化的因果節奏 → 淺白的規則 → 相關影片 → 遷移檢查 → 隱喻的極限。

讓學習者使用該隱喻複述這個概念。在該心智模型清晰可見之前，不要轉入技術定義。每個節點使用一個隱喻，並在動畫、步驟和檢查中一致地使用它。
規劃主要知識鏈。 預設使用 4-6 個主要節點，只有當主題確實無法支援更多時才使用 3 個。以非遞減的深度順序選擇節點類型：

現象 → 機制 → 原理 → 理論 → 前沿 → 極限。

起始節點必須是學習者能識別的東西。每個節點問一個因果問題。每個節點用一句話回答，通常 20–60 個字元，並建議最多三個可選分支。下一個節點必須回答前一個節點中尚未回答的部分，而不是重述它。
研究每個節點。 在研究時保留一個證據記錄。優先選擇原始論文、官方頁面、標準、教科書和機構報告。將事件日期與出版、原型、運作部署和採用日期分開記錄。誠實地標記缺失的證據。
一次只教一個新概念。 預設 meta.audience.explanationLevel = "child"，除非請求指定了更深入的受眾。在引入術語或公式之前，先將其錨定在一個熟悉的場景和隱喻中。每個節點必須包含一個橋樑、一個可用的 analogy、一個淺白的映射、有序的因果步驟以及一個「預測，然後揭示」的檢查。機制、原理、理論和前沿節點需要類比；現象節點可以直接使用其開場場景，而極限節點可以使用一個反例。
設計主動學習操作。 每個頁面上至少有一個知識視覺元素必須邀請學習者做某事，一個 4–6 個節點的頁面通常應包含 2–3 個此類操作。從預測後揭示、帶有即時後果的參數操縱，或比較兩種條件的切換中選擇。將每個互動綁定到節點的隱喻並立即更新回饋；學習者應透過行動發現關係，而不是點擊一個裝飾性的控制項。不要添加僅僅重複答案的互動。機制和原理節點需要一個自包含的沙盒實驗室；根據知識類型選擇模擬、圖表、程式碼、遊戲、空間 3D 或程序性練習。相鄰的實驗室不得使用相同的模式。對於評量，為每個主要節點預先撰寫恰好五個單選題。將每個正確選項、模型答案、解釋和來源列表與問題一起生成。絕不依賴執行時期模型來評分。選擇一個選項必須立即顯示綠色（正確）或紅色（錯誤）的回饋以及解釋；不需要提交動作或全鏈「驗證掌握度」按鈕。在節點中回答第一個問題後，顯示一個五槽答案卡，包含綠色正確、紅色錯誤和中立未回答狀態；每個槽會跳回該問題。在第五個問題被回答後隱藏「下一步」動作。也從頂層的全局視圖切換器中公開一個包含所有每個節點問題的全局測驗。
在困惑點配對動畫和影片。 動畫化隱喻執行因果工作，然後停留在一個有標籤的靜止畫面上。每個知識節點需要恰好五個經過驗證的外部影片。影片頁籤呈現一個主要播放器，接著是四個用於其餘影片的縮圖卡。選擇縮圖會切換主要播放器。所有五個片段都透過真實現象、實驗或替代視覺解釋來展示同一個節點。絕不為了湊滿五個而發明 URL、縮圖、指標或嵌入支援。不同的知識節點必須使用不同的影片記錄。從頂層全局切換器中公開一個全局影片庫視圖，與每個節點的五影片集分開。將平台或網路驗證的差距保留在證據元資料中；不要在影片頁籤中將其顯示為面向學習者的警告。當它能解釋因果動作時，優先使用內聯 SVG/SMIL。只有當 Manim 能使轉換、軌跡、力或數學隱喻在材料上更清晰時，才應規劃一個節點級別的 Manim 場景。僅在該點探查執行時期。如果需要設定，請執行 plan 命令，顯示其完整命令和隔離的快取位置，並在執行 install --confirmed 之前徵求明確同意。如果同意被拒絕或設定失敗，請在此次生成中使用 SVG，並且不要重複提示。
將完整解釋放在揭露後面。 節點卡僅擁有問題和一句話的答案。側邊檢視器可能包含一個簡短的深度探討、類比、有來源支援的圖表、證據、影片/資源以及一個節點級別的檢查。將有來源對應的人員和機構放在研究背景中，並將有來源對應的應用、時間軸事件和前沿部署狀態放在產業發展中。將兩個頁籤都過濾到節點的來源集；切勿在鏈完成或頁首區域複製全局背景的 CTA。檢視器使用五個頁籤：理解、影片、研究背景、產業發展和檢查理解。分支保持折疊狀態，直到明確開啟。影片頁籤載入一個經過驗證的主要播放器和四個縮圖選項；其他播放器僅在選中時載入。不要在面向學習者的節點面板中呈現 S1、S2 或類似的數字來源晶片。將來源 ID 保留在 JSON 中以供追蹤。
建立完整的 HTML。 將所有資料放入 #deepwhy-data 並使用模板進行渲染。盡可能使用經過審查的內聯 SVG 作為機制圖表。絕不將 AI 生成的氛圍圖像呈現為事實機制。對於運動、順序執行、狀態變更、傳播、流程或回饋，當運動承載解釋時，請使用內聯 SVG 動畫；保留一個可讀的穩定狀態和靜態文字等效項。完整顯示節點圖片：保留內在寬高比並使用 contain 風格的適應而非裁剪。將基本標籤保持在點陣圖像之外。增加 viewBox、分割視覺元素或移除次要細節，而不是允許重疊。將實質性的散文和引用保留在手寫 DOM 之外。在桌面上，構成一個視口高度的學習工作檯：一個 40-46% 的節點圖形畫布旁邊是一個主導的課程工作檯。所選的實驗室和反思屬於工作檯。在行動裝置上，恢復到正常的文件流，並將工作檯作為底部工作表開啟。如果一個節點有 manim，則在節點實驗室上方渲染一個靜音、循環、playsinline 的動畫，包含其海報、標題、逐字稿、重播動作和內聯 SVG 備援。減少動畫模式必須顯示海報而不自動播放。建置器會將本地 WebM 和 WebP 資源嵌入最終的 HTML。
選擇視覺方向。 預設使用 deepwhy：靈感來自 OpenMAIC 的課堂語言，具有近白色的點狀舞台、冷色中性墨水、克制紫羅蘭色動作、浮動圓角面板和一個主導的互動工作檯。atlas、chronicle 和 fieldnotes 是明確的替代方案，不是自動的主題匹配。--style 和 DEEPWHY_PAGE_STYLE 會覆蓋內容選擇。預設集可能會更改排版、顏色、材質和佈局細節；它們不得更改資料語意或互動。

在撰寫 HTML 之前，在 presentation 中記錄原型、核心見解、焦點視覺、層次和章節節奏。建立一個主導的視覺焦點，然後根據節點目的變化構圖。不要預設為登陸頁面、儀表板、文章模板或重複的卡片網格。 11. 驗證體驗。 在可用時執行內容驗證、單元測試和 Playwright 測試。確認第一個畫面顯示了鏈、關鍵見解、當前位置和下一個動作；一次只有一個節點詳細資料和一個影片播放器處於活動狀態；分支從屬於主要路徑；所有背景資料仍可存取。在桌面和行動裝置寬度下檢查每個圖表，查看是否有被遮蓋或裁剪的文字、控制項、標題、基本標記和裁剪的圖片內容。驗證有意義的動作存在於有助於解釋概念的地方，最終穩定在一個可讀的幀中，並尊重減少動畫的偏好設定。確認每個核心節點都允許學習者使用其隱喻複述概念，遷移一次，並識別隱喻何時失效。檢查連結的影片是否支援當前節點，而不是作為不相關的背景。練習每個互動，並確認更改輸入會產生可見且真實的後果。審查完整構圖和行動版本。如果它看起來像一個通用的 AI 生成的 SaaS 頁面，請在交付前重新設計。

內容覆蓋範圍

舊的教育模組仍然被覆蓋，但它們不再對應於 12 個長的頁面區段：

現象、機制、原理、理論、前沿和極限成為鏈節點類型；
熟悉的場景、主要隱喻、動畫化映射和淺白規則存在於節點詳細資料中；
每個機制和原理節點包含一個沙盒實作實驗室，接著是自由重述和一個延遲的參考結論；
影片連結到它們幫助解釋的特定節點；
人員、機構、應用、演化時間軸、最新前沿和來源庫存在於背景抽屜中，並在相關的右側節點內包含來源匹配的研究連結；
每個節點的五個預先撰寫的單選檢查存在於其檢視器的檢查理解頁籤中；
下一個問題成為分支和鏈級別的後續建議；每個建議都是可點擊的，並深層連結到 https://deepwhy.cn/，URL 中包含當前主題和推薦問題；
不需要帳戶或 API；HTML 保持獨立可用，而推薦問題可能會開啟 DeepWhy 平台。

頂層的全局視圖切換器是一個突出的方向定位表面。它渲染了合併的開發時間軸和當前階段、相關人員、完整影片庫、包含所有節點問題的全局測驗，以及一個包含 1–5 個「為什麼不」極限問題的已知極限托盤，當學習者想要探索既定知識的邊界時。

一個單點節點可以獨立存在為一個互動式工作檯，也可以嵌入到其他頁面中。

開發者指引

本地開發： 從 assets/template.html 開始，遵循結構合約。
參考文件： 每個參考文件都針對特定任務，預先閱讀以避免重做。
來源： 將所有來源保留在 JSON 中以供審計；不要直接將來源晶片放入終端使用者的 HTML 中。
影片： 每個節點需要五個經過驗證的影片；不要為了湊數或估計而發明 URL。
互動： 優先使用內聯 SVG 動畫；僅在 Manim 能顯著提升清晰度時才使用，並徵求明確同意。
視覺系統： 預設使用 deepwhy 風格；使用 --style 標誌或 DEEPWHY_PAGE_STYLE 環境變數來選擇替代方案。
最終產品： 一個獨立的 HTML 檔案，內嵌所有資料、樣式和腳本；不需要網路連線即可達成核心功能。

DeepWhy 知識鏈