内部框架文档 · 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 100% 占用的问题从根本解决,所有页面必须显式声明渲染策略

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 参考实现

快速上手 →