更新日志

本文档记录元件管理器插件的所有重要更新。

格式基于 Keep a Changelog， 版本号遵循 语义化版本。

---

Unreleased

计划中

---

2.2.2 - 2026-07-12

新增功能

✅ 库存验证报告（图形界面）

• 从原理图/PCB 读取元件，按 C编号分组统计需求
• 独立 iframe 窗口展示验证报告（支持全屏）
• 图形化表格：C编号、名称、位号、需用量、库存量、状态
• 分类展示：缺少 / 不足 / 充足（三色卡片摘要）
• 跳过"不加入BOM"的元件
• 仅验证有 C编号的元件
• 菜单名改为"验证库存"

其他

• 默认库存预警值设为 1
• 新增 report.html / report.js 报告界面

---

2.1.1 - 2026-07-12

改进

• 默认 minQuantity: 1，所有新建元件自动开启低库存预警
• 从图纸导入改为并行查询立创，不阻塞流程
• BOM 入库列映射「名称」选项禁用，提示自动匹配
• BOM 出库优先按 C编号匹配
• 同 C编号行自动合并数量

---

2.1.0 - 2026-07-12

UI 改进

• 统计界面全面改版：环形图、库存健康条、百分比
• 新增总库存量、收藏数、低库存数统计卡片
• 来源分布 CSS 环形图（conic-gradient）

---

2.0.0 - 2026-07-12

重大改进

🏗️ 架构升级

• 从图纸导入改为并行查询立创，不阻塞
• 导入时自动用 C编号获取完整商品名、封装
• BOM入库支持仅 C编号即可，名称自动匹配
• 同 C编号行自动合并，数量累加

📥 BOM 导入增强

• 名称列不再强制要求，有 C编号即可导入
• 入库后自动用 C编号补全分类、封装、制造商、型号、描述
• 名称始终替换为立创商品名（如"薄膜电阻 10kΩ ±0.1% 100mW 编带"）
• 出库匹配优先按 C编号，再按名称
• 同 C编号数量自动合并，避免重复

📦 从图纸导入改进

• 并行查询立创，不阻塞导入流程
• 有 C编号的元件自动获取完整商品名
• 网络错误/超时自动跳过，用图纸原始数据

其他

• 适配 EDA 3.x API
• 修复全选复选框同步问题
• BOM 导入列映射「名称」选项禁用，提示自动匹配

---

1.2.2 - 2026-07-12

新增功能

🏷️ 智能分类建议

• 输入元件名称/型号时，自动根据关键词推荐分类
• 支持中英文关键词匹配（如"电阻"/"Ω"/"resistor"→电阻、"IC"/"STM"/"芯片"→IC芯片）
• 分类为空时自动填写，已手动选择则不覆盖
• 匹配规则覆盖常用元件类型

⚙️ 列显隐配置

• 搜索栏新增「⚙」按钮，可开关表格列的显示
• 支持显隐：型号、封装、分类、位置、来源、库存、C编号、添加时间
• 配置保存在 localStorage，持久化
• 名称、复选框、收藏、操作列始终显示

文档

• 功能规划输出到 ComponentManager_功能规划.txt

---

1.2.1 - 2026-07-12

新增功能

⚠️ 低库存预警

• 新增 minQuantity 字段，可在详情弹窗中设置最低库存阈值
• 库存 ≤ 最低库存时，表格行变黄标记，库存数字变红
• 一眼识别需要补货的元件

⭐ 收藏

• 新增 favorite 字段，点击表格中的 ☆/⭐ 切换收藏状态
• 搜索栏新增「⭐」按钮，点击只显示收藏的元件
• 收藏的元件 ☆ 变为 ⭐ 黄色星标

📝 批量编辑

• 表格每行新增复选框，表头支持全选/取消全选
• 选中元件后弹出批量操作条，支持：
  • 📂 批量修改分类
  • 📍 批量修改存放位置
  • 🗑️ 批量删除

🔍 搜索历史

• 按 Enter 搜索时自动保存关键词
• 搜索栏下方显示最近 8 条搜索历史，点击可快速搜索
• 支持清除搜索历史

📦 订单导入增强

• 导入订单时自动补全已有元件的 C编号、制造商、型号、封装
• 始终更新 C编号和制造商，其他字段仅补缺失

技术改进

• ComponentItem 接口新增 minQuantity、favorite 字段
• 使用 localStorage 持久化搜索历史

---

1.2.0 - 2026-07-12

新增功能

📦 导入立创商城订单

• 支持立创商城导出的 .xls / .xlsx 订单文件
• 自动解析"商品明细列表"，提取 C编号、品牌、厂家型号、封装、商品名称、订购数量
• 无需列映射，格式固定自动识别
• 已存在元件自动叠加数量，补充缺失的 C编号/制造商
• 依赖 SheetJS 动态加载解析 xls/xlsx

📤 BOM 出库

• 与 BOM 入库相同流程，但操作为扣减库存
• 按名称匹配元件，自动减数量
• 报告未找到/库存不足的元件清单

📥 BOM 入库改进

• 已存在元件改为叠加数量而非跳过
• 支持 .xlsx 格式文件（动态加载 SheetJS）
• 文件选择增加编码检测，避免中文乱码

UI/UX 改进

• 工具栏导入/出库/订单合并为下拉菜单，减少按钮数量
• 下拉菜单支持点击切换 + 点击外部关闭

