refactor(models): 补充模型与视图层中文说明

apps/audit/models.py

@@ -2,6 +2,14 @@ from django.db import models
 
 
 class AgentAuditLog(models.Model):
+    """
+    保存一次 Agent 执行的完整审计快照。
+
+    该模型是“系统可解释性”的核心：
+    - 对话页负责触发执行
+    - Agent Core 负责生成结果
+    - Audit 模型负责长期保存输入、引用、工具调用和模型输出
+    """
     # 审计状态需要同时服务数据库检索和前端展示。
     STATUS_SUCCESS = "success"
     STATUS_FAILED = "failed"
@@ -41,6 +49,12 @@ class AgentAuditLog(models.Model):
 
 
 class DemoBusinessRecord(models.Model):
+    """
+    演示用业务记录表。
+
+    该表不直接参与页面主流程，而是供内置工具 `query_demo_records`
+    查询，证明 Agent 除知识库外也可以结合结构化业务数据。
+    """
     scenario_id = models.CharField(max_length=100, db_index=True)
     record_type = models.CharField(max_length=100, db_index=True)
     title = models.CharField(max_length=255)

apps/audit/views.py

@@ -20,5 +20,7 @@ def log_list(request):
 
 
 def log_detail(request, log_id: int):
+    # 详情页只负责按主键加载审计快照并渲染；
+    # 所有脱敏和字段映射都应在服务层完成。
     audit_log = get_object_or_404(AgentAuditLog, pk=log_id)
     return render(request, "audit/log_detail.html", {"log": audit_log})