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

---

一、技术栈总览

本项目是一个 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	服务端推送