pinmap-to-pinlist/CHANGELOG.md

Changelog

[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