maskedmatters/flex-suite

Flex Suite

Flex Suite是一款现代高性能浏览器办公套件，结合Rust、C++和TypeScript技术栈，提供丰富的文档编辑能力与流畅的用户体验，适用于个人及团队的日常办公需求。

🚀 核心功能

• 富文本编辑器：基于Tiptap开发，支持粗体、斜体、下划线、删除线、字体设置等多种格式。
• 数学与LaTeX：集成KaTeX实现专业数学公式排版，满足学术写作需求。
• 表格工具：高级可视化表格选择器（最大50×50），支持动态扩展与编辑。
• 多格式导出：可将文档导出为Markdown、DOCX或PDF格式，也支持直接打印。
• 现代界面：采用Material 3 Expressive设计风格，搭配Framer Motion实现流畅动画效果。
• 高性能计算：核心计算引擎基于C++20开发，确保数据处理快速高效。

🏗️ 项目结构

该项目采用单仓库（Monorepo）组织：

• /frontend：React Web应用（基于Vite、TypeScript、Tiptap、Framer Motion）。
• /backend：Rust API服务（基于Axum、Tokio、Serde）。
• /calc_engine：C++计算引擎（基于C++20、CMake）。

📦 部署方式

选项1：Docker（推荐）

从Docker Hub或GitHub Container Registry拉取并运行最新稳定版：

bash
# 从Docker Hub拉取
docker pull docker.xuanyuan.run/maskedmatters/flex-suite:latest
docker run -p 3000:3000 docker.xuanyuan.run/maskedmatters/flex-suite:latest

# 从GitHub Container Registry拉取
docker pull ***-ghcr.xuanyuan.run/maskedmatters/flex-suite:latest
docker run -p 3000:3000 ***-ghcr.xuanyuan.run/maskedmatters/flex-suite:latest

选项2：手动生产构建

无需Docker，直接在本地构建并运行生产版本：

1. 构建前端：

   bash
   cd frontend
   npm install
   npm run build
   

   生成dist文件夹包含编译后的资源。
2. 运行后端：

   bash
   cd ../backend
   cargo run --release
   

   后端将自动服务前端dist文件夹，访问地址：http://localhost:3000。

🛠️ 本地开发

前提条件

• Node.js：版本18及以上。
• Rust：最新稳定版。
• C++编译器 & CMake：用于计算引擎构建。
• Docker（可选）：用于容器测试。

选项1：交互式工作流（推荐）

适合活跃开发，支持热模块替换（HMR）：

1. 前端（终端1）：

   bash
   cd frontend
   npm install
   npm run dev
   

   • 运行地址：http://localhost:5173。
   • API请求代理至3000端口。
2. 后端（终端2）：

   bash
   cd backend
   cargo run
   

   • API服务地址：http://localhost:3000。
   • 重启时自动重新编译Rust/C++变更。

选项2：Docker Compose

验证本地变更在容器环境中的构建正确性：

bash
docker compose up --build

基于当前源代码构建应用，访问地址：http://localhost:3000。

由https://github.com/CaptioDev开发。