Altium Designer交互式BOM插件开发：从静态报表到智能导航地图-育师

简介：本资源是面向Altium Designer中高级PCB工程师的交互式BOM导出增强插件，专为解决原生软件缺乏Web化、可点击、带器件定位与采购链接的智能BOM输出能力而设计，适用于量产前物料协同、供应链对接及跨部门评审等实际工程场景。压缩包共35个文件，以17个JavaScript脚本（含核心导出逻辑、路径配置、HTML渲染与ECAD适配模块）为主干，辅以2个批处理文件（Initialize.bat/UnInitialize.bat）实现一键安装卸载，3个Markdown文档提供完整使用说明与配置指南，另有HTML/CSS前端资源及轻量级工具模块（modules-lite、tools、web），整体仅94KB，结构紧凑、依赖极简。目前已有393人学习下载，用户可直接部署即用，获得支持器件高亮定位、原理图/PCB双向跳转、自定义字段扩展及响应式Web页面导出的完整交互式BOM解决方案。

1. 项目概述：为什么我们需要一个交互式BOM插件？

如果你是一名电子工程师，或者长期使用Altium Designer进行PCB设计，那么对BOM（物料清单）的导出和整理工作一定不会陌生。传统的BOM导出流程是怎样的？无非是在AD里运行“报告 -> Bill of Materials”，选择一个模板，生成一个静态的Excel或CSV文件。然后，你把这个文件扔给采购、生产或仓库的同事，接下来就是无尽的沟通循环：“这个料号对应哪个位置？”“这个元件参数有替代料吗？”“这颗电容的封装确定是0603吗？”——你不得不一遍又一遍地打开庞大的PCB文件，在密密麻麻的元件中寻找答案，效率低下且容易出错。

这个“Altium Designer 导出交互式 BOM 表插件”项目，正是为了解决这一核心痛点而生。它不是一个简单的导出工具，而是一个旨在打通设计端与制造端信息壁垒的桥梁。所谓“交互式”，意味着生成的BOM不再是一张死板的表格，而是一个能与原始设计数据动态关联、可查询、可追溯的智能文档。想象一下，生产人员点击BOM表中的某个元件，就能在右侧看到该元件在PCB板上的精确位置（高亮显示），并能查看其所有属性、原理图符号、甚至附近的走线情况。这不仅能极大减少沟通成本，更能从源头避免因信息误解导致的生产错误。

从技术角度看，这个插件深度挖掘了Altium Designer的API潜力。Altium Designer作为一个成熟的EDA平台，提供了完善的COM（Component Object Model）接口，允许外部程序访问其几乎所有的内部对象，如原理图文档（ISch_Document）、PCB文档（IPCB_Board）、元件（IPCB_Component）、网络（IPCB_Net）等。本插件的核心，就是利用这些API，在导出BOM数据的同时，嵌入一套精密的索引和链接机制，将表格中的每一行数据与后台设计数据库中的具体对象一一绑定。当用户在外部查看器（如一个定制化的HTML页面或集成在AD内的面板）中与BOM交互时，插件能实时响应，并驱动Altium Designer主程序进行视图跳转、对象高亮等操作，从而实现真正的“交互”。

这个项目适合所有被BOM处理流程困扰的硬件团队，无论是初创公司的硬件工程师，还是大型企业的PCB设计专家。它不仅能提升个人效率，更能优化团队协作流程，是硬件设计数据管理走向智能化、可视化的一个关键实践。

2. 插件核心功能与设计思路拆解

2.1 从“静态报表”到“动态地图”的思维转变

设计这个插件，首先要颠覆对BOM的传统认知。我们不再将BOM视为设计流程的终点——一个交付物，而是将其视为一个动态的、处于设计数据生态中心的“导航地图”。

核心设计目标可以分解为以下几点：

