「页数转页号」WPS 表格加载项介绍

一、这是什么

一个 WPS 表格（ET）的原生 JS 加载项，用于自动化整理“档案目录”类表格。它的核心任务是把目录里每份文件的页数自动累加成连续的页号，再按名单匹配出序号、另存到指定位置，替代人工逐行计算和逐个文件处理。

二、解决什么问题

处理档案目录时，原本需要人工：把每份文件的页数手动累加成页号、逐份核对数据是否有缺漏、按名单找序号、另存到固定目录。本加载项把这些全部自动化，并在写入前先做校验，避免“页号算错却已打印/归档”的问题。

三、核心功能

1. 批量页数转页号 一次处理工作簿里所有符合规则的工作表（默认以某个前缀开头，如 Sheet1…）。每张表当作独立卷宗，页号各自从 1 起累加；末行可选写成“起始-结束”区间。

2. 转页号前自动数据检查 写入前先扫所有匹配表，两类问题判为非法并中止，绝不静默写错：

   • 页数所在列：为空、或不是数字；
   • 日期所在列：为空、或不是 8 位数字格式（含真实月日/闰年校验）。 发现后自动定位并选中首个问题单元格，提示用户修正。

3. 名单序号匹配 按当前工作簿文件名，在〈名单文件〉里匹配出对应人员的序号，作为另存文件名的前缀（补零对齐）。

4. 自动另存 处理完自动另存到指定输出目录（路径见下方“自动探测”）。

5. 结果面板 右侧任务窗格展示每次处理/检测的明细：处理了哪些表、份数、页号区间、另存路径、问题单元格清单等。

四、界面入口

功能区新增三个按钮：

五、检测的三级顺序

严格按 工作簿名 工作表名 数据 三级进行，前一级不满足就停止、不再往下查：

1. 工作簿名是否含目录表关键字；
2. 是否有以指定前缀开头的工作表；
3. 逐表检查页数列、日期列数据是否合法。

六、路径自动探测（关键设计）

名单文件与输出目录不写死单一位置，而是按盘符顺序自动探测：

1. 先探测主盘符下指定目录结构里是否有〈名单文件〉 有就用该盘；
2. 没有则试备用盘符的对应位置 有则名单、另存位置一并切到该盘；
3. 都没有 兜底：不读名单（序号取默认值），另存到当前工作簿所在目录下的输出子文件夹。

这样同一套工具能直接分发给使用不同盘符/网络环境的同事，无需改任何配置。

七、技术实现要点

• 原生 WPS JS 加载项，无框架、无构建链，代码结构简单、依赖少。
• 单元格读写统一用 Value2（WPS 表格宿主兼容要求），取值前先归一化二维数组形态。
• 关闭“屏幕刷新/弹窗”后，无论成功失败都在 finally 里恢复宿主状态，避免异常后界面卡死。
• 名单文件若原本就被用户打开，处理完不会关掉用户窗口，只关闭插件自己打开的文件。

八、部署与升级

• 打包成单个自解压 exe（官方 wpsjs build --exe），用户双击即自动部署并注册。
• 与机器相关的注册文件由 WPS 按目标机自动生成，无需随包分发。
• 升级：改版本号后重新打包，安装包名带 _v<版本号> 后缀（如 ..._v1.3.0.exe）。