前言¶
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 模型的自动化流程，无需复杂的本地环境配置。对于需要批量处理平板零件图纸的开发者或工程师，该插件能显著提升工作效率。
