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 字符串塞进去,现在要改成真正的对象,否则会被当成一个普通字段存下来,读的时候取不到子项。
验证方式:先用一条测试数据调新接口,返回里会带上解析后的字段列表,确认每个字段都落到预期位置,再批量跑。批量跑之前建议先备份,出错时可以直接回退到调用前的状态。