PF.AutoFramework 项目工具
面向工业自动化 / SECS-GEM 产线软件的一站式 Visual Studio 脚手架与运维工具
🧩 这是什么
PF.AutoFramework 项目工具 是配合 PF.AutoFramework 框架使用的 Visual Studio 扩展。它把"新建工站项目 → 生成配置代码 → 日常联调 → 打包发布"这一整条链路,从手工操作和命令行脚本,收进了 VS 的右键菜单和向导对话框里,做成开箱即用的图形化操作。
适合人群:使用 PF.AutoFramework 框架开发工站/产线控制软件的团队开发者。

✨ 核心能力
🚀 1. 新建工站项目向导
「新建项目」里选择 PF AutoFramework 工站项目,向导会一次性生成完整解决方案骨架:PF.Application.Shell 主程序、PF.WorkStation.<工站名> 业务工程、标准解决方案文件夹结构、本地开发脚本与打包工程,全部按框架约定摆放到位,不用照着文档手工搭。
向导内可直接导出一份带示例数据的 Config.xlsx,作为后续配置代码生成的起点。

📊 2. Config.xlsx 表格一键生成配置代码
把 IO 点位、报警码、系统参数、硬件设备、通讯实例等信息填进一份 Config.xlsx,右键解决方案(或右键表格文件本身)→「PF: 生成配置代码」,即可生成对应的 C# 配置文件。
- ✅ 生成前先校验:格式或跨表引用有问题会逐条列出(Sheet 名 + 行号),改完可以直接重新校验,不用关窗口。
- 🎯 支持逐项生成:只想更新报警码就只生成报警码相关文件,不会把手改过的其他文件一并覆盖。
- 📂 窗口内可直接「打开表格」,改完保存回来点校验即可,来回切换不折腾。

🛠️ 3. 文件级脚手架
右键工站业务项目,「PF: 新建机构 / 工站 / 硬件设备…」按框架约定直接生成对应基类子类,存在配套 UI 项目时同步生成调试页面,命名与导航特性自动对齐,省去手写样板代码的时间。

🔗 4. 联合库调试(源码级联调)
右键解决方案 →「PF: 进入联合库调试」,把对框架各 NuGet 包的引用临时切换成对框架源码的直接引用,生成合并视图 LocalDev.slnx,即可在框架源码里打断点、单步调试;一键「退出联合库调试」即可切回 NuGet 包发布模式。进入前还会自动比对框架源码版本与当前项目引用的 NuGet 版本,避免联调时把版本差异误判成 bug。

📦 5. 一键打包安装包
右键解决方案 →「PF: 打包生成安装包(EXE)」,自动完成发布与安装包编译,日志实时输出到 VS 输出窗口;「PF: 打包配置…」提供表单化编辑安装包配置(应用信息、Windows 服务列表、版本来源等),不用手改配置文件。
🎨 6. 私包版本管理 & 界面字体切换
- 🔄 「PF: 更新私包版本号…」:一键查询并回写框架各 NuGet 包的最新版本。
- 🔤 「PF: 切换界面字体…」:在可选的中文字体包之间切换,一次操作同步改好所有相关配置。
🏁 快速上手
- 🔌 安装本扩展后重启 Visual Studio。
- 🆕 新建项目 → 搜索 "PF AutoFramework" → 按向导填写工站名等信息完成创建。
- 📝 打开向导生成(或自行整理)的
Config.xlsx,按需要维护 IO 点位 / 报警码 / 硬件设备等表格。
- ⚙️ 右键解决方案 → PF: 生成配置代码(Config.xlsx) → 先「校验表格」,通过后逐项或「全部生成」。
- 🐞 日常开发需要联调框架源码时,右键解决方案 → PF: 进入联合库调试;调完右键 → PF: 退出联合库调试 切回正常模式。
- 🚚 准备发布时,右键解决方案 → PF: 打包生成安装包(EXE),产出可直接分发的安装包。
💻 环境要求
- Visual Studio 2022(Community / Professional / Enterprise)
- 目标项目基于
PF.AutoFramework 框架
💬 反馈与文档
详细使用文档、完整命令列表与约定说明,见项目仓库 README。使用中遇到问题欢迎提交 Issue 反馈 🙌。