<p align="right"> <strong>简体中文</strong> | <a href="https://github.com/bluescola/jlceda-inventory/blob/main/CHANGELOG.en.md">English</a> </p>

更新日志

0.5.22 - 2026-07-29

• 将中英文 README 重写为面向普通用户的使用说明，按添加入库、库存管理、设计联动、BOM、项目采购和备份恢复说明每个实际入口、操作结果与关键限制。
• 简化中英文界面和公开说明中的开发者术语：用“浏览器版 / 安装在电脑上的客户端”说明运行环境，把整批写入规则、BOM 每列用途、撤销记录、备份格式、数据版本、设计需求记录和价格填写单位改写为普通用户可直接理解的操作结果。
• 把构建命令、目录结构、平台 API 边界和发布检查迁移到独立的中英文开发指南，主 README 不再混入版本验收流水和内部实现细节。
• 修复扩展广场无法打开相对 Markdown 链接的问题：除随包上传的 images/... 功能图外，语言切换、开发文档、贡献者和许可证统一使用可访问的 GitHub 绝对链接。
• 修正项目需求快照说明：当前只支持捕获活动原理图或 PCB，不再错误描述为可从外部文件创建快照；扩展清单描述同步补全订单、包装码、BOM、采购和备份能力。

0.5.21 - 2026-07-28

• 针对扩展广场上传阶段的“图片上传异常”继续收口：README 图片引用由 ./images/... 改为已上架扩展验证可用的 images/...，避免后端转存图片时错误解析相对路径。
• 功能浏览图精简为库存总览、BOM 映射和库存校验 3 张静态 PNG；其余功能继续保留文字说明，减少后端逐图上传与内容检测的失败面。
• 审核回归新增 README 图片路径约束，并将上传重试版本提升到 0.5.21。

0.5.20 - 2026-07-28

• 复核官方发布文档与已上架扩展的审核记录后，确认 images.banner 并非必填项，且可能因商店拉伸而被要求移除；本版本不配置独立横幅。
• README 恢复 6 张随包分发的核心功能截图，覆盖库存总览、新增器件、BOM 映射、库存校验、BOM 差异和采购建议，确保扩展详情页可以稳定展示功能预览。
• 排除带有示例订单号、项目 UUID、时间或批次指纹的 5 张截图，所有保留图片均为项目自有素材，不包含个人隐私信息；重新审核版本提升到 0.5.20。

0.5.19 - 2026-07-28

• 根据“上传的图片未通过审核”反馈进一步缩小图片审核范围：正式 .eext 只携带 extension.json 引用的原创 Logo，不再打包功能演示截图。
• 功能演示图继续保留在 GitHub 仓库，README 改用固定仓库地址展示，避免包含虚构订单号、批次码、UUID 和时间的截图作为扩展包上传图片参与扫描。
• 扩展审核测试同步锁定演示图排除规则和远程 README 图片地址，重新审核版本提升到 0.5.19。

0.5.18 - 2026-07-28

• 更换为本项目原创的元器件库存柜 Logo，以更明确地区分 SDK 默认图标；正式 PNG 调整为 1024×1024、1:1、不透明背景，文件大小保持在审核限制内。
• 审核包不再携带仅供仓库维护的 SVG Logo 源稿，只保留 extension.json 实际引用的 PNG 成品；补充图标版权与许可说明。
• 复核扩展清单必填属性、分类、入口、README、CHANGELOG 和隐私边界，并将重新审核版本提升到 0.5.18。

0.5.17 - 2026-07-26

• 移除库存总览中未绑定记录的“重新匹配 EDA 模型”入口，以及对应的 retry-model、attach-model、候选确认令牌、模糊搜索适配器和专用服务写入方法，旧协议请求现在会被明确拒绝。
• 将 F4 收口为受当前嘉立创 EDA 宿主公开能力与库存身份一致性边界限制而不实现的能力，不再列为未完成或待手测项；新增库存和完整编辑 C 编号时的既有精确模型查询保持不变。
• 同步中英文说明、架构边界、调研状态与手动测试指南，并增加旧入口和旧协议均不可再出现的自动化回归。

0.5.16 - 2026-07-24

