Huaqiu-Electronics/dsh-pcb-parts-search

README excerpt

dsh-tool-pcb-parts-search English DSH PCB 元器件搜索工具插件 —— 按关键词搜索 IC / 有源 / 无源电子元器件，用于 PCB 设计与 EDA 选型。通过芯灵（eda.cn）queryPage 接口查询，默认只返回带 EDA 模型（原理图符号 / PCB 封装）的器件。 动机 Agent 做 PCB 设计、原理图绘制、BOM 选型时，需要按型号或描述查找电子元器件。现有路径是起 bash 进程让模型现写 curl 脚本调搜索引擎： 1. 每次调用都起进程 ——Windows 上尤其昂贵，且模型手写 HTTP 请求错误率高 2. 结果不可结构化 ——模型从网页 HTML 里提取型号、描述、数据手册地址，字段缺失/格式混乱是常态 3. 无法保证可设计性 ——搜到的器件不一定有 EDA 模型（原理图符号 / PCB 封装），放进设计后发现无法布局连线 本插件封装芯灵 queryPage 搜索接口为一次函数调用，毫秒级返回结构化 JSON（mpn / 制造商 / 描述 / 数据手册），默认过滤出带 EDA 模型的器件，保证结果可直接用于 PCB 设计。 安全模型 - 白名单域名 ：仅向写死的 https://www.eda.cn/api/chiplet/products/queryPage 发送 POST 请求，不接受用户传入的 URL - 入口参数双重校验 ：工具入口（ runSearch ）与 API 客户端（ queryPageSearch ）各自独立校验，不依赖上游 schema - keyword ：非空字符串，≤200 字符 - page size ：整数 1–50 - require eda model ：布尔值 - HTTP 状态码 + 业务 code 双重校验 ：HTTP 200 不代表业务成功，必须再检查响应体 code === 200000 （eda.cn 接口的坑，详见 queryPage.ts 文件头注释） - 防御性结构解包 ：对 result[].queryPartVO.part 做空值过滤，避免下游 map 时 undefined 报错 - 字段白名单 ：返回只取 mpn / manufacturer id / part desc / datasheet 四个字段，不透传接口原始返回的其他字段 - 超时兜底 ： timeoutMs: 15000 （网络请求，高于纯计算工具的 1000ms） - 工具参数会记入会话日志，不要传入敏感数据 架构 - src/index.ts ：Cordis 插件入口（ name / inject / apply ），注册 pcb parts search 工具；含参数防御、结果映射、文本渲染 - src/queryPage.ts ： queryPageSear…

Category