一款基于 Electron C DLL 架构的桌面验证工具统一桥接sdtech_docxWord与sdtech_xlsx v3.1Excel通过可视化 API 面板、结构树与只读预览快速验证 OOXML 读写能力与前后端全链路。一、软件概览OfficeExcel 面向Office 文档库开发与集成联调场景前端 React 通过 Koffi 调用backend.dllBackend 再链接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层级说明Frontend无边框 Electron 窗口三视图工作台 / 打开文件 / 设置Backend会话句柄映射doc_id/xlsx_id不暴露 C 指针到 JSsdtech_docxWord OOXML 子集读写段落、表格、图片、样式等sdtech_xlsxExcel 工作簿建模对标 Apache POI XSSF 能力演进三、主要功能3.1 导航与文档类型工具栏左侧为文档类型标签右侧为页面导航入口说明Word (.docx)docx API 工作台与解析Excel (.xlsx)xlsx API 工作台与解析工作台创建 / 打开 / 保存 / 各类写操作 API打开文件只读解析预览 consistency 检查设置配置持久化%APPDATA%\OfficeExcel\config.json状态栏显示 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能力说明创建 / 打开 / 保存标准 xlsx 生命周期单元格文本、数值、布尔、日期、公式合并 / 样式字体、对齐、背景色、边框、数字格式行列列宽、行高、冻结、筛选富文本 / 批注 / 超链接 / 图片单元格级扩展v3.0 流式 / 懒加载workbook_create_streaming(windowRows)— SXSSF 风格窗口行workbook_open_lazyload_sheet— 按需加载大文件v3.1 深化新增模块API 示例说明图表add_chart/get_charts类别轴 数值系列读写 chart part透视表add_pivot_table/get_pivot_tables数据源区域与落位公式引擎VLOOKUP、DATE、TODAY、YEAR/MONTH/DAY、CONCAT常用函数扩展流式 flushflush_streaming_rowsstreaming 工作簿落盘中间态加密workbook_open_encrypted/workbook_save_encryptedAgile / Standard 加密库版本常量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 写入保持Word (.docx)标签选中进入「工作台」点击docx_create对应「调用」依次调用 add_paragraph、add_heading 等 API填写保存路径点击「保存」或「另存为…」切换到「打开文件」浏览同一文件查看预览与 consistency示例 2xlsx 图表与透视表v3.1切换到Excel (.xlsx)workbook_create()写入表头与数据单元格展开「v3.1 图表 / 透视表」填写系列区域后调用 add_chart / add_pivot_table保存 xlsx在「打开文件」中重新打开验证结构树与预览示例 3加密工作簿创建或打开工作簿展开「v3.1 流式 flush / 加密」设置密码调用workbook_save_encrypted使用workbook_open_encrypted重新打开验证五、开发与构建5.1 快速开始cd Frontend npm install npm runsync-docx# 同步 prebuilt/docxnpm runsync-xlsx# 同步 prebuilt/xlsxnpm run backend# 编译 backend.dll 并拷贝到 Frontend/dllnpm run dev# 开发模式5.2 打包桌面程序cd Frontend npm run backend npm run dist# 输出: Frontend/release/win-unpacked/OfficeExcel.exe5.3 库层测试GTestcd Libs/sdtech_xlsx cmake--preset win-release cmake--build build/win-release--config Release ctest--test-dirbuild/win-release-C ReleaseXlsxPhaseDeepeningTest等用例覆盖图表、透视、公式、加密、flush 等 v3.1 能力。5.4 博文配图自动生成pipinstall-rscripts/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现代化桌面 UIHash 路由切换视图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 需求欢迎反馈。下载版本说明下载链接绿色版解压即用无需安装OfficeExcel.rar访问密码: 1150安装版一键安装支持卸载OfficeExcel_Setup_1.0.0.exe访问密码: 1150源码包源码包OfficeExcel-Source.rar访问密码: 1150