• 首页
  • 使用指南
    上传指南安装指南
  • API文档
    开发指南API调用API参考
  • 相关网站
    嘉立创EDA嘉立创社区开源广场
  • 编辑器
    在线编辑器(专业版)桌面客户端
  • 扩展管理
  • 登录注册
嘉立创产业服务站群

电子产业

logo

嘉立创PCB

PCB、FPC制造服务

logo

嘉立创SMT

一站式PCBA服务平台

logo

嘉立创激光钢网治具

激光钢网&治具制造

logo

嘉立创EDA

国产PCB设计工具

机械产业

logo

嘉立创FA

机械/电气零部件一站式商城

logo

嘉立创3D打印

树脂、尼龙、金属3D打印服务

logo

嘉立创CNC机械智造

机加件一件起订,3天交货

更多服务

嘉立创CAM

国产线路板CAM软件

Forface 3D

SaaS化3D技术服务平台

硬创社

好玩的硬件交流社区

供应商合作

一站式阳光采购平台

· EDA扩展广场
首页

使用指南

上传指南安装指南

API文档

开发指南API调用API参考

相关网站

嘉立创EDA嘉立创社区开源广场

编辑器

在线编辑器(专业版)桌面客户端
登录注册

加载工程/库文件夹

OSHWHub6v1.0.0
(0)Apache-2.0
直接从未解压的文件夹导入嘉立创EDA专业版工程(.epro2)与库(.elibz2)。扩展会遍历文件夹树、自动识别嵌套的工程 / 库文件夹,在内存中重新打包后走官方导入流程——全程不写入本地磁盘,因此本地文件被加密系统(DLP)保护、压缩包无法直接导入的客户端也能正常加载自己的设计。
详情
更改日志
历史版本
评论

加载工程/库文件夹

OSHWHub6
(0)Apache-2.0
详情
更改日志
历史版本
评论

简体中文 | English

加载工程/库文件夹

嘉立创EDA / EasyEDA 专业版扩展:直接从未解压的文件夹导入工程(.epro2)与库(.elibz2)。

alt text

解决什么问题

很多企业客户的电脑装有本地文件加密系统(DLP / 透明加密),这类系统对压缩包支持穿透加密:zip 内部每个文件被单独加密;但不支持穿透解密。

于是出现下面的死循环:

  1. 工程从 EDA 导出为 .epro2 / .elibz2(本质是一个 zip);
  2. 加密系统把 zip 里的每个文件再次加密;
  3. 之后用 EDA 导入这个文件时,EDA 解压出来的是密文,导入直接失败,且没有可用的错误提示。

本扩展把流程换了一条路:绕开“压缩包”这一层,改为直接读文件夹。

  • 文件夹里的每个文件由操作系统在读取时逐个解密(加密系统对“单个文件读取”是支持的);
  • 扩展在内存中遍历、识别、重新打包成合法的 .epro2 / .elibz2;
  • 再把内存中的压缩包交给 EDA 官方导入接口。

因为压缩包从未落盘,不会被再次加密,EDA 拿到的就是明文包,导入恢复正常。

功能

功能说明
拖拽 / 选择文件夹弹窗支持把文件夹直接拖进去,也可点按钮打开系统文件夹选择框
自动识别嵌套递归扫描文件夹树,自动识别多层级嵌套的工程 / 库文件夹,无需手工挑选
自动区分类型含 project2.json(或 *.epru)→ 工程;含 device2.json(或 *.elibu)→ 库
内存打包在内存中重建 epro2 / elibz2 压缩包,全程不写本地磁盘,不会被再次加密
批量导入一次识别出多个工程 / 库,勾选后逐个导入,带进度与失败原因
选择归属导入前选择工作区 / 团队与目标目录,可选“导入后自动打开工程”
原生压缩包兼容文件夹里本来就有未加密的 .epro2 / .elibz2 / .zip 时,作为一项直接导入
全部文档类型可用顶部菜单在 home / blank / 原理图 / 符号 / PCB / 封装 / PCB 视图 / 面板 / 面板视图中均可用
中英双语跟随客户端语言自动切换

安装

  1. 下载编译好的扩展包 import-folder-to-easyeda_v1.0.0.eext;
  2. 打开 嘉立创EDA 专业版 → 设置 → 扩展 → 扩展管理器 → 加载扩展;
  3. 选择上面的 .eext 文件完成安装。

需要 嘉立创EDA 专业版 v3.2.0 及以上版本。“打开系统文件夹”按钮使用 openReadFolderDialog(v4.2+), 低版本会自动回退到浏览器标准的文件夹选择框,功能不受影响。

