HALOU CAD PLUGIN MANUAL
Halou
综合说明书
这是一份面向实际操作的说明书。内容依据当前插件源码、功能清单和项目维护记录整理，重点说明软件真正如何识别、计算和修改图纸。
自动识别结果必须经过人工确认。涉及展开长度、开缺位置、数量或下料的数据，在投入生产前至少抽查一件。
FUNCTION INDEX
功能目录
下表按当前插件功能清单整理。已经完成源码解析的功能在后文给出完整章节，其余功能后续可按同一结构继续补充。
ZK / ZKK展开与开缺闭合钣金截面展开；按基点、开缺料和有限行径线生成开缺轮廓。
BZ自动标注选择闭合钣金截面多段线，生成原生 AutoCAD 尺寸标注。
KB开板耗材计算按 ZK 展开口径计算展开长度和指定板宽内的可开支数。
批量联动批量联动展开识别生产模版、表格字段和联动区域，通过 Excel 批量生成汇总图。
审阅物料规范审阅校正模版长度，并同步检料表规格、数量与备注总数；不改变物料几何。
JT方框截图按选定方框复制 CAD 内容并导出 PNG。
OLE批量导入图片扫描图纸目录图片并按 OLE 对象依次插入。
CL颜色线数字 1–255 修改对象 ACI 颜色；c1–c255 设置当前绘图颜色。
MATERIAL TEMPLATE REVIEW
物料规范审阅
用于校正物料模版的“长度”字段，并把结果同步到所选检料表。它会修改文字和表格数据，但不会拉伸、移动或重画物料几何。
识别条件
- 模版由青色闭合大框、框内青色小框和小框下方约 5mm 的洋红线组成。
- 洋红线下方需要有物料几何与有效尺寸标注。
- 检料表是可选项；需要同步时必须与模版一起框选。
- 建议一次只处理同一订单或同一规格，避免同名物料跨图框匹配。
长度与数量规则
忽略 L1、L2 等子联动标记，优先从普通尺寸中取最长有效尺寸，再四舍五入为整数写入“长度”。
按模版定义的段数寻找连续尺寸链，使用 * 连接，例如 153.6*143.2。分段不完整时跳过，不会误写总长。
在检料表中自动归组并累加数量；同名但规格不同不会简单合并。
物料名称本身即可作为锚点。若其下方没有已归属明细，程序会新增“长度=数量支”，而不是改掉物料名称。
已存在“总数x支”时按本次识别数量替换；没有模板占位或总数文字时，不擅自重写整段备注。
模版长度与检料表在同一事务中写回；任一目标移动、删除、锁定或写入不完整时，整次修改回滚。
操作步骤
- 1
框选
运行“物料规范审阅”，完整框选同一批物料模版；需要同步检料表时，把检料表一起框入。
- 2
检查识别
程序识别“大青框 + 小青框 + 洋红线”组合，并计算每件模版应使用的规格长度。
- 3
阅读预览
确认窗口会列出原值 → 新值、检料表将更新的单元数量，以及因资料不足而跳过的模版。
- 4
确认写回
只有选择“是”后才写图；选择“否”不会改变图纸。
- 5
抽查结果
核对模版长度、物料名下的“长度=数量支”、检料表规格以及备注“总数x支”。
完成后应看到
- 确认窗口中的“已更新长度、原本一致、跳过”数量合理。
- 检料表匹配数与图面物料种类相符。
- 没有占位符的物料名下方出现一条明细，且不会重复新增。
- 备注总数与明细数量合计一致。
视频补充物料规范审阅完整操作展开
视频只用于辅助理解。实际操作顺序和当前规则以本页文字说明为准。
BATCH LINKED UNFOLD
批量联动展开
用于把已经制作好的生产模版与 Excel 订单数据结合，批量克隆、拉伸、替换字段、同步检料表并生成汇总 CAD 图。
模版是怎样被识别的
程序先在当前模型空间中寻找青色闭合矩形与洋红线，再按以下关系组成模版：小青框位于大青框内；洋红线也在大青框内；洋红线与小青框横向重叠，并位于小青框下方约 5mm。字段、几何、尺寸和检料表随后按唯一归属分配给一件模版，减少相邻模版互相抢实体。
母联动与子联动
负责主长度变化。使用手动画框时，只有落在框内的点按目标长度差移动；框外保持不动，连接框内外的线自然被拉伸。
用于局部孔位、缺口或分段尺寸。每个 Lx 对应一个独立拉伸框，只有源坐标落在该框内的点叠加 Lx 差值。
子联动框外的下游段不会被自动带动。该规则用于避免左侧子联动误作用到右侧模版或同一料的其他分段。
先执行母联动，再在映射结果上叠加子联动位移。子联动框只负责自己的 Lx，不应拿来包住整根料。
只框住需要随 Lx 变化的孔圆、缺口顶点或线端点，并留少量余量；不要跨过相邻大青框，也不要把另一套模版的实体包进来。框内端点移动、框外端点固定，才是 AutoCAD STRETCH 的预期语义。
标准流程
- 1
识别模版
框选大青框、小青框、洋红线、表格文字和需要参与生成的几何。
- 2
校正拉伸区
在拉伸区域编辑器中核对母联动区域；存在 L1、L2 等局部尺寸时，逐个核对子联动框。
- 3
审阅字段
检查款式、客户名、订单号、颜色、长度、数量、公式和检料表归属。
- 4
导出表格
导出 Excel 后填写订单数据。不要改列名、隐藏结构或模版标识。
- 5
导入生成
导入表格，程序克隆模版、执行母联动和子联动、替换字段、同步检料表并横向排版。
- 6
逐单抽查
重点检查总长、Lx 局部尺寸、孔位/缺口、检料表数量以及相邻模版是否串联。
检料表规则
批量联动与物料审阅共用检料表匹配语义：可以识别表格行、已有“长度=数量”明细，也可以只依靠物料名称锚点。没有占位符时会在名称下方补真实明细；备注中的“总数x支”按整批上下文汇总。
导入生成前必须确认
- 所有模版都显示正确名称、长度公式和数量字段。
- 每个 Lx 都能找到尺寸标注和有效拉伸区。
- 编辑器叠加框没有跨到相邻模版。
- Excel 的固定列名、模版标识和导出结构没有被删除。
ZK UNFOLD & NOTCH
ZK 展开与开缺
ZKK 先分析闭合钣金截面的外壁并计算展开段列，再进入普通展开或开缺分支。开缺不是只按一个基点做“第三投影”，而是由基点、开缺料真实轮廓、有限行径线和截面外壁共同计算。
当前开缺定位逻辑
必须是闭合多段线，可以是矩形、三角形或其他形状；程序读取真实顶点，不把它写死成固定模板。
用户在开缺料上点选第一投影角。程序会把点击位置吸附到开缺料最近顶点，并把它作为投影原点。
必须是 LINE 或多段线。只使用行径线的真实有限区间，不会把末端自动延长一个模板长度。多段拐角会逐段计算。
有效缺口先命中截面外壁，再换算成展开段列的累计长度位置，因此行径线指向错误的截面边时，展开位置也会错误。
总扣减值在缺口两端各分摊一半。
当前实现只在深度方向增加 0.3mm，且每处缺口只加一次；宽度方向不加该余量。
操作步骤
- 1
选择截面
运行 ZKK，选择一条闭合 LWPOLYLINE 或 POLYLINE 作为钣金截面。
- 2
输入参数
确认板厚和扣减值。扣减值是总扣减，开缺计算时会按两端各一半分摊。
- 3
选择分支
输入 Z 只做展开；输入 K 进入开缺。K 分支会先绘制展开闭合矩形。
- 4
选择方式
单线开缺适合一次处理一条行径线；多线开缺可连续追加多个上、下或上下开缺。
- 5
提供定位
选择闭合开缺料，在开缺料上点第一投影角作为基点，再选择有限长度的开缺行径线。
- 6
确定方向
选择上开缺 S、下开缺 X 或上下开缺 Q；生成后核对宽、深、端部和总展开长度。
单线模式：开缺料 → 基点 → 悬停预览并选择行径线 → 上/下/上下方向。多线模式：每轮选择开缺料 → 方向 → 基点 → 行径线，然后可继续添加下一处开缺。
人工复核重点
- 展开总长和各段一位小数是否与截面一致。
- 行径线实际命中的截面边是否就是目标侧面。
- 上、下开缺方向是否正确，首尾端部是否被当作中间开缺。
- 多段行径线的每个转角是否都产生了合理区域。
- 命令行打印的每处“宽、深”是否符合下料要求。
视频补充ZK 展开与开缺完整操作展开
视频只用于辅助理解。实际操作顺序和当前规则以本页文字说明为准。
UPDATE & RELOAD
更新与重载
HALOURELOAD 能更新什么
Halou 采用 Host、Contract、Payload 三层结构。Host 常驻 AutoCAD，业务逻辑位于可替换的 Payload。下载新 Payload 后执行 HALOURELOAD，可以在不关闭 CAD 的情况下切换业务版本；失败时加载器会尝试回退到上次可用版本。
HALOURELOAD 只替换 Payload 和解压资源，不会清除 AutoCAD LISP 引擎中已经定义的旧函数。更新 ZK、KB、BZ、JT、OLE、CL 后，应重新点击 Halou 面板对应功能按钮触发 load；仍异常时重启 AutoCAD。
版本与功能清单
“当前版本”是本机已经加载的 Payload；“最新版本”来自授权服务。功能列表还受账号授权和插件清单影响。登录成功并不等于所有功能都获准使用。
TROUBLESHOOTING
常见问题
01审阅提示没有识别到模版+
检查是否同时存在青色闭合大框、框内小青框，以及小青框下方约 5mm、与其横向重叠的洋红线。
02物料名下面没有“长度=数量”+
当前逻辑允许检料表只有物料名称。名称必须在框选范围内且能与模版物料名匹配；若名称下已有归属明细则不会重复新增。
03数量与检料表不一致+
数量按同名同规格汇总。检查是否混入相邻订单、同名不同规格，或检料表备注“总数x支”不是可识别文字。
04批量联动带动了相邻模版+
先检查子联动框是否跨过大青框或覆盖了邻图实体。子联动只应框住需要随 Lx 移动的孔位、缺口端点或线端点。
05批量生成后局部孔位不跟随+
对应 Lx 子联动框没有覆盖该孔位/端点，或 Lx 尺寸标注未被识别。回到评审窗口重新框选子联动区域。
06ZK 开缺位置偏移+
不要只看基点。当前定位由基点、开缺料投影和有限行径线共同决定；行径线方向或投影视图不对应时，结果会落到错误截面边。
07提示 no function definition: C:ZKK+
Payload 已更新但 AutoCAD 内存中的 LISP 尚未重载。重新点击 Halou 面板里的 ZK 功能按钮触发加载，或重启 AutoCAD。
08登录成功但功能列表为空+
先点“刷新清单”；仍为空时重新登录。若只有个别功能缺失，需要检查该账号是否获准使用对应功能。