pinmap-to-pinlist/docs/features.md

功能清单

核心功能

功能 ID	功能名称	描述	输入	输出	依赖	优先级	验收标准	审批状态
F001	PinMAP 解析	解析 PinMAP Excel 文件	Excel 文件	解析后的 Pin 数据	无	1	能正确解析 PinMAP 结构	已通过
F002	PinList 生成	从 PinMAP 生成 PinList	Pin 数据	PinList Excel 文件	F001	2	能正确生成 PinList	已通过
F003	PinList 解析	解析 PinList Excel 文件	Excel 文件	解析后的 Pin 数据	无	1	能正确解析 PinList 结构	已通过
F004	PinMAP 生成	从 PinList 生成 PinMAP	Pin 数据	PinMAP Excel 文件	F003	2	能正确生成 PinMAP	已通过

Bug 修复

功能 ID	功能名称	描述	输入	输出	依赖	优先级	验收标准	审批状态
F005	BAT 脚本修复	修复 run.bat 换行符为 CRLF，去掉 lines=50 参数	无	修复后的 run.bat	无	3	Windows 下正常运行	已通过
F006	周长公式修复	将周长公式从 2*rows+2*cols-4 改为 (rows+cols)*2	rows, cols	正确的周长值	无	1	15×15 网格 60Pin 验证通过	已通过

功能增强

功能 ID	功能名称	描述	输入	输出	依赖	优先级	验收标准	审批状态
F007	模板读取	MAP→List 和 List→MAP 双向转换均读取并应用模板样式	模板文件	带样式的输出文件	无	2	双向转换均应用模板样式	已通过
F008	循环处理流程	处理完不退出，循环等待下一个文件，输入 Q 返回主菜单	用户输入	循环处理或返回主菜单	无	2	处理完不退出，Q 返回主菜单	已通过

v1.5.0 新增（2026-06-06）

功能 ID	功能名称	描述	输入	输出	依赖	优先级	验收标准	审批状态
F009	MAP→List 使用 balllist 模板	PinMAP→PinList 转换方向查找并使用 BallList-Template.xlsx，不再共用 PinMAP 模板	BallList-Template.xlsx	带 balllist 模板样式的 PinList 输出	无	P1	MAP→List 使用 balllist 模板的样式	已完成
F010	List→MAP 使用 ballmap 模板	PinList→PinMAP 转换方向查找并使用 BallMAP-Template.xlsx，不再共用 PinMAP 模板	BallMAP-Template.xlsx	带 ballmap 模板样式的 PinMAP 输出	无	P1	List→MAP 使用 ballmap 模板的样式	已完成
F011	模板格式提取式应用	从模板仅提取格式信息（字体、边框、对齐、列宽、行高），输出文件行列数由实际 Pin 数量决定，不复制模板行列结构	模板文件	格式信息正确应用到输出文件	F009, F010	P1	模板格式正确应用到不同 Pin 数的输出文件	已完成
F012	修复 PinMAP 生成中上/下边 PinName 位置	PinList→PinMAP 时，下边 PinName 应在序号上方（max_row-1 而非 min_row+1），上边 PinName 应在序号下方（min_row+1 而非 max_row-1）	PinList 数据 + 网格尺寸	PinName 位于正确位置的 PinMAP	无	P0	4×4 PinMAP 示例中 Pin3/Pin4 出现在 C6/D6，Pin5/Pin6 出现在 E5/E4	已完成

v1.5.5 整改（2026-06-12）

