feat(app): add lightweight feedback capture

README.md

@@ -23,3 +23,4 @@ Configure these as Hugging Face Space secrets:
 ## Runtime Storage
 
 Set `AIGC_ARTIFACT_ROOT=/data/outputs` for persistent generated models and manifests on Hugging Face Spaces.
+Feedback is appended to `$AIGC_ARTIFACT_ROOT/feedback/feedback.jsonl`.

app.py

@@ -1,5 +1,7 @@
+import json
 import os
 import shutil
+from datetime import datetime
 from pathlib import Path
 from uuid import uuid4
 
@@ -14,6 +16,7 @@ def new_session_state() -> dict:
         "session_id": uuid4().hex[:12],
         "agent_messages": [],
         "chat_messages": [],
+        "latest_tool_payload": None,
     }
 
 
@@ -63,13 +66,35 @@ def format_status(result: dict) -> str:
     ]).strip()
 
 
+def write_feedback(state: dict, rating: str, comment: str) -> Path:
+    payload = state.get("latest_tool_payload") or {}
+    feedback_dir = ARTIFACT_ROOT / "feedback"
+    feedback_dir.mkdir(parents=True, exist_ok=True)
+    feedback_path = feedback_dir / "feedback.jsonl"
+
+    record = {
+        "timestamp": datetime.now().astimezone().isoformat(timespec="seconds"),
+        "session_id": state.get("session_id"),
+        "run_id": payload.get("run_id"),
+        "rating": rating,
+        "comment": comment.strip(),
+        "output_path": payload.get("output_path"),
+        "manifest_path": payload.get("manifest_path"),
+    }
+
+    with feedback_path.open("a", encoding="utf-8") as handle:
+        handle.write(json.dumps(record, ensure_ascii=False) + "\n")
+
+    return feedback_path
+
+
 def submit_message(message, state):
     state = state or new_session_state()
     text, image_path = parse_user_message(message)
     uploaded_image = copy_uploaded_image(image_path, state["session_id"])
 
     if not text and not uploaded_image:
-        return state["chat_messages"], state, None, None, "Enter a message or upload an image.", {"text": "", "files": []}
+        return state["chat_messages"], state, None, None, "Enter a message or upload an image.", {"text": "", "files": []}, None, "", ""
 
     display_text = text or "Generate a 3D model from the uploaded image."
     if uploaded_image:
@@ -87,6 +112,7 @@ def submit_message(message, state):
         if result.get("error") and not assistant_text:
             assistant_text = result["error"]
         state["chat_messages"].append({"role": "assistant", "content": assistant_text})
+        state["latest_tool_payload"] = result.get("tool_payload")
         status = format_status(result)
         return (
             state["chat_messages"],
@@ -95,15 +121,30 @@ def submit_message(message, state):
             result.get("download_path"),
             status,
             {"text": "", "files": []},
+            None,
+            "",
+            "",
         )
     except Exception as exc:
         state["chat_messages"].append({"role": "assistant", "content": f"Failed: {exc}"})
-        return state["chat_messages"], state, None, None, f"Failed: `{exc}`", {"text": "", "files": []}
+        return state["chat_messages"], state, None, None, f"Failed: `{exc}`", {"text": "", "files": []}, None, "", ""
+
+
+def submit_feedback(rating, comment, state):
+    state = state or new_session_state()
+    payload = state.get("latest_tool_payload") or {}
+    if not payload.get("run_id"):
+        return "Generate a model before submitting feedback.", comment or ""
+    if not rating:
+        return "Choose satisfied or unsatisfied before submitting feedback.", comment or ""
+
+    feedback_path = write_feedback(state, rating, comment or "")
+    return f"Feedback saved to `{feedback_path}`.", ""
 
 
 def reset_session():
     state = new_session_state()
-    return [], state, None, None, "New session started.", {"text": "", "files": []}
+    return [], state, None, None, "New session started.", {"text": "", "files": []}, None, "", ""
 
 
 with gr.Blocks(title="AI CAD Agent", fill_height=True) as demo:
@@ -131,15 +172,52 @@ with gr.Blocks(title="AI CAD Agent", fill_height=True) as demo:
             preview = gr.Model3D(label="Model Preview", height=560)
             download = gr.File(label="Download Latest Model")
             status = gr.Markdown("No model generated yet.")
+            gr.Markdown("### Feedback")
+            feedback_rating = gr.Radio(
+                choices=["满意", "不满意"],
+                label="How was this result?",
+            )
+            feedback_comment = gr.Textbox(
+                label="Optional notes",
+                placeholder="What worked, what failed, or what you wanted instead.",
+                lines=3,
+            )
+            feedback_submit = gr.Button("Submit Feedback")
+            feedback_status = gr.Markdown("")
 
     composer.submit(
         submit_message,
         inputs=[composer, state],
-        outputs=[chatbot, state, preview, download, status, composer],
+        outputs=[
+            chatbot,
+            state,
+            preview,
+            download,
+            status,
+            composer,
+            feedback_rating,
+            feedback_comment,
+            feedback_status,
+        ],
     )
     clear.click(
         reset_session,
-        outputs=[chatbot, state, preview, download, status, composer],
+        outputs=[
+            chatbot,
+            state,
+            preview,
+            download,
+            status,
+            composer,
+            feedback_rating,
+            feedback_comment,
+            feedback_status,
+        ],
+    )
+    feedback_submit.click(
+        submit_feedback,
+        inputs=[feedback_rating, feedback_comment, state],
+        outputs=[feedback_status, feedback_comment],
     )