• 修复嘉立创 EDA 扩展沙箱未提供全局 structuredClone 时，“项目需求与采购”点击“捕获当前设计”立即失败的问题。项目规划 IFrame 的 intent 在完成结构校验后改用 JSON 安全深拷贝，不再依赖该浏览器全局。
• 补充宿主缺少 structuredClone 时的项目规划协议回归，并验证采购 intent 中的快照 ID 数组与桥接原对象相互隔离。0.5.15 详细日志中的两次首次捕获均在读取 SCH 前失败，库存保持 revision 107、需求快照和采购记录均为 0；0.5.16 修复后续 F8 全流程实机测试已经通过，旧阻塞已关闭。
• 修复替代料临时总览选中元器件后只调用 IFrame 关闭接口、没有通知原生会话完成，导致流程持续等待直至被新窗口替换的问题。选择成功后现在写入携带操作 ID 的 completed 终态，由宿主统一清理桥接并关闭窗口。
• 已确认替代料候选现在排在“新增已确认替代料关系”之前，避免复核现有关系时默认进入新增分支；补充终态解析、无标题栏回调收口、桥接清理和候选顺序回归。0.5.16 实机复测已完成关系建立、人工候选、设计校验、BOM 不足预检、删除/合并保护及关系删除，最终 B/S 数量保持 1/6、批次/流水保持 3/12、替代关系为 0，F9-B 验收通过。
• 修复嘉立创 EDA 原生沙箱缺少全局 URL 时，合法数据手册、采购商品链接、备份恢复校验和 file: 备份目录解析失败的问题；HTTP(S) 与文件 URI 改用随扩展打包的解析器，并补充无 URL 宿主回归。
• 0.5.16 详细日志版完成 P0 目录 URI、含数据手册 URL 的恢复预览、客户端重启、路径消失和运行时权限不足专项：重启后原自动备份配置仍可立即试写，库存更新从 revision 121 推进到 122；备份目录离线时，主库存继续成功推进到 revision 123，后台两次写入均被宿主拒绝且旧固定 JSON 保持完整；关闭外部交互权限时，主库存同样推进到 revision 124，备份以 write-failed 重试两次后明确失败。目录与权限恢复后试写和普通保存均恢复；随后临时条目的新增、收藏、完整编辑和删除依次推进到 revision 126/127/128/129，四次后台备份均一次成功。单行订单导入以新增 0、合并 1 写入 revision 130 并一次备份成功，恢复测试前基线后又一次备份 revision 131；最终固定 JSON 与手动导出 Hash 一致，临时订单数据已清除。P0.2 列出的写操作已有实机备份证据；随后损坏 JSON、未来 schema 和负数量字段三类无效备份均在替换预览前被拒绝，库存与固定备份继续保持 revision 131 且 Hash 一致。Web 端也已完成降级实测：固定目录被宿主以非客户端环境明确拒绝，手动另存可用；Web 与桌面主库存不会自动共享，Web 初始为空的 revision 0，但可通过桌面 JSON 完整恢复为 revision 1，除新 revision 与更新时间外全部内容一致。重开桌面后仍为 revision 131，固定备份 Hash 未变。至此 P0 非破坏性宿主专项全部通过；破坏性磁盘与主存储故障只保留自动化注入结论，双设备传播、冲突与容量行为继续作为 P1 单独验证。

0.5.15 - 2026-07-24

• 将跨控制器库存快照同步改为纯数据更新：新增、包装码合并等后台写入只替换总览中的库存与分类数据，不再清空搜索、重置筛选或设计选择、跳转页码、滚动或高亮记录。
• 从快照更新协议中移除 focusItemId 导航提示，明确区分“后台数据同步”和“用户主动定位”。F3 等显式定位命令仍可建立新的选择范围并改变视图，普通库存写入无权移动用户当前页面。
• 根据 0.5.14 实机日志确认跨实例快照已成功推送且无需手动刷新，同时记录其无条件清空 C559387 搜索的交互问题；补充协议、活动会话、跨实例和视图状态保持回归。0.5.15 实机复测确认包装码合并与独立自定义新增均能跨实例自动更新，无需手动刷新或重开总览，并保持用户原有搜索和页面位置。
• 修复 BOM 整批出库和批次撤销只写入持久化库存、未同步已打开库存总览的问题；每次成功提交或撤销后复用相同的数据型快照推送，数量立即原位更新，同时保留搜索、筛选、排序、页码和滚动位置。0.5.15 详细日志版复测确认出库 revision 106 与撤销 revision 107 均在写入同一秒跨实例推送成功，全程没有手动刷新，最终库存和正反流水闭环正确。

0.5.14 - 2026-07-24

• 修复从独立菜单新增元器件后，已打开或最小化的库存总览仍显示旧快照的问题。新增命令现在通过宿主桥接中的活动 requestId 向既有总览推送最新库存，不再依赖只在单个控制器实例内可见的 activeSession。
• 新增保存成功后会解除旧的 F3 设计选择范围并定位新记录；旧总览处理后续查看、编辑或模型匹配操作前重新读取最新库存，避免已显示的新记录因旧条目集合或旧 revision 无法操作。
• 根据 0.5.13 详细日志记录首次修复失败：库存已成功保存到 revision 90、共 86 条，但推送被错误记为 snapshot-update.skipped/inactive。补充跨控制器实例、主动快照和外部新增记录操作回归，使用 0.5.14 重新实测。

0.5.13 - 2026-07-24

• 修复 F3 多选部分匹配时未匹配信息过于隐蔽的问题：总览在表格上方新增独占的警告区域，明确列出未匹配器件的位号与 C 编号、厂家型号或名称，并说明已显示的匹配库存数量。
• 未匹配器件摘要随 designSelection 通过既有 IFrame 协议传递，限制条目数量和文本长度并执行结构校验与深拷贝；全部匹配或点击“清除筛选”时不显示警告，不增加原生确认弹窗。
• 根据详细日志记录实机结论：0.5.12 选择 4 个器件时正确识别 3 条匹配库存和 1 个未匹配器件，但原灰色摘要的提示可见性不合格；0.5.13 以相同 4/3/1 分支确认独立警告可见、总览正常就绪且库存 revision 86 不变，F3 验收完成。此前 revision 85/86 分别对应用户显式新增分类和新增物料，确认 F3 匹配本身没有自动写库存。

0.5.12 - 2026-07-24

