KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

FlowExcel

★ 115 Open GitHub ↗

🎯 Visual Excel data processing tool - Build complex workflows without coding. Drag & drop interface with real-time preview. Cross-platform desktop app.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="left">
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/logo_light.png" alt="FlowExcel Logo" width="60" style="display: inline-block; vertical-align: middle; margin-right: 15px;"/>
<h1 style="display: inline-block; vertical-align: middle; margin: 0;">FlowExcel</h1>
</div>

**🌍 Language / 语言**: [English](README_EN.md) | **中文**

### 让Excel数据处理变得像搭积木一样简单

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/TimsPizza/FlowExcel/main/LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/TimsPizza/FlowExcel/releases)
[![CI](https://github.com/TimsPizza/FlowExcel/workflows/CI/badge.svg)](https://github.com/TimsPizza/FlowExcel/actions)
[![Release](https://github.com/TimsPizza/FlowExcel/workflows/Build%20and%20Release/badge.svg)](https://github.com/TimsPizza/FlowExcel/releases)

## 💡 关于FlowExcel

FlowExcel是一个专门为简化常规数据分析工作定制化的工具，让业务人员无需编程知识也能构建复杂的数据处理流程。

### ✨ 核心特性

🎯 **可视化流程编辑** - 拖拽式操作，智能连接，自动布局  
📊 **实时数据预览** - 节点级预览，即时反馈，确保准确性  
🗂️ **工作区管理** - 多项目支持，团队协作，配置复用  
🔧 **灵活配置** - 工作表级配置，适配各种Excel格式  
📈 **强大处理** - 索引驱动，多种聚合，复杂逻辑支持

### 🎯 为什么选择FlowExcel？

<table>
<tr>
<td align="center">
<img src="https://img.icons8.com/?size=100&id=63760&format=png&color=000000" alt="拖拽"/>
<br><strong>用户友好</strong><br>
极简界面<br>极低学习门槛
</td><td align="center">
<img src="https://img.icons8.com/?size=100&id=B01YPclGisjL&format=png&color=000000" alt="拖拽"/>
<br><strong>无编程门槛</strong><br>
业务人员用业务思维<br>解决业务问题
</td>
<td align="center">
<img src="https://img.icons8.com/?size=100&id=13758&format=png&color=000000" alt="预览"/>
<br><strong>所见即所得</strong><br>
每个操作节点实时预览<br>确保处理正确性
</td>
<td align="center">
<img src="https://img.icons8.com/?size=100&id=114444&format=png&color=000000" alt="安全"/>
<br><strong>数据安全</strong><br>
完全本地运行<br>确保数据隐私
</td><td align="center">
<img src="https://img.icons8.com/?size=100&id=63766&format=png&color=000000" alt="国际化"/>
<br><strong>国际化支持</strong><br>
多语言支持<br>完善的多语言支持
</td>
</tr>
</table>

---

## 🚀 快速开始

### 🎯 三步上手

只需三步，完成你的首个数据处理流程：

1. **📁 导入Excel文件** - 支持多工作表，工作表级表头配置，对非标准格式友好
2. **🎯 拖拽构建流程** - 可视化节点，无需编程知识，边构建边预览
3. **📊 导出处理结果** - 一键执行导出报表，可复用的流程配置

### 📦 示例工作区

想要快速体验FlowExcel的强大功能？我们提供了一个完整的示例工作区：

📁 **[example.fxw](https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/example.fxw)** - 下载示例工作区文件，一键导入即可体验完整功能

---

## ✨ 功能演示

### 🎯 添加节点 & 🔧 自动布局

<div align="center">
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/add_node_clipped_gif.gif" alt="添加节点演示" width="45%" style="display: inline-block; margin: 10px;"/>
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/auto_layout_clipped_gif.gif" alt="自动布局演示" width="45%" style="display: inline-block; margin: 10px;"/>
<p><em>左：点击即可添加节点，配置简单直观 | 右：一键自动布局，让复杂流程图变得井然有序</em></p>
</div>

### 👁️ 实时预览 & ⚡ 一键执行

<div align="center">
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/per_node_preview_clipped_gif.gif" alt="节点预览演示" width="45%" style="display: inline-block; margin: 10px;"/>
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/execute_flow_clipped_gif.gif" alt="执行流程演示" width="45%" style="display: inline-block; margin: 10px;"/>
<p><em>左：每个节点都能实时预览处理结果，确保数据准确性 | 右：构建完成后一键执行，快速获得处理结果</em></p>
</div>

### 📁 文件管理 & 🤝 团队协作

<div align="center">
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/add_file_edit_meta_clipped_gif.gif" alt="文件管理演示" width="45%" style="display: inline-block; margin: 10px;"/>
<img src="https://raw.githubusercontent.com/TimsPizza/blob/flow-excel/flow-excel/gifs/ws_import_export_clipped_gif.gif" alt="工作区导入导出演示" width="45%" style="display: inline-block; margin: 10px;"/>
<p><em>左：支持多文件管理，每个工作表可独立配置 | 右：工作区一键导入导出，团队协作更便捷</em></p>
</div>

---

## 💼 适用场景

### 财务分析

- 多部门预算数据汇总
- 月度/季度财务报表生成
- 成本费用分析和归类

### 销售运营

- 多渠道销售数据整合
- 客户数据清洗和分析
- 销售业绩统计和排名

### 人力资源

- 员工信息管理和统计
- 薪资数据处理和分析
- 绩效评估数据汇总

### 业务分析

- 运营数据的清洗和转换
- 多维度数据交叉分析
- 定制化报表生成

---

## 🛠️ 技术亮点

- **🎨 现代化前端**: React 18 + TypeScript + Tailwind CSS
- **⚡ 高性能后端**: Python FastAPI + Pandas
- **🖥️ 跨平台桌面**: Tauri框架，支持Windows/macOS/Linux
- **🔒 安全可靠**: 本地化运行，数据不离开本地环境
- **🚀 高性能**: 批量处理优化，大数据集流式处理

---

## 📦 安装使用

### 直接下载

前往 [Releases](https://github.com/TimsPizza/FlowExcel/releases) 页面下载对应平台的安装包：

#### 📦 安装包（推荐）
- **Windows**: `.msi` 安装包，自动配置系统集成
- **macOS**: `.dmg` 磁盘映像，拖拽即可安装
- **Linux**: `.deb` 包或 `AppImage` 文件

#### 💼 便携版
- **Windows**: `.zip` 压缩包，解压即用

### 支持平台

- Windows 10/11 (x64)
- macOS 10.15+ (Apple Silicon) 
- Linux (x64)

> ⚠️ **macOS用户注意**: 首次运行可能会出现安全警告，这是正常现象。请参考 [macOS安全指南](docs/macos-security-guide.md) 了解如何解决。

---

## 🔧 构建指南

### 环境要求

- **Node.js**: >= 21.0.0
- **Python**: >= 3.9.0
- **Rust**: >= 1.70.0 (用于Tauri)
- **pnpm**: >= 8.0.0
- **uv**: >= 0.6.17

### 克隆项目

```bash
git clone https://github.com/TimsPizza/FlowExcel.git
cd FlowExcel
```

### 安装依赖

```bash
# 安装前端依赖
pnpm install

# 安装Python依赖
cd src-python
uv sync
```

### 开发环境

```bash
# 启动开发服务器
pnpm tauri dev

# 在新终端启动Python后端
cd src-python
# 启动venv虚拟环境
# linux/macos
source .venv/bin/activate
# windows
.venv\Scripts\activate
# 启动后端
cd src
python main.py
```

### 构建发布

```bash
# 构建前端
pnpm build
# 构建Tauri应用
pnpm tauri build
```

### 项目结构

```
FlowExcel/
├── src/                 # React前端源码
├── src-python/          # Python后端源码
├── src-tauri/          # Tauri桌面应用
├── public/             # 静态资源
└── docs/               # 项目文档
```

---

## 🤝 贡献指南

欢迎任何形式的贡献！

### 如何贡献

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 开发规范

- 遵循现有的代码风格
- 为新功能添加测试
- 更新相关文档

---

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

---

## 🚀 开发和发布

### 开发环境设置

```bash
# 克隆项目
git clone https://github.com/TimsPizza/FlowExcel.git
cd FlowExcel

# 安装前端依赖
pnpm install

# 安装后端依赖
cd src-python && uv sync

# 运行开发服务器
pnpm start
```

### 快速命令

```bash
# 开发
pnpm dev                 # 启动开发服务器
pnpm test               # 运行所有测试
pnpm lint               # 代码检查

# 构建
pnpm build              # 构建前端和后端
pnpm build:full         # 完整构建（包含Tauri）

# 发布
pnpm release:draft      # 创建草稿发布
pnpm release:prerelease # 创建预发布
pnpm release:stable     # 创建正式发布
```

### CI/CD 流程

- ✅ **持续集成**: 每次推送代码自动运行测试和代码检查
- 🚀 **多平台构建**: 自动构建 Windows、macOS、Linux 版本
- 📦 **自动发布**: 推送版本标签自动发布到 GitHub Releases
- 🔒 **安全审计**: 自动检查依赖安全性

详细说明请查看 [部署指南](docs/deployment-guide.md)

---

## 🙏 致谢

感谢所有为FlowExcel贡献代码和建议的开发者！

Icons by [Icons8](https://icons8.com)

Badges by [ShieldsIO](https://img.shields.io)

---

<div align="center">
<strong>FlowExcel - 让数据处理回归简单</strong><br>
<a href="https://github.com/TimsPizza/FlowExcel/issues">报告问题</a> • 
<a href="https://github.com/TimsPizza/FlowExcel/discussions">讨论交流</a> • 
<a href="docs/deployment-guide.md">部署指南</a>
</div>

FlowExcel

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README