前言¶
DeepSeek Harness（DSH）插件生態允許通過插件擴展功能。在模型推理和工程工具鏈中，將 2D 工程圖紙（特別是平板零件）轉換爲 3D 模型通常需要繁瑣的手工建模或編寫複雜的腳本。dsh-noBS-CAD-step 插件旨在解決這一問題，它利用 noBS CAD 引擎，自動將 2D 平板圖紙處理爲可執行的腳本和 STEP 文件。
核心能力¶
該插件註冊了核心 Skill 和五個工具，覆蓋從圖紙讀取到模型驗證的全流程。
Skill：nobs-cad-step¶
這是針對平板零件的標準工作流。它包含以下步驟：
* Sheet survey（板材清單）
* Callout inventory（孔位清單）
* Corner-origin frame（角點原點框架）
* Chain arithmetic（鏈式運算）
* Verification（驗證）
工具集¶
插件提供了五個工具來驅動 noBS CAD 引擎和圖紙：
nbcad_run_script(script_path, step_path)
在空白文檔中運行.nbcad.jsonc腳本，導出 STEP 文件。返回引擎的特徵摘要和警告（如未使用的綁定、重疊孔位、孔位偏離主體等）。nbcad_inspect_step(step_path)
重新導入 STEP 文件並返回特徵摘要，用於驗證導出結果。nbcad_check(step_path, expected, tolerance_mm?)
通過引擎比較模型特徵表與 STEP 文件：找出匹配、缺失或額外的孔位，計算孔位偏移量和邊界框。nbcad_print_probe(action, print_path, ...)
原生像素工具包（Rust 實現，已打包爲二進制文件）。它直接讀取 PDF、PNG 和 JPG 圖紙。支持渲染、校準、裁剪（帶毫米網格）、環評分和符號識別。渲染結果會被緩存。nbcad_overlay_print(print_path, step_path, out_png, length_mm, width_mm, region?, dpi?)
將模型孔位繪製在打印的平面視圖上（支持全板或毫米窗口的高分辨率裁剪），便於人工覈對。
Web UI 面板：2D → 3D¶
在 web 配置文件下，插件會在側邊欄添加一個 2D → 3D 面板。該面板每兩秒刷新一次，顯示 noBS CAD 引擎狀態、桌面會話心跳以及本地打印探針二進制是否存在。面板支持上傳打印文件（PDF/PNG/JPG），啓動會話，並保存生成的 STEP 文件和報告。
安裝與依賴¶
- DSH 版本：0.1.5 到 0.2.0（包含預發佈版本）。
- Node.js：22 或更高版本。
- noBS CAD：需要安裝 noBS CAD 應用，並啓用 MCP stdio 接口（啓動時需加
--headless標誌）。引擎版本需爲 0.2.1 或更新。 - 環境要求：不需要 Python、Poppler 或 Rust 工具鏈。打印探針的二進制文件已針對 macOS、Linux 和 Windows 預打包。
重命名說明：該插件於 2026-09-28 從 dsh-nbcad-plate 重命名爲 dsh-nobs-cad-step。如果配置中引用了舊的插件 ID，需在配置覆蓋中重命名。
安裝命令：
dsh --profile nbcad --from-default-profile headless --dump-config
典型用法¶
插件通過函數調用和 Web 面板兩種方式使用：
- 命令行工具調用：
nbcad_run_script(script_path, step_path)
nbcad_inspect_step(step_path)
nbcad_check(step_path, expected, tolerance_mm)
nbcad_print_probe(action, print_path, ...)
- Web UI 操作：
在側邊欄打開 2D → 3D 面板，上傳打印文件，啓動會話，並在輸出目錄中保存 STEP 文件。
限制與注意事項¶
- 孔位識別範圍：
nbcad_run_script、nbcad_inspect_step和nbcad_check僅檢查垂直圓柱孔。半徑小於 0.3mm 的孔會被識別爲孔，但倒角孔、錐度孔、槽孔和斜孔均被忽略。引擎的錯誤在這些檢查中會表現出相同的特徵。 - 驗證依賴：模型的準確性最終依賴於打印本身。
ring-score、symbols和nbcad_overlay_print用於將模型與圖紙進行獨立對比。 - 網絡訪問：Web 路由綁定到
127.0.0.1，且每次啓動需要一個新的 secret token，確保本地單用戶環境的安全性。 - 插件源碼：插件爲純 JavaScript 加上預打包二進制，無需構建。安裝前建議檢查源碼與許可證（MIT）。
總結¶
dsh-noBS-CAD-step 提供了一套完整的從 2D 圖紙到 3D 模型的自動化流程，無需複雜的本地環境配置。對於需要批量處理平板零件圖紙的開發者或工程師，該插件能顯著提升工作效率。
