AI-FIRST / FULL-STACK NODE.JS

VextJS

VextJS 是面向 API 与服务端渲染 React 页面的 AI-first Node.js 全栈应用框架。约定、脚手架、类型契约、OpenAPI 与机器可读文档为 AI 编程助手提供明确输入。AI-first 不代表内置 LLM、Agent、RAG 系统或推理 runtime。

一套路由JSON 与 SSR 共用 URL 所有权
契约贯通路由契约驱动校验、文档和客户端类型
按需起步默认全栈,同时支持 API-only
Nativehttp.createServer fast path

Hot Reload Pipeline

三段式后端热重载加前端重建,让开发反馈更紧。

Vext 会按变更边界选择不同策略:能热替换的直接替换,客户端文件变化时重建前端资源,触及运行时边界时再冷启动。

T1 / code

路由代码热替换

命中 src/routes/ 等业务代码时走定向替换路径,保留开发服务进程和连接状态。

保留开发进程
T2 / struct

服务与模型结构重载

服务层、模型、语言资源等结构变更触发局部重载,不把每次改动都推向冷启动。

重载受影响依赖图
T3 / cold

运行时边界冷启动

配置、插件和中间件改变时执行冷启动,保证运行边界正确重建,不牺牲安全性。

重建运行时边界

Performance Stack

性能不是包装词,而是从 HTTP 路径到生产护栏的一组工程选择。

首页保留框架真实工程面:Native fast path、route-core、schema/OpenAPI、CLI 与生产交付能力。

fast path

Native 高性能路径

Native Adapter 贴近 Node.js 原生 HTTP,配合 route-core 路由核心保持轻量。

router

全栈路由核心

文件路由、三段式路由定义、生成客户端契约和请求上下文围绕同一套 Vext 工程模型组织。

schema

校验与 OpenAPI

在路由 options 中声明参数规则,让请求校验和接口文档共用同一份定义。

cli

开箱即用 CLI

创建、开发、构建和启动命令收敛在框架入口,新项目可以直接开工。

hooks

运行时生命周期

request、validation、response、service、fetch 等 hooks 支撑插件和横切逻辑。

safe ship

生产安全能力

限流、结构化错误、优雅关闭、心跳监控和多进程部署组成交付闭环。

Runtime Flexibility

Adapter 是弹性,不是首页主角。

Vext 的主线是框架自身的 API 性能与开发体验。Adapter 负责在需要时连接不同 HTTP 生态,让迁移和集成更稳。

Native原生 HTTP fast path,适合追求极简依赖和吞吐。core
Hono通过 Vext 自有 Node.js 桥接提供 Web Standard API;仅需 hono,且不是 Edge runtime adapter。lean
Fastify成熟高性能生态,适合复杂插件场景。plugin
Express兼容传统 Node.js 项目迁移。classic
Koa适合洋葱模型和既有 Koa 代码复用。flow

Production Ready

安全、稳定、可发布,不停在 demo 层。

Vext 的文档入口应该让团队快速判断它能否进入真实服务端项目:限流、优雅关闭、Rolling Restart、Cluster、国际化、结构化错误和 OpenAPI 都要被看见。

Rate Limit内置限流能力降低滥用风险。
Graceful关闭流程保护连接与请求。
Cluster多进程与心跳适合生产守护。
Errors业务码、i18n 与 JSON-safe details。

Next Steps

直接进入你要验证的工程路径。