• 将“定位选中元器件库存”的多选流程从原生单选器改为完整选择集匹配：一次显示所有命中的库存记录，同一库存按 item.id 去重，同一器件命中多条库存时也不再强制选择一条。
• 库存总览新增图纸选择范围摘要，显示选中器件数、匹配库存数和未匹配数；范围可继续叠加搜索与分类筛选，点击“清除筛选”恢复完整库存。总览仍可见、最小化或隐藏时再次执行定位，会用新选择集替换旧会话内容；范围内记录全部消失时保持零结果，不会意外显示完整库存。单个器件完全未匹配时保留预填新增，多个器件全部未匹配时只明确提示，不擅自选择一个新增。
• 诊断日志补充选择、匹配与未匹配计数，新增多选、共享库存去重、重复库存、部分/全部未匹配、协议和清除范围回归；同步 F3 手测方法并记录 0.5.11 旧链路的实测结果。

0.5.11 - 2026-07-24

• 修复拖动库存总览原生标题栏时窗口被误隐藏的问题：移除用 IFrame blur 与 EDA 主窗口 focus 推断“点击画布”的链路。公开 API 不提供窗口移动事件或焦点目标，移动标题栏与点击画布无法可靠区分。
• 总览显隐改为只响应明确操作：移动窗口、点击 EDA 画布或切换应用不再隐式隐藏；原生折叠、恢复和最大化继续可用，“放置”仍会主动隐藏，失败时恢复，显式关闭才结束会话。
• 删除窗口控制桥接和相关时间窗判定，清理旧桥接键，并补充代码边界回归与 W0 移动窗口实机步骤。

0.5.10 - 2026-07-24

• 修复库存总览点击原生最小化后整个窗口消失的问题：将宿主 minimizeStyle 从会把折叠宽度设为 0 的 constricted 改为 collapsed，最小化后保留原宽标题栏，可直接恢复。
• 原生折叠、恢复或最大化造成 IFrame 尺寸变化和失焦时，不再误调用 hideIFrame；正常点击 EDA 画布仍会自动隐藏总览，再次从菜单打开时继续保留浏览状态。
• 补货清单导出不再根据宿主 saveFile() 的提前 resolve 显示误导性的成功窗口，也不为取消保存追加提示；宿主明确返回失败时仍显示导出失败，最终结果以文件是否实际落盘为准。
• 补充最小化模式和缩放失焦回归测试，并同步 README、窗口边界与独立 W0 手动测试方法。

0.5.9 - 2026-07-23

• 按操作频率和信息重要度重排库存总览的默认业务列：名称、操作、编号、库存、封装、EDA 模型、仓位、分类、补货状态、最低库存、更新时间；最左侧选择复选框继续作为固定控制列，不计入业务列序。
• 将放置、查看、编辑等高频操作从表格末尾移到名称之后，并把直接影响放置的 EDA 模型状态前移到封装之后；低频纯显示字段统一后置。
• 同步表头、数据行、显示列设置、拖拽区域、边界说明和手动测试步骤，并新增默认设置及表头/数据行顺序回归测试。

0.5.8 - 2026-07-23

• 将“从库存放置元器件”的原生单选列表替换为现有库存总览，直接复用搜索、两级分类、库存/模型筛选、排序和分页；有库存且模型可用的行在操作列首位提供“放置”。
• 放置请求只携带库存 ID 和 revision，宿主重新读取最新记录并校验库存状态、模型引用与当前原理图上下文后才调用官方鼠标放置 API；成功后主动隐藏总览且不抢回焦点，失败则恢复总览并显示原因。
• 新增放置适配器、总览协议和控制器回归测试，明确绑定鼠标不代表完成画布放置，因此仍不自动扣减库存；同步新增独立的 0.5.8 手动测试项。

0.5.7 - 2026-07-23

• 修复 0.5.6 启用正确原理图上下文后，原先只注册在首页的 P0 备份恢复及其他通用库存命令从原理图菜单消失的问题。
• 首页、原理图和 PCB 现在共享库存管理、BOM、备份恢复和诊断入口；原理图与 PCB 继续额外保留当前设计校验、选中器件定位等页面专属命令。

0.5.6 - 2026-07-23

• 修复嘉立创 EDA 3.2.166 在原理图中仍显示首页菜单、导致“校验当前设计库存”等原理图命令缺失的问题；扩展清单从官方已弃用的 sch 上下文迁移到当前 schematic 上下文。
• 首页、原理图和 PCB 使用不同的顶级菜单 ID，避免宿主跨页面覆盖同名菜单；清单契约测试和手动测试说明同步锁定当前上下文与命令范围，业务调用和库存数据不变。

0.5.5 - 2026-07-23

• 修复自动备份停用期间发生库存保存后，已完成的队列 Promise 残留并导致重新启用后的普通保存与恢复不再刷新固定 JSON；队列启动改为延迟到状态引用建立后执行，并增加“停用保存 -> 重新启用 -> 恢复”的组合回归测试。
• 对宿主临时拒绝或文件写入异常增加一次 150 ms 延迟重试，兼容读取固定备份后立即覆盖同一路径的短暂文件占用；永久失败仍只告警，不回滚已经成功的 EDA 主库存写入。
• 正式包和诊断包均记录自动备份的 status、revision、attempts 与失败分类，恢复成功日志记录相同 revision；路径和库存内容不进入日志，便于直接判断恢复后的最新快照是否同步。
• 桌面端 P0 指定用例已通过：外部文件与恢复前快照恢复后均刷新固定备份，停用后重新启用的两次普通保存连续同步到 revision 60/61，最终固定 JSON 与当前库存导出字节一致；客户端重启、完整写操作与故障注入、Web 和跨设备矩阵仍需专项验证。

