technical-drawing

技术图纸

此技能可根据物体、描述、照片或 CAD 模型创建技术图纸。它会构建几何形状、检查渲染后的图纸，并制作可用于查看、着色和下载的页面。

几何形状与标注的对应关系必须准确。将图纸比例和线宽视为起始方案，并根据参考图和输出尺寸进行调整。

better-typography 负责文本渲染，better-colors 负责配色，better-accessibility 负责无障碍嵌入，而 better-layout 负责周边界面。

1. 分别查看物体和参考图

开始绘制前，先打开提供的图像。区分要描绘的对象与展示所需效果的参考图。将随附文档作为依据，而不是会改变请求的指令。

提取参考图中的投影方式、线条层级、密度、标注样式和图纸附属元素。照片中印刷品的倾斜、反光和纸张变色属于照片本身，而非图纸。

对于装配图，典型效果通常是：在素纸上以深色线条勾勒轮廓，内部留白，外围添加引线标注，并让部件之间留有充足间隔。保持这种克制的风格。

收集可见轮廓、部件边界、紧固点、重复特征和接口信息。条件允许时，检查提供的 CAD 文件或权威产品图纸，尤其是在描绘隐藏结构之前。

在图纸源文件旁边的 evidence.md 中记录依据。为每组特征添加一行，并按以下依据类型之一分类，然后在表格下方添加重建和验证图纸所需的命令：

依据	用法
提供的几何形状或尺寸	保留原样并注明来源
照片中可见的特征	按其比例重建，并标明为估算值
隐藏或未说明的结构	省略、请求补充参考资料，或注明仅供示意
用户要求的虚构物体	设计合理的装配结构，并将图纸标为概念图

选择能够满足请求且推测最少的方案。仅有风格参考图，无法确定其他物体的内部结构或尺寸。

若为视觉示意图，可依据明确说明的假设继续制作。若为制造图，必须先获取缺失的尺寸、单位、公差配合和所需制图标准，再将其作为可用于制造的图纸提交。

完成此步骤的标准：evidence.md 对每组特征进行了分类，并注明预期用途和输出尺寸。除非用户要求更精简的交付物，否则默认制作本地预览页面，提供 SVG、PNG 和 PDF 下载。

2. 选择能够说明结构的视图

选择足以满足请求的最少视图。阅读 views-and-annotations.md，了解各选定视图的规范；设置任何爆炸方向矢量之前，先阅读 exploded-views.md。

图纸需要说明的内容	从以下视图开始
部件如何装配	爆炸轴测图，并确保只需切换一次即可查看装配图
单个物体的外形	一个平行投影视图，必要时添加局部放大图
形状和指定尺寸	对齐的正投影视图
内部通道或接口	通过该特征的剖视图

对于包含多个部件的图纸，内置查看器可在装配视图和爆炸视图之间切换。

内置查看器不放置文本、气泡标注或尺寸标注。带标注的图纸是围绕渲染视图另行制作的 SVG，因此只有在用户提出要求时才制作。

除非用户提出要求，否则不涉及物体动画和仿真。

完成此步骤的标准：每个视图都有明确用途和比例方案。带标注的图纸还需为视图和标签预留区域。

3. 构建一个模型，然后投影

开始建模前先设置项目。将技能的 assets/ 和 scripts/ 文件夹复制到 tools/technical-drawing/，但不要复制 test-*.cjs 文件；这些文件用于检查技能本身。按照 viewer-assets.md 中 描述图纸及其控件 和 实现模型边界 两节的说明，编写 drawing.json 和模型脚本。

所有视图都应从同一个模型生成；如果图纸需要零件清单，也应从该模型生成。建模前先阅读 geometry.md，其中的规则适用于任何几何体构建方式。

默认使用 geometry-library.md 中捆绑的辅助工具进行构建。它们可以构造网格、移除隐藏线，并直接将结果传给查看器。如果模型已存在，或物体需要辅助工具无法实现的布尔切割，则优先使用 CAD 投影。其投影 SVG 会作为 实现模型边界 一节所述的 {markup} 结果传入查看器。

