ZK 正版91
版本发布记录 · 更新日志

正版91 版本发布表:按日期倒序核对每次更新

这一页把正版91的版本号、发布日期、变更摘要和相关说明按时间从新到旧排成一张表。读者大多是来确认「我手上这个版本改了什么」「新版本值不值得升」「文件哈希对不对得上」的人,所以每条记录都尽量写清楚改动的范围和需要注意的地方,而不是只写一句「优化体验」。

版本发布表(倒序)

共 9 条记录 · 最近更新 2026-11-16
2026-11-16
v2.14.3

修复批量导入时字段映射错位

上一版在导入包含中英文混排列头的表格时,第 4 列之后可能整体右移一列,导致备注写进标签字段。本版改为按表头文本匹配而非下标匹配,并给不认识的表头单独列进「未识别字段」清单。

导入字段映射建议升级
2026-11-09
v2.14.2

离线模式下搜索不再阻塞界面

把本地索引的构建挪到空闲时段,输入关键字时先返回已就绪的部分结果,避免大库(十万条以上)在输入框里卡住两秒。索引未完成时会在结果顶部给出提示,不影响继续操作。

搜索性能
2026-10-30
v2.14.0

配置导出格式调整,旧备份仍可读取

导出文件的顶层结构由数组改为带版本号的对象,方便后续兼容。v2.13 及更早导出的备份文件可以直接导入,无需手工转换;反过来把新备份导入旧版本会提示格式不支持,这是预期行为。

配置兼容性需留意
2026-10-21
v2.13.6

修正定时任务在跨时区下的触发时间

原先按本地时间计算,设备时区变更后已保存的任务会提前或推迟执行。本版统一按绝对时间戳保存,并新增一次性的时间校正提示,升级后首次启动会列出受影响的三个以内的任务。

定时任务时区
2026-10-08
v2.13.4

日志轮转策略可自定义保留天数

默认保留 14 天,可在设置里改为 3 至 90 天。超过上限的旧日志按天清理,清理动作本身也写入日志,便于事后追溯。该设置不影响已有归档文件。

日志设置项
2026-09-25
v2.13.2

修复网络中断后重连重复提交

在弱网环境下点击提交后断线重连,可能出现同一条记录被写入两次。本版加入请求去重标记,重连后只补发未确认的请求,已确认的直接跳过。若历史数据中已有重复条目,需按说明页的手工合并流程处理。

网络数据一致性建议升级
2026-09-12
v2.13.0

列表视图支持按列分组折叠

在列表头部右键即可选择分组列,分组后每组默认展开,可一键全部收起。分组状态随视图保存,切换回来不会丢失。排序规则仍以组内排序优先。

列表视图新功能
2026-08-28
v2.12.5

安装包签名证书更换,需重新校验

自本版起安装包使用新的签名证书,旧证书在 2026-12-31 之后停止签发。升级前请按「包校验」一节的步骤核对指纹,指纹不匹配时不要继续安装,可先保留旧版本运行。

签名安全需留意
2026-08-14
v2.12.0

移除了已废弃的旧版导入接口

该接口自 v2.9 起标注为废弃,本版正式移除。仍在调用旧接口的脚本需要改为新接口,字段名变化见「变更说明」中的对照表。这一条是本次升级中最容易导致脚本报错的地方。

接口破坏性变更需留意

变更说明 · 逐条正文

下面几段是发布表里最常被单独翻出来的记录,写全了背景和操作步骤,方便直接照着做。

v2.14.3:批量导入字段映射错位的成因与自查

2026-11-16 · 归属版本 v2.14.3 · 标签:导入 / 字段映射

问题出现在「按列顺序读取」的旧逻辑上。当表格的表头是「名称、分类、数量、备注」这种中英文混排,且中间夹了空列时,程序会跳过空列,但下标没有同步回退,于是第 4 列开始整体右移一列,备注被写进标签字段。表现是导入完成后标签列出现一段长文本,而备注是空的。

本版的修法是改为按表头文本匹配,匹配不上的列不猜测,统一放进「未识别字段」清单让你手工指定。自查方法:导入前先看一眼预览界面的字段对照,如果某个目标字段显示为「未映射」,说明表头没被识别,手动选一次即可,选完会记住这组映射。

已经导入出错的数据不会自动回滚。处理办法是先按导入批次筛选出来,把标签列的长文本复制回备注,清空标签,再重新保存。批次号在导入记录里能查到。

v2.14.0:配置导出格式变了,旧备份还能用吗

2026-10-30 · 归属版本 v2.14.0 · 标签:配置 / 兼容性

能用。新格式只是在最外层包了一层带版本号的对象,读取时会先判断是数组还是对象,两种都能解析。所以从 v2.13 导出的备份可以直接在 v2.14 导入,不需要转换工具。

