# iOffice

**Repository Path**: masonwu21/ioffice

## Basic Information

- **Project Name**: iOffice
- **Description**: No description available
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iOffice

> 一个轻量级、免安装的桌面办公套件：内置文档编辑器与电子表格，开箱即用。

iOffice 当前版本 **v0.0.1**，提供「文档」与「表格」两大功能，无需安装 Microsoft Office / WPS，双击即可使用。

## 功能特性

- **文档编辑（Word）**：基于 `@eigenpal/docx-editor-react` 的富文本编辑器，支持打开 / 保存 `.docx`，自动记忆上次停留的视图。
- **电子表格（Excel）**：基于 FortuneSheet 的高性能表格，支持打开 / 保存真实的 `.xlsx` 文件（读写由 C++ 端 `xlnt` 完成），公式、数字、文本均正确渲染。
- **原生体验**：C++（TauriCPP 封装 wxWidgets / Win32）负责文件系统对话框、文件读写与版本信息；前端 React 负责交互与渲染。
- **绿色免安装**：发布为单个 `.exe`，不写入注册表、不污染系统。

## 技术架构

| 层 | 技术 |
| --- | --- |
| 原生内核 | C++17 + TauriCPP + xlnt（xlsx 读写）+ nlohmann/json |
| 前端 | React 18 + TypeScript + Vite |
| 文档组件 | @eigenpal/docx-editor-react |
| 表格组件 | @fortune-sheet/react |

C++ 与前端通过「命令桥（bridge）」通信：`open_file` / `save_file` / `open_xlsx` / `save_xlsx` / `get_version` 等。

## 构建

```powershell
# 需安装 CMake、Python3、Node.js，以及 Windows 构建工具链
.\build.ps1
```

构建完成后可执行文件位于 `build/Release/Release/iOffice.exe`。

## 目录结构

```
IOffice/
├── CMakeLists.txt        # 构建配置（含版本号、图标、EXE 资源）
├── build.ps1             # 一键构建脚本（前端 + C++）
├── src/                  # C++ 源码（main.cpp, xlsx_conv.cpp, ...）
├── frontend/             # React 前端
│   └── src/              # App.tsx, WordEditor.tsx, ExcelEditor.tsx, bridge.ts
├── TauriCPP/             # 原生框架依赖
├── doc/                  # 文档与软文
└── README.md
```

## 版本

当前版本：**0.0.1**。EXE 右键「属性 → 详细信息」中可见文件版本与产品版本，界面标题栏亦显示版本号。

## 许可

仅供学习与交流使用。