AI Skills
cad-viewer

cad-viewer

熱門

啟動或重複使用 CAD Viewer，並回傳用於檢視明確 CAD、隱式 CAD、機器人描述與 G-code 檔案的審查連結。當需要視覺化檢視 `.step`、`.stp`、`.implicit.js`、`.implicit.mjs`、`.glb`、`.stl`、`.3mf`、`.gcode`、`.dxf`、`.urdf`、`.srdf` 或 `.sdf` 檔案時使用，特別是在從 CAD、implicit-cad、G-code、URDF、SRDF 或 SDF 生成技能交接後。

8633星標
991分支
更新於 2026/7/11
獲取技能源代碼

相關技能

homelab-vlan-segmentation24萬orca-emulator-android5.6萬github-triage6.8萬
SKILL.md
唯讀
名稱
cad-viewer
描述

啟動或重複使用 CAD Viewer，並回傳用於檢視明確 CAD、隱式 CAD、機器人描述與 G-code 檔案的審查連結。當需要視覺化檢視 `.step`、`.stp`、`.implicit.js`、`.implicit.mjs`、`.glb`、`.stl`、`.3mf`、`.gcode`、`.dxf`、`.urdf`、`.srdf` 或 `.sdf` 檔案時使用，特別是在從 CAD、implicit-cad、G-code、URDF、SRDF 或 SDF 生成技能交接後。

CAD Viewer

來源：維護於 earthtojake/text-to-cad。
使用安裝在本機的技能檔案作為執行階段的唯一依據；儲存庫連結僅供來源追溯與版本審查。

使用此技能在 CAD Viewer 中開啟現有或新產生的 CAD、隱式 CAD、機器人描述、DXF 或一般 FDM G-code 檔案，並回傳即時審查連結。預期輸入為一個或多個明確的檔案路徑。

啟動 Viewer

使用 npm run agent:start 啟動或重複使用一個本機 CAD Viewer，並傳入絕對的成品目錄作為 --dir。agent:start 啟動器負責連接埠選擇、相容伺服器重複使用、目錄啟用以及 ?dir= 查詢參數。開發模式下的 Viewer 僅在 git 身份匹配時重複使用；發行版 Viewer 可在 viewer 版本匹配時跨 git 分支重複使用。它透過 Viewer 的輕量目錄啟用 API 來啟用重複使用的伺服器，無需代理程式手動探測連接埠或觸發目錄掃描。直接使用 agent:start 輸出的 Viewer URL，然後僅為您要審查的成品加上 file= 查詢值。

選擇 --dir 為包含模型成品與 sidecar 檔案的絕對目錄，通常是 <repo>/models 或使用專案的等效模型目錄。file= 的值必須相對於該 --dir。請勿手動選擇連接埠、探測伺服器、重寫 ?dir=，或為了切換目錄而啟動獨立的 Viewer。

從此技能目錄執行：

npm --prefix scripts/viewer run agent:start -- --host 127.0.0.1 --dir <absolute-model-root>

使用輸出的 Viewer URL 並附加 file=：

http://127.0.0.1:<printed-port>/?dir=/absolute/project/models&file=path/to/model.step

如果非 Viewer 程序或其他工作目錄的 Viewer 佔用了候選連接埠，啟動器會自動繼續。在沙盒代理環境中，本機綁定或探測失敗（例如 EPERM 或 EACCES）是預期情況；請以所需權限/權限提升重新執行相同指令。

連結

  • 在回傳任何 file= 連結之前，請解析 <dir>/<file> 並確認成品存在。傳遞產生的成品（例如 .step），而非其生成來源（例如 .py）。如果解析路徑不存在，請勿回傳連結，而是回報問題並指向正確的產生成品路徑。
  • 每個請求的檔案回傳一個 Viewer URL。
  • 每個絕對目錄 --dir 啟動/重複使用一次 Viewer，然後為每個請求的檔案附加 file=<path>。檔案路徑必須相對於 --dir。
  • 對於僅目錄的審查連結，回傳 agent:start 輸出的 URL，不加上 file=。
  • 除非使用者要求，否則請勿停止現有的 Viewer 伺服器。
  • 如果 Viewer 啟動失敗，請回報失敗，並繼續使用所屬技能的非 GUI 驗證或成品。

Claude Preview

Viewer 連接埠是動態的——在啟動時選定，且可能因工作目錄而異。若要與 Claude Preview 工具整合，請在 agent:start 指令中加入 --json：

npm --prefix scripts/viewer run agent:start -- --host 127.0.0.1 --dir <absolute-model-root> --json

啟動器會在人類可讀的行之後，將 JSON 結果行寫入標準輸出。透過取用標準輸出的最後一行以 { 開頭的行來解析：

{"url":"http://127.0.0.1:<port>/?dir=<absolute-model-root>","port":<port>,"action":"reuse"}

action 為 "reuse" 表示重複使用現有伺服器且已就緒，或 "start" 表示已啟動新伺服器程序且可能仍在初始化。對於 "start" 結果，請在基礎 URL（例如 http://127.0.0.1:<port>/__cad/server）上探測 GET /__cad/server，直到回傳 HTTP 200，再將 url 值傳遞給 Claude Preview 工具。

參考資料

  • 當使用者要求修改、除錯或迭代 CAD Viewer 原始碼時，請閱讀 references/development.md。
  • 當您需要支援的檔案類型、Viewer 控制項或檔案特定功能細節時，請閱讀 references/viewer-features.md。
  • 僅在使用者特別需要選用的 SRDF MoveIt2 IK 或路徑規劃控制項時，才閱讀 references/moveit2-server.md。