first commit

2026-07-17 17:45:56 +08:00
commit 04c487823b
5873 changed files with 12227228 additions and 0 deletions
@@ -0,0 +1,107 @@
+# Agent4
+
+Agent4 is a rebuilt learning and assessment platform for SolidWorks modeling and ANSYS simulation education.
+
+It separates the product into these roles:
+
+- Knowledge standards: standard answers, extracted skillflows, teaching scripts, and assessment rules.
+- Learning controller: teaching and testing sessions.
+- C# backend: learning/testing API, SolidWorks extraction orchestration, and method-sensitive grading.
+- Extractors: SolidWorks part and assembly feature extraction tools.
+- Grader: compares student extracted operations with standard answers.
+- Web workbench: teaching/testing UI.
+
+## Current Scope
+
+This first rebuild focuses on SolidWorks feature-process learning:
+
+1. Search standard answers from the reducer knowledge framework and local skillflow JSON files.
+2. Start a teaching session from a standard answer.
+3. Generate step voice text from the expected SolidWorks feature operation.
+4. Accept observed student steps or extract a submitted `.SLDPRT`.
+5. Compare feature method and core parameters.
+6. Start a testing session and produce a grade report.
+
+## Run Backend
+
+```powershell
+cd D:\CSharpProjects\agent3\agent4
+.\run_backend.ps1
+```
+
+Backend URL:
+
+```text
+http://127.0.0.1:7200
+```
+
+The default backend is now the C# API:
+
+```text
+backend-csharp/Agent4.Api
+```
+
+The earlier Python FastAPI backend remains as a fallback/reference and can be started with:
+
+```powershell
+.\run_backend_python.ps1
+```
+
+## Important APIs
+
+```text
+GET  /health
+GET  /api/standards?query=榻胯疆
+GET  /api/standards/{standard_id}
+POST /api/teaching/sessions
+POST /api/teaching/sessions/{session_id}/observations
+POST /api/teaching/sessions/{session_id}/audit-part
+POST /api/testing/sessions
+POST /api/testing/sessions/{session_id}/submit
+```
+
+## Extractor Tools
+
+The rebuilt project copies the existing extraction tools into:
+
+```text
+tools/modeling-process/PartFeatureAudit
+tools/modeling-process/AssemblyKnowledgeAudit
+```
+
+`PartFeatureAudit` is the core for method-sensitive judgment. It can distinguish feature methods such as boss extrude, cut extrude, shell, loft, sweep, hole wizard, mirror, fillet, chamfer, linear pattern, and circular pattern.
+
+## Import Standard Records
+
+Extracted records such as `*_modeling_plan.json`, `*_skill_flow.json`, and
+`*_skill_flow_validation.json` should be imported as standard-answer assets:
+
+```powershell
+cd D:\CSharpProjects\agent3
+.\.venv\Scripts\python.exe agent4\scripts\import_standard_records.py --source "D:\Desktop\鎻愬彇璁板綍" --target "D:\CSharpProjects\agent3\agent4\data\standards"
+```
+
+The importer copies records into categorized folders and writes:
+
+```text
+agent4/data/standards/manifest.json
+```
+
+The manifest is the main lookup index for teaching and testing. The raw JSON
+files remain the authority for executable and comparable feature traces.
+
+## Architecture Direction
+
+Agent4 should judge student work from extracted SolidWorks feature traces, not from UI button clicks.
+
+```text
+standard answer skillflow
+  -> expected feature trace
+student model or operation
+  -> extracted feature trace
+grader
+  -> teaching feedback or test score
+```
+
+Final geometry comparison is secondary. Feature method correctness is primary for teaching.
+