ManualFig 生成说明书线稿，先锁定视角与标注层级

ManualFig 出说明书线稿，返工通常不是线画错，而是同一批图视角不一致、标注混层，调一张比重新画还慢。稳妥顺序是：出图前把每张图归入主视图、剖视或局部放大，把视角方向、投影方式、线宽和标注层级写成一份配置，再用两张同源图验证参数是否落到输出文件，最后存成预设。结构成套的说明书插图适合这样做；自由透视、艺术化外观的图，视角是否锁死需结合出图目标确认。

ManualFig 线稿批量返工的两个源头通常是视角漂移和标注混层。建议先把画面按主视图、剖视、局部放大分类，把视角方向、投影方式、线宽写进同一份配置，再按零件名、尺寸、序号拆图层。批量前用两张同源图叠加比对，确认改动落到导出文件而不是只停在界面。该做法适合结构成套的说明书插图，自由透视类画面可放宽。

把要画的图拆成主视图、剖视、局部放大三类

先分类，再排清单。判断依据可以这样定：主视图承担整体外形和主要装配关系，通常是整机或组件第一眼能看懂的图；剖视承担内部结构、孔位、装配顺序中主视图看不穿的部分，必须有明确的剖切位置和观察方向；局部放大承担倒角、卡扣、密封圈、小间距等细节，必须有放大范围和引出关系。一张图里尽量不要同时承担两种视角，否则后期改标注会牵连线稿。

清单按章节排列，视角来源一栏就是后面写进配置的关键字，避免出图时临时决定。

章节: 3.2 驱动组件
图号      画面类型     表达重点           视角来源        标注层级
3.2-1    主视图       外形与装配关系     前视 + 等轴     零件名/序号
3.2-2    剖视         内部孔位与轴配合   全剖 A-A       尺寸/零件名
3.2-3    局部放大     密封圈安装间隙     局部 B / 2:1   尺寸/公差
备注: 同一零件跨图时沿用同一视角参数与图层前缀

在同一次出图里固定视角参数，而不是逐张手调

同一批插图最怕逐张手调视角。做法是在一次出图任务里用同一份视角配置，让所有主视图共享一组方向参数，所有剖视共享另一组。ManualFig 的具体字段名可能随版本或配置方式不同，下面是一份通用骨架，字段需要按实际工具替换。

project: manual-3.2
units: mm
line:
  width: 0.35
  hidden: dashed
view:
  type: orthographic      # orthographic | isometric
  azimuth: 45
  elevation: 35
  zoom: 1.0
  fit: selection
section:
  plane: A-A
  direction: +Z
  hatch: section_hatch
export:
  format: svg
  layers: true

等轴写法就把 type 设为 isometric，正投影保持 orthographic；多张图共用同一视角时，把这段单独存成 view.yaml 或预设文件，出图时引用，而不是在每张图的界面里重选。比对两次出图差异，先固定同一零件、同一视角，只改一个参数，导出两份带版本后缀的文件，再用叠加或差异方式看偏移。

# 记录配置指纹，确认两次出图引用的是否同一份参数
sha256sum view.yaml > view.sha
# 叠加比对，差异区域会被标出
compare -compose src-over base_v1.png base_v2.png diff.png

这里的 compare 是通用图像比对做法，替换成所在环境可用的差异工具即可。看差异时先看轮廓是否整体平移或旋转，再看线宽和隐藏线是否变化；如果两次出图只有标注文字位置不同，说明视角参数没变，问题在标注层。

按结构层级拆标注：零件名、尺寸、序号分放不同图层

标注不要和线稿混在一层。建议按结构层级拆：零件名、尺寸、序号气泡各占独立图层，引线单独一层，隐藏线和剖面线也分开。这样后期改标注只改对应图层，线稿不用重画。

layers:
  - view.outline          线稿轮廓
  - view.hidden           隐藏线
  - view.section_hatch    剖面线
  - anno.part_name        零件名称
  - anno.dimension        尺寸与公差
  - anno.balloon          序号气泡
  - anno.leader           引线
  - anno.note             说明文字

命名示例里用点分前缀，view 开头的是几何层，anno 开头的是标注层，导出时要求保留图层。导出后检查是否真的分离，可以按下面的顺序做：

用支持图层的查看器打开导出的 SVG 或 PDF，看图层面板是否出现上述名称；
检查 SVG 时直接看 g 标签的 id，确认每个标注组没有被合并成一个组；
临时隐藏 anno.dimension，看尺寸是否消失而线稿保留；
隐藏 view.hidden，确认隐藏线单独可控；
若导出格式不支持图层，改选支持图层的格式，或保留源文件用于后续修改。

如果图层检查发现标注和线稿在同一组，先解决导出设置，不要继续批量出图。

用两张同源图验证改动是否真的生效

参数改完，界面预览正常不代表导出文件也正常。用两张同源图验证：选同一个零件、同一个画面类型，第一次用旧参数导出作为基准，第二次只改一个参数导出作为对照。把两张线稿按同一画布叠加，看轮廓是否出现偏移、线宽是否变化、隐藏线是否按预期显示。

# 叠加做法示意，具体命令按环境替换
composite base_v1.png test_v2.png overlay.png
# 或用差异图定位偏移方向
compare -highlight-color red base_v1.png test_v2.png diff.png

改动记录建议按表保存，出问题时能回看是哪一步没生效：

参数名          改动前     改动后      输出文件      验证方式        是否生效
azimuth         30         45          test_v2.svg   叠加看轮廓       是
line.width      0.25       0.35        test_v2.svg   放大看线宽       待确认
hidden          隐藏       虚线        test_v2.svg   隐藏层开关       否
anno.dimension  默认层     独立层      test_v2.svg   图层面板         是

标成否或待确认的项，说明改动只停在界面或没落到输出文件，先回到配置或导出设置里查，不要带着未确认的参数批量出图。验证时只改一个参数，改多项会分不清哪一项导致差异。

把定好的参数存成可复用预设

一套参数验证通过后，存成预设，下一批图直接套用。预设至少要包含这些字段：投影方式、视角方向、缩放与适配范围、线宽与隐藏线样式、剖面线样式、图层命名结构、标注默认样式、单位与比例、导出格式与是否保留图层。字段名按 ManualFig 实际配置替换，但内容不要缺项。

preset:
  name: manual-view-standard
  view: {type: orthographic, azimuth: 45, elevation: 35, zoom: 1.0}
  line: {width: 0.35, hidden: dashed}
  section: {hatch: section_hatch}
  layers: [view.outline, view.hidden, anno.part_name, anno.dimension, anno.balloon]
  unit: mm
  export: {format: svg, layers: true}

恢复预设后要复现验证，不要只看界面有没有变。步骤是：新建一个空任务，应用预设，用之前验证过的测试零件重新出图，再和基准图做叠加比对，并打开图层面板确认标注层仍然分离。如果复现图与基准图在轮廓和图层结构上一致，预设就可以用于下一批图；如果出现偏移或图层合并，说明预设字段有缺失，先补齐再使用。

边界也要说清楚：这套做法适合结构成套、视角可标准化的说明书线稿。不同版本 ManualFig 的字段名和导出选项可能有差异，配置骨架需要结合当前环境确认后再落地；自由透视或需要艺术化表达的插图，不必强行锁死全部视角参数。