框架能力
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 工具链开箱即用
@swift-web/standards
生态规范单一事实源:开发 SOP、AI 协作约定、commit / 分支规范,以及可分发的 ESLint / Prettier / Stylelint 配置与 commit-msg 校验,sync 注入各仓
查看规范 →@swift-web/starter
项目工程模板,发布在 verdaccio 私服。sw create 运行时用 npm pack 拉取最新版,内含 framework 接入、业务结构与 Demo 参考实现