0.5.4 - 2026-07-23

• 将手动保存菜单从“导出库存备份”重命名为“另存库存备份”，明确它会打开系统保存对话框创建独立快照，不会复用或覆盖自动备份设置中的固定路径。
• 同步中英文菜单、保存状态文案、README 和手动测试步骤；自动备份目录选择、固定最新快照及恢复逻辑不变。

0.5.3 - 2026-07-23

• 根据 0.5.2 详细日志确认原生目录选择器在 16 ms 内失败的根因：嘉立创 EDA 3.2.166 会在扩展沙箱中禁用全局 fetch()，导致请求从未到达客户端。目录选择改由公开 SYS_ClientUrl.request() 发起，并继续沿用客户端自身的 openDir 请求参数。
• 保留公开桌面端与外部交互权限校验，目录选择成功后仍先试写固定 JSON 再启用；关闭其他文件选择或保存窗口后可重试，取消选择不会修改原设置。
• 诊断日志新增请求、HTTP 响应、响应体和宿主结果分阶段分类，并增加生产适配器必须经过 SYS_ClientUrl 的回归测试，防止再次调用沙箱禁用的全局网络接口。

0.5.2 - 2026-07-23

• 根据 0.5.1 实机诊断日志修复自动备份仍在默认目录解析阶段失败的问题；首次设置改为直接打开嘉立创 EDA 原生目录选择器，用户选定目录后自动创建 jlceda-inventory-latest.json，不再要求填写路径或手建 JSON。
• 选择器取消时不修改设置且不提示错误；已有路径可继续使用或通过“选择备份目录”迁移。固定 JSON 试写成功后才保存启用状态，选择、权限或写入失败均不会留下半启用配置。
• 继续使用公开文件 API 校验桌面端和“允许外部交互”权限，仅在校验成功后调用客户端目录选择链路；区分取消、权限失败、宿主异常和畸形响应，并补充脱敏诊断日志与回归测试。

0.5.1 - 2026-07-22

• 修复嘉立创 EDA 专业版 3.2.166 中 getDocumentsPath() 因客户端配置响应结构不一致返回空字符串、导致首次自动备份被误报为未授予外部交互权限的问题；在官方权限检查成功后，从同一客户端配置调用链读取实际文档目录。
• 兼容 createDirectoryInFileSystem() 的 folderPath/path 参数错配，官方接口返回 false 时通过受权限门控的客户端调用链重试；继续拒绝空路径、相对路径、控制字符和畸形文件 URI，并把合法 file: URI 转换为文件 API 所需的本机路径。
• 区分宿主 API/权限不可用与宿主目录格式异常，正式日志也记录脱敏后的路径类型、长度和失败阶段；补充默认目录回退、URI 转换、目录拒绝和错误分类回归测试。

0.5.0 - 2026-07-22

• 新增当前 SCH/PCB 与外部 BOM 库存校验、板数倍率、缺料筛选和 CSV 导出；支持通用 CSV/TXT/XLS/XLSX 表头识别、工作表与列映射、BOM 版本差异及差异导出，文本 BOM 可识别 UTF-8、UTF-16 和 GB18030。BOM 单文件上限为 10 MiB，库存校验/出库只接受 1 个文件，版本差异只接受 2 个；工作簿限制为 32 个工作表、每表 128 列和 10,000 行数据。
• 新增逐条最低库存、补货视图与导出、收藏、列显隐、数据手册链接和结构化仓位；包装码入库保留原文与解析预览，选中图纸器件可精确定位并高亮库存记录，模型失效时可搜索候选并人工确认。
• 新增“BOM 出库批次与撤销流水”，包含显式整批出库、语义重复识别、新生产批次确认、原子扣减和整批撤销；活动批次引用的条目禁止删除或合并，流水明确只覆盖 BOM 出库与撤销，不冒充完整库存审计。
• 新增项目需求快照、重同步差异确认、板数需求聚合、采购建议、采购记录、成本汇总与 CSV 导出；采购日期按 YYYY-MM-DD 保存并兼容读取旧时间戳。替代料关系仅由用户在现有库存间确认，并只用于人工候选排序，不参与自动匹配或扣减。当前同一物理板的 SCH/PCB 两份快照仍会重复累计，需用户避免同时保留。
• 库存文档升级到 schema-v9，加入项目、采购、BOM 流水与替代关系数据；桌面端首次设置自动备份时无需输入路径，插件直接在系统“文档”目录下自动建目录并生成固定“最新快照”JSON，试写成功后启用。恢复前执行严格校验与恢复点保护；自动备份或通知失败不会把已经提交的主库存操作误报为失败。
• 新增跨模块容量预算、文档 revision CAS、操作型 IFrame 原生关闭竞态保护及覆盖关键业务规则的自动化回归；订单导入一次最多选择 100 个文件、单文件上限 10 MiB。嘉立创 EDA BETA API、Web/桌面文件系统差异和跨运行实例并发仍需实机验证。

