技術圖紙 是做什麼的？
圖紙是生成的，而非手繪：參數化的 build123d 模型（或 STEP 檔案）是
單一事實來源，scripts/drawlib.py 從中推導視圖（隱藏線移除、剖面、剖面線）
並添加車間所需的標註。每次儲存都會執行自動圖紙檢查。
結果是每個圖紙頁面生成一個向量 PDF（可選 DXF/SVG）以及一個 PNG
預覽圖，在您宣告完成之前必須先檢視。
為何選擇此路徑：視圖永遠不會與模型不一致，更改參數可重新生成 每個圖紙，且相同模型可免費提供 STEP 檔案和干涉檢查。
一份好的圖紙應達到的目標
圖紙是與製造和檢驗零件人員之間的契約。從未見過此專案的人 必須能僅憑圖紙就製造出該零件。這決定了以下所有事項：僅標註 功能 所需的尺寸，僅對重要部分進行公差標註，並說明每個功能表面 應有的樣貌。一張標註了所有邊緣尺寸但沒有配合、粗糙度或幾何公差的圖紙， 對於審查員和車間而言是無法製造的。
選擇路線
- 使用者有 STEP 檔案並希望快速獲得圖紙：執行
python scripts/step2drawing.py part.step [--section] [--lang en --projection third] [--units in] [--material ...] [--density ...] [--dxf]。它會提供視圖、隱藏線、中心 線、總體尺寸、標題欄和檢查結果。然後明確說明功能性 尺寸、配合、公差和表面紋理仍需添加 - 並提供添加它們的選項： 相同模組中的auto_drawing()返回(sheet, views, issues)，其中out=None，因此 您可以繼續在 Python 中對圖紙進行標註（對於 Y 向上匯出使用--up y）。 - 任何需要製造的零件：先在 Python 中對零件進行建模並編寫圖紙
（工作流程如下）。STEP 輸入仍可作為模型：使用
D.load_step(path)。
工作流程
- 首先釐清功能。 對於每個零件，詢問：哪些表面與什麼配合， 為了機器能運作，哪些必須同軸/垂直/平坦，哪些尺寸來自於 採購件（軸承、銷、螺絲）。這些將成為基準、配合和公差。如果 使用者有報告、物料清單或舊圖紙，請閱讀並保留其數值；將您 發明的每個值標記為您的假設並告知使用者。詢問圖紙使用的語言 和投影方法（預設：德語，第一角；北美：英語，第三角） 以及是否有公司標題欄。
- 在一個模組中對零件進行建模，每個零件處於其製造位置，所有
尺寸作為命名參數。車削件：旋轉半輪廓
(x, r)； 棱柱件：方塊減去孔實體，或擠出一個輪廓（無融合接縫）。僅將螺紋 建模為底孔。將採購/標準件放入為簡單實體，以便裝配和 干涉檢查完整。 - 在繪圖前檢查裝配：對所有零件進行兩兩
(a & b).volume檢查；每個 重疊必須為零或是刻意的（螺紋嚙合、壓配合）。修復模型，而非圖紙。 - 每個圖紙頁面編寫一個函數，複製
examples/中最接近的範例：flanged_bush.py（車削件，基本模板）、bearing_bracket.py（裝配， 零件清單）、stepped_shaft.py（斷裂視圖、細節、移除剖面、螺紋）、flange.py（半剖、節圓、位置公差）、spur_gear.py（齒輪數據 表）、weldment.py（焊接符號）、milled_block.py（英語、第三角、公司 標題欄）。先只處理幾何形狀，渲染，查看，然後分層添加標註： 中心線 -> 尺寸 -> 基準和公差 -> 表面紋理 -> 備註、表格 -> 標題欄。 - 渲染、閱讀檢查報告、查看每個頁面。
Sheet.save(pdf, png=...)列印 檢查報告並寫入<png>_check.png，其中每個發現都帶有框線。修正每個錯誤 和警告（移動標註、更改偏移量、tshift、tpos、引線的膝點）。然後 親自閱讀 PNG - 檢查能發現衝突和不一致，但無法發現 錯誤的尺寸標註概念或指向錯誤邊緣的箭頭。裁剪密集區域以進行 縮放。切勿報告您尚未查看過的圖紙為完成。 - 交付：按圖號命名的每個頁面一個 PDF，一個合併集（pypdf
PdfWriter.append），如果使用者在 CAD 中編輯則提供 DXF，每個零件 和裝配體的 STEP（export_step）。清楚說明哪些尚未繪製以及哪些值是假設。
每台機器設定一次：pip install -r requirements.txt。ISO 3098 字型 osifont 是
未捆綁的；它位於 $DRAWLIB_FONT、scripts/fonts/、~/.drawlib/fonts/ 或
系統字型中（參見 scripts/fonts/README.md）。沒有它，函式庫使用 DejaVu Sans -
幾何相同，但字體不符合 ISO 3098；檢查會測量當前啟用的任何字型。
使用 drawlib
在撰寫第一個圖紙之前閱讀 references/drawlib_api.md - 每個呼叫及其
座標慣例、配方和陷阱。要點如下：
S = D.Sheet("A4"|"A3"|"A2"|"A1"|"A0", lang="de"|"en", projection="first"|"third")。A4 是 縱向，其他為橫向（landscape=可覆蓋）。圖紙座標以公釐為單位，從 左下角開始。函式庫編寫的數字遵循該語言的小數點標記，且 尺寸文字內的小數點會被轉換（在德語圖紙上"0.02"->0,02）。V = D.View(S, origin, scale, *D.VIEWS["front"])-VIEWS包含 front、top、bottom、left、 right、rear、iso。V.p(u, v)將視圖座標（模型公釐）轉換為圖紙公釐 - 對於每個 標註都使用它。錯誤的向量會引發明確的錯誤；非 ISO 比例和上下顛倒的視圖會發出警告。- 視圖：
V.draw(solids, hidden=)、V.section([(V.cut(solid), angle, spacing), ...], background=[uncut parts])、V.half_section(...)、V.removed_section(...)、V.detail(centre, r, at, scale, "Z")、D.BrokenView(...)、V.thread(...)、D.views_layout(...)用於按投影方法放置。 - 尺寸：
S.hdim、S.vdim、S.dim、S.dim_angle、S.rdim、S.ddim；選項tol=、box=True、outside=True、half=True、tshift=。 - 配合：在文字中書寫它們（
"Ø20 H7"、"Ø20 H7/s6"）；S.fit_table、S.fit_pair_table列印 ISO 286 數值；iso_tolerances提供偏差、極限、配合、ISO 2768。 - GD&T：
S.datum、S.fcf(x, y, kind, "0.02", ["A", "B"])、S.fcf_leader。 - 表面：
S.rough、S.rough_leader、S.general_surface。 S.notes、S.leader_text、S.posnum、S.cutting_plane、S.bom、S.table、S.weld、S.pitch_circle、S.title_block(values, layout=json_or_dict, logo=png)。
影響品質的規則
以下是審查員和車間檢查的要點；references/normen.md 包含表格
（線型、ISO 2768 數值、常見配合、典型 Ra 值、哪種幾何公差
用於哪種功能），應在選擇數值時閱讀。
- 投影和視圖：說明方法（標題欄中的符號）。定義零件所需的最少 視圖；車削件需要一個沿其軸線的剖面。優先使用剖面而非隱藏線。 僅使用 ISO 5455 的比例；小零件應放大繪製，以便尺寸有空間； 長零件應斷開；小細節應有局部詳圖。
- 從功能基準標註尺寸，不要形成鏈，永遠不要重複。 輔助尺寸放在括號內。尺寸盡可能放在輪廓外部；孔陣列放在顯示它們為圓形的視圖中； 較小尺寸靠近零件。
- 配合和公差：每個配合直徑都應有 ISO 286 配合（軸承座按軸承製造商 建議）。所有未標註公差的部分都屬於標題欄中的一般公差 （預設為 ISO 2768-mK；焊接件為 ISO 13920）。
- 僅在功能需要時使用幾何公差，始終帶有本身是功能性的、可測量特徵的 基準。軸線上的基準：與該直徑的尺寸線對齊。引線垂直於 表面。孔陣列：理論正確尺寸加上位置公差。
- 每個功能表面都有表面紋理，一般值在標題欄旁出現一次。 符號必須從下方或從右側讀取 - 對於朝下的面使用引線。
- 剖面：在縱向剖面中，軸、銷、螺絲、鍵、滾動體和肋不應被剖切。
相鄰零件使用不同的剖面線；薄的剖切面應塗黑
（
angle="solid"）；剖面線會自動在文字周圍中斷。 - 螺紋（ISO 6410）、焊接（ISO 2553）、齒輪（ISO 2203）：簡化繪製， 透過註解或數據表承載資訊。
- 裝配圖：零件序號排成一行，引線末端帶點；零件清單在 標題欄上方，項目 1 在底部；標準件帶有其標準名稱；僅可 標註功能性和安裝尺寸；備註說明如何組裝和調整。
- 標題欄：標題、圖號、材料（含標準名稱）、質量
（
solid.volume× 密度）、比例、一般公差、日期、頁碼 m/n、文件類型、 版本。切勿留空材料或比例 - 檢查會標記它。
關於限制的誠實說明
- 輸出是 PDF/SVG/PNG/DXF 以及 STEP，而非原生的 SolidWorks/Inventor 圖紙。如需在 CAD 中 進一步編輯，請提供 DXF 和 STEP 並說明。
- 圖紙檢查可以發現衝突和不一致；它無法判斷
尺寸、公差或視圖選擇是否正確。這需要您根據
references/normen.md中的檢查清單 審查 PNG。 - 您選擇的公差值屬於工程建議。請說明哪些來自使用者的 文件，哪些是您自己的，以便他們能為其辯護。