数据完整性：导出的BOM必须包含所有必要的元件信息，且这些信息直接来源于AD的内部数据库，确保绝对准确。这包括：位号（Designator）、注释（Comment）、描述（Description）、封装（Footprint）、库参考（LibRef）、数量、以及所有自定义的元件参数（如厂商、料号、电压、容值等）。
双向链接：在BOM视图和PCB/原理图视图之间建立稳固的双向链接。不仅可以从BOM点击定位到PCB，理想情况下，在PCB上选中一个元件，也能在BOM视图中快速滚动并高亮对应的行。
轻量级与可移植性：生成的交互式BOM应该易于分发给没有安装Altium Designer的同事（如采购、项目经理）。因此，输出格式不能依赖于AD环境。一个非常理想的方案是生成一个独立的HTML文件，内嵌JavaScript来实现交互逻辑，通过WebSocket或HTTP与本地一个轻量级服务通信，再由该服务调用AD的API。
可定制性：不同的公司、不同的项目对BOM的格式和显示字段要求不同。插件需要提供灵活的模板系统，允许用户自定义BOM表中显示的列、排序规则、分组方式以及交互界面的布局。

2.2 技术架构选型：为什么是本地服务+Web前端？

实现交互式BOM，有几种可能的技术路径：

路径A：纯Altium Designer脚本/插件UI。在AD内部创建一个面板（Panel），直接在其中渲染BOM表格并处理交互。优点是集成度高，无需外部环境。缺点是界面定制能力受AD开发框架限制，且无法脱离AD环境查看，可移植性差。
路径B：生成带宏的Excel文件。在Excel中利用VBA编写宏，通过COM接口与正在运行的Altium Designer通信。这种方式对于熟悉Excel的团队有一定吸引力，但跨平台兼容性差（尤其是macOS），且Excel宏的安全性设置常常成为拦路虎，用户体验不稳定。
路径C：本地Web服务 + 前端页面。这是本项目推荐的架构。插件在AD内部作为一个“服务器端”运行，启动一个本地的HTTP/WebSocket服务（例如使用Delphi的Indy组件，或嵌入一个轻量级Web服务器库）。然后，插件生成一个静态的HTML/JS/CSS文件包，这个文件包可以通过浏览器直接打开。前端页面通过Ajax或WebSocket与本地服务通信，发送指令（如“高亮位号R1”），本地服务接收指令后，通过AD的API执行相应操作。

我们选择路径C，理由如下：

极致的前端自由度：HTML/CSS/JS生态拥有无比丰富的UI库（如Vue.js, React, Bootstrap），可以构建出非常美观、易用、响应式的交互界面，这是AD内置控件无法比拟的。
真正的跨平台与免安装查看：生成的HTML文件可以在任何操作系统的任何现代浏览器中打开。采购同事用他的Chrome，生产经理用她的Edge，都能获得一致的体验，无需任何额外软件。
松耦合与安全性：前端页面与AD后端通过定义良好的API接口通信，逻辑清晰。同时，本地服务只监听本地回路（localhost），不会对外网暴露，安全性有保障。
易于扩展：未来可以很容易地将此架构扩展为简单的团队协作工具。例如，将本地服务升级为一个小型网络服务，允许局域网内多个经过授权的浏览器客户端连接，实现多人同时查看和协同定位（需谨慎处理并发控制）。

2.3 插件模块划分

基于以上思路，我们可以将插件划分为以下几个核心模块：

AD接口模块：负责与Altium Designer交互。封装所有对AD API的调用，如遍历项目文档、提取元件信息、执行视图跳转和高亮命令。这是插件的基石。
数据提取与处理引擎：从AD接口模块获取原始元件数据，按照用户定义的模板进行清洗、整理、归类（如将电阻、电容按值分组），并计算总数量。这个模块需要高效处理可能包含数千个元件的大型设计。
模板系统：管理BOM输出格式。提供默认模板，并允许用户通过JSON或XML格式的配置文件自定义BOM表的列、过滤器、分组规则等。
本地服务模块：插件启动时，在后台开启一个Web服务器。它负责提供两项核心服务：一是响应前端页面的数据请求，返回JSON格式的BOM数据；二是接收前端发来的交互指令（如highlight?designator=R1,C2），并调用AD接口模块执行。
前端生成器：根据模板和整理后的BOM数据，动态生成一个完整的、包含HTML、JavaScript和CSS的文件夹。其中的JavaScript代码包含了与本地服务通信的所有逻辑。
用户界面（AD内）：在Altium Designer中提供一个简洁的对话框或面板，用于启动BOM导出、配置模板、打开生成的HTML文件等。

