什么是 Nexus
Nexus 是一个 面向 AI 原生的全栈 SaaS 框架，也是一套可立即运行的启动模版。Nexus 内置用户认证、积分与支付、AI 模块、工单支持等开箱即用的能力，让独立开发者和小团队借助 Coding Agent 快速构建可运行的 AI 产品。对常见 AI SaaS 形态给出开箱即用的默认实现，同时保留充分的二次开发空间。
为什么需要 Nexus
一个 AI 产品从想法到上线，往往要重复搭建大量与「AI 核心」无关的通用设施：账号体系、支付计费、积分、团队权限、多语言、文件存储、工单和运营后台……这些工作枯燥、易错、且高度相似。
Nexus 把这些「反复出现的轮子」统一标准化，让你专注于真正的产品差异化：
- 从 0 到可部署原型的时间显著缩短：内置通用模块 + 标准化模板，一次对话后即可得到具备真实用户、支付、积分、AI 生成能力的可运行产品。
- Agent-Native 体验：通过 Nexus Skill 指令集，Coding Agent 可以用标准化指令完成新建模块、新增页面、同步上游、安全扫描、一键部署等操作。
- 模板 + 框架双形态：既可以作为完整可运行的 starter 直接改业务，也可以作为可独立引用的框架能力逐步集成。
- 可同步的框架更新：自定义业务代码与框架底层解耦，支持在不破坏业务逻辑的前提下同步 Nexus 上游更新。
目标用户与场景
适合谁
- 产品经理 / 运营人员：希望快速理解 AI SaaS 的通用能力，并通过管理后台完成产品与运营配置。
- 技术负责人 / 开发人员：需要可二次开发、可部署的全栈工程，并希望减少重复基础设施建设。
- 独立开发者 / 独立创客：习惯用 Claude Code、Codex 等 Coding Agent 把想法快速变成可运行产品的个人开发者。
- 小团队 / 创业公司：需要快速启动 AI 产品 MVP、验证市场，但不想重复搭建用户系统、支付、权限等基础设施的团队。
- AI 产品原型构建者：希望专注 AI 核心交互与业务逻辑，而非通用 Web 基础设施的开发者。
产品和运营角色可以从产品能力总览与首次进入管理后台开始；开发和运维角色可以直接进入快速开始。
典型场景
- AI 图像 / 视频生成工具（积分计费 + 生成任务编排）
- AI 内容创作 / 知识助手（用户体系 + 订阅 + 多语言）
- 面向特定行业的 AI SaaS（团队权限 + 工单 + 运营后台）
开箱即用的能力
开箱即用的核心能力与技术基础，聚焦业务创新，拿来即用。Nexus 的核心能力可分为四类，均可以直接作为 AI SaaS 的基础设施使用：
基础服务
产品运行的地基，覆盖账号、AI、扩展与全球化。
| 能力 | 说明 |
|---|---|
| 用户与认证 | 注册登录、邮箱验证、GitHub/Google 社交登录、找回密码，开箱即用。 |
| AI 基础设施 | Provider 抽象、模型能力管理、生成任务编排，AI 能力可插拔接入。 |
| 模块机制 | 可插拔业务模块：清单、路由/API/迁移聚合、菜单自治，垂直场景随模块扩展。 |
| 多语言本地化 | i18n 框架与语言包管理，支持多语言站点全球化发布。 |
商业化基础
覆盖获客、转化、变现、留存全链路，无需自建支付与积分体系。
| 能力 | 说明 |
|---|---|
| 获客 | 注册登录、邮箱验证、GitHub/Google 社交登录，低门槛获取你的第一批用户。 |
| 线索管理 | 收集与跟进潜在客户线索，打通从访问到付费的转化链路。 |
| 积分体系 | 签到、注册奖励、积分消费与流水审计，支撑按量计费与能力兑换。 |
| 支付 | 微信支付（扫码）/ 支付宝（电脑网站）真实支付通道，支撑充值与付费转化。 |
| 授权售卖 | 授权商品配置、积分兑换、授权码生成与验证、撤销/恢复，让能力可变现。 |
平台运营
面向用户服务与后台管理，支撑精细化运营。
| 能力 | 说明 |
|---|---|
| 工单与支持 | 用户工单提交、状态流转、回复时间线，管理员统一处理。 |
| Admin 运营后台 | 用户、订单、积分运营、系统配置、主题、认证等全站运营可视化。 |
系统配置
系统级管理与定制，覆盖用户、模型、认证与品牌。
| 能力 | 说明 |
|---|---|
| 用户管理 | 后台用户与角色管理，支撑精细化运营与权限控制。 |
| AI 模型管理 | Provider 模型能力的集中配置与开关，统一接入多模型。 |
| 第三方认证 | GitHub/Google 等社交登录与认证提供方配置，开箱即用。 |
| OAuth 应用 | 自建 OAuth 应用与授权客户端管理，支持开放集成。 |
| 主题换肤 | 设计 Token + 多主题预设（默认/暖橙/黑金），明暗自适应。 |
开箱即用的商业化闭环
从获客、转化、变现到留存，Nexus 覆盖 AI 产品商业化的每一环——无需自建支付、积分与运营体系，开箱即可变现：
| 阶段 | Nexus 提供的能力 |
|---|---|
| 获客 | 注册登录、邮箱验证、社交登录，以及首页和价格页用户留资。 |
| 线索跟进 | 后台查询潜在客户需求，管理待联系与已联系状态。 |
| 转化 | 充值、支付（微信/支付宝）、积分兑换授权，多通路完成付费转化。 |
| 变现 | AI 能力按量计费、积分消费，流水与对账闭环，持续产出收入。 |
| 留存 | 工单售后、运营后台，精细化运营让用户持续付费、复购与传播。 |
Agent+规格驱动开发
作为 Agent-Native 开发框架，Nexus 以规格为驱动——先定义规格、再按规格实施与验收。spec-* 技能集让 Coding Agent 从需求到上线全程遵循项目规格，一次对话即可交付可运行、可部署的产品。
从描述想法到完成部署的五步规格驱动工作流：每一步都有规格基准与验收标准，全程可追溯、可验收。
- 描述需求：用自然语言描述产品想法，无需传统编程经验，Nexus 将其提炼为项目顶层规格并拆解功能范围。
- 规格规划：规划 Sprint 与功能阶段，为每个功能定义功能规格与测试规格（
spec.md/dod.md），验收标准先行。 - 按规格实施：
spec-impl按规格 TDD 实施：先写测试再实现，严格对照规格文档与项目约定。 - 测试验收：
spec-test运行全量测试，对照验收标准逐项核验，通过spec-review评审后才进入下一环节。 - 归档部署：
spec-checkpoint归档决策与经验沉淀，通过标准化指令完成部署上线，快速得到可运行产品。
Nexus Skill 指令集
Coding Agent 通过标准化指令完成快速启动、新建模块、构建镜像、扩展主题、批量翻译、更新模型等开发运维操作，让项目维护高效可控：
| 指令 | 用途 |
|---|---|
/quick-start | 快速启动：检测环境、安装依赖、校验配置、初始化数据库并运行，快速进入可访问状态。 |
/new-module | 新建模块：先问需求再开发，按项目惯例经 spec 流程产出完整业务模块。 |
/build-image | 构建镜像：一键构建生产 Docker 镜像，支持 tag 与推送。 |
/theme-extend | 扩展主题：新增主题预设包（色板 + 明暗自适应），可复刻网址配色。 |
/i18n-translate | 批量翻译：为已实现的中文功能一键产出英文版，语言包同步。 |
/models-update | 更新模型：补充 Provider 最新模型或新增 Provider，按能力去重避免重复。 |
现代技术栈
基于成熟生态构建，兼顾开发效率与生产可靠性：
| 层 | 技术 | 说明 |
|---|---|---|
| 框架 | Nuxt 4（Vue 3 + TypeScript） | 全栈同构，SSR/SSG，模块化架构；组合式 API、类型安全、组件化开发。 |
| 样式 | Tailwind CSS v4 + shadcn-vue（reka-ui） | 设计 Token + 多主题换肤、明暗自适应；无样式组件原语统一封装 Ui* 组件；@nuxt/icon（lucide）。 |
| 数据 | Drizzle ORM + PostgreSQL | 类型安全 ORM、迁移管理、事务支持。 |
| 邮件 | nodemailer | 邮箱验证、找回密码等事务邮件。 |
| 认证 | OAuth 2.0 / OIDC + RS256 JWT + JWKS | 标准授权码 + JWKS，可作身份提供方；RSA 密码加密传输、HttpOnly 会话、密码版本失效。 |
| AI | OpenAI / Anthropic SDK（Provider 适配器抽象） | 多 Provider 可插拔接入。 |
| 支付 | 微信支付（Native 扫码）/ 支付宝（电脑网站支付） | 充值与按量计费。 |
| API 文档 | OpenAPI + Scalar | 自托管接口文档，结构测试强制校验路由全覆盖。 |
| 构建 | Agent-Native（Skill 指令集 + 模块机制） | AI 驱动开发，从需求到部署。 |
| 部署 | Docker / Docker Compose | 一键镜像与生产编排。 |
核心原则
Nexus 在规划和实施中遵循以下原则（详见 AI 驱动开发）：
- 人类主导决策：AI 提供建议和方案，关键决策必须由人类确认后才能执行。
- 规格先行：任何实施前必须先产生规格文档，经人类确认后再执行。
- 测试先行：编写实现代码前必须先定义并确认测试规格。
- 层级推进：产品顶层规格 → Sprint 目标 → 功能规格 → 实施，不可跳层。
- 聚焦范围：每个 Sprint / 阶段只做当前必需的，不提前实现「未来可能需要」的功能。