技术改进

• 新增 loadSheetJS() 动态加载 SheetJS 库（CDN 按需加载）
• 订单 xls 解析器：定位"商品明细列表"标记，自动提取表头与数据行

---

1.1.1 - 2026-07-11

新增功能

📥 BOM 导入（CSV）

• 支持导入 CSV 格式的 BOM 文件（逗号/分号/制表符分隔）
• 自动识别分隔符，处理引号包裹的字段
• 自动列映射：根据常见的 BOM 列名（名称/型号/封装/位号/C编号/制造商/数量等）自动匹配到元件字段
• 手动调整映射：通过下拉菜单自由调整列对应关系
• 预览确认：显示前 10 行数据预览，确认无误后导入
• 智能去重：按元件名称查重，已存在的元件自动跳过并显示清单
• 位号（Designator）映射到元件的 parameters.designator 字段
• 导入结果显示成功/跳过数量及重复名称列表

技术改进

• 纯前端实现 CSV 解析（FileReader + 手写 CSV 解析器），零依赖
• 支持中英文多语种列名匹配（如 name/名称/Value/零件名称）

---

1.1.0 - 2026-07-11

新增功能

🆕 库存位置管理

• 新增 location 字段，记录元件存放位置（如货架编号、抽屉号等）
• 手动添加元件时，可在表单中填写「存放位置」
• 从立创商城搜索添加时，可在搜索框下方填写「存放位置」
• 元件详情弹窗中可查看和编辑「存放位置」
• 表格列表新增「位置」列，紫色标签显示

📊 按位置筛选

• 自动收集所有不重复的存放位置，生成可点击的筛选标签
• 支持多项选择筛选，点击切换选中状态
• 支持「清除筛选」按钮
• 搜索关键字也匹配位置名称
• 推荐放置面板搜索也支持按位置过滤

🔧 立创商城数据获取改进

• 修复 C编号 获取：使用 supplierId 字段（立创商城编号如 C100223）
• 修复分类获取：从 otherProperty.Type 提取分类名称（如"厚膜电阻"），无 Type 则从 otherProperty["LCSC Part Name"] 首段提取
• 新增制造商获取：manufacturer / property.manufacturer
• 封装从 footprintName 获取，后备 otherProperty["Supplier Footprint"]
• 符号/封装 UUID 从搜索结果的 symbolUuid/footprintUuid 及详情的 property.symbol.uuid/property.footprint.uuid 获取
• 所有字段增加类型安全处理（getStringValue 函数），避免对象值显示为 [object Object]
• 前后端（iframe UI 和 EDA 菜单对话框）同步更新

🖥️ UI/UX 改进

• 弹窗宽度 820 → 960px，适配更多数据列
• 最大化按钮改为全屏按钮
• 表格增加横向滚动条，列宽按百分比自适应
• 表格新增「C编号」列，立创商城编号可直接在列表查看
• 搜索结果展示分类名称

技术改进

• 后端 ComponentItem 和 NewComponentInfo 接口新增 location?: string 字段
• 后端 store.search() 方法支持搜索 location
• 前端所有 CRUD 操作均同步 location 字段
• 前后端数据模型保持一致

---

1.0.0 - 2025-01-XX

初始版本发布

新增功能

库存管理

• 表格形式展示所有已存储元件
• 实时统计总元件数和总库存数量
• 支持 +/- 按钮和直接输入调整元件数量
• 元件详情弹窗（型号、描述、封装、数据手册）
• 删除单个元件
• 一键清空所有元件

添加元件

• 🔍 立创商城关键词/型号搜索（通过 eda.lib_Device.search）
• 从搜索结果选择元件添加到个人库
• ✏️ 手动填写元件信息（型号、描述、封装、数据手册、库存）
• 数据持久化存储（eda.sys_Storage）

图纸导入

• 从当前原理图一键提取所有元件
• 从当前 PCB 一键提取所有元件
• 自动识别编辑器类型（sch/pcb）
• 智能去重（相同元件覆盖更新）

推荐放置

• 💡 从个人库选择元件放置到图纸
• 智能放置策略：
  • 有 symbolUuid：直接调用 eda.sch_PrimitiveComponent.add 放置
  • 无 symbolUuid：复制型号到剪贴板，引导用户在 EDA 面板搜索放置
• 弹窗展示所有元件，支持快速选择

UI/UX

• 响应式对话框（modal-large，max-height: 85vh）
• ESC / 点击背景 / 关闭按钮关闭弹窗
• 空状态提示
• 操作成功/失败反馈

菜单系统

• 原理图编辑器菜单：打开元件库、从当前图纸导入
• PCB 编辑器菜单：打开元件库、从当前 PCB 导入

技术实现

• 构建格式：IIFE + globalName: 'edaEsbuildExportName'
• 打包格式：.eext（zip 压缩包）
• 单文件入口、零运行时依赖
• 支持开发模式（npm run dev）和生产模式（npm run build）

文档

• 完整 README（功能说明、安装、使用流程、开发指南）
• 本 CHANGELOG

---

版本说明

符号	含义
🔍	搜索功能
✏️	编辑功能
📥	导入功能
💡	推荐/智能功能
📦	库存/数据管理
📊	统计/展示
🆕	新增功能
🔧	修复/改进
⚠️	破坏性变更

---