功能 ID	功能名称	描述	输入	输出	依赖	优先级	验收标准	审批状态
F013	修复 PinMAP→PinList 上方引脚丢失	PinMAP 解析时封装上侧（Top）引脚未被识别，导致 PinList 中缺失上边所有引脚。需修复解析逻辑确保四边引脚全部提取	PinMAP Excel	完整的 PinList	无	P0	示例 QFN60 PinMAP→PinList 输出 60 个引脚，无缺失	已完成
F014	PinList→PinMAP 样式模板应用	List→MAP 时必须读取 PinMAP-Template.xlsx（位于 Code/src/Template/），提取字体（名称/大小/粗体/颜色）、对齐方式（水平/垂直）、列宽、行高、单元格背景色、边框样式，应用到输出 xlsx。行列数由实际数据决定，不复制模板行列结构	PinMAP-Template.xlsx + PinList 数据	带模板样式的 PinMAP xlsx	F013	P0	输出 PinMAP 的字体、对齐、列宽行高、背景色、边框与模板一致	已完成
F015	PinMAP→PinList 样式模板应用	MAP→List 时必须读取 PinList-Template.xlsx（位于 Code/src/Template/），提取字体、对齐方式、列宽、行高、单元格背景色、边框样式，应用到输出 xlsx。行列数由实际数据决定	PinList-Template.xlsx + PinMAP 数据	带模板样式的 PinList xlsx	F013	P0	输出 PinList 的字体、对齐、列宽行高、背景色、边框与模板一致	已完成
F016	PinList→PinMAP 转换正确性验证	使用用户提供的示例 PinList（CSV）作为输入，验证 List→MAP 生成的 PinMAP 与示例 PinMAP 结构一致：上方引脚占第2-3行(序号+PinName)，标题独立第1行合并单元格，共21行	示例 PinList CSV	与期望 PinMAP 逐行一致的 xlsx	F013, F014	P0	输出与 bugs.md BUG-007 期望 CSV 逐行一致	已完成
F017	PinMAP→PinList 转换正确性验证	使用用户提供的示例 PinMAP（CSV）作为输入，验证 MAP→List 生成的 PinList 与示例 PinList 一致：60 个引脚无缺失、封装名正确提取、格式正确	示例 PinMAP CSV	与示例 PinList 结构一致的 xlsx	F013, F015	P0	生成的 PinList 与示例 PinList 结构完全一致	已完成

优先级排序

1. P0（必须）：F013 修复 PinMAP→PinList 上方引脚丢失 — 核心逻辑 Bug，两个方向转换的前置依赖
2. P0（必须）：F014 PinList→PinMAP 样式模板应用 — 用户反馈双向转换都不正常
3. P0（必须）：F015 PinMAP→PinList 样式模板应用 — 用户反馈双向转换都不正常
4. P0（必须）：F016 PinList→PinMAP 转换正确性验证 — 端到端验收
5. P0（必须）：F017 PinMAP→PinList 转换正确性验证 — 端到端验收
6. P1（重要）：F012 修复上/下边 PinName 位置 — 核心逻辑 Bug
7. P1（重要）：F006 周长公式修复 — 核心逻辑错误
8. P1（重要）：F005 BAT 脚本修复 — 影响 Windows 用户使用
9. P2（建议）：F009 MAP→List 用 balllist 模板 — 已被 F015 覆盖
10. P2（建议）：F010 List→MAP 用 ballmap 模板 — 已被 F014 覆盖
11. P2（建议）：F011 模板格式提取式应用 — 已被 F014/F015 覆盖
12. P2（建议）：F007 模板读取 — 功能增强（已被 F014/F015 取代）
13. P2（建议）：F008 循环处理流程 — 体验优化

v1.6 回归 Bug（2026-06-12）

Bug ID	关联功能	问题描述	详细对比	状态
BUG-007	F013, F016	PinList→PinMAP 上方引脚并入标题行，结构缺 2 行	程序生成：19 行，标题 QFN60,Pin60,... 上方引脚混入第 1 行；期望：21 行，第 1 行独立标题（合并单元格），第 2-3 行为上方序号和 PinName，第 4 行起为左边引脚	已修复

具体差异（见 bugs.md BUG-007 完整 CSV 对比）：

1. 上方引脚（Pin60-Pin46）被挤入第 1 行标题行，缺少独立的上方序号行和 PinName 行
2. 标题应为多行合并单元格，实际被压缩为单行
3. 总行数：19 vs 期望 21，缺 2 行