pinmap-to-pinlist/CHANGELOG.md

Changelog

[v1.5.0] - 2026-06-06

✨ 功能新增

• F009 MAP→List 使用 balllist 模板：run_map_to_list() 改查 BallList-Template.xlsx，不再共用旧模板
• F010 List→MAP 使用 ballmap 模板：run_list_to_map() 改查 BallMAP-Template.xlsx，模板完全分离
• F011 模板格式提取式应用：从模板的 cellXfs/fonts/borders/fills 提取实际样式定义，替换硬编码边框和对齐；无模板时完全回退到默认样式
• F012 验证+回归测试：新增 test_f012_pinname_position() 验证下边 Name 在 max_row-1、上边 Name 在 min_row+1，添加 5×5 往返一致性测试

🗑️ 废弃

• _find_template_path() (PinMAP-Template.xlsx) — 不再自动查找，由 _find_balllist_template_path() 和 _find_ballmap_template_path() 替代

📝 文档

• 更新 docs/tasks.md T015 状态为已完成
• 更新 docs/features.md F009-F012 状态

🔧 修改文件

• Code/src/main.py — 新增两个模板查找函数，修改两个方向的模板调用
• Code/src/xlsx_writer.py — 重写 _styles_xml() 支持模板样式提取
• Code/src/template_reader.py — 增强 cellXfs 提取（xfId、applyAlignment、wrapText）
• Code/src/test_pinmap.py — 新增 F012 回归测试

[v1.3.15] - 2026-06-01

🐛 Bug 修复

• pinmap_layout.py: 周长公式从 2(rows+cols)−4 改为 (rows+cols)×2 — 修复角点共享策略，每条边独立包含其端点
• pinmap_generator.py: 角点单元格写入 "6/7" 格式 — 修复 v1.3 下角点引脚丢失问题
• pinmap_parser.py: 读取时包含角点，按 "/" 拆分解析多引脚序号 — 修复 roundtrip 丢失引脚问题

[v1.2.0] - 2026-05-26

🐛 Bug 修复

• run.bat: cd /d "%~dp0src" → cd /d "%~dp0Code\src" — 修复 cd 路径报错
• run.bat: chcp 65001 末尾添加 >nul — 修复 title 中文乱码
• run.bat: mode con lines=20 → lines=50 — 修复 Log 窗口无法上滑
• Code/src/file_selector.py: .strip() 后增加 .strip('"\'') — 修复拖拽文件路径带引号导致不存在

[v1.0.1] - 2026-05-25

📝 文档完善

• 新增 Code/docs/README.md — 项目完整说明文档（8.1KB）
• 新增 Code/docs/QUICKSTART.md — 快速入门指南（6.6KB）
• 新增 Code/docs/RELEASE.md — 版本发布说明（5.1KB）
• 完善项目文档体系，覆盖架构设计、快速上手、版本历史

[v1.0.0] - 2026-05-25

🎉 首次发布

功能

• PinMAP 解析：支持方形/长方形封装，左上角为 1 脚，逆时针排序
• 格式支持：兼容 .xls（BIFF8 引擎）和 .xlsx 两种 Excel 格式
• 智能验证：自动检测重复引脚、间隙、空单元格等结构问题
• PinList 生成：按顺时针顺序输出引脚序号列表
• GUI 模式：支持 tkinter 文件选择器，零命令行使用
• 命令行模式：python main.py input.xlsx 快速转换

技术

• Python 标准库，零第三方依赖
• 自定义 BIFF8 引擎解析 .xls 文件（~19KB）
• openpyxl 读写 .xlsx 文件
• 模块化架构：解析 → 验证 → 生成 → 输出

架构

• main.py — 入口与流程编排
• xls_reader.py — BIFF8 .xls 解析引擎
• xlsx_reader.py — .xlsx 解析器
• pinmap_parser.py — PinMAP 结构解析
• validator.py — 结构验证与错误检测
• pinlist_generator.py — PinList 生成器
• xlsx_writer.py — .xlsx 输出
• file_selector.py — tkinter 文件选择器
• models.py — 数据模型
• utils.py — 工具函数

测试

• 6 个测试夹具覆盖正常/异常场景
• 测试报告：Test/test_report.md