diff --git a/README.md b/README.md new file mode 100644 index 0000000..0eb670e --- /dev/null +++ b/README.md @@ -0,0 +1,37 @@ +# 一叶知秋重构版 + +一叶知秋重构版是面向 DxDesigner 7.9.5 和 Expedition PCB 的 Python productivity suite。业务逻辑在 Python 中实现,宿主程序负责设计读写和 Excel 输出;项目不再依赖旧 EFM/VBS 作为正式功能实现。 + +## 功能范围 + +- 自动位号重编与恢复 +- Value、Value1、Part Number 批量修改 +- PartName、PartLabel 批量隐藏与显示 +- 孤立网络、网络列表、跨页互动检查 +- Value/Value1 遗漏查找 +- BOM 导出、分组合并、NC 过滤和料号校验 +- Expedition PCB 装配位号整理 + +改图操作使用 `preflight -> apply -> verify -> rollback` 事务流程。DxDesigner/Expedition 的真实宿主行为仍需按现场验收文档验证。 + +## 环境与安装 + +- Windows +- DxDesigner 7.9.5(需要宿主联调时) +- Python 3.12 + +```powershell +py -3.12 -m venv .venv +.\.venv\Scripts\Activate.ps1 +python -m pip install -e ".[dev]" +``` + +命令行入口为 `dx-productivity`,可用 `dx-productivity --help` 查看当前命令。未连接真实宿主时,可以运行逻辑测试和构建,但不能据此宣称 DxDesigner/Expedition 写回已通过。 + +## 测试与文档 + +```powershell +pytest +``` + +用户说明、模块支持矩阵和更新记录见 [`docs/user`](docs/user),验收材料见 [`docs/testing`](docs/testing)。当前模块支持矩阵仍将真实宿主验收标记为待完成。