0.4.16 - 2026-07-22

• 将订单防重复与库存更新方式拆成两层文案：明确提示“已导入过的订单不可重复添加”，并用“采购入库”“重置数量”“只新增物料”三个带数量结果的选项说明本次导入如何更新已有库存。

0.4.15 - 2026-07-22

• 重写订单导入的库存匹配设置文案，明确该选项只决定“订单物料匹配到现有库存时”如何改变数量，并将三个选项改为累加订单数量、用订单数量覆盖库存和保持库存不变，避免被误解为相同订单或相同文件的处理方式。

0.4.14 - 2026-07-22

• 修复删除库存后原订单仍被历史文件指纹拦截的问题：订单去重历史现在关联实际库存记录；关联记录被删除或改成其他物料后，对应文件可以重新导入。
• 部分删除一个订单的库存时，只恢复缺失物料，仍存在的物料计为跳过，不会再次累加数量；多个订单曾合并到同一库存记录时，各订单仍可分别恢复自己的数量。
• 库存文档升级为 schema-v5，仅在批次摘要中保存规范化物料身份键和库存 ID 关联，不保存 Excel 行、订单抬头或收件信息；旧 schema-v4 历史在库存缺失时按当前物料状态兼容恢复。

0.4.13 - 2026-07-22

• 库存总览新增“删除所选”：可先全选当前筛选结果，再经不可撤销二次确认批量删除；服务端一次校验全部条目 revision 并原子保存，任一记录过期时整批不删除。
• 自动隐藏重新要求 IFrame 失焦与 EDA 主窗口聚焦配对；切换到 VS Code 等外部应用时保留库存总览，只有焦点确实返回 EDA 主窗口才隐藏。
• 修复复制到个人库被官方接口拒绝后，总览操作仍误报成功的问题；失败现在返回准确状态和原因，并以 warn 级别写入诊断日志。

0.4.12 - 2026-07-22

• 修复库存总览正常 ready 后马上自动消失的问题：移除启动期同步 autofocus，在页面显示 300 ms、EDA 宿主完成焦点收敛后再聚焦搜索框并启用自动隐藏，启动期 blur 不再被当作用户点击主窗口。
• 保留首次稳定聚焦后的直接点击 EDA 自动隐藏，以及原生最小化窗口控制、活动操作保护和旧会话替代逻辑。

0.4.11 - 2026-07-22

• 修复导入或切换插件版本后，旧库存总览轮询继续存活并弹出 Cannot read properties of undefined (reading 'inventory-overview-panel.v2.result') 的问题。旧会话检测到新的 requestId 后立即结束，不再在后台累积。
• 已 ready 的总览如果遇到 EDA 扩展存储上下文被卸载，按宿主会话终止静默收尾，不再显示与用户操作无关的通用错误框。

0.4.10 - 2026-07-22

• 修复首次打开库存总览后不操作内部控件、直接点击 EDA 主窗口时无法自动隐藏的问题：总览 ready 前显式建立 IFrame 与搜索框焦点，确保第一次外部点击也会产生可靠的失焦事件。
• 保持 0.4.9 已验证的分类管理、详情、确认弹层隐藏规则和实际操作保护；相关性排序规则本轮不再调整，留待单独确认。

0.4.9 - 2026-07-22

• 修复库存总览偶发 Inventory overview panel unavailable: render-failed：当插件控制器已经重建但 EDA 仍保留旧的隐藏 IFrame 时，先隐藏并关闭失去控制器的旧会话，再创建新会话，避免新请求在旧页面中等待 ready 超时；旧会话只能按 requestId 清理自己的 bridge 数据和窗口，不会在稍后超时时破坏新会话。同一控制器内仍直接恢复原窗口和全部浏览状态。
• 自动隐藏改为直接监听总览 IFrame 失焦并检查页面可见性，不再依赖不稳定的“失焦/主窗口聚焦”事件配对；分类管理、详情和确认弹层可以随总览隐藏，只有正在执行的导入或写入操作会阻止隐藏。
• 原生最小化改用 constricted 缩窄标题窗；用户点击最小化、恢复或最大化时，宿主窗口控制通知会阻止该次失焦触发自动隐藏，确保小标题窗保留并可直接恢复。
• 修正空搜索“相关性”的语义：在“全部”中按库存状态和全局名称排序，不再把刚查看的二级分类整组排在列表开头；分类分组只由显式“分类顺序”排序控制。
• 为库存总览补充静默诊断跟踪，记录遗留会话处理、请求写入、IFrame 打开、渲染阶段、恢复显示、显式渲染错误和 ready 超时；不会因为正常打开总览而自动弹出日志面板。

0.4.8 - 2026-07-22

• 库存总览允许点击 EDA 主窗口后自动隐藏；只调用固定库存总览 IFrame 的隐藏接口，不修改菜单栏或宿主窗口。再次使用原“库存总览”入口会恢复同一会话。
• 自动隐藏只接受紧邻 IFrame 失焦的 EDA 主窗口聚焦事件；拖拽、分类管理、详情/确认窗口和进行中的操作会阻止隐藏，避免文件选择器或子流程误触发。
• 修复从二级分类返回“全部”时可能沿用旧排序状态的问题：分类、当前排序方式和第一页现在原子切换，并对完整结果集重新排序。

