工程文档批量导出（engineering-document-export）

批量导出当前工作区中勾选工程的源文件（.epro2 归档包）。适用于工程归档、备份、交付等场景，免去逐个工程手动下载。

• 桌面客户端：直写本地目录，每工程一个子目录
• 浏览器（Chrome 等）：可选输出文件夹直写；不允许直写时打包为 zip 下载包

功能

• 在工程管理页（及空白页）顶部菜单「工程文档导出」打开面板
• 弹窗列出当前工作区全部工程（含各团队/文件夹），按原有文件夹分组显示（如 Personal / 小项目），组内按名称排序，组头显示计数，可折叠
• 组头三态复选框整组勾选/取消（点组名行折叠/展开）；工具栏全选 / 反选 / 刷新
• 搜索工程名 / 文件夹 / 团队（不区分大小写），只影响显示不影响勾选（隐藏项保持勾选态）；Esc 或 ✕ 清空
• 刷新保留已勾选状态，新出现的工程默认勾选
• 一次选择输出位置，批量导出：
  • 客户端 / 浏览器直写结构（每工程一个子目录）：

<输出目录>\
├── 工程A\
│   └── 工程A.epro2
├── 工程B\
│   └── 工程B.epro2
└── ...

• 客户端直写受限时（如导出到桌面等含系统文件的目录），自动写入子目录并在结果区注明：

<输出目录>\工程文档导出\
├── 工程A\
│   └── 工程A.epro2
└── ...

• 浏览器 zip 下载包结构（解压后同上）：

工程文档导出_<时间戳>.zip
├── 工程A\
│   └── 工程A.epro2
├── 工程B\
│   └── 工程B.epro2
└── ...

• 逐工程错误隔离：单个工程下载失败会记入结果清单，继续导出其余工程
• 工程名自动做文件系统安全化处理；重名工程自动追加 uuid 短后缀，互不覆盖
• 客户端记住上次使用的输出目录

权限开启

客户端直写成功时不会弹出任何对话框；直写受限自动兜底为 zip 时只弹一次「另存为」。

使用步骤

1. 安装并启用本扩展（见下方「安装」）
2. 开启「项目管理 > 下载工程」权限（客户端直写另需「扩展外部交互权限」）
3. 打开工程管理页 → 顶部菜单「工程文档导出」→「批量导出工程源文件 (.epro2)...」
4. 在面板中勾选工程：
   • 客户端：点「选择目录...」选定输出目录 → 点「导出所选工程」
   • 浏览器：点「选择输出文件夹…」直写磁盘；或不选文件夹直接点「导出为 zip 下载包」
5. 结果区查看逐项成功/失败与最终摘要

安装

powershell -ExecutionPolicy Bypass -File package.ps1

生成 release\engineering-document-export-<版本>.eext，然后在嘉立创EDA专业版客户端「扩展管理」中导入并启用。

疑难排查

导出到桌面 / 提示「当前目录下有系统文件」等写入受限

客户端文件接口可能拒绝写入含系统文件的目录（如桌面 desktop.ini）。插件会自动兜底并在结果区注明实际落点：

1. 先直写所选目录；
2. 受限则写入 <所选目录>\工程文档导出\ 子目录；
3. 仍受限则打包 zip 弹一次「另存为」（可直接存到桌面）。

若希望恢复直接写入（无子目录层），按顺序检查：

1. 确认已开启「扩展外部交互权限」（见上文）；

2. 若已开启仍受限，说明所选目录不在客户端允许的文件读写范围内。请把目标目录加入允许列表：

   • 打开 %USERPROFILE%\Documents\EasyEDA-Pro\config.json
   • 在 APP_PROJECT_DIR 列表中添加导出目录（或其上级目录）的绝对路径
   • 重启客户端后重试

   兜底发生时结果区会明确写明原因与实际落点，不会静默改写到你看不到的位置。

报「缺少『项目管理 > 下载工程』权限」

在扩展管理中为本扩展开启「项目管理 > 下载工程」权限后重试。团队/企业工作区中该权限可能由管理员控制，需联系管理员开通。

报「当前客户端版本过旧，需 EDA ≥ 3.2.201」

客户端选择输出目录依赖 openReadFolderPathDialog API（EDA v3.2.201 引入）。请升级嘉立创EDA专业版客户端。

浏览器中「选择输出文件夹」不可用 / 被拒绝

浏览器直写依赖 File System Access API（showDirectoryPicker）。若浏览器不支持、或扩展 iframe 被安全策略拒绝（提示「已切换为 zip 下载包模式」），插件会自动改为 zip 下载包导出，不影响使用。

zip 解压后中文文件名乱码

zip 内文件名使用 UTF-8 编码（已置标准 UTF-8 标志位）。请用 Windows 10 及以上自带的解压或 7-Zip 解压；部分极老的解压工具不识别 UTF-8 标志位，可能显示乱码（文件内容不受影响）。

个别工程显示「下载返回空」

该工程数据获取失败（BETA 接口的单项失败），其余工程不受影响。可稍后单独重试该工程；若持续失败请检查该工程权限或联系支持。

说明

• 导出内容为工程源文件归档（.epro2），可在嘉立创EDA中通过「导入工程」恢复；如需旧版兼容格式（.epro），修改 iframe/index.html 中常量 EXPORT_FILE_TYPE 为 'epro' 后重新打包。
• 批量导出使用 getProjectFileByProjectUuid（BETA 接口，无需打开工程）；接口未来演进时本插件会做对应适配。

许可证

木兰宽松许可证，第2版（MulanPSL-2），见 LICENSE。