Next.js AI 应用路由设计:页面轻一点,边界清楚一点

Next.js AI 应用路由设计:页面轻一点,边界清楚一点

Next.js 很适合做 AI 生活化应用:前端体验细腻,后端接口也能放在同一个项目里。但方便也容易带来边界混乱。页面组件里直接写模型调用、API 路由里混入产品逻辑、鉴权散落各处,项目很快就会变得难维护。

我做小型 AI 应用时,会让页面轻一点,把模型调用、用量、权限和日志放到明确的服务层。独立项目不一定需要微服务,但需要清楚的目录和责任边界。

一、路由先按用户任务组织

AI 生活化产品的页面不要按技术炫技组织,而要按用户任务:聊天、回忆录、提醒、设置、导出。路由结构本身就是产品地图。

flowchart TD A[app] --> B[chat] A --> C[memories] A --> D[reminders] A --> E[settings] A --> F[api] F --> G[ai] F --> H[jobs] F --> I[billing]

页面层只负责展示和轻交互,不直接知道模型供应商细节。这样以后从一个模型切到另一个模型,不会牵动整个界面。

二、AI 调用放到服务层

把 AI 调用封装成服务,统一处理模型、超时、重试、token 统计和安全策略。

ts 复制代码
export async function runGentleAssistant(input: {
  userId: string;
  message: string;
  scenario: "chat" | "reminder" | "memory";
}) {
  await assertQuota(input.userId);
  const safety = await assessSafety(input.message);
  const response = await callModel({
    template: selectTemplate(input.scenario, safety.level),
    variables: { message: input.message },
    timeoutMs: 15000,
  });
  await recordAiUsage(input.userId, response.usage);
  return response;
}

这段代码表达了边界:额度、安全、模板、模型调用、用量记录都在服务层。API route 只负责接收请求和返回结果。

三、流式输出要处理取消

AI 应用常用流式输出,但用户可能关闭页面、切换任务或点停止。服务端要能处理取消,不要继续烧 token。

ts 复制代码
export async function POST(req: Request) {
  const controller = new AbortController();
  req.signal.addEventListener("abort", () => controller.abort());
  return streamAssistantResponse({
    body: await req.json(),
    signal: controller.signal,
  });
}

取消能力也是体验的一部分。生活化产品里,用户不该被一段正在生成的回答困住。

四、错误页面要有人话

AI 接口失败很常见:超时、限流、模型不可用、额度不足。Next.js 的错误边界要把这些情况翻译成用户能理解的状态,而不是只显示技术错误。

可以把错误分为可重试、需等待、需升级、需联系支持。界面给出对应动作。产品越温柔,越要在失败时清楚。

五、总结

Next.js 做 AI 生活化应用时,关键是边界清楚。页面按任务组织,AI 调用放服务层,流式输出支持取消,错误状态讲人话。

小项目也值得有结构。结构不是束缚,而是让产品慢慢长大时仍然保持安静。

相关推荐
写标小何2 分钟前
AI 标书工具技术架构解析:从文件解析到排版导出的工程实践
人工智能
敖老师5 分钟前
DeepSeek Harness Web 版从装到用:dsh web 启动、接入本地 Ollama 全流程
人工智能
阿里云大数据AI技术5 分钟前
DataWorks AI 数据生成:一条配置,量产多行业的仿真级业务数据
人工智能
QA老兵的AI实战手记12 分钟前
别再用人工盯 AI 幻觉了:我手搓了一套带“代码审查拦截”的 AI 效能大屏(附源码)
人工智能
火山引擎开发者社区16 分钟前
APMPlus・看得见的 Agent(三) | Agent 说完成,结果却不对?APMPlus Agent 轨迹帮你查清执行过程
人工智能
羲云网络19 分钟前
Claude Fable 5.2 创意编程分析:程序化生成、多智能体协作与工程验收
人工智能·大语言模型·blender·游戏开发
Linye22 分钟前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能
weixin_469163691 小时前
金融租赁项目管理:维普时代以混合模型+AI实现管控与效率兼得
人工智能·金融
框架那些事儿1 小时前
深入 Pi 源码:一个优秀的 Agent,是如何管理上下文的?
人工智能·ai编程·全栈
Java内核笔记1 小时前
方法级 trace 看不出第几轮:给 Agent 补一层轮次维度
人工智能·spring boot·后端