3. 核心细节解析与实操要点

3.1 深入AD API：精准抓取元件数据

Altium Designer的API功能强大但体系庞杂。提取BOM数据，主要涉及以下几个核心接口：

IWorkspace：工作区管理器，是访问当前打开项目的入口。
IProject：代表一个PCB项目。
ISch_Sheet和IPCB_Board：分别代表原理图纸和PCB板对象。
ISch_Component和IPCB_Component：代表原理图元件和PCB元件。

一个常见的陷阱是数据源的选择。BOM数据应该以原理图为准，还是以PCB为准？最佳实践是以原理图为主要数据源，用PCB数据进行补充和校验。因为原理图包含了元件的逻辑信息（参数、值），而PCB主要包含物理信息（位置、封装）。具体流程如下：

遍历原理图：通过IProject.DM_PhysicalDocuments遍历所有原理图文档，收集每一个ISch_Component。从每个元件对象中，可以获取Designator,Comment,Description, 以及通过SchComponent.GetState_AddParameterToDataBase获取所有附加参数（如Manufacturer,Part Number）。
映射PCB信息：通过元件的唯一标识（如UniqueId或Designator与Comment的组合），在PCB文档 (IPCB_Board) 中查找对应的IPCB_Component，从而获取其在板上的精确坐标 (X,Y)、旋转角度 (Rotation)、以及实际的封装名称（有时PCB上的封装名可能与原理图库中引用的名称略有不同，应以PCB为准）。
处理多通道设计：这是BOM处理的难点。AD中多通道设计会导致同一个逻辑元件在PCB上出现多个实例（如R1_1,R1_2）。在提取数据时，需要识别这些“父-子”关系，在BOM表中将它们合并为一行，但数量要乘以通道数。这需要仔细处理IPCB_Component的ChannelOffset和ChannelIdentifier属性。
参数优先级与合并：一个元件的同一个参数（如Part Number）可能在原理图元件、集成库、甚至是数据库链接中都有定义。插件需要定义清晰的参数值优先级规则（例如：原理图实例参数 > 数据库链接参数 > 库元件参数），并在数据提取阶段就完成合并，避免后续混乱。

注意：直接操作AD的API，尤其是涉及UI操作（如高亮、跳转）时，必须在主线程（或通过RunProcess方法）中执行，否则会导致AD界面无响应甚至崩溃。在本地服务模块中收到网络请求后，必须将操作请求派发到AD的主线程队列中执行。

3.2 构建轻量级本地Web服务

在AD插件中嵌入一个Web服务器听起来复杂，但利用现代库可以简化。例如，可以使用TIdHTTPServer(Indy) 来创建一个简单的HTTP服务器。

关键实现步骤：

初始化服务器：在插件初始化时，创建一个TIdHTTPServer实例。为其分配一个未被占用的端口（如 8080）。务必绑定到127.0.0.1(localhost)，而不是0.0.0.0，以确保服务只对本机可用。

// 伪代码示例 (Delphi) FHttpServer := TIdHTTPServer.Create(nil); FHttpServer.Bindings.Add.SetBinding('127.0.0.1', 8080); FHttpServer.OnCommandGet := HandleHTTPCommandGet; // 处理GET请求 FHttpServer.OnCommandOther := HandleHTTPCommandOther; // 处理POST等请求 FHttpServer.Active := True;

设计API接口：定义几个简单的RESTful风格的API端点供前端调用。
- GET /api/bom：返回整个BOM数据的JSON格式。这是页面加载时首次调用的接口。
- GET /api/highlight?designators=R1,C5,U3：接收一个位号列表，让AD高亮这些元件。服务端处理这个请求时，需要将位号列表解析出来，然后通过RunProcess调用AD API执行高亮命令。
- POST /api/zoom：接收一个区域坐标（{x1, y1, x2, y2}），让AD将视图缩放至该区域。

