dsh-cad-review:面向 DeepSeek Harness 的 ASCII DXF 检查与确定性规则审查

前言

DSH 的插件生态强调“一切皆插件”。在 CAD 图纸审查里,如果只依赖截图或人工经验,问题定位容易缺少证据,重复运行时结果也可能不一致。dsh-cad-review 把检查对象落到 ASCII DXF 实体:先读取实体,再按项目自有策略执行确定性规则检查,并把问题关联到实体、图层、源文件行范围和几何位置。

这是什么

dsh-cad-review 是 DeepSeek Harness 插件,由 dongsheng123132 维护,许可证为 MIT。它用于 ASCII DXF 的实体级检查和确定性 CAD 规则审查。

它不从事截图推断工程缺陷。它读取 CAD 实体,哈希源图纸,并输出与实体位置、图层、源文件行范围和几何位置相关的问题证据。

核心功能

实体与证据

  • 读取 CAD 实体,并对源图纸做哈希。
  • 支持 LINELWPOLYLINECIRCLEARCTEXTMTEXTPOINTINSERT 几何。
  • 问题输出会关联到实体 handle/index、图层、源文件行范围和几何位置。
  • TEXT/MTEXT 正文以及 malformed numeric tokens 仅以 SHA-256 和长度表示。

DSH 工具

  • dsh_cad_inspect_dxf:返回源文件 SHA-256、单位、边界、图层、实体计数和精确的实体几何/行证据。
  • dsh_cad_review_dxf:返回同样证据,并附加确定性策略报告;可按调用传入 policyJson 覆盖已配置策略。

MCP 暴露

.mcp.json 暴露:

  • cad_dxf_inspect_inline
  • cad_dxf_review_inline

MCP 服务不能读取文件、访问网络、执行图纸内容、启动子进程或写产物。

CLI

  • dsh-cad-review inspect
  • dsh-cad-review review

确定性规则

规则检查覆盖:

  • malformed numbers
  • zero-length lines
  • non-positive radii
  • polyline closure
  • exact duplicate geometry
  • required/forbidden layers
  • forbidden entity types
  • text height
  • units
  • drawing span
  • entity limits

项目策略配置

支持项目自有策略配置,包括:

  • workspaceRoot
  • maxBytes
  • requiredLayers
  • forbiddenLayers
  • forbiddenEntityTypes
  • requireClosedPolylines
  • minTextHeight
  • maxDrawingSpan
  • requiredInsUnits
  • maxEntities
  • maxIssues

安装与启用

先安装插件:

dsh plugin --profile <name> add github:dongsheng123132/dsh-cad-review

插件要求 Node.js >=22

安装后,配置工作区根目录和项目策略。路径必须是相对于 workspaceRoot.dxf 文件。

典型用法

下面示例来自文档给出的可复现用法。

检查单个 DXF 文件

运行:

dsh-cad-review inspect drawing.dxf

这一步返回检查证据,用于查看源文件哈希、单位、边界、图层、实体计数和实体级证据。

使用项目策略审查

运行:

dsh-cad-review review drawing.dxf --policy examples/strict-mm-policy.json

经过上面的步骤,如果存在 error-severity 问题,review 会以退出码 2 结束。

在 DSH 中调用工具

  • 调用 dsh_cad_inspect_dxf 获取检查证据。
  • 调用 dsh_cad_review_dxf 获取检查证据和确定性策略报告;可按调用传入 policyJson 覆盖已配置策略。

本地验证

文档给出以下验证命令:

npm test
npm run check
npm run smoke:plugin
npm run smoke:mcp
npm run smoke:cli
DSH_CHECKOUT=/path/to/deepseek-harness npm run smoke:dsh

适用场景与注意

适合:

  • 在 DSH 插件或 CLI 中处理 ASCII DXF 实体检查。
  • 需要把问题定位到实体、图层、源文件行范围和几何位置。
  • 需要按项目策略执行确定性规则审查。
  • 使用 Node.js >=22 环境,并接受 MIT 许可证。

不适合:

  • 需要从截图推断工程缺陷。
  • 需要处理 Binary DXF 或 DWG;这些格式会被拒绝,而不是猜测。
  • 需要把通过报告当作专业工程审批;通过报告只表示当前确定性策略未找到 error。
  • 需要通用建筑、机械或电气规范判断;规则是项目自有,不声明为通用规范。

使用限制:

  • 源文件 SHA-256 标识被审查的精确字节,不证明作者身份。
  • 不支持的实体类型会使提取不完整,并会显式保留在报告中。
  • 路径访问会拒绝 traversal、symlink escape、binary DXF 和 oversized input。
  • 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。
  • 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,不应理解为官方应用商店。

结尾

dsh-cad-review 的价值是把 ASCII DXF 审查从“看图”落到“读实体、查规则、给证据”。它适合在 DSH 插件生态中作为确定性的 CAD 规则证据层使用。

  • GitHub 链接:https://github.com/dongsheng123132/dsh-cad-review
  • 目录页:未提供已核实的独立 URL;可从仓库页面或社区目录入口查看。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