前言¶
DSH 的插件生態強調“一切皆插件”。在 CAD 圖紙審查裏,如果只依賴截圖或人工經驗,問題定位容易缺少證據,重複運行時結果也可能不一致。dsh-cad-review 把檢查對象落到 ASCII DXF 實體:先讀取實體,再按項目自有策略執行確定性規則檢查,並把問題關聯到實體、圖層、源文件行範圍和幾何位置。
這是什麼¶
dsh-cad-review 是 DeepSeek Harness 插件,由 dongsheng123132 維護,許可證爲 MIT。它用於 ASCII DXF 的實體級檢查和確定性 CAD 規則審查。
它不從事截圖推斷工程缺陷。它讀取 CAD 實體,哈希源圖紙,並輸出與實體位置、圖層、源文件行範圍和幾何位置相關的問題證據。
核心功能¶
實體與證據¶
- 讀取 CAD 實體,並對源圖紙做哈希。
- 支持
LINE、LWPOLYLINE、CIRCLE、ARC、TEXT、MTEXT、POINT、INSERT幾何。 - 問題輸出會關聯到實體
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_inlinecad_dxf_review_inline
MCP 服務不能讀取文件、訪問網絡、執行圖紙內容、啓動子進程或寫產物。
CLI¶
dsh-cad-review inspectdsh-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
項目策略配置¶
支持項目自有策略配置,包括:
workspaceRootmaxBytesrequiredLayersforbiddenLayersforbiddenEntityTypesrequireClosedPolylinesminTextHeightmaxDrawingSpanrequiredInsUnitsmaxEntitiesmaxIssues
安裝與啓用¶
先安裝插件:
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;可從倉庫頁面或社區目錄入口查看。