使用方法

准备:先准备好文件夹

  1. 批量下载:在 EDA 中把工程(epro2)或库(elibz2)下载到本地。批量导出可使用扩展 导出设计压缩包。
  2. 批量解压:把工程与库压缩包解压到单独的文件夹中(每个工程 / 库一个文件夹)。
  3. 选顶层文件夹:导入时只需选择这些文件夹的顶层目录,扩展会自动识别其中所有工程与库。

1. 打开弹窗

在任意文档类型下点击顶部菜单:加载工程/库文件夹 → 从文件夹导入工程 / 库...

2. 选择文件夹

  • 把文件夹直接拖进虚线区域;或
  • 点击 打开系统文件夹... 在系统对话框中选择文件夹。

选中的文件夹可以是一整棵目录树,扩展会自动找出里面所有工程 / 库:

我的项目/
├── 电源板/                ← 工程文件夹
│   ├── project2.json
│   └── 电源板.epru
├── 历史版本/
│   └── 控制板V1/          ← 嵌套工程文件夹,同样会被识别
│       ├── project2.json
│       └── 控制板V1.epru
└── 常用库/                ← 库文件夹
    ├── device2.json
    └── lib2.elibu

3. 点「导入」开始分析

扩展会遍历文件夹树、识别出所有工程 / 库文件夹,并读出名称与内容统计:

  • 工程:取 project2.json 里的 title
  • 库:取文件夹名,并统计器件 / 符号 / 封装数量

4. 设置归属并确认

在右侧面板选择:

  • 工作区 / 团队:导入到哪个归属下(个人库也会出现在列表中);
  • 目标目录:该团队下的目录树,可选团队根目录;
  • 导入完成后自动打开工程:勾选后,最后一个成功导入的工程会自动打开;
  • 库中单个符号自动创建器件:导入库时是否自动为单符号创建器件(默认勾选)。

确认后点 开始导入。

5. 查看进度

每个工程 / 库逐个导入,列表实时显示状态:

  • 正在打包 x / y:读取文件并在内存中重建压缩包;
  • 正在导入...:调用 EDA 官方导入接口;
  • 导入成功 / 导入失败(失败会显示具体原因)。

全部完成后点 关闭。

识别规则

判定以目录为单位,从浅到深递归扫描;命中后不再深入该目录(其整个子树作为该工程 / 库的内容):

目录特征判定打包名
存在 project2.json 或任意 *.epru工程<名称>.epro2
存在 device2.json 或任意 *.elibu库<名称>.elibz2
存在 *.epro2 / *.elibz2 / *.zip 文件原生压缩包,原样导入原文件名

project2.json 缺失时会自动补一个最小可用的元数据文件,避免因单个文件丢失导致整包导入失败。 .DS_Store、Thumbs.db、__MACOSX、._* 等系统垃圾文件会被忽略。

常见问题

Q:为什么必须用文件夹,不能直接选 .epro2 文件? A:加密系统不支持“穿透解密”,压缩包里的文件对 EDA 而言是密文。文件夹方式下每个文件都是独立读取的,能正常解密。若文件夹里本来就有未加密的压缩包,扩展也支持直接导入。

Q:会不会把我的文件写到磁盘? A:不会。文件内容只在内存中被读取与打包,压缩包以 File 对象直接交给 EDA 导入接口。

Q:导入后工程名很奇怪? A:工程名优先取 project2.json 的 title,取不到时使用文件夹名;导入后可在工程树中重命名。

Q:点了「导入」没反应,或提示 EDA 拒绝压缩包? A:请确认所选文件夹内确实包含 project2.json / device2.json。若压缩包来自其他软件或已损坏,EDA 会拒绝导入,请改用对应格式的官方导入流程。

Q:能导入面板库吗? A:面板库(panelLibs)随库文件一起导入,扩展本身不做拆分。

开发

npm install      # 安装依赖
npm run compile  # 仅编译(ts-node + esbuild → dist/)
npm run build    # 编译并打包为 build/dist/*.eext
npm run debug    # 调试构建
npm run lint     # ESLint 检查

开发文档:嘉立创EDA 扩展 API 开发指南

目录结构