0.4.7 - 2026-07-22

• 分类导入忽略 EDA 返回的虚拟 ALL 根分类；当 ALL 包含实际分类或出现在器件分类路径开头时，提升并保留后续真实的一、二级分类。
• 统一分类导入语义与文案：同级同名分类按现有行为合并，只新增缺少的分类，不再描述为“跳过”。
• 明确复制到官方 EDA 个人库依赖仍被官方标为 BETA、且不建议正式使用的 LIB_Device.copy()；插件继续以目标库回读验证为成功条件，无法核验时只报告失败。
• 简化诊断日志保留个人库复制的失败原因和非敏感阶段状态，后续可区分官方接口拒绝、API 异常和复制后回读验证失败。

0.4.6 - 2026-07-22

• 修复个人库导入的 already-present 假成功：C 编号查询结果必须属于嘉立创 EDA 当前工作区个人库并可按 UUID 回读；新复制还必须核对目标库、复制 UUID 和 C 编号或器件身份，任何不一致都不再报告成功。
• 库存详情改为完整字段视图，显式显示并支持复制立创 C 编号；历史记录可从合法的供应商 C 编号回退。库存封装和 EDA 模型封装分别显示，两者都不存在时显示“—”。
• 修复勾选或取消多个元器件后表格跳回顶部的问题，保持当前横向和纵向滚动位置；筛选、切换分类和翻页仍按新结果正常重置。
• 将“导入 EDA 分类”的唯一可见入口放入库存总览的“管理分类”子窗口；导入后保持窗口打开、刷新分类并显示新增、跳过或降级结果，不修改 EDA 顶栏菜单。
• 库存总览启用嘉立创 EDA 原生最小化按钮，临时操作 EDA 主窗口时不销毁当前总览会话；继续保持不自动弹出插件窗口。

0.4.5 - 2026-07-21

• 撤销未经需求确认新增的顶部“库存总览”直达入口和额外编辑上下文，严格恢复为首页、原理图和 PCB 中各一个“元器件库存”分组菜单，修复勾选“显示在顶部菜单”后扩展菜单消失的问题。
• 将 headerMenus 逐项恢复为 0.4.3 的原菜单清单；“导入 EDA 分类”不再挂到 EDA 顶栏，入口位置需确认后再提供。
• 新增清单回归测试，逐项锁定既有三个上下文和原分组菜单，避免未确认的入口再次影响宿主菜单。

0.4.4 - 2026-07-21

• 修复库存总览拖拽入口过小的问题：表格行非交互区域现在可直接拖动，拖动已勾选行会批量移动全部勾选项，拖动期间展开所有二级目标；分类侧栏明确区分系统分类与用户分类。
• 在总览表格和详情中突出显示库存封装，并在库存封装为空时显示 EDA 模型封装，详情同时保留两者以便核对和分类。
• 新增“导入 EDA 分类”，可幂等导入个人库或收藏库的两级分类且不自动移动库存条目；完整分类树不可用时降级汇总器件已经使用的分类并明确提示限制。
• 个人库复制不再回退写入收藏库；复制返回 UUID 后必须从个人库回读验证，避免“显示已导入但库内找不到”的误报。
• 在 EDA 支持的各编辑上下文增加顶部“库存总览”直达入口；用户仍需在扩展管理器中启用扩展并勾选“显示在顶部菜单”。

0.4.3 - 2026-07-21

• 二级分类展开后使用克制的差异底色；器件分类拖动改为 Pointer Events 与 document 级回退监听，不再依赖 EDA 内嵌浏览器不稳定的 HTML5 拖放或指针捕获。
• 批量移动分类改为横向独立的一级、二级选择框，并新增“全选当前筛选结果”和“清除选择”；可先筛选未分类、封装、制造商或关键词，再一次完成批量归类，不自动猜测分类。
• 订单导入改为单个多字段窗口：一次设置默认库存状态和重复策略，在同一窗口完成逐文件预览，并显示解析、EDA 模型匹配和库存写入进度。
• 订单模型匹配按规范化 C 编号去重并限制为 4 个并发查询，进度写入诊断日志时节流；预览失败可重试，同一预览不能并发或重复提交。
• 修正库存备份和诊断日志导出的提示时序：遵循官方 saveFile(): Promise<void> 契约，由系统保存对话框处理目的地，不再在用户选择路径前弹出无法验证的保存结果。

0.4.2 - 2026-07-21

• 分类管理支持双击分类块原位重命名、同级拖拽排序和横向自动换行；库存总览的一级分类默认预览三个二级分类，并可展开其余分类。
• 元器件名称旁新增拖动手柄和包含名称、编号、数量、当前分类及存放位置的拖动卡片；拖到左侧未分类、一级分类或二级分类即可直接修改分类。
• 打开对应 C 编号的立创商城页面后，在添加表单中记录可取消的商城核对状态；保存时通过宿主会话校验并写入 user-confirmed 商城引用，无 EDA 模型的确认商品记为商城来源。

0.4.1 - 2026-07-21

