v0.3.0

主要更新

Added

• 为 textfigure 增加可选的 auto-text-width 图片实宽测量，并提供 min-text-width 与 column-gap 控制，避免宽图把正文压成窄列（Gitee #I7QT33）
• 为 choices 增加 \item* 正确选项标记以及 show-answer、answer-color 显示控制；默认隐藏标记，启用后同时着色正确选项标签和内容（Gitee #I5ROOL）
• 为 problem 新增 hang 键，并为 choices 新增 item-linesep、left-indent、right-indent 与 margin 键（Gitee #I6HQ2S、#ID7HWH、#I67JXY）
• 为 paren/type 新增 dotfill 点线填充模式（Gitee #I63X3T）
• 为 multifigures 新增 column-gap 图片列间距键，并文档化底层 tblr 的 colspec 参数透传方式（Gitee #ID823C）
• 为 page 新增 custom 纸张尺寸以及 paper-width、paper-height、margin、headheight 键，可配置任意单页纸张（含 16K）（Gitee #IDBLDN、#ID7G2T）

Changed

• \fillin 在显示长答案时会按自然宽度自动切换到可换行排版，\fillin* 继续作为强制换行兼容写法；多行答案会根据内容深度自动调整下划线，避免高公式压线（Gitee #ID6D6C）
• 解答题内第二层小题默认改用小写罗马数字编号，第三层改用小写字母编号，以匹配 2026 年高考试卷层级样式（Gitee #IK0BLV）
• 抽取 question、fillin、choices 与 calculations 共用的计数器注册层；新增 \tikzcirclednumber，并弃用有歧义的直接调用 \circlednumber*{...}（Gitee #IDPOT4）
• 文档明确 \varnothing 固定使用 Asana Math 字形的范围，并澄清该单符号覆盖不等同于完整支持 mtpro2（Gitee #ID83OW）
• calculations/align=t|m|b 现在同时控制同行项目的首行基线、居中和末行基线对齐
• 文档化通过 \ExamPrintAnswerSet 为教师版覆盖标题、科目并隐藏 \warning、notice 的稳定写法（Gitee #I670KF）

Fixed

• 完善 GitHub/Gitee 双平台发布流程：Gitee Release 支持幂等更新与附件替换，完整构建脚本同步更新 build.lua、类、宏包和手册版本元数据
• 修复题目列表参数被辅助分组提前还原，导致题目后出现额外行间距及缩进异常的问题（Gitee #IK0A55）
• 修复多份试卷使用 solution/show-solution=show-move 时，章节题号重置导致前面试卷答案文件被覆盖的问题（Gitee #IJR78Q）
• 修复 question 和 problem 捕获环境正文，导致其中不能使用 verbatim、\verb 等代码内容的问题（Gitee #I8QVL9）
• 修复填空宽度恰好等于 \linewidth 时未进入可换行分支，仍可能超出版心的问题（Gitee #IAXE1N）
• 修复 question/problem 中 \textfigure 的首行基线随行内内容高度漂移的问题（Gitee #ICEH9X）
• 修复 problem 没有题干、直接以 enumerate 开头时首个小问额外缩进的问题（Gitee #ID9469）
• 修复 \vec{\beta} 等单控制序列被按命令名称字符数判断，错误使用箭头样式的问题（Gitee #IDDOCK）
• 为独立加载的 exam-zh-choices 注册 tikzcirclednumber 计数器，并抽取共享的 TikZ 带圈数字实现（Gitee #IDPPJR）
• 修正文档中 fillin/width-type 的默认值标记，使其与源码的 normal 一致（Gitee #ID6INO）
• 修复 calculations 同行项目公式高度不同时基线不一致的问题（Gitee #IHXNX9）
• 修复 calculations 在 question 与 problem 首段中的位置受宿主 itemindent 影响而不一致的问题（Gitee #IHQMPM）

完整变更记录见仓库中的 CHANGELOG.md。

v0.2.7

Added

• 新增 scripts/gitee-release.sh：Gitee Release 自动创建脚本
• 新增 scripts/git-update.sh：智能 Git 工作流脚本，支持自动按模块分组提交
• 新增 scripts/test-build.sh：测试构建流程验证脚本
• 新增 scripts/build-common.sh：构建脚本公共函数库
• 新增 scripts/README.md：脚本使用说明文档
• 新增 examples-basic/03-real-exam-scenario.tex：真实试卷场景示例
• 新增 doc-basic/body/quick-reference.tex：快速参考手册
• 新增 AGENTS.md：代理协作文档

Changed

• 重构 scripts/build.py：优化代码结构和 CTAN 打包逻辑
• 增强 scripts/build-ctan.sh：改进 CTAN 构建流程
• 优化 scripts/build-release.sh：完善发布流程处理
• 改进 Makefile：新增 examples-basic 编译目标
• 优化 examples-basic/ 下所有示例文件的内容和格式
• 全面更新入门文档 doc-basic/ 各章节内容
• 更新 doc/body/usage.tex：修正选项值说明
• 更新 README.md：改进项目说明和使用指南
• 优化 .gitignore：添加 Python 缓存排除规则，修正 .claude/ 排除逻辑

Fixed

• 修复入门文档中的笔误和格式问题
• 移除 exam-zh-question.sty 中未使用的答案颜色变量
• 统一代码格式：清理尾随空格，规范缩进

Documentation

• 新增 GitHub 仓库链接，保留 Gitee 作为国内镜像

Testing

• 更新所有测试基准文件（.lvt 和 .tlg），确保测试与代码修改同步

v0.2.6 - 2025-11-12

[0.2.6] - 2025-11-07

Added

• 增加 exam-zh/draft 的多层级键值对支持，允许更灵活的草稿配置

Changed

• 修改 calculations 环境的宽度参数，从 0.3\textwidth 调整为 0.45\textwidth，改善计算题排版效果

Fixed

• 修复 solution 环境与 align* 数学环境结合时出现的尾随空行问题
• 修复 \fillin 命令在 no-answer-type=none 时超宽内容无法自动换行的问题
• 将 \par 保护起来，防止其被意外展开导致的格式问题
• 使用字符串比较方式处理 * 和 label-pos 的值，提高代码健壮性

Documentation

• 补充 page/show-foot 选项的文档说明