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;可從倉庫頁面或社區目錄入口查看。
羽毛球分组比赛记分
小程序二维码

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

小夜