需要注意的是反方向:把新版本导出的备份拿到 v2.13 或更早的版本导入,会提示「格式不支持」。这不是文件损坏,而是旧版本不认识外层结构。如果确实需要在旧机器上恢复,可以在新版本里选择「导出为兼容格式」,会生成旧结构的文件,代价是新增的几个设置项不会被带过去。

建议做法:升级前先导出一份当前配置留底,升级后再导出一份,两份分开存放,文件名带上日期,出问题时能快速退回。

v2.12.5:签名证书更换后的校验步骤

2026-08-28 · 归属版本 v2.12.5 · 标签:签名 / 安全

证书更换意味着旧版本内置的公钥无法验证新包的签名,所以从 v2.12.5 起需要先更新一次受信任的公钥,再安装。顺序反了会看到「签名无法验证」的提示,这时不要点忽略继续安装。

正确的顺序是:下载安装包 → 对照发布页给出的指纹核对文件哈希 → 用新公钥验证签名 → 安装。哈希和指纹都要对得上,只对上一个不算通过。如果哈希对得上但签名验证失败,多半是下载过程中被中间层替换过,重新下载一次再试。

旧证书在 2026-12-31 之后停止签发,在此之前用旧证书签的包仍然可以正常工作,不必因为证书到期就紧急升级,但新装的机器建议直接用新证书的包。

v2.12.0:旧版导入接口移除,脚本要怎么改

2026-08-14 · 归属版本 v2.12.0 · 标签:接口 / 破坏性变更

旧接口 /api/import/legacy 已移除,统一走 /api/import。字段名有三处变化:title 改为 name,type_id 改为 category,extra 改为 fields 且值从字符串改为对象。其余字段保持不变。

如果脚本里只是简单拼接请求体,改这三个键名即可。如果之前把 extra 当成 JSON 字符串塞进去,现在要改成真正的对象,否则会被当成一个普通字段存下来,读的时候取不到子项。

验证方式:先用一条测试数据调新接口,返回里会带上解析后的字段列表,确认每个字段都落到预期位置,再批量跑。批量跑之前建议先备份,出错时可以直接回退到调用前的状态。

包校验 · 常用方法

  • 怎么核对安装包哈希

    Windows 用 certutil -hashfile 文件名 SHA256,macOS 用 shasum -a 256 文件名,Linux 用 sha256sum 文件名。把输出和发布页给出的值逐位比对,注意不要漏掉前导零。

    方法 · 2026-11-11
  • 签名指纹和哈希有什么区别

    哈希只能证明文件没被改动,签名还能证明这个文件确实由发布方签出。两者都要核对:哈希对上但签名失败,说明文件被完整地替换过。

    方法 · 2026-10-29
  • 下载后文件体积对不上怎么办

    先确认单位是字节还是 MB,再确认下载工具没有做二次压缩。两者都排除后重新下载,连续两次体积不同基本可以判断传输链路有问题。

    排查 · 2026-10-15

升级排查 · 常见现象

  • 升级后首次启动变慢

    多数是本地索引在重建,等进度条走完即可。如果超过十分钟没有动静,检查磁盘剩余空间是否低于 2GB。

    排查 · 2026-11-13
  • 回退到旧版本后配置读不出来

    用旧版本导出兼容格式的备份再导入,或直接恢复升级前留底的那份配置文件。

    排查 · 2026-11-02
  • 提示缺少依赖组件

    按提示里的组件名到系统组件页单独安装,装完重启一次再启动主程序。不要跳过重启,部分组件注册要重启才生效。

    排查 · 2026-10-19
  • 定时任务升级后不触发

    v2.13.6 之前的任务按本地时间保存,升级后会被校正一次。打开任务列表确认时间是否符合预期,不符合就重新保存一次。

    排查 · 2026-10-24

历史归档 · 更早的版本

  • v2.11.x 系列汇总

    主要围绕列表渲染性能,共 6 个修订版。当前已不再提供该系列的安装包,仅保留变更记录。

    归档 · 2026-07
  • v2.10.x 系列汇总

    引入分组视图的初始版本,早期版本有已知的排序缺陷,建议不要停留在此系列。

    归档 · 2026-05
  • v2.9.x 与旧接口废弃起点

    旧导入接口在此系列开始标注废弃,字段对照表可在这里查到。

    归档 · 2026-03

常见问题

一定要升到最新版吗?
不一定。表里标了「建议升级」的多是数据一致性问题,建议跟进;标「需留意」的升级前先看说明,尤其是破坏性变更那几条。

怎么看自己现在的版本号?
主界面标题栏右侧或设置页底部都有,格式是 v 加三段数字。

发布表会保留多久?
每个大版本至少保留最近两年的记录,更早的收进「历史归档」做汇总。

发现记录和实际不符怎么办?
先核对版本号是否对得上,同一版本号下不同构建可能有细微差别,以发布页当日的记录为准。