CAD看图助手（自控点位统计）

# CAD 看图助手（自控点位统计） ## 你遇到的痛点 - 拿到一张暖通/楼宇/工业自控 CAD 图纸，密密麻麻几百个点位，人工点数又慢又容易漏，做 IO 表、设备清单要熬到半夜。 - 招标清单、深化设计、采购核量都要"按 AI/AO/DI/DO 分类汇总"，手点既慢又不准，返工率高。 - 市面上看图软件只能"看"，不能"数"——点位得自己一个个数、一个个抄。 ## 这个技能能做什么 CAD 看图助手是一个**带真实代码的命令行程序**（非空壳），你只要输入一条指令读取图纸，它就帮你： 1. **自动读取 CAD 图纸**（DXF 格式；DWG 先用 AutoCAD / ODA File Converter 另存为 DXF 即可）。 2. **智能识别四类自控点位**：AI 模拟量输入、AO 模拟量输出、DI 数字量输入、DO 数字量输出——既认单个点位编号（如 `AI-101`），也认模块聚合规格（如 `16AI`、`8DI`）。 3. **解析设备与信号标识**：自动关联 PT/TT/LT/FT/AHU/PAU/P/MV/TV 等设备编号，把"点位—设备"对应起来。 4. **一键生成三张规范表格**：`点位表`（编号/类型/信号/IO方向/数量/用途/关联设备/图层）、`设备清单`（设备编号/类型/关联点数）、`统计汇总`（各类点数合计）——导出 Excel(.xlsx) 或 CSV，打开即用。 ## 四步出片（照做即得结果） **第一步：装依赖** ```bash pip install ezdxf openpyxl ``` **第二步：读一张图纸（核心指令）** ```bash python cad_point_assistant.py read 图纸.dxf --output ./output --format xlsx ``` 程序会输出： ``` ========== 自控点位统计汇总 ========== AI 模拟量输入: 19 点 AO 模拟量输出: 10 点 DI 数字量输入: 44 点 DO 数字量输出: 27 点 合计 : 100 点 ``` **第三步：拿到清单** `./output/图纸.xlsx` 含三张表：点位表 / 设备清单 / 统计汇总。也可加 `--format csv` 导出 CSV。 **第四步：批量 or 复核** ```bash python cad_point_assistant.py batch 图纸目录/ # 批量处理整个文件夹 python cad_point_assistant.py parse 图纸.dxf # 仅看汇总，不写文件 ``` ## 点位识别规则（可扩展） | 类型 | 中文 | 信号 | 识别写法示例 | |---|---|---|---| | AI | 模拟量输入 | 模拟量 | `AI-101`、模块 `16AI` | | AO | 模拟量输出 | 模拟量 | `AO-201`、模块 `8AO` | | DI | 数字量输入 | 数字量 | `DI-301`、模块 `32DI` | | DO | 数字量输出 | 数字量 | `DO-401`、模块 `16DO` | 程序同时抽取 TEXT、MTEXT、块属性(INSERT+ATTRIB) 三类文本；支持通过 `TYPE_MAP`、`DEVICE_PREFIXES` 两个变量按项目扩充类型与设备前缀。 ## 输出表格字段 - **点位表**：点位编号 / 类型 / 信号类别 / IO方向 / 数量 / 描述·用途 / 关联设备 / 所在图层 / 来源空间 / 备注 - **设备清单**：设备编号 / 设备类型 / 关联点位数量 / 关联点位 / 备注 - **统计汇总**：点位类型 / 中文名称 / 信号类别 / IO方向 / 点数合计 ## 适合谁用 - 楼宇自控 / 弱电 / 暖通 HVAC 工程师：做 IO 表、深化设计、点位核量 - 招投标与技术标书编制：快速出自控点位清单、设备材料表 - 系统集成商 / 实施调试：进场前盘点图纸点位、对接 DDC/PLC 配置 - 业主 / 运维：接手图纸时快速摸清自控规模 ## ⚠️ 注意事项（必读） - **DWG 不支持直接读取**：请先用 AutoCAD / ODA File Converter / LibreCAD 将图纸"另存为 DXF"（R12~R2018 均可），再用本工具读取。 - **识别基于文本**：点位必须从图纸文本（标签/块属性）中能读到编号。若图纸仅以图形符号表达、无文字标签，则无法统计——这是所有同类工具的共有前提。 - **描述取自行内/邻近文本**："描述·用途"来自点位编号同行的后续文字，或附近(可配置半径)文本；若图纸标签与说明分置较远，可在指令中用 `--unit` 调大空间半径。 - **自定义类型/设备**：项目有特殊的信号代号或设备前缀时，改 `TYPE_MAP` / `DEVICE_PREFIXES` 即可，无需改主逻辑。 ## 触发词 CAD看图、CAD点位统计、自控点位、AI点数、AO点数、DI点数、DO点数、IO表、点位表、设备清单、楼宇自控、BA系统、暖通自控、DDC点位、PLC点数、深化设计、招投标清单、弱电点数、图纸点数、自动数点、CAD统计、HVAC点位、模拟量输入、数字量输出 ## 文件清单 - `SKILL.md` — 本文件 - `examples/cad_point_assistant.md` — 主程序完整源码（复制为 `cad_point_assistant.py` 即可运行） - `examples/make_sample_dxf.md` — 样例图纸生成脚本（用于自测） - `examples/usage.md` — 详细使用说明、DWG 转 DXF、依赖与排错 - `examples/example_output.md` — 示例输出（点位表 / 设备清单样本）