线程安全与AD主线程调用：这是最大的挑战。HTTP服务器的回调函数通常运行在独立线程中。绝对禁止在回调线程中直接调用任何会修改AD UI状态或文档的API。必须使用RunProcess方法或AD提供的线程同步机制，将任务抛给主线程执行。

procedure TMyPlugin.HandleHighlightRequest(DesignatorList: TStringList); begin // 这个函数在HTTP线程中被调用 RunProcess('MyHighlightProcess', procedure begin // 这个匿名过程会在AD主线程中执行 for Des in DesignatorList do begin Comp := FindComponentOnPCB(Des); if Comp <> nil then Comp.SetState_Selected(True); // 安全地调用AD API end; ClientAPI.ViewManager_FullUpdate; end); end;

3.3 前端页面的设计与通信逻辑

前端页面的目标是提供一个清晰、易用的表格界面，并处理与本地服务的通信。

技术栈选择：为了简单和便携，可以不依赖Node.js等构建工具。直接使用CDN引入Vue.js或React等框架，以及一个表格组件库（如ag-Grid Community或Tabulator）。它们功能强大，只需一个HTML文件引入即可运行。
页面结构：页面可分为左右或上下两栏。左栏（或上栏）是交互式BOM表格，支持排序、过滤、列拖拽。右栏（或下栏）是一个“预览区”，可以显示当前选中元件在PCB上的位置截图（通过服务端API/api/snapshot?designator=xx动态获取）或关键属性。
通信机制：
- 初始加载：页面加载后，立即向http://127.0.0.1:8080/api/bom发起Ajax请求，获取JSON数据并渲染表格。
- 交互响应：为表格的每一行添加点击事件。当用户点击某一行时，前端代码收集当前选中的位号，并向/api/highlight接口发送请求。同时，可以更新预览区的内容。
- 状态保持与错误处理：前端需要处理本地服务未启动的情况（请求超时），并给出友好提示，如“请确保Altium Designer正在运行且插件已启用”。可以考虑增加一个“连接状态”指示灯。

3.4 模板系统的实现

模板系统决定了BOM的输出面貌。一个灵活的模板可以用JSON来定义：

{ "bomTemplate": { "name": "公司标准BOM模板", "columns": [ {"id": "Designator", "title": "位号", "width": 120, "groupable": false}, {"id": "Comment", "title": "型号/值", "width": 150}, {"id": "Description", "title": "描述", "width": 200}, {"id": "Footprint", "title": "封装", "width": 100}, {"id": "Manufacturer", "title": "制造商", "width": 150}, {"id": "PartNumber", "title": "厂商料号", "width": 200}, {"id": "Quantity", "title": "数量", "width": 80, "aggregator": "sum"} ], "groupBy": ["Comment", "Footprint", "PartNumber"], "filters": [ {"field": "Comment", "operator": "notEmpty"} ] } }

插件在导出时读取这个JSON文件，指导数据引擎如何组织列、分组和过滤。用户可以通过AD插件内的一个简易编辑器来修改和创建自己的模板。

4. 插件开发实操流程详解

4.1 开发环境搭建与项目初始化

开发Altium Designer插件，官方主要支持两种语言：Delphi和C++。对于此类需要复杂UI交互和脚本功能的插件，使用Delphi配合Altium Designer Scripting System往往是更高效的选择。因为AD自身的很多功能就是用Delphi写的，其API对Delphi的支持最为原生和稳定。

安装必备工具：
- Altium Designer：确保已安装，并记下其安装目录。需要从中找到必要的类型库文件（.tlb或.pas接口文件）。
- Embarcadero RAD Studio (Delphi)：建议使用较新的版本（如10.4 Sydney或11 Alexandria），以获得更好的开发体验。社区版对于个人开发是免费的。
- 获取AD接口文件：在AD安装目录下（如C:\Program Files\Altium\AD22\System）找到ScriptingSystem文件夹，其中包含Client.pas,Server.pas等关键文件。将这些文件复制到你的Delphi项目目录中，它们是与AD通信的桥梁。
创建Delphi项目：
- 打开RAD Studio，新建一个 “Package” 项目。Altium插件本质上是一个特殊的动态链接库（DLL）。
- 在项目中，需要引用从AD复制过来的接口文件（Client.pas等）。
- 设置正确的输出路径。编译后的DLL需要放置在AD的插件目录下，通常是C:\Users\<用户名>\AppData\Roaming\Altium\Altium Designer <版本>\Extensions。你可以在项目设置中直接将输出目录指向这里，方便调试。

