前言¶
做物理、化學或數學的交互式仿真,常見兩條路:要麼依賴現成的仿真平臺,頁面和邏輯都受限;要麼自己手寫一個 HTML 文件,從畫布拖拽、連線、增刪元件一路寫到求解和重算,最後還要逐個點擊確認每個交互真的能用。單文件 HTML 的好處是離線可用、零依賴,代價是工程量集中到一個文件裏,驗證也沒有瀏覽器自動化工具可用。
下面介紹的 Skill 「初中物理交互式工作臺」就是針對這條路徑的。它給出的不是某個成品頁面,而是一套完整工作流:先確立「高自由度自由搭建」的範式,再用「Node DOM 樁」在沒有瀏覽器的情況下自動驗證頁面裏所有交互是否真的可用。
這是什麼¶
「初中物理交互式工作臺」是一個社區來源的 Skill,座標 @user_f8d8a3c9/physics-lab,版本 1.0.0,分類 dev-programming,發佈者 user_f8d8a3c9,來源標記爲 community,標籤 requires_api_key=false。SkillHub 頁面顯示評分 100000,下載 1134,安裝 0。
它解決的問題是:用戶要「做一個物理/化學/數學交互式仿真」「參考 PhET 做仿真頁面」「可視化實驗臺/學習工作臺」「電路仿真能自由加電線加電阻」「模型條件可以隨便搭建」「給每個模型加自定義選項能自己擴展」「教學動畫演示頁面」「單文件 HTML 仿真且要能離線用」,或者需要驗證一個大型單文件 HTML 頁面裏所有交互是否真的可用時,給出一套可直接執行的工作流和配套代碼模板。
核心功能¶
這個 Skill 的能力分三塊:範式、驗證方法論、可直接內聯的代碼。
高自由度自由搭建範式¶
畫布上任意位置放元件、拖動、連線、增刪實體、參數逐項可調、自動重算求解。這是整套工作流的骨架:先定義元件和參數,再定義交互,最後接上求解和重算。它區別於固定實驗流程的頁面——用戶每次進來都能自己搭一遍,而不是隻能點「下一步」。
Node DOM 樁無瀏覽器自動化驗證¶
寫完頁面後,用 Node 環境裏的 DOM 樁(不啓動真實瀏覽器)依次檢查:語法、外鏈、id 一致性、初始化、動畫活性、端到端點擊。這條鏈路覆蓋了單文件 HTML 最常見的失效點——語法錯誤、外部資源引用失效、id 對不上、初始化沒跑起來、動畫循環沒動、點擊事件沒綁定。
可直接內聯的電路編輯器引擎¶
並查集合並節點 + 高斯消元節點電壓法。這是電路仿真的求解部分:先用並查集把導線連接的節點合併,再用節點電壓法列方程並高斯消元求解。引擎可以直接內聯進單文件 HTML,不需要額外依賴。
公共運行時¶
多 Tab 支持、requestAnimationFrame 只驅動當前可見頁、localStorage 持久化、導入導出。這幾個能力解決的是單文件 HTML 在多標籤頁裏同時打開時的資源與狀態問題。
驗證腳本模板與踩坑鐵律¶
Skill 附帶驗證腳本模板,以及 10 條真實踩坑鐵律。鐵律來自實際開發中踩過的坑,用於在寫頁面之前就規避掉。
安裝與啓用¶
資料中未給出該 Skill 的安裝命令或配置文件字段,只標註了 requires_api_key=false(無需 API Key)和安裝數爲 0。需要安裝命令和啓用方式的話,應到官方頁面確認,不要照搬其他 Skill 的安裝步驟。
官方地址:
https://api.skillhub.cn/user_f8d8a3c9/physics-lab
SkillHub 頁面:
https://www.skillhub.cn/skills/user_f8d8a3c9/physics-lab
典型用法¶
這個 Skill 的觸發條件寫得很明確,以下場景會啓用它:
- 做一個物理、化學或數學的交互式仿真
- 參考 PhET 風格做仿真頁面
- 可視化實驗臺或學習工作臺
- 電路仿真要能自由加電線、加電阻
- 模型條件可以隨便搭建
- 給每個模型加自定義選項並能自己擴展
- 教學動畫演示頁面
- 單文件 HTML 仿真且要能離線用
- 需要驗證一個大型單文件 HTML 頁面裏所有交互是否真的可用
工作流順序是:先按自由搭建範式定義元件、參數和交互,再接上求解與重算,最後跑 Node DOM 樁驗證鏈路。經過上面的步驟,得到的產物是一個離線可用、交互經過自動驗證的單文件 HTML。
適用場景與注意¶
適合需要在單個 HTML 文件裏交付交互式仿真、且要求離線可用的場景,尤其是教學演示、實驗臺和自由搭建類仿真。電路仿真部分內置了並查集和高斯消元,適合電阻、導線這類基礎電路,超出這個範圍的電路模型需要自行擴展求解器。
注意三點。第一,這是社區來源 Skill,發佈者爲 user_f8d8a3c9,使用前建議自行審一遍內聯代碼。第二,資料未提供安裝命令和配置字段,啓用方式需到官方頁面確認。第三,驗證方法論依賴 Node DOM 樁,它覆蓋語法、外鏈、id 一致性、初始化、動畫活性和端到端點擊,但不等於真實瀏覽器渲染驗證,視覺和佈局層面的問題仍需在瀏覽器里人工過一遍。
結尾¶
這個 Skill 的價值在於把單文件 HTML 交互仿真的開發拆成了可執行的兩步:先用自由搭建範式把頁面寫出來,再用 Node DOM 樁把交互驗證跑通。適合要離線交付、要自由搭建、又不想引入重型框架的場景。
官方地址:https://api.skillhub.cn/user_f8d8a3c9/physics-lab