@zhouchangui/math-ati 0.1.0

package/server/grading.js

@@ -0,0 +1,116 @@
+import { callChatAgent, callVisionAgent } from './agentClient.js';
+import { promptPayload, readPrompt } from './promptStore.js';
+
+function gradingError(reason, detail = '') {
+  const error = new Error(`grading_failed:${reason}`);
+  error.status = 502;
+  error.reason = reason;
+  error.detail = detail;
+  return error;
+}
+
+export async function gradeSubmission({ practice, profile, files, notes }) {
+  const systemPrompt = await readPrompt('grading.system.md');
+  const agent = await callChatAgent({
+    timeoutMs: 60000,
+    system: systemPrompt,
+    user: promptPayload({
+      task: '根据练习卷题干、标准答案、知识点标签、上传照片文件信息和家长备注生成批改总结。练习 JSON 必须提供答案元数据；不能臆造看不清的手写内容。',
+      context: {
+        student: profile,
+        practice,
+        uploadedFiles: files.map((file) => ({
+          originalName: file.originalname,
+          storedName: file.filename,
+          path: file.path,
+          mimetype: file.mimetype,
+          size: file.size
+        })),
+        notes
+      },
+      schema: {
+        summary: 'string',
+        masterySignals: ['string'],
+        nextPracticeSuggestion: 'string',
+        grading: [
+          {
+            questionId: 'q1',
+            recognizedAnswer: 'string',
+            status: 'correct|partial|wrong|unrecognized|needs_review',
+            score: 0,
+            maxScore: 6,
+            errorTypes: ['string'],
+            comment: 'string',
+            referenceAnswer: 'string',
+            solutionMethod: ['string'],
+            teachingHint: 'string'
+          }
+        ]
+      }
+    })
+  });
+  if (!agent.ok || !Array.isArray(agent.data?.grading)) {
+    throw gradingError(agent.reason || 'invalid_agent_response', agent.detail || '');
+  }
+  return {
+    ...agent.data,
+    source: 'agent',
+    uploadedPhotos: files.length
+  };
+}
+
+export async function gradeSubmissionImages({ practice, profile, imagePaths, notes }) {
+  const files = imagePaths.map((imagePath) => ({
+    originalname: imagePath.split('/').pop(),
+    filename: imagePath.split('/').pop(),
+    path: imagePath,
+    mimetype: 'image/*',
+    size: 0
+  }));
+  const systemPrompt = await readPrompt('grading.system.md');
+  const agent = await callVisionAgent({
+    timeoutMs: 90000,
+    system: systemPrompt,
+    text: promptPayload({
+      task: '根据练习卷题干、标准答案、知识点标签和上传的学生作答照片生成批改总结。练习 JSON 必须提供答案元数据；不能臆造看不清的手写内容。',
+      context: {
+        student: profile,
+        practice,
+        uploadedFiles: files.map((file) => ({
+          originalName: file.originalname,
+          path: file.path,
+          mimetype: file.mimetype
+        })),
+        notes
+      },
+      schema: {
+        summary: 'string',
+        masterySignals: ['string'],
+        nextPracticeSuggestion: 'string',
+        grading: [
+          {
+            questionId: 'q1',
+            recognizedAnswer: 'string',
+            status: 'correct|partial|wrong|unrecognized|needs_review',
+            score: 0,
+            maxScore: 6,
+            errorTypes: ['string'],
+            comment: 'string',
+            referenceAnswer: 'string',
+            solutionMethod: ['string'],
+            teachingHint: 'string'
+          }
+        ]
+      }
+    }),
+    imagePaths
+  });
+  if (!agent.ok || !Array.isArray(agent.data?.grading)) {
+    throw gradingError(agent.reason || 'invalid_agent_response', agent.detail || '');
+  }
+  return {
+    ...agent.data,
+    source: 'agent',
+    uploadedPhotos: imagePaths.length
+  };
+}