本文档提供了 Dify Web 前端架构的技术概述，包括核心组件、结构和关键技术。它解释了前端如何组织、组件如何通信以及国际化功能如何实现。

技术栈

Dify 的 Web 前端基于现代 JavaScript 技术栈构建：

• 框架：Next.js（基于 React 的框架）
• 语言：TypeScript
• 样式：Tailwind CSS（从组件结构推断）
• 国际化：支持多语言的 i18next
• 状态管理：React Context API
• 路由：Next.js 内置路由系统

整体架构

Dify 前端遵循模块化架构，职责分离清晰：

页面与布局结构

前端使用 Next.js 的 App 目录结构和嵌套布局，支持：

• 分层组件组合
• 相关页面共享布局
• 持久化组件的高效路由

布局层级

• 根布局
• 通用布局
• 应用详情布局
• 数据集布局
• 设置布局

页面示例

• 应用概览页
• 应用提示工程页
• 应用 API 访问页
• 应用日志页
• 数据集文档页
• 数据集测试页
• 数据集设置页
• 账户设置页
• 成员设置页
• 服务提供商设置页

当用户在同一布局内的页面间导航（如从应用概览到日志页），仅页面内容更新，布局组件保持挂载，提升用户体验。

组件架构

组件架构遵循分层组织：

• 基础组件：低级可复用 UI 组件（如 Button、Input、Portal、Modal）
• 领域组件：特定领域的高级组件（如 AppConfiguration、ParamConfig、MaintenanceNotice）
• 页面组件：由领域组件和基础组件组成的完整页面（如 AppOverview、PromptEngineering、APIAccess）
• 布局组件：为页面提供统一结构的包装器（如 CommonLayout、AppLayout、DatasetLayout）

国际化系统

Dify 通过完整的 i18n 系统支持多语言：

系统架构

• i18n 上下文提供器
• useTranslation 钩子
• 当前语言状态
• 翻译文件（英语 en-US、简体中文 zh-Hans、日语 ja-JP、其他语言如 pt-BR、de-DE 等）

使用示例

翻译文件以分层对象组织，键为 UI 元素或消息标识，值为翻译后的字符串，键在所有语言文件中保持一致，支持无缝切换语言。

// 组件中的示例用法  
const { t } = useTranslation()  
return <Button>{t('operation.save')}</Button>  

基于上下文的状态管理

前端使用 React Context API 进行状态管理，创建上下文提供器层级：

Component Tree  
├─ Context Providers  
│  ├─ useAppContext()  
│  ├─ useContext(I18n)  
│  │  ├─ App Context（应用状态、工作区信息）  
│  │  ├─ I18n Context（当前语言、翻译函数）  
│  │  └─ Settings Context（用户设置、主题偏好）  
├─ Root Component  
└─ Nested Components  

优势

• 全局状态可在整个组件树中访问
• 相关状态和功能逻辑分组
• 按需选择性消费状态

路由与导航

Dify 利用 Next.js 路由能力，支持：

• 文件系统路由
• 自动代码拆分
• 带预加载的客户端导航

路由结构

Next.js Routing  
├─ Next.js Router  
│  ├─ 编程式导航（useRouter 钩子）  
│  └─ 链接组件（Link Component）  
├─ 路由路径  
│  ├─ /apps/*  
│  ├─ /datasets/*  
│  ├─ /settings/*  
│  └─ /explore/*  

编程式导航示例

const router = useRouter()  
// 检查用户权限并按需重定向  
if (isCurrentWorkspaceDatasetOperator) {  return router.replace('/datasets')  
}  

Dify Web 前端架构通过 Next.js 和现代 React 模式，构建了模块化、易维护且用户友好的应用。基于上下文的状态管理、完整的国际化系统和分层组件组织，实现了高效开发和流畅的用户体验。