docs: add project README
This commit is contained in:
1 parent
e422ca8b2a
commit
b6883c1f6f
1 file changed
+37
@@ -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)。当前模块支持矩阵仍将真实宿主验收标记为待完成。
|
||||||
Reference in new issue
Block a user