InteractiveHtmlBom中轨道和区域包含功能失效问题分析

问题描述

在使用InteractiveHtmlBom(简称IBOM)插件版本2.8.0配合KiCad 7.0.10时，用户发现即使启用了"包含轨道(tracks)"和"包含区域(zones)"的选项，生成的BOM(物料清单)中仍然未能正确显示这些内容。

问题原因

经过分析，这个问题可能涉及两个关键因素：

1. HTML页面缓存问题：当用户首次生成BOM时如果没有启用轨道和区域选项，后续即使启用了这些选项，浏览器可能仍然加载之前缓存的HTML页面版本。

2. 图纸信息设置不完整：某些情况下，图纸页面设置信息(如标题、版本等)的缺失可能导致IBOM插件无法正确处理轨道和区域的包含逻辑。

解决方案

针对上述问题，建议采取以下解决步骤：

1. 清除浏览器缓存：在生成新的BOM前，清除浏览器缓存或使用隐私浏览模式，确保加载的是最新生成的HTML文件。

2. 完整填写图纸信息：

   • 在KiCad中打开项目
   • 进入"文件"→"页面设置"
   • 确保所有相关字段(如标题、版本、日期等)都已填写完整
   • 重新生成IBOM

3. 双重确认选项设置：

   • 在IBOM生成对话框中，确保"包含轨道"和"包含区域"选项已被勾选
   • 生成后，在HTML页面左上角的设置面板中再次确认这些选项是否启用

技术背景

IBOM插件在处理PCB轨道和区域信息时，需要完整的项目上下文信息。图纸页面设置的缺失可能导致插件无法正确建立PCB元素的坐标参照系。此外，HTML前端采用了本地存储机制来记忆用户偏好，这可能导致新旧设置冲突。

最佳实践建议

1. 养成在项目开始时完整填写图纸信息的习惯
2. 定期清理浏览器缓存或使用"强制刷新"(Ctrl+F5)查看最新BOM
3. 在团队协作环境中，确保所有成员使用相同版本的IBOM插件和KiCad
4. 遇到显示问题时，首先检查HTML页面内的设置面板，而非仅依赖生成对话框的设置

通过以上措施，可以确保IBOM插件正确显示PCB的轨道和区域信息，为PCB设计和检视提供更完整的数据支持。