├── extension.json              # 扩展清单(菜单、多语言字段、logo)
├── images/
│   ├── logo.png                # 商店 / 扩展列表 logo(512×512)
│   └── logo.svg                # logo 源文件
├── iframe/
│   └── import-folder.html      # 导入弹窗(自包含 HTML:UI + 识别 + 打包 + 导入)
├── locales/
│   ├── en.json                 # 界面文案(英文)
│   ├── zh-Hans.json            # 界面文案(简体中文)
│   └── extensionJson/          # extension.json 字段的翻译
├── src/
│   └── index.ts                # 扩展入口:菜单命令、打开弹窗、关闭协作
└── case/                       # .epro2 / .elibz2 样例(不参与打包)

开源许可

本扩展使用 Apache License 2.0 开源许可协议。 你仅可以将 嘉立创EDA、EasyEDA 商标信息用于依托于本扩展的 功能描述部分 和 开源发布的标题部分。

Changelog

1.0.0

首个版本 / Initial release.

新增 / Added

  • 菜单「加载工程/库文件夹 → 从文件夹导入工程 / 库...」,在 home、blank、原理图、符号、PCB、封装、PCB 视图、面板、面板视图中均可用。
  • 导入弹窗:支持拖拽文件夹、点击打开系统文件夹选择框,分「选择文件夹 → 设置归属 → 导入」三步。
  • 弹窗内置使用说明:批量下载工程/库压缩包(附「导出设计压缩包」扩展链接)→ 批量解压到单独文件夹 → 选择顶层文件夹导入。
  • 递归识别多层嵌套的工程(project2.json / *.epru)与库(device2.json / *.elibu)文件夹,自动区分类型。
  • 在内存中重建 .epro2 / .elibz2 压缩包(自实现 ZIP 写入器,STORE + CRC32),全程不写磁盘,规避压缩包被 DLP 再次加密。
  • 支持一次识别多个工程 / 库,勾选后逐个导入,展示打包进度、导入状态与失败原因。
  • 导入前选择工作区 / 团队与目标目录,可自动打开导入后的工程、可为库中的单符号创建器件。
  • 文件夹内已存在的未加密 .epro2 / .elibz2 / .zip 可直接原样导入;类型未知的压缩包会依次尝试工程 / 库两条导入通道。
  • 补充扩展描述、README(中/英)、中英文界面文案与 extension.json 字段翻译。
  • 重新设计扩展 logo(images/logo.svg 与 512×512 的 images/logo.png)。

修复 / Fixed

  • 主按钮 hover 时丢失渐变背景,白色文字压在浅色底上不可见。
  • 弹窗文案改为内联中文字典 + 语言探测,修复中文环境下文案显示英文的问题。
  • 移除「关于」菜单项与对应方法,菜单只保留导入入口。

依赖的 EDA 接口 / APIs used

  • sys_IFrame.openIFrame / closeIFrame / isIFrameAlreadyExist / hideIFrame
  • sys_FileSystem.openReadFolderDialog
  • sys_FileManager.importProjectByProjectFile
  • sys_I18n.getCurrentLanguage(弹窗语言探测)
  • sys_Window.open(使用说明中的外链)
  • dmt_Team.getAllTeamsInfo / getAllInvolvedTeamInfo / getCurrentTeamInfo
  • dmt_Folder.getAllFoldersUuid / getFolderInfo
  • dmt_Project.openProject
暂无数据
暂无数据

评论

在登录或注册后才可以进行评论操作
全部评论(1)
按时间排序|按热度排序

类型

ProjectLibrary

关键词

ImportFolderArchiveProjectLibraryepro2elibz2Tool

扩展信息

版本v1.0.0
发布者

EasyEDA

发布时间2026-11-11 09:31:07
名称

import-project-library-folder

UUID

d4f7a1c2b9e84a6d8f320c5b7e1a9d63

适用EDA版本:^3.2.0
报告

报告滥用

相关链接

主页:https://github.com/easyeda/eext-import-project-library-folder
反馈:https://github.com/easyeda/eext-import-project-library-folder/issues
logo

政策条款

服务条款隐私政策项目授权许可协议作出贡献感谢名单

软件版本

专业版标准版教育版私有化部署版

解决方案

专业版编辑器标准版编辑器桌面客户端API接口文档格式

使用帮助

用户论坛专业版教程标准版教程专业版更新标准版更新

关于我们

团队介绍相关报道关于公司联系我们合作联系
EDA公众号
EDA公众号
开源公众号
开源公众号
开源硬件交流群
开源硬件交流群
版权所有 - 深圳创电优选科技有限公司 粤ICP备2026007863号粤公网安备44030402002736号增值电信业务经营许可证粤B2-20201198ISO/IEC隐私政策用户协议