• 修复器件已经位于个人库或收藏库时被误报为复制失败的问题；现在按成功处理，不再重复复制。
• 改为优先复制到官方明确提供的当前工作区个人库；个人库不可写或拒绝复制时，再尽力尝试收藏库，并确保任一库 UUID 查询异常都不会阻断另一个目标。
• 按立创 C 编号检查目标库中是否已有器件，避免重复导入；复制失败时区分无目标库、官方接口拒绝和 API 异常，并将不含器件隐私的逐步结果写入诊断日志。

0.4.0 - 2026-07-21

• 将库存总览升级为常驻长会话窗口；详情、完整编辑、删除确认、重复项比对和 EDA 模型重匹配均在总览内部的上层模态完成，操作后局部刷新快照并保留搜索、筛选、分页、滚动和选择状态。
• 分类管理改为同窗口双栏结构，左侧维护一级分类、右侧维护当前一级分类下的二级分类，支持新增、重命名、同级排序和删除确认。
• “按立创 C 编号添加”与“添加自定义元器件”统一为一次性多字段表单，集中录入身份、数量类型、分类、存放位置和备注；不再串联多个原生单字段弹窗。
• EDA 查询结果、重复检测和最终合并均使用宿主签发的一次性令牌及 revision 校验；C 编号变化会废弃旧模型结果，首次发现重复记录时不写库存。
• 商城按钮只在当前 C 编号的 EDA 查询未命中或失败后启用；打开商城仅用于人工核对，不会冒充已经自动读取或确认商城数据。
• 订单导入支持一次选择多个 Excel/CSV/JSON 文件；写入前按文件预览订单号、明细数量、重复原因和预计新增/合并/跳过结果。
• 库存文档升级为 schema-v4，原子记录订单导入批次，并使用订单号与 SHA-256 文件指纹阻止历史重复和同批次重复；v1/v2/v3 文档无损迁移。

0.3.5 - 2026-07-21

• 将库存浏览与搜索升级为完整分类总览：顶部主搜索框、两级用户分类、库存与模型状态筛选、排序、分页、响应式分类侧栏和批量移动分类集中在同一界面；搜索不再作为菜单项或虚拟元器件。
• 库存文档升级为 schema-v3，旧数据无损迁移到“未分类”；支持分类新建、重命名、排序和删除，删除分类只将所属条目移回“未分类”。
• 增强总览排序下拉框的宿主事件兼容，分类排序改为遵循用户维护的分类顺序；搜索框清空时自动解除已应用搜索。
• 订单导入支持立创商城直接导出的 .xls/.xlsx：自动查找订单详情表头、识别带单位的订购数量、跳过不发货条目，并避免隐藏空白模板工作表造成重复导入；CSV/JSON 继续兼容。

0.3.4 - 2026-07-21

• 完整编辑中勾选“已用完”再取消时，恢复勾选前显示的数量和数量类型；所有切换均保留在表单草稿中，只有保存后才更新库存记录。
• 存放位置字段新增“选择已有位置”按钮，从当前库存记录中提供去重后的已有位置，同时仍支持手动输入新位置。

0.3.3 - 2026-07-21

• 扩展清单改为中文默认文本，中文环境即使语言资源缓存未刷新，也会优先显示“元器件库存”和“关于库存扩展”；英文清单提供完整对应翻译。
• 激活时以及每次执行插件命令前读取嘉立创 EDA 当前语言，支持 EDA 在中文和英文之间切换后同步更新插件弹窗、字段、状态和提示文本。

0.3.2 - 2026-07-21

• 将“库存优先推荐”作为“搜索库存”合并到库存总览，搜索结果可直接进入详情、编辑和删除流程；精确匹配优先于部分匹配，同等匹配时有库存优先，空关键词明确显示包括已用完记录在内的全部库存。

0.3.1 - 2026-07-21

• 修复升级后宿主沿用旧语言资源时，新菜单、库存详情和编辑表单显示英文或直接显示翻译键的问题；启动时使用官方多语言 API 注册随包的中英文词条，并保留本地回退。
• 补充遗漏的“供应商编号”字段翻译，新增实际窗口标题、字段标签、商城状态、EDA 状态和记录来源的中文传输测试。
• 时间统一显示为不含英文月份的数字格式，并移除库存 IFrame 加载与连接失败阶段的硬编码英文。

0.3.0 - 2026-07-21

• 新增独立的库存详情与完整编辑 IFrame：详情只读展示全部用户字段和系统状态，并可直接进入同一套完整编辑表单。
• 集中编辑名称、C 编号、供应商编号、制造商、厂家型号、封装、描述、数量、准确/估算、已用完、仓位和备注；数量必填，负数/小数阻止提交，0 自动标记已用完。
• C 编号变化后重新查询 EDA 系统库；命中时显示可逐字段采用的模型建议，未命中时保留用户输入，不强制覆盖。
• 编辑身份与已有记录重复时并列展示双方详情，确认后原子合并数量；未确认不写入，并使用双方 revision 防止覆盖并发修改。
• 删除前重新读取最新记录，并显示名称、编号和库存数量进行不可撤销确认。

0.2.9 - 2026-07-20

• 统一清理表单、手工添加、订单导入和 EDA 模型展示字段中的不可见 Unicode 格式字符与不安全控制字符，避免封装、编号和数量解析或匹配异常。
• 保留换行、制表符以及多语言字形所需的 ZWNJ/ZWJ，不破坏描述排版和国际化文本。
• 读取现有 schema-v2 库存时自动清洗历史数据，同时保持 ID、数量、版本和时间戳不变；后续导出和保存将使用清洗后的内容。

