Metadata-Version: 2.4
Name: deepKernel
Version: 0.0.39
Summary: A simple example package
Author-email: pz <meichiyuan@pzeda.com>
Project-URL: Homepage, https://www.pzeda.com/CN
Project-URL: Repository, https://gitee.com/the-sky_fly/deep-kernel_api_docs-and-changelog
Project-URL: Documentation, https://gitee.com/the-sky_fly/deep-kernel_api_docs-and-changelog/blob/master/API_Document.md
Project-URL: Changelog, https://gitee.com/the-sky_fly/deep-kernel_api_docs-and-changelog/blob/master/ChangeLog.md
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# deepKernel

`deepKernel` 是一个 Deepline 的二次开发 Python 接口包，提供 PCB/EDA 制造辅助设计的 SDK 能力。

**当前版本：0.0.39**

## 依赖清单 (Dependencies)

本包目前无任何第三方依赖，您可以直接安装使用。

## 更新日志 (Changelog)

本项目所有的显著变更都将记录在此文件中。

## [0.0.39] - 2026-05-15 (正式第十九版)

### Added (新增)

* 新增 `PCBA` 模块，包含 Component 组件操作、Package 封装库操作及 BOM 交互共 9 个接口。

### Changed (变更)

* `base.py` 中 PCBA 底层通信函数重构为 `@kernel_command` 装饰器方式。

* `Mask.importDxf` 新增 `autoScaleOffset`、`boardOffset` 参数。

* `Mask.outlineToSurface` 移除 `canToPad` 参数，新增 `distance` 参数。

* `Input.openJob`、`Configuration.init` 底层调用逻辑优化。

### Removed (移除)

* 移除以下已废弃的模块源码：`Analysis`、`Guide`、`Optimization`、`MI.stackup`。

* 从 API 文档中移除已废弃的 `Application` 模块条目。

## [0.0.38] - 2026-05-12 (正式第十八版)

### Added (新增)

* 在 `Mask` 模块中新增了 `polygonSmooth` 接口。

* 在 `Mask` 模块中新增了 `breakSurface` 接口。

### Changed (变更)

* 将 `Mask.setProfileCenterAsDatum` 接口重命名为 `autoZeroDatumProfileCenter`。

* 在 `Mask.addNewWayBarcodeCode39`、`Mask.addNewWayBarcodeNikon` 接口中新增了 `textOffset` 参数。

* 在 `Mask.breakSurfaceArc` 接口中新增了 `changemode` 参数。

## [0.0.37] - 2026-05-07 (正式第十七版)

### Added (新增)

* 在 `Mask` 模块中新增了 `setProfileCenterAsDatum` 接口。

### Fixed (修复)

* 修正了 `addNewWayQrcode`、`addNewWayBarcodeCode39`、`addNewWayBarcodeNikon` 三个接口存在的参数传递问题：

  * 移除了 `addNewWayQrcode`、`addNewWayBarcodeCode39`、`addNewWayBarcodeNikon` 中暂未开放的 `selection`、`attributes` 参数。

  * 修正了 `position` 参数的类型定义（`bool` → `int`，1=条码上方，2=条码下方）。


## [0.0.36] - 2026-04-29 (正式第十六版)

### Added (新增)

* 在 `Mask` 模块中新增了 `addNewWayQrcode`、`addNewWayBarcodeCode39`、`addNewWayBarcodeNikon`接口。

### Fixed (修复)

* 修正了`exportGds`存在的参数传递错误的问题。

## [0.0.35] - 2026-04-09 (正式第十五版)

### Added (新增)

* 在 `Mask` 模块中新增了 `exportGdsPlus` 接口。

## [0.0.34] - 2026-04-07 (正式第十四版)

### Added (新增)

* 在 `GUI` 模块中新增了 `getDeepKernelConfigurationInitPath、getCurrentStep、getCurrentJob、getAllProject、getOpenedProjectInfo、inputGerber` 接口。

* 在 `GUI` 模块中新增了 `changeCurrentStep、closeProject、openProject、createProject、updateCamGui、updateLayerList、updateMatrix、updateView` 接口。

* 在 `Information` 模块中新增了 `getSelectFilter` 接口。

### Deprecated (弃用)

* 废弃了原 `GUI` 模块中的 `showLayer、showMatrix` 接口。

* 废弃了原 `Selection` 模块中的 `setSymbolRangeFilter、setAttrRangeFilter、setExcludeAttrFilter、setExcludeAttrRangeFilter` 接口。

* 废弃了原 `Information` 模块中的 `getSelectParam` 接口。

* 废弃了原 `Guide` 模块和原 `MI.stackup` 模块中的所有接口。

### Fixed (修复)

* 修正了部分接口存在的参数传递错误问题。

  * `Selection.setIncludeSymbolFilter`

  * `Selection.setFeaturetypeFilter`

