════════════════════════════════════════════════════════════════════
        AC钢构—CAD图形合并  v1.1  使用说明
════════════════════════════════════════════════════════════════════

【软件简介】
  绿色免安装的 CAD 图纸批量合并小工具。可把多张 DWG/DXF 图纸准确、
  快速地合并到一张图中，自动按每张图纸的实际外框排布成整齐网格，
  图层、线型、文字、标注样式与标注对象全部原样保留，不错乱、不丢失。

【v1.1 界面（参照主流 CAD 转换器风格）】
  • 无边框自绘窗口：顶栏可直接按住拖动，右侧为最小化/关闭按钮；
  • 顶部品牌页眉：深蓝渐变 + AC 徽标 + “AC钢构—CAD图形合并”；
  • 步骤引导条：①添加图纸 → ②排布参数 → ③开始合并（自动高亮推进）；
  • 卡片式双栏：左侧「待合并图纸」（拖拽添加区 + 统计：数量/总大小），
    右侧「排布参数」；底部「开始合并」大圆角主按钮 + 进度条 + 日志。
  • 空列表时列表区显示“拖拽到此处”提示，点击也可弹出文件选择。

【工作原理】
  通过 COM 自动化连接本机已安装的 CAD 程序（无需额外插件），将每张
  图纸以「块引用」方式插入目标图纸 —— 这是 CAD 官方原生的合并方式，
  速度快、精度高、内容零损失。插入后按图纸实际外框自动对齐排布，
  相邻图纸互不压盖、间距可调。

【支持的程序与版本】
  • 不限制 CAD 版本：AutoCAD 2007~2025、中望CAD(ZWCAD)、浩辰CAD、
    GstarCAD、BricsCAD 等，凡注册了标准 COM 接口均可使用。
  • 本工具为单一 AnyCPU 程序：64 位系统上自动以 64 位运行，兼容
    当前所有主流 CAD（AutoCAD 2012 及以后、中望/浩辰均为 64 位）。
  • 极少数情况：若使用 2009 年之前的 32 位老版 CAD 且系统为 64 位，
    需 32 位版本的程序，可用源码重新编译（编译命令加 /platform:x86）。
  • 要求：本机已安装 CAD；CAD 可先打开（推荐），未打开时工具会自动启动。

【使用方法】
  1. 打开本工具（绿色免安装，双击即用）。
  2. 点击「添加文件…」选择多张图纸，或「添加文件夹…」批量加入
     （支持在弹出的窗口中直接粘贴文件夹路径，回车确认；也支持
      “浏览…”选择；“含子文件夹”勾选后可递归扫描）。支持拖拽
     文件/文件夹到列表。
  3. 用「上移/下移/排序▾」调整合并顺序（列表从上到下依次排列）。
  4. 设置合并参数（见下节）。
  5. 点击「▶ 开始合并」，进度条与日志实时显示；CAD 未打开时会自动启动。
  6. 合并完成后检查结果：默认合并到 CAD 当前活动图纸；如需保存为文件，
     在“保存路径”填好路径（或点“浏览…”），合并后自动保存。

【参数说明】
  • 每行图纸数  ：一行排几张图（超过则自动换行）。
  • 图纸间距X/Y：相邻图纸之间的空隙，单位与图纸一致
                 （毫米图约 500~2000，米图约 0.5~2）。
  • 缩放比例    ：统一缩放（1=原尺寸；需放大/缩小单位不一致的图时用）。
  • 旋转角度    ：统一旋转（度）。
  • 基点 X/Y    ：第一张图所在位置，其余图纸自动向右、向上排开。
  • 行方向/列方向：自下而上/自上而下 × 从左到右/从右到左。
  • 输出到      ：「当前活动图纸」合并到 CAD 里正在编辑的图；
                 「新建图纸」新建一张空白图来合并（推荐）。
  • 保存路径    ：留空则不保存；填写后合并完成自动另存为 DWG。
  • 遇错继续    ：某张图失败（如只读、损坏）时跳过并继续合并。
  • 缩放全图    ：合并后自动 ZOOM 到全部内容（默认开）。
  • 清理(PURGE)：合并后清理未用图层/样式等（可选）。
  • 插入后炸开  ：把块引用炸开，直接并入为普通实体（默认不炸，
                 保持块结构最整洁、可整体选中移动）。
  • 按原坐标插入：不重新排布，每张图按自身坐标系原位插入
                 （适合需要保持现场坐标的图纸）。
  • 自动比例    ：勾选后自动检查各图纸的图框大小。横向图框与竖向图框
                 分别统计，以各自方向“占比较多的图框”为基准，小的放大、
                 大的缩小，统一后同一方向的图纸排列一样大、整齐美观；
                 长宽比不一致时按等比折中（完整放入基准图框，不超出）；
                 缩放自动补偿文字与标注，字体大小与标注数值保持原打印
                 比例，不随缩放变化。