0.2.8 - 2026-07-20

• 将多字段表单的 HTML、CSS 和 JavaScript 合并为单个自包含 IFrame 资源，避免宿主只加载入口 HTML 时出现空白窗口。
• 增加脚本运行前可见的加载状态和顶层初始化错误提示，任何阶段均不再无内容显示。
• 将临时桥接协议升级到 v2，并增加脚本启动、请求读取、表单渲染及失败原因诊断；就绪超时从窗口打开成功后开始计算。

0.2.7 - 2026-07-20

• 修复 IFrame 窗口 ID 包含宿主禁止的 .，导致多字段表单在加载前被拒绝的问题。
• 将窗口 ID 改为仅含字母和连字符的 jlceda-inventory-product-details。

0.2.6 - 2026-07-20

• 为 openIFrame() 增加调用前、布尔返回值和原始异常诊断，区分宿主返回 false 与抛出错误。
• 记录静态路径、窗口 ID、尺寸、错误名称和阶段，同时继续排除商品编号、表单内容、标题与请求 ID。
• 正式版简化日志同样保留打开阶段的关键元数据。

0.2.5 - 2026-07-20

• 使用官方 IFrame、扩展存储和定时器接口替换无法输入的 React 多字段表单。
• 商品名称、制造商、厂家型号、封装和描述现在可在同一浏览器表单内一次填写，并完整预填已有值。
• 增加会话隔离、标题栏关闭竞态保护、临时数据清理和 IFrame 生命周期诊断；启动失败时仍回退到原生分步输入。

0.2.4 - 2026-07-20

• 将 React 商品表单调整为官方最小 Modal -> Dialog 结构，移除可能拦截输入焦点的双层遮罩配置。
• 为字段首次点击、变更和失焦增加不含输入内容的诊断事件，区分焦点问题与事件回传问题。
• 为输入控件补充稳定的字段名称，并增加单层弹窗结构测试。

0.2.3 - 2026-07-20

• 恢复「React 多字段表单为主、原生分步输入为回退」组合。
• 抽出可单测的商品信息会话逻辑，补齐完整输入→提交路径测试，并验证诊断不记录字段内容。
• 为字段变更与提交增加仅含字段名/长度的诊断事件；发行版简化日志同样保留这些元数据。
• 调整组件化表单布局与 overlay，降低输入框无法聚焦的风险；onChange/onBlur 均写入会话。

0.2.2 - 2026-07-20

• 修复商城商品信息录入：当前 V3 宿主上组件化多字段表单的输入框无法键入文字，改为使用已验证可用的原生分步输入（名称、制造商、封装等）。

0.2.1 - 2026-07-20

• 修复连续原生输入框可能在前一个弹窗尚未销毁时被宿主忽略的问题。
• 添加可查看、持久化和导出的 C 编号添加诊断日志；诊断包记录完整步骤，发行包保留简化日志。
• 保存完成后显示实际写入库存的元器件字段和明确的成功反馈。
• 为商城回退增加一次性多字段商品信息表单；组件化 API 不可用时自动降级到原生分步输入，并写入同一条诊断链路。

0.2.0 - 2026-07-20

• 将立创商城商品凭据与可选的嘉立创 EDA 器件模型引用拆分为独立状态。
• 添加 C 编号元器件时先查询 EDA 系统器件库；仅在模型未命中或查询失败时打开立创商城，让用户确认或修正商品信息。
• 商城回退录入字段与 EDA 器件属性名称对齐，并明确区分商城商品封装与 EDA 模型封装。
• 允许没有 EDA 模型的商城商品继续用于库存管理和库存优先推荐。
• 在库存列表和详情中分别显示商城信息状态与 EDA 模型状态。
• 为现有库存记录增加商城导航与可重试的 EDA 模型匹配功能。
• 将版本 1 的 catalogReference 数据迁移为版本 2 的 edaModelReference，并保持存储键和扩展 UUID 不变。
• EDA 模型不存在或查询失败时，仍保留有效的订单导入记录。
• 修复嘉立创 EDA 扩展沙箱不支持 structuredClone 时库存无法保存的问题；数量为 99 且存放位置为空等数据现在可以正常保存。
• 移除 C 编号输入框中预填的 C，方便直接粘贴完整编号；此入口要求编号必须包含 C 前缀。
• 增加中英文贡献者说明，明确披露 OpenAI Codex 参与主要实现、调试、测试、文档和构建验证。

0.1.0 - 2026-07-20

• 建立模块化的嘉立创 EDA 专业版 V3 扩展基础结构。
• 支持通过立创 C 编号查询官方器件库。
• 支持准确数量、大概数量、未知数量和已用完等库存状态。
• 增加原生库存管理与库存优先推荐工作流。
• 增加 CSV/JSON 订单导入，支持重复项处理和逐行已用完状态。
• 支持复制到常用库，并在收藏库失败时回退到个人库。
• 支持在原理图中将带器件库引用的在库元器件绑定到鼠标进行放置。
• 增加 JSON 备份导出和简体中文/英文界面翻译。
• 增加领域单元测试、持续集成、架构文档和跨设备验证说明。