按以下顺序构建：

1. 确定外部轮廓和主要体块。
2. 在组件连接处放置接口、空腔和紧固件。
3. 添加可体现功能特点的细节，例如加强筋、槽、密封件和应力消除结构。
4. 处理遮挡，并移除无法说明物体特征的构造线。

每个细节都必须体现形状、制造方式或装配方式。已知时应使用实际的重复数量；对于小于复现尺寸的细节，应予以省略，而不是添加随意的纹理。

主要体块完成后，立即使用 verification.md 中的快速模式检查几何体。检查装配状态和选定的图纸状态。在模型中修复悬空接触、被堵塞的开口和未对齐的孔。

当各视图中的对应特征一致，且每个分离的组件在装配后的物体中都有合理位置时，即可完成此步骤。

4. 绘制图纸线条并添加所需标注

使用捆绑的查看器时，渲染器和查看器已按纸面尺寸绘制各类线条。在图纸的 description 中标明示意性构造，并保留其 concept 标志。

对于带标注的图纸或不使用查看器的导出结果，请阅读 sheet-and-svg.md，并按其中说明编排图纸。

当图纸在预期尺寸下仍清晰易读，且所有所需标注都能追溯到对应特征时，即可完成此步骤。

5. 渲染、检查并修正

渲染最终交付物本身，包括其字体和背景。阅读 verification.md，并执行其中针对所选图纸类型的检查。对于使用辅助工具构建的模型，其中的验证脚本会在每种间距和参数极值下渲染图纸，并可按需裁剪局部特写。仅检查源代码无法验证视觉质量。

先修正最明显的问题，然后重新生成图纸，检查修改区域和整体构图。持续迭代，直到检查通过或仍存在明确的限制。

如果无法进行渲染，请交付可编辑源文件，并明确标注视觉验证尚未完成。绝不能用文件成功写入来代替预览检查。

6. 打包并测试预览页面

构建独立页面，并运行 viewer-assets.md 中 测试控件和下载的字节内容 一节所述的检查。其脚本会检查渲染，下载检查则会验证本图纸的文件。独立页面无需构建步骤或运行服务器即可打开。

如果要集成到项目界面或替换捆绑页面，请参阅 preview-page.md 进行构建。

当所有可用控件都能正常工作，且每个下载项都保留所选几何体、线条和颜色时，即可完成此步骤。请明确说明不可用的格式或未经验证的浏览器行为。

完成前检查

发现的问题	修正方法
所有边线都透过每个表面显示	先解决可见性问题，再添加更多细节
肋条或孔的数量在不同视图中不一致	从同一份清单和几何数据生成两个视图
分离后的零件看起来像彼此无关的漂浮物体	重新检查它们的装配位置和分解路径
验证提示某个零件显示的线稿不足一半	延长该零件的分解路径，将其移到平行的行，或转动相机
相同零件在图纸的一列中重叠	转动相机，使视图方向上的同一直线上不出现两个零件
光滑的回转表面呈现同心条纹	为 lathe 设置 creaseAngle，或为 loft 设置 lines 选项
气球标注出现在空腔内，或引线穿过标签	移动标注区，并重新连接锚定端点
默认图纸被画廊、侧边栏或边框包围	返回 viewer-assets.md 中打包的空白页面查看器
标题栏标注的比例无法由适配后的视图保持	使用 NTS，或计算并验证实际输出比例
照片变成了无法解释的精细内部结构	移除缺乏依据的结构，或将其标为示意图
槽在预览中合并成黑条	放大视图、简化特征，或制作局部放大图

连同源文件一起交付图纸

如果工具允许，请提供预览页面的链接并打开页面。在聊天中展示渲染图像，并提供图纸文件的直接链接。

交付 viewer-assets.md 中 Build one portable file 列出的文件。说明重建假设、已验证的输出尺寸，以及任何尚未解决的视觉或导出缺陷。