OfficeExcel — Word / Excel DLL 验证台功能介绍

一款基于 Electron + C++ DLL 架构的桌面验证工具，统一桥接 sdtech_docx（Word）与 sdtech_xlsx v3.1（Excel），通过可视化 API 面板、结构树与只读预览，快速验证 OOXML 读写能力与前后端全链路。

一、软件概览

OfficeExcel 面向 Office 文档库开发 与 集成联调 场景：前端 React 通过 Koffi 调用 backend.dll，Backend 再链接 sdtech_docx.dll / sdtech_xlsx.dll，对外暴露稳定的 C ABI 与 JSON 结构预览。

核心能力：

• 双文档类型：顶部切换 Word (.docx) / Excel (.xlsx)

• DLL 工作台：分组 API 按钮，一键调用并记录调用日志

• 打开并解析：拖放或浏览文件，网格/段落预览 + 读写一致性检查

• xlsx v3.1：图表、透视表、公式扩展、SXSSF flush、Agile/Standard 加密

Word 工作台：API 操作区、文档预览、结构树与调用日志

二、架构

Frontend (Electron + React + Koffi)         ↓ backend.dll  (sdtech_officeexcel_*)         ↓    ┌────┴────┐ sdtech_docx.dll   sdtech_xlsx.dll  (v3.1.0)    ↓                    ↓  OOXML / Word        OOXML / Excel 

三、主要功能

3.1 导航与文档类型

工具栏左侧为文档类型标签，右侧为页面导航：

状态栏显示 Backend DLL 加载状态及当前模式（docx / xlsx API）。

3.2 Word (.docx) 工作台

适用于验证 sdtech_docx 写入与结构回读。

典型 API 分组：

• 文档生命周期：docx_create / docx_open / docx_save / docx_destroy

• 内容块：段落、标题、表格、图片

• 样式：粗体、斜体、字体名等

• 结构预览：左侧树形结构 + 中间「纸张」预览 + 右侧属性

点击「调用」后，底部 调用日志 记录 API 名、参数 JSON 与成功/失败，便于对照 GTest 与 C API 文档。

3.3 Excel (.xlsx) 工作台 · v3.1

适用于验证 sdtech_xlsx 全量能力；面板标题为 「API 操作区 · xlsx v3.1」。

Excel 工作台：workbook_create 后可见 PreviewGrid 与 Sheet 结构树

工作簿与 Sheet：

v3.0 流式 / 懒加载：

• workbook_create_streaming(windowRows) — SXSSF 风格窗口行

• workbook_open_lazy + load_sheet — 按需加载大文件

v3.1 深化（新增）：

库版本常量：SDTECH_XLSX_VERSION_MAJOR/MINOR/PATCH = 3 / 1 / 0。

3.4 打开并解析

「打开文件」页提供 只读 解析链路，与写入工作台分离，便于对比「磁盘文件 ↔ 内存模型 ↔ UI 预览」是否一致。

界面分区：

• 左侧：拖放区 / 浏览文件，已解析文件信息

• 中间：docx 段落块预览 或 xlsx 网格预览（PreviewGrid）

• 右侧：读写一致性检查（checks 列表）

• 底部：本页独立调用日志

支持 .docx 与 .xlsx；切换顶部文档类型标签即可更换过滤器与预览组件。

3.5 设置

设置页集中管理应用级选项（路径、显示等），写入 %APPDATA%\OfficeExcel\config.json，重启后保持。

四、使用流程示例

示例 1：快速验证 docx 写入

1. 保持 Word (.docx) 标签选中，进入「工作台」

2. 点击 docx_create 对应「调用」

3. 依次调用 add_paragraph、add_heading 等 API

4. 填写保存路径，点击「保存」或「另存为…」

5. 切换到「打开文件」，浏览同一文件，查看预览与 consistency

示例 2：xlsx 图表与透视表（v3.1）

1. 切换到 Excel (.xlsx)，workbook_create()

2. 写入表头与数据单元格

