本文面向希望基于此项目进行二次开发的前端工程师，从技术栈选型、核心架构设计、关键模块实现到二开实践路径，提供一份完整的技术地图。

---

一、技术栈总览

本项目是一个 Taro 多端 CMS 内容展示前端，一套代码同时编译为 H5、微信/支付宝/抖音小程序等多端应用：

层面	技术	版本	用途
框架	Taro	4.1.x	多端统一框架
UI 库	React	18.x	视图层
语言	TypeScript	5.x	类型安全
构建	Vite	4.x	编译打包
样式	Tailwind CSS	3.x	原子化 CSS
小程序适配	weapp-tailwindcss	4.x	小程序端 Tailwind rem→rpx 转换
状态管理	Zustand	5.x	轻量响应式 Store（Context 模式）
数据层	TanStack React Query	5.x	服务端状态管理
国际化	i18next + react-i18next	25.x / 16.x	多语言翻译
HTTP 客户端	Axios	1.x	REST 通信
代码高亮	highlight.js	11.x	语法着色
Markdown	marked	17.x	内容解析
数学公式	KaTeX	0.16.x	LaTeX 渲染
流程图	Mermaid	11.x	图表渲染
实时通信	SSE (fetch-event-source)	2.x	服务端推送

本文面向希望基于此项目进行二次开发的前端工程师，系统性地讲解项目的技术选型、架构设计与模块划分，并提供扩展开发的实操指引。

---

一、项目概览

本项目是一个面向内容管理的现代前端应用，使用 Nuxt 4（Vue 3）构建，支持 SSR/SSG 双模式部署，提供文章、分类、标签、评论等完整的内容管理功能，并内置多语言（中英文）和暗色模式支持。

核心特性一览

特性	技术方案
框架	Nuxt 4（Vue 3.5+）
样式	Tailwind CSS v4 + CSS 变量主题系统
UI 组件库	shadcn-vue（基于 Reka UI）
状态管理	Pinia + 持久化插件
数据请求	Axios + TanStack Vue Query
国际化	@nuxtjs/i18n（prefix 路由策略）
内容渲染	marked + Shiki + KaTeX + Mermaid
富文本编辑	Tiptap
API 协议	Protobuf 生成 TypeScript HTTP 客户端
部署	SSG 静态生成 + SPA fallback

本文面向希望基于此项目进行二次开发的前端工程师，从技术栈选型、核心架构设计、关键模块实现到二开实践路径，提供一份完整的技术地图。

---

一、技术栈总览

本项目是一个静态导出型 CMS 内容展示前端，采用以下核心技术栈：

层面	技术	版本	用途
框架	Next.js (App Router)	16.x	静态导出、路由、SSG
UI 库	React	19.x	视图层
语言	TypeScript	5.x	类型安全
样式	Tailwind CSS	4.x	原子化 CSS
组件库	shadcn/ui (Radix UI)	最新	无障碍 UI 原语
状态管理	Zustand	5.x	轻量响应式 Store
数据层	TanStack React Query	5.x	服务端状态管理
国际化	next-intl	4.x	多语言路由与翻译
HTTP 客户端	Axios	1.x	REST 通信
代码高亮	Shiki	4.x	双主题语法着色
Markdown	marked	17.x	内容解析
数学公式	KaTeX	0.16.x	LaTeX 渲染
流程图	Mermaid	11.x	图表渲染
富文本编辑	Tiptap	3.x	评论编辑器
实时通信	SSE (fetch-event-source)	2.x	服务端推送

本文面向希望基于此项目进行二次开发的 Flutter 工程师，从技术栈选型、核心架构设计、关键模块实现到二开实践路径，提供一份完整的技术地图。

---

一、技术栈总览

本项目是一个 Flutter 全平台 CMS 内容展示前端，一套 Dart 代码同时编译为 iOS、Android、Web、macOS、Windows 等多端应用：

层面	技术	版本	用途
框架	Flutter	3.x (Dart 3.12+)	全平台 UI 框架
语言	Dart	3.x	类型安全 + 空安全
状态管理	flutter_bloc + Cubit	9.x	响应式状态（Cubit 模式）
服务定位	GetIt	9.x	轻量 IoC 容器（单例管理）
路由	GoRouter	17.x	声明式路由 + ShellRoute
国际化	flutter_intl (intl)	0.21.x	ARB 翻译文件 + 代码生成
HTTP 客户端	Dio + Retrofit	5.x / 4.x	REST 通信 + 类型安全客户端
API 代码生成	swagger_parser	1.43.x	OpenAPI → Dart 模型 + 客户端
数据缓存	cached_query	3.x	Query/Mutation 缓存管理
响应式适配	flutter_screenutil	5.x	手机端设计稿适配（Web 端禁用）
Markdown	flutter_markdown	0.7.x	内容解析
HTML 渲染	flutter_widget_from_html	0.17.x	富文本渲染
加密	encrypt + crypto	5.x / 3.x	AES 加密（Token 持久化）
JWT	jose	0.3.x	JWT Token 解析
图片缓存	cached_network_image	3.x	网络图片缓存
骨架屏	shimmer	3.x	加载占位动画
环境变量	flutter_dotenv	6.x	.env 文件管理
日志	logger	2.x	结构化日志