useAiWork开发者文档
技术架构

技术栈与运行时

了解框架、数据、AI 和 Cloudflare 部署之间的关系。

技术组成

层次当前实现主要职责
页面与服务端
Next.js 16、React 19、TypeScript
App Router、页面、服务端处理
样式与组件
Tailwind CSS 4、Radix UI、Lucide
共享界面、交互与图标
简历富文本
TipTap
经历编辑与事务撤销
国际化
next-intl
路由、消息模块与语言选择
文档
Fumadocs、MDX
文件内容、导航树与搜索
认证
Better Auth
会话、登录与账户能力
数据
Drizzle ORM、Cloudflare D1
业务持久化与迁移
AI
AI SDK、Google、兼容协议适配
结构化生成、流式对话与图片
部署
OpenNext、Cloudflare Workers
将 Next.js 构建为 Worker
质量
Biome、TypeScript、Node 测试
格式、类型与核心行为验证

精确版本以 package.json 与锁文件为准。

运行时边界

浏览器负责编辑状态、预览以及本地模型配置。服务端负责认证、业务校验、按账户访问数据库、模型请求和平台计费。

Next.js 本地开发与 Cloudflare Worker 预览不是同一种环境。D1 通过 OpenNext 的 Cloudflare context 获取;新增仅支持 Node 的依赖前,要验证 Worker 兼容性。

开发前阅读

仓库所安装的 Next.js 文档位于 node_modules/next/dist/docs/。新增路由、缓存或服务端 API 前阅读对应版本说明;不要直接沿用旧版本同步读取 params、cookies 等写法。

实现入口

  • next.config.ts 与 open-next.config.ts:构建与部署适配。
  • src/integrations/database/client.ts:D1 context。
  • src/ai/index.ts:平台模型注册表。

继续阅读项目结构。

本页目录