## [0.0.33] - 2026-04-01 (正式第十三版)

### Added (新增)

* 在 `Mask` 模块中新增了 `exportGds` 接口。

* 在 `Information` 模块中新增了 `getSolderpasteLayers` 接口。

* 在 `Layers` 模块中新增了 `doStepRepeat、surfaceRepair` 接口。

### Deprecated (弃用)

* 废弃了原 `Mask` 模块中的 `exportGds2` 接口。

* 废弃了原 `Output` 模块中的 `savePdf、saveSvg` 接口。

### Fixed (修复)

* 修正了部分接口存在的参数传递错误问题。

  * `Selection.setFeaturetypeFilter`

  * `Selection.resetSelectFilter`

  * `Layers.copy2otherLayer`

  * `Matrix.changeMatrixColumn`

  * `Matrix.changeDrillCross`

## [0.0.32] - 2026-03-13 (正式第十二版)

### Added (新增)

* 在 `Mask` 模块中添加了以下接口：

  * `clipArea`

  * `resizeGlobal`

  * `moveToOtherLayer`

  * `copyToOtherLayer`

  * `getUserSymbolHistogram`

  * `contourize`

### Fixed (修复)

* 修正了部分接口存在的参数传递错误问题。

## [0.0.31] - 2026-03-04 (正式第十一版)

### Fixed (修复)

* 修正了 0.0.30 版本中存在的接口传参错误问题。

## [0.0.30] - 2026-03-02 (正式第十版 - 重构版本)

### Added (新增)

* 新增 `Action` 包及其下属的 `Information`、`Selection` 模块。

* 新增 `Edition` 包及其下属的 `Job`、`Layers`、`Matrix` 模块。

* 新增 `MI` 包及其下属的 `stackup` 模块。

* 新增了以下独立模块：`Analysis`, `Application`, `base`, `Configuration`, `deepline`, `GUI`, `Guide`, `input`, `Mask`, `Optimization`, `output`。

* 封装了多数基础功能接口，以供进一步测试。

### Deprecated (弃用)

* ⚠️ **重大变更**: 弃用了原有的所有旧版模块结构，全面迁移至新的包结构框架。

## [0.0.21] - 2025-11-13

### Changed (变更)

* 引入多线程机制，大幅优化了 PNG 的输出速度。

## [0.0.20] - 2025-11-13

### Changed (变更)

* 持续更新并优化 PNG 输出函数。

## [0.0.19] - 2025-11-13

### Changed (变更)

* 更新输出 PNG 函数。

## [0.0.18] - 2025-11-13

### Changed (变更)

* 更新输出 PNG 函数。

## [0.0.17] - 2025-11-13

### Fixed (修复)

* 对输出 PNG 的相关逻辑进行了调试和修复。

## [0.0.16] - 2025-10-31 (正式第九版)

### Added (新增)

* 封装了 Gerber 层别比对相关接口。

### Changed (变更)

* 简化了业务流程逻辑，进一步优化用户调用体验。

## [0.0.15] - 2025-10-30 (正式第八版)

### Changed (变更)

* 更新并优化了 Gerber 导入相关接口。

## [0.0.14] - 2025-10-30 (正式第七版)

### Added (新增)

* 增加了创建 Job 等相关工程管理接口。

## [0.0.13] - 2025-10-30 (正式第六版)

### Added (新增)

* 增加了 Gerber 导入相关接口。

## [0.0.12] - 2025-10-30 (正式第五版)

### Added (新增)

* 增加了 `layercompare` (层比对) 相关接口。

## [0.0.11] - 2025-09-29 (正式第四版)

### Added (新增)

* 在 `input`、`output`、`base` 模块中加入了 DXF 的导入导出测试函数。

### Changed (变更)

* 修改并优化了 DXF 导入逻辑中的 JSON 细节处理。

## [0.0.8] - 2025-09-29 (正式第三版)

### Added (新增)

* `information` 模块中加入 `get_layer_feature_count` 与 `get_all_features_info` 接口，用于在无法导出时验证导入的正确性，以及在导入后获取特征信息。

### Fixed (修复/已知问题)

* 确认可使用 `information` 模块的导出函数获取所有 feature 信息。

* *(已知问题)* `output` 模块的导出函数目前仍无法输出目标文件。

## [0.0.7] - 2025-09-28 (正式第二版)

### Added (新增)

* 加入 `output` 模块，用于测试导出 Gerber / ODB++ 接口的可用性（目前处于不可用状态）。

## [0.0.5] - 2025-09-26 (正式第一版)

### Added (新增)

* 首个 SDK 测试版本发布。

* 提供基础测试接口：`configuration.init`、`input.open_job`、`information.get_profile_box`，用于验证 SDK 包整体是否可用。