3. 展开 「v3.1 图表 / 透视表」，填写系列区域后调用 add_chart / add_pivot_table

4. 保存 xlsx，在「打开文件」中重新打开验证结构树与预览

示例 3：加密工作簿

1. 创建或打开工作簿

2. 展开 「v3.1 流式 flush / 加密」

3. 设置密码，调用 workbook_save_encrypted

4. 使用 workbook_open_encrypted 重新打开验证

五、开发与构建

5.1 快速开始

cd Frontend npm install npm run sync-docx    # 同步 prebuilt/docx npm run sync-xlsx    # 同步 prebuilt/xlsx npm run backend      # 编译 backend.dll 并拷贝到 Frontend/dll npm run dev          # 开发模式 

5.2 打包桌面程序

cd Frontend npm run backend npm run dist # 输出: Frontend/release/win-unpacked/OfficeExcel.exe 

5.3 库层测试（GTest）

cd Libs/sdtech_xlsx cmake --preset win-release cmake --build build/win-release --config Release ctest --test-dir build/win-release -C Release 

XlsxPhaseDeepeningTest 等用例覆盖图表、透视、公式、加密、flush 等 v3.1 能力。

5.4 博文配图自动生成

pip install -r scripts/requirements-screenshot.txt  # 推荐：开发模式 python scripts/auto_screenshot.py --dev  # 或打包版 python scripts/auto_screenshot.py  # 已手动打开应用 python scripts/auto_screenshot.py --attach 

截图保存至 Docs/Blogs/OfficeExcel-功能介绍/images/。详见该目录下 README.md。

六、技术特点

• Electron + React：现代化桌面 UI，Hash 路由切换视图

• Koffi 桥接：JS 直接加载 backend.dll，低延迟 API 调用

• 双库合一：同一壳层验证 docx / xlsx，减少重复工具链

• JSON 预览协议：结构树、网格、consistency 统一由 Backend 序列化

• prebuilt 协作：协作者可只检出含 prebuilt/ 的源码包，无需本地编译 docx/xlsx 库

• 版本对齐：Frontend → Backend → sdtech_xlsx C API 全链路已桥接 v3.1 新接口

七、目录结构（摘要）

OfficeExcel/ ├── Frontend/           Electron + React 验证台 ├── Backend/            sdtech_officeexcel → backend.dll ├── Libs/ │   ├── sdtech_docx/    Word 库 + gtest │   └── sdtech_xlsx/    Excel 库 v3.1 + gtest ├── prebuilt/           SDK / docx / xlsx 预编译（打包用） ├── Docs/Blogs/         功能介绍博文与配图 └── scripts/            auto_screenshot.py 

八、系统要求

• 操作系统：Windows 10 及以上（64 位）

• 开发：Node.js 18+、CMake、MSVC、Windows SDK

• 运行：打包版已内置 Electron 运行时；开发版需先 npm run backend 生成 DLL

九、结语

OfficeExcel 将 Word / Excel 原生库能力 收敛到同一验证桌面：开发库时跑 GTest，联调 UI 时点按钮看预览与日志，发布前用「打开并解析」做一致性回归。若在使用中遇到问题或有 API 需求，欢迎反馈。

下载

<!-- itgather:downloads -->

## 下载

| 版本 | 说明 | 下载链接 |

|------|------|----------|

| 绿色版 | 解压即用，无需安装 | [OfficeExcel.rar](https://url66.ctfile.com/f/17802766-17569807277548-f7e6d9?p=1150)（访问密码: 1150） |

| 安装版 | 一键安装，支持卸载 | [OfficeExcel_Setup_1.0.0.exe](https://url66.ctfile.com/f/17802766-17569807276927-bbbd39?p=1150)（访问密码: 1150） |

| 源码包 | 源码包 | [OfficeExcel-Source.rar](https://url66.ctfile.com/f/17802766-17569807277645-fb4d2e?p=1150)（访问密码: 1150） |

<!-- /itgather:downloads -->

长按识别关注公众号