## [zhnumber-v3.1](https://github.com/CTeX-org/ctex-kit/releases/tag/zhnumber-v3.1)

- 说明带选项形式在写入辅助文件时的行为：计数器值在写入时即已固定，样式留待读回时套用（#1008）。
- 提升 LaTeX3 最低版本要求至 2025/10/09。
- 带选项的 `\zhnum` 与 `\zhdig` 先把计数器展开为数值再交给处理数值的实现，使它们在写入 `.toc` 一类辅助文件时固定为当时的计数器值（#1008）。
- 修正 `\zhdigwithoptions` 把选项当作额外参数传给 `\zhnum_digits_counter:n` 的笔误——带选项的 `\zhdig` 此前直接报 `Use of \??? doesn't match its definition` 并输出乱码（#1008）。
- 支持仅输出年或年月。
- 新增算筹数字 `\zhrod` 与 `\zhrodbox`，以及配置命令 `\zhrodsetup`（#366）。
- 修正 `Tn` 绑定到干支变量而非天干变量的笔误——设置 `Tn` 此前会改掉 `\zhganzhi` 的输出而对 `\zhtiangan` 无效（#1077）。
- 改用 `\keys_set_exclude_groups:nnnN` 代替已弃用的 `\keys_set_filter:nnnN`，避免 l3kernel 2026-09-09 起在调试模式下报错（#1095）。