🐛 fix(codegen): 补齐自增主键模板上下文标记

[ZhaoXingPeng]

关联 Issue

Closes #171

背景（Situation）

Default/mapper.mustache 通过 {{#primaryKey.isAutoIncrement}} 控制 MyBatis keyProperty 和 useGeneratedKeys。TemplateContextBuilder._build_primary_key_context() 过去只返回主键名称、类型、JDBC 类型和注释，没有传递 ColumnInfo.auto_increment，所以真实自增主键即使已被 introspection 正确识别，最终 mapper 也会静默省略数据库生成主键回填配置。

任务（Task）

让主键上下文提供与列上下文一致的自增标记，并验证 Default mapper 对自增与非自增主键分别展开和跳过生成键选项。

行动（Action）

• 提交：752e11e
• 在 primaryKey 字典增加 isAutoIncrement 与兼容别名 autoIncrement，值直接来自主键列元数据。
• 新增上下文回归，覆盖 True/False 两种输入和两个别名。
• 新增实际渲染回归，读取 Default/mapper.mustache，断言仅自增主键输出 useGeneratedKeys="true"。
• 不修改数据库 introspection、SQL、复合主键策略、模板语法、输入 schema 或其他模板分类。

验证（Verification）

环境：Windows，仓库 .venv，Python 3.10.1，pytest 9.0.3，Ruff 来自 .venv。

PYTHONPATH=src python -m pytest tests/unit/test_template_context_builder.py -q
67 passed in 3.18s

PYTHONPATH=src python -m pytest tests/unit/ -q
693 passed in 5.52s

python -m ruff check src/ tests/ scripts/
All checks passed!

python -m ruff format --check src/dbjavagenix/generator/template_context.py tests/unit/test_template_context_builder.py
2 files already formatted

git diff --check
无输出

未运行真实 MySQL/PostgreSQL、Java/Maven 或 CI；这些结果只证明本地上下文和模板回归。

实验与证据（Evidence）

固定 TableInfo 输入为 account(id BIGINT PRIMARY KEY)，分别设置 ColumnInfo.auto_increment=True/False，通过 MustacheTemplateEngine 渲染真实 Default/mapper.mustache：

• True：primaryKey.isAutoIncrement=True，输出 useGeneratedKeys="true"。
• False：primaryKey.isAutoIncrement=False，输出不含 useGeneratedKeys="true"。

修复前主键字典没有该字段，Mustache section 对两种输入均不展开；当前行为与列上下文标记和模板意图一致。未据此宣称真实数据库或性能结论。

兼容性、风险与回滚

• 公共模板上下文只增加两个布尔字段，既有字段和非主键路径保持不变；旧模板忽略新增字段即可继续运行。
• 风险：复合主键仍沿用现有单主键模板语义，本 PR 明确不扩展该范围。
• 回滚：恢复单一提交 752e11e 即可，不涉及数据或配置迁移。
• 本 PR base 为 fix/169-postgresql-type-aliases，相对 base 仅包含本主题一个新增提交；待依赖链处理后合并前只检查一次最终 required checks。

[ZhaoXingPeng]

实现完成（2026-09-09）

当前结论

Issue #171 已完成实现。primaryKey 上下文现在传递主键列的自增状态，Default mapper 可以区分数据库生成键和调用方提供的主键；其他上下文字段和模板分类未改变。

变更与设计取舍

• 提交：752e11e
• 新增 isAutoIncrement 与 autoIncrement 两个布尔键，和现有列上下文命名保持一致，避免破坏旧模板。
• 选择在上下文构建边界补齐数据，而不是改 Mustache 条件；模板已有正确意图，缺口是元数据丢失。
• 复合主键、数据库查询和 SQL 生成仍是非目标；uv.lock 未跟踪、未提交。

验证与证据

• 固定 account(id BIGINT PRIMARY KEY) 输入分别设置 auto_increment=True/False。
• 上下文断言覆盖两个布尔键；真实 Default/mapper.mustache 渲染断言只在 True 分支包含 useGeneratedKeys="true"。
• 定向测试：python -m pytest tests/unit/test_template_context_builder.py -q，67 passed。

兼容性与下一步

• 新增字段对旧模板是可忽略的，已有字段和输出路径不变。
• 待验证回帖完成后保留当前依赖链，合并前统一检查最终 required checks；未查询 CI。

[ZhaoXingPeng]

验证完成（2026-09-09）

当前结论

本地完整单元套件、Ruff 静态检查和本次变更文件格式检查均通过。验证覆盖了上下文字典和真实 Mustache 渲染；没有把未运行的数据库、Maven 或 CI 检查写成通过。

变更与设计取舍

• 提交：752e11e
• 相对 base fix/169-postgresql-type-aliases 只有一个提交，改动为 2 个源/测试文件共 58 行新增。
• 维持 primaryKey=None（无主键表）行为；只为存在的主键增加明确布尔标记。

验证与证据

• PYTHONPATH=src python -m pytest tests/unit/test_template_context_builder.py -q：67 passed in 3.18s。
• PYTHONPATH=src python -m pytest tests/unit/ -q：693 passed in 5.52s。
• python -m ruff check src/ tests/ scripts/：All checks passed!。
• python -m ruff format --check src/dbjavagenix/generator/template_context.py tests/unit/test_template_context_builder.py：2 files already formatted。
• git diff --check：无输出。

兼容性与下一步

• 未运行真实数据库/Testcontainers、Java/Maven 和 CI；没有生产行为或性能结论。
• 回滚点为 752e11e；待前置 PR 🐛 fix(mcp): 统一跨工具驱动值 JSON 序列化 #162、🐛 fix(mcp): 收口全部 MCP 响应 JSON 序列化 #164、🐛 fix(codegen): 规范无前缀模板输出路径 #166、🐛 fix(codegen): 统一分析结果与模板导入映射 #168、🐛 fix(mcp): 补齐 PostgreSQL 时间类型别名映射 #170 按顺序合并，合并前只检查一次最终 required checks。