定义插件入口点：每个AD插件DLL必须导出一个名为Run的函数，这是AD加载插件时的入口。

library MyInteractiveBOMPlugin; uses SysUtils, Classes, Client; // 引入AD Client接口 function Run(const Client: IClient): LongBool; stdcall; begin Result := True; try // 在这里初始化你的插件主窗体或逻辑 if not Assigned(MyPluginForm) then MyPluginForm := TMyPluginForm.Create(nil); MyPluginForm.Show; except on E: Exception do Client.ShowMessage('插件启动失败: ' + E.Message); end; end; exports Run; begin end.

4.2 数据提取引擎的实现

这是插件的“心脏”。我们需要创建一个专门的数据管理器类TBomDataManager。

遍历与收集：

procedure TBomDataManager.ExtractBomData; var WorkSpace: IWorkspace; Project: IProject; Doc: IDocument; SchDoc: ISch_Document; Comp: ISch_Component; BomItem: TBomItem; begin FBomList.Clear; // 清空现有列表 WorkSpace := GetWorkspace; // 获取当前工作区 if not Assigned(WorkSpace) then Exit; Project := WorkSpace.DM_FocusedProject; // 获取当前焦点项目 if not Assigned(Project) then Exit; // 遍历项目中的所有物理文档（原理图） for i := 0 to Project.DM_LogicalDocumentCount - 1 do begin Doc := Project.DM_LogicalDocuments(i); if Doc.DM_DocumentKind = 'SCH' then // 判断为原理图 begin SchDoc := Doc as ISch_Document; for j := 0 to SchDoc.SchIterator_Count - 1 do begin Comp := SchDoc.SchIterator[j] as ISch_Component; if Comp.IsHidden or Comp.IsLocked then Continue; // 跳过隐藏或锁定元件 BomItem := TBomItem.Create; BomItem.Designator := Comp.Designator.Text; BomItem.Comment := Comp.Comment.Text; // 提取所有参数 for k := 0 to Comp.GetState_AddParameterToDataBaseCount - 1 do begin Param := Comp.GetState_AddParameterToDataBase(k); BomItem.Parameters.Values[Param.Name] := Param.Value; end; // 查找对应的PCB元件，补充坐标和封装信息 FindAndFillPcbInfo(BomItem); FBomList.Add(BomItem); end; end; end; // 后续进行分组、合并（处理多通道）、数量统计 ProcessGroupingAndQuantity; end;

分组与合并逻辑：ProcessGroupingAndQuantity方法需要根据用户模板中定义的groupBy字段（如Comment,Footprint,PartNumber），对FBomList中的条目进行合并。合并时，Designator字段需要将多个位号用逗号连接（如R1, R2, R3），Quantity字段则累加。这里需要特别注意字符串比较的准确性（大小写、空格处理）。

4.3 本地HTTP服务的集成

在插件主窗体创建时，初始化HTTP服务器。

启动服务：

procedure TMyPluginForm.FormCreate(Sender: TObject); begin FHttpServer := TIdHTTPServer.Create(nil); FHttpServer.Bindings.Add.SetBinding('127.0.0.1', FConfig.Port); // 端口从配置读取 FHttpServer.OnCommandGet := HandleCommandGet; FHttpServer.Active := True; // 生成一个随机的API密钥，用于简单验证，防止未经授权的访问 FApiKey := GenerateRandomKey; Log('交互式BOM服务已启动在: http://127.0.0.1:' + IntToStr(FConfig.Port)); end;

处理API请求：

