# LEYE

LEYE 电子元器件库存管理系统 EDA 联动扩展

> **Notice:** 此版本为测试版，可能存在 BUG，若需帮助请与开发者联系

## 简介

本扩展在嘉立创 EDA 专业版内提供了 LEYE 电子元器件库存管理系统，此版本为**免费体验版**，兼容常规版 API。

本扩展允许用户通过立创商城 C 编号、立创商城订单导入元器件，支持从库存内查询、放置器件，支持通过 BOM 批量出库。

使用本扩展需要在本地安装 [LEYE Service 服务端](https://lrurl.top/LeyeService)（目前仅提供 Windows 版，[服务端开源](/backend/server.js)），数据均储存在本地，不会上传。

## [介绍视频](https://www.bilibili.com/video/BV1nvcFzpEuP/)

https://www.bilibili.com/video/BV1nvcFzpEuP/

## 如何使用

安装本扩展后**需要给予扩展外部交互**权限以与服务端交互：

- V2.2：设置-扩展-扩展管理器-LEYE-允许外部交互；
- V3：高级-扩展管理器-已安装-LEYE-配置-允许外部交互。

V2.2 用户菜单栏将直接出现“LEYE”选项；V3 用户若未开启“显示在顶部菜单”，则可在“高级”菜单中找到 LEYE。

若未部署常规版，使用本扩展需要在本地安装 LEYE Service 服务端，[点击此处前往下载](https://lrurl.top/LeyeService)。

### 查看库存

查询界面支持直接在原理图放置库存器件，同时可以对库存元件进行管理（编辑型号、CID，出入库）。

若未启动 LEYE Service，扩展将尝试拉起，使用期间不要关闭服务端。

![img01](/images/img_01.png)

![img02](/images/img_02.png)

## 器件入库

扩展支持从立创商城单 Excel 文档、立创商城物料二维码以及 CID 导入器件。

![img03](/images/img_03.png)

> **Tip: 扫描立创商城二维码导入器件** _V1.0.5+_
>
> 在 V1.0.5 版本以上，可以通过扫描立创商城物料包装上的二维码导入器件，扫描后会自动识别 CID 并导入对应器件。
> ![img07](/images/img_07.png)

> **Tip: 使用手机扫码导入器件** _V1.0.6+_
>
> 在 V1.0.6 版本以上，可以在扫码界面选择“WebSocket 远程扫码”，点击“打开摄像头”按钮后用手机扫描二维码即可打开远程端。
> 远程端同样支持扫描立创商城物料包装上的二维码导入器件，扫描后会自动识别 CID 并导入对应器件。
> ![img07](/images/img_08.png)

### 批量出库

打开本页面后将自动整理 BOM 与 LEYE 库存相比较，非立创商城器件（无 CID）显示为红底，不在 LEYE 库存内的器件显示为黄底，在 LEYE 库存内的器件显示为绿底。

建议器件标准化后再使用批量出库功能。

![img06](/images/img_06.png)

## 配置项说明

| 配置项         | 说明                                                                     | 默认值                   |
| :------------- | :----------------------------------------------------------------------- | :----------------------- |
| 服务器地址     | LEYE Service 服务器地址                                                  | `http://localhost:21816` |
| 允许拉起服务端 | 允许通过 [`leye://open`](leye://open) 拉起本地安装的 LEYE Service 服务端 | `true`                   |

## 已知问题

1. 小尺寸屏幕上 UI 无法自适应，体验不佳

## 开源许可

本扩展使用以下开源软件：

- [SheetJS](https://www.npmjs.com/package/xlsx)：Excel 解析库，使用 [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/) 许可协议授权
- [jsQR](https://www.npmjs.com/package/jsqr)：二维码解析库，使用 [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/) 许可协议授权
- [node-qrcode](https://www.npmjs.com/package/qrcode)：二维码生成库，使用 [MIT License](https://choosealicense.com/licenses/mit/) 许可协议授权
- [MQTT.js](https://www.npmjs.com/package/mqtt)：MQTT 客户端库，使用 [MIT License](https://choosealicense.com/licenses/mit/) 许可协议授权
- [Tailwind CSS](https://www.npmjs.com/package/tailwindcss)：CSS 框架，使用 [MIT License](https://choosealicense.com/licenses/mit/) 许可协议授权

本扩展使用 [Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/) 开源许可协议，商业/教育用途请考虑联系开发者获取常规版。