Import CAD projects and cad-router v1

2026-07-22 19:38:36 +08:00
parent e4e0199bd5
commit af9f630c11
2253 changed files with 1994207 additions and 0 deletions
@@ -0,0 +1,12 @@
+# CAD Viewer Development
+
+Use this reference only when the user asks to modify, debug, or iterate on CAD
+Viewer source.
+
+CAD Viewer source development happens in the root
+source workspace, not inside this generated skill runtime.
+
+If you are not currently working directly in the editable source workspace, ask
+the user for the correct checkout and run the agent from that repository.
+
+Once inside the repository, read root `AGENTS.md` for guidance on modifying and running the Viewer.
@@ -0,0 +1,29 @@
+# MoveIt2 Server
+
+Load this only when the user specifically needs CAD Viewer's optional SRDF IK or path-planning controls. Plain SRDF review and normal Viewer links do not require MoveIt2.
+
+## Start
+
+Run from the `cad-viewer` skill directory:
+
+```bash
+npm --prefix scripts/viewer run moveit2:setup
+npm --prefix scripts/viewer run moveit2:check
+npm --prefix scripts/viewer run moveit2:serve
+```
+
+The server defaults to `ws://127.0.0.1:8765/ws`. CAD Viewer connects to that URL when `VIEWER_MOVEIT2_WS_URL` or the browser `?moveit2Ws=` query points at it.
+
+Use the configured ROS 2 / MoveIt2 environment. Do not install ROS 2 or MoveIt2 packages into the repository CAD `.venv`.
+
+## Viewer Controls
+
+Open an `.srdf` file, expand the right-side `MoveIt2` sheet, and use:
+
+- Status: linked SRDF and MoveIt2 server status.
+- Target: planning group, end effector, target frame, and X/Y/Z target coordinates.
+- Solver: IK timeout, attempts, and tolerance.
+- Planning: pipeline, planner ID, plan time, velocity scale, and acceleration scale.
+- Actions: select pose from the model, reset to the current pose, solve pose, or plan to pose.
+
+Report whether the environment check passed, whether pose solving/planning worked, and any viewer/server error text.
@@ -0,0 +1,22 @@
+# CAD Viewer Features
+
+Load this only when a task needs Viewer file-support details or UI control guidance.
+
+## Supported Files
+
+- `.step`, `.stp`: STEP/STP review through hidden GLB sidecars; supports assembly trees, part hide/show, inspect/focus, face/edge/vertex/part selection, copied `#...` CAD references, display modes, clip planes, and optional STEP module parameters/animations when a sidecar module exists.
+- `.stl`, `.3mf`, `.glb`: mesh viewing with orbit/pan/zoom, screenshots, appearance controls, and solid/wireframe display where available.
+- `.dxf`: read-only flat-pattern viewing, plus plate thickness and bend direction/angle controls when bend preview data is available.
+- `.gcode`: diagnostic toolpath preview; shows layer-colored extrusion ribbons, optional travel moves, visible-layer and detail controls, feature markers, movement stats, bounds, and parser warnings. It does not reslice, simulate firmware, or replace G-code validation.
+- `.urdf`: robot link/mesh viewing with movable joint sliders, reset pose, and copied joint values.
+- `.srdf`: linked-URDF viewing with planning groups, group-state presets, joint controls, and optional MoveIt2 IK/planning controls.
+- `.sdf`: SDF model/world viewing with metadata, counts, warnings, and joint controls when available.
+
+## Controls
+
+- Navigation: left-drag to orbit, right/middle-drag to pan, wheel or pinch to zoom, and Arrow/WASD keys to orbit. Use the view sphere for top/bottom/front/back/left/right views; click its center for the default isometric view.
+- File browser: toggle the left CAD Viewer sidebar, search files/ids/paths, expand folders, select entries, or switch files from the breadcrumb menus.
+- Floating toolbar: `Select` copies STEP topology references, `Draw` opens annotation tools, `Select Pose` appears for robot target picking when available, `Open orbit preview` starts an auto-rotating preview, and the copy/download buttons capture screenshots.
+- Drawing tools: freehand, line, arrow, expand, rectangle, circle, fill, erase, undo, redo, and clear.
+- File sheet: open the right sheet for file-specific controls such as STEP tree/parameters, G-code layers/detail/travel, DXF thickness/bends, URDF/SRDF/SDF joints and metadata, plus display and appearance controls.
+- Display/appearance: use the file sheet and theme menu for solid/wireframe/x-ray modes, STEP clipping, an independent Explode toggle for animated vertical STEP disassembly, surface colors, edge visibility/detail, highlight styling, backdrop, floor/grid, lighting, theme presets, and color mode.