procedure TMyPluginForm.HandleCommandGet(AContext: TIdContext; ARequestInfo: TIdHTTPRequestInfo; AResponseInfo: TIdHTTPResponseInfo); var ApiPath: string; Designators: string; begin AResponseInfo.ContentType := 'application/json'; AResponseInfo.CharSet := 'utf-8'; // 简单验证 if ARequestInfo.Params.Values['key'] <> FApiKey then begin AResponseInfo.ResponseNo := 403; AResponseInfo.ContentText := '{"error": "Forbidden"}'; Exit; end; ApiPath := ARequestInfo.Document; if ApiPath = '/api/bom' then begin // 返回BOM JSON数据 AResponseInfo.ContentText := FBomDataManager.GetBomAsJson; end else if Pos('/api/highlight', ApiPath) = 1 then begin Designators := ARequestInfo.Params.Values['designators']; // 将高亮请求派发到主线程执行 TThread.Queue(nil, procedure begin RunInMainThread(procedure begin HighlightComponentsOnPCB(Designators); end); end); AResponseInfo.ContentText := '{"status": "ok"}'; end; end;

4.4 前端页面的生成与集成

插件需要有一个“导出”按钮，点击后执行以下操作：

准备前端资源：在插件目录下预先存放一个web_template文件夹，里面包含：
- index.html：主页面骨架。
- app.js：主要的JavaScript应用逻辑（使用CDN引入Vue和ag-Grid）。
- style.css：样式表。
- config.js：配置文件，包含本地服务的地址和端口。
动态生成数据文件：在导出时，调用FBomDataManager.GetBomAsJson方法，将BOM数据写入到web_template文件夹下的一个bom_data.json文件中。

复制并打开：将整个web_template文件夹复制到用户指定的输出目录（如桌面），并重命名为BOM_项目名称_日期。然后，使用ShellExecute函数，用默认浏览器打开新文件夹中的index.html文件。

procedure TMyPluginForm.ExportInteractiveBOM; var OutputDir, SourceDir, DestDir: string; BomJson: string; begin // 1. 让用户选择输出目录 if SelectDirectory('请选择输出目录', '', OutputDir) then begin // 2. 生成BOM JSON数据 BomJson := FBomDataManager.GetBomAsJson; // 3. 复制前端模板 SourceDir := ExtractFilePath(Application.ExeName) + 'web_template\'; DestDir := IncludeTrailingPathDelimiter(OutputDir) + 'Interactive_BOM\'; CopyDirTree(SourceDir, DestDir); // 需要自己实现目录复制函数 // 4. 将JSON数据写入目标文件夹 WriteStringToFile(DestDir + 'data\bom.json', BomJson, TEncoding.UTF8); // 5. 用浏览器打开 ShellExecute(0, 'open', PChar(DestDir + 'index.html'), nil, nil, SW_SHOWNORMAL); ShowMessage('交互式BOM已生成并打开！'); end; end;

5. 常见问题与排查技巧实录

在开发和实际使用这类插件时，会遇到各种各样的问题。以下是一些典型问题及其解决方案。

5.1 插件加载失败或功能异常

问题现象：在Altium Designer的插件列表中看不到你的插件，或者点击菜单命令无反应。
排查步骤：
1. 检查DLL位置：确认编译生成的.dl文件是否在正确的插件目录下。不同版本的AD插件路径可能不同，可以尝试在AD中运行System -> Explore -> Running Scripts，查看弹出的资源管理器窗口的路径。
2. 检查依赖项：你的DLL可能依赖某些运行时库（如Indy的DLL）。确保这些DLL也存在于AD的安装目录或系统PATH中。最简单的办法是使用静态链接编译你的项目。
3. 查看AD脚本错误窗口：AD在加载插件出错时，有时会在脚本错误窗口（System -> Messages -> Scripting System）中打印信息。这是最重要的调试信息来源。
4. 入口函数签名：确保Run函数的声明完全正确（参数类型、调用约定stdcall），并且已正确导出（exports段）。

5.2 BOM数据不完整或错误

