內部框架文件 · v0.170.x

Swift Web
官方文件

以 ISR 快取驅動高效能,為 AI 輔助開發量身定制的 Nuxt 4 全端框架。
44 個無樣式元件、16 個 Composable、嚴格規則護欄,開箱即用。

sw create YC001-WEB-專案名稱

框架能力

AI 原生開發規範

嚴格規則護欄 + MCP 整合,Claude Code 等 AI 工具可直接呼叫 sw 命令。規則清晰讓 AI 穩定產出可預測代碼

ISR 快取驅動效能

以 ISR 為主力渲染策略,高並發場景 CPU 不飆升。所有頁面須明確宣告渲染策略,杜絕意外 SSR

CLI 一鍵建立專案

sw create 即時拉取最新 starter,按需啟用 theme / i18n / PWA / WebSocket;starter 自帶 .mcp.json 讓 AI 工具鏈開箱即用

44 個無樣式元件

按鈕、彈窗、上傳、播放器、富文字、QR Code、橫排輪播、廣告位等,僅提供功能邏輯,樣式完全自訂,不綁定任何 CSS 框架

SEO / GEO 一站式封裝

useSeo() 一次呼叫全套 og:* / canonical / robots / JSON-LD;影視 Movie / TVSeries / VideoObject 結構化資料讓 AI 搜尋讀懂並引用;AI 爬蟲策略一鍵開關;私有頁 noindex

Sitemap 零配置收錄

framework 內建 @nuxtjs/sitemap(含 robots + schema-org),靜態頁自動收錄、私有路徑自動排除;動態詳情頁走 sitemap.sources 接入,單一管線零配置

可選主題系統

內建 light / dark / auto 三種模式,useTheme() 一行切換並持久化;不需要時關閉,不產生任何額外體積

多語言 i18n

按需整合 @nuxtjs/i18n,可選 zh-CN / zh-TW / en;純中文專案可關閉以減小建置體積

PWA 離線支援

Service Worker 自動生成,支援「加入主畫面」與離線快取;建立專案時按需啟用,不需要時零體積

路由鑑權中介層

login.global / guest.global 全域路由守衛,基於 auth.guardedPaths / guestPaths 零程式碼設定,登入態自動接管

廣告底座與統一埋點

9 個自渲染 SwAd* 廣告元件(內建曝光/點擊埋點)+ 集團 WebSDK 統一埋點底座,useTracker / useAdTrack 上報,設定缺失自動降級靜默

JS 正式混淆

正式建置自動啟用 javascript-obfuscator,提升反編譯難度;除錯環境自動跳過,不影響開發體驗

生態組成

@swift-web/cli

命令列腳手架,sw create 即時拉取最新 starter、sw config 管理設定、sw add 生成檔案、sw run 執行腳本,starter 自帶 .mcp.json 讓 AI 工具鏈開箱即用

查看 CLI 文件 →
+

@swift-web/standards

生態規範單一事實源:開發 SOP、AI 協作約定、commit / 分支規範,以及可分發的 ESLint / Prettier / Stylelint 設定與 commit-msg 校驗,sync 注入各倉

查看規範 →
→

@swift-web/framework

Nuxt Module,自動註冊 44 個元件、16 個 Composable、2 個 Store、全域路由守衛、主題與 i18n 等核心能力

查看元件文件 →
→

@swift-web/starter

專案工程模板,發布於 verdaccio 私服。sw create 執行時用 npm pack 拉取最新版,內含 framework 接入、業務結構與 Demo 參考實作

快速上手 →