【命令行模式（自动化/批量）】
  AC钢构-CAD图形合并.exe /run 配置.ini
  配置示例：
    files=C:\图纸\a.dwg;C:\图纸\b.dwg    ← 分号分隔
    newdoc=true
    savepath=C:\输出\合并结果.dwg
    columns=3
    gapx=1000
    gapy=1000
    scale=1
    rotation=0
    basex=0
    basey=0
    rowdir=up            ← up=自下而上 / down=自上而下
    coldir=left          ← left=从左到右 / right=从右到左
    explode=false
    purge=false
    zoom=true
    continue=true
    keepcoord=false
    log=run_log.txt
  退出码：0=全部成功，1=有失败。

【诊断功能】
  AC钢构-CAD图形合并.exe /diag
  生成“AC钢构合并_诊断.txt”，列出系统环境与检测到的 CAD 程序，
  用于排查连接问题。

【常见问题】
  Q1 提示“未检测到CAD程序”？
     确认已安装 AutoCAD/中望/浩辰等；如杀毒软件拦截了 COM 自动化，
     请在杀毒软件中放行本工具。
  Q2 提示“目标图纸为只读”？
     当前图纸以只读方式打开。请把“输出到”改为“新建图纸”，
     或先在 CAD 中另存后再合并。
  Q3 合并后图纸重叠？
     说明两张图的原点/外框特殊（如图纸原点在图形内部）。
     可勾选“按原坐标插入”观察，或适当增大间距、调整基点。
  Q4 合并速度？
     本工具用 CAD 原生“插入块”完成，百张图通常几十秒内完成
     （首次连接 CAD 需几秒~几十秒启动时间）。
  Q5 杀毒软件报毒？
     本工具为纯 .NET WinForms 程序，无网络行为、无安装行为，
     属常见误报；如不放心可删除源码自行编译（附完整 C# 源码）。
  Q6 提示“CAD 正忙 / 被呼叫方拒绝接收呼叫(0x80010001)”？
     CAD 在弹出对话框（欢迎/许可/错误提示）、正在执行命令或启动加载
     期间会暂时拒绝自动化调用。本工具会自动等待并重试（最长约20秒）；
     若持续失败，请检查 CAD 界面中是否有未关闭的对话框，关闭后重试。

【文件清单】
  AC钢构-CAD图形合并.exe      唯一主程序（AnyCPU，单文件独立运行）
  ACSteelMerge.cs             完整源代码（可用系统自带编译器自行编译）
  icon.ico                    程序图标（已嵌入 exe，可删除）
  使用说明.txt                本说明

【关于“独立运行”】
  • 本工具是绿色软件：免安装、不写注册表、不留缓存，拷贝到任意
    Windows 10/11 电脑即可双击运行，无需安装任何运行库。
  • 程序基于 .NET Framework 4.x 编译，该运行库由 Windows 10/11
    系统自带（4.8 版本），因此单文件 exe 即可独立运行。
  • 界面参数（列数、间距等）自动保存在用户数据目录
    %APPDATA%\AC钢构CAD合并\ 下，exe 所在目录不写任何文件，
    绿色封装包保持纯净（旧版如有残留配置会自动迁移并清理）。

  编译方法（本机无需安装任何SDK）：
  "%WINDIR%\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /nologo
      /target:winexe /codepage:65001 /optimize+
      /win32icon:icon.ico
      /out:"AC钢构-CAD图形合并.exe"
      /r:System.dll /r:System.Core.dll /r:System.Windows.Forms.dll
      /r:System.Drawing.dll /r:Microsoft.CSharp.dll
      ACSteelMerge.cs

【免责声明】
  本工具免费提供，按“现状”使用。合并前建议先备份原始图纸。
  程序页眉：AC钢构—CAD图形合并
════════════════════════════════════════════════════════════════════