问题现象：导出的BOM缺少某些元件，或者参数值不对。
排查技巧：
1. 逐层调试遍历逻辑：在数据提取代码中，加入详细的日志，记录遍历到的每一个文档和元件。对比AD软件自带的BOM报告，看缺失了哪些部分。常见原因是过滤条件过于严格，误删了某些元件（如电源端口、图纸符号等）。
2. 参数来源验证：用AD打开一个元件，查看其属性面板，对比“Parameters”列表和“Database Links”等信息。确认你的代码是从正确的来源获取参数。有时参数名是大小写敏感的。
3. 多通道设计验证：创建一个简单的多通道设计（如一个电阻重复使用3次），测试你的分组和数量计算逻辑是否正确。重点检查IPCB_Component的ChannelOffset属性。

5.3 前端页面无法与本地服务通信

问题现象：浏览器打开了HTML页面，但表格是空的，或者点击元件没有高亮反应，浏览器控制台显示网络错误。
排查流程：
1. 检查服务是否运行：在浏览器中直接访问http://127.0.0.1:8080/api/bom?key=你的密钥。如果返回JSON数据，说明服务正常；如果连接失败，说明插件内的HTTP服务器未成功启动。
2. 检查端口冲突：你代码中使用的端口（如8080）可能被其他程序占用。可以在插件中实现端口自动探测，如果默认端口被占，尝试下一个端口（如8081, 8082）。
3. 检查跨域问题（CORS）：如果你的HTML文件是用file://协议打开的，向localhost发请求可能会遇到跨域限制。解决方法是在HTTP服务器的响应头中添加CORS头。
```
AResponseInfo.CustomHeaders.AddValue('Access-Control-Allow-Origin', '*'); AResponseInfo.CustomHeaders.AddValue('Access-Control-Allow-Methods', 'GET, POST');
```
4. 检查防火墙：某些严格的防火墙或安全软件可能会阻止本地回环端口的通信。尝试临时禁用防火墙测试。

5.4 AD界面卡死或无响应

问题现象：点击BOM表中的元件后，Altium Designer主程序卡住，甚至停止响应。
根本原因与解决：这几乎可以肯定是因为在非主线程中直接调用了修改AD UI或文档的API。所有涉及ISch_Component,IPCB_Board,Client等接口的调用，都必须确保在AD的主线程上下文中执行。
- 正确做法：使用RunProcess或TThread.Synchronize/TThread.Queue（在Delphi中）将任务包装起来，提交给主线程执行。如前文代码示例所示。
- 调试方法：在可能耗时的操作前后，用Client.SendMessage输出调试信息，观察AD的消息面板，看操作是否被正确序列化。

5.5 性能问题：处理大型设计时速度慢

问题场景：当PCB设计包含上万个元件时，数据提取和前端页面渲染可能变慢。
优化策略：
1. 数据提取优化：避免在遍历过程中进行频繁的、耗时的单个查询（如每次都为单个元件查询PCB坐标）。改为先批量收集所有原理图元件信息，再一次性通过PCB板的GetPcbComponentsByIterator等方法批量获取物理信息，建立映射关系。
2. 前端虚拟滚动：使用支持虚拟滚动（Virtual Scrolling）的表格组件，如ag-Grid或Tabulator。它们只渲染可视区域内的行，即使BOM有数万行，也能保持流畅滚动。
3. 数据分页：对于后端API，如果BOM数据极大，可以考虑支持分页查询（/api/bom?page=1&size=100），而不是一次性返回所有数据。
4. 缓存机制：如果同一个项目被多次导出，且设计未更改，插件可以缓存处理好的BOM数据（存储为本地文件），下次直接读取缓存，跳过耗时的AD API遍历过程。

开发这样一个深度集成的插件，就像在Altium Designer这个庞大的生态系统中开辟一条新的数据通道。最大的挑战往往不是某个具体功能的实现，而是对AD对象模型的理解深度、多线程编程的严谨性，以及对整个数据流从设计端到用户端的全局把控。当你看到生产部门的同事不再拿着打印的图纸跑来问你“这个R34在哪”，而是轻松地在网页上点一下就看到高亮位置时，那种提升团队协同效率的成就感，会让人觉得所有的调试和踩坑都是值得的。这个插件项目，本质上是一次对硬件设计数据流动方式的微小但重要的改进尝试。

本文还有配套的精品资源，点击获取