refactor: 4层架构重构 + 饮食VLM接入 + 多项修复

- 后端: remaining_endpoints拆分为6个独立文件
- 后端: AI Agent Handler从ai_chat_endpoints抽取为7个独立处理器
- 后端: 食物识别prompt改为输出结构化JSON
- 前端: 饮食识别从Mock替换为真实VLM API调用
- 前端: 首页图片上传URL修复(/api/upload→/api/files/upload)
- 前端: 拍饮食按钮导航到独立DietCapturePage
- 前端: 删除无用agent_bar.dart
- 前端: 修复widget_test.dart过期属性名
- 前端: 恢复ServicePackageCard和详情页
- 新增6份实施文档(情况/问诊/报告/建档/日历/视觉统一)

backend/src/Health.Infrastructure/AI/AgentHandlers/common_agent_handler.cs

@@ -0,0 +1,64 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 共享工具处理器——被多个 Agent 引用的通用工具
+/// </summary>
+public static class CommonAgentHandler
+{
+    public static readonly ToolDefinition QueryHealthRecordsTool = new()
+    {
+        Function = new()
+        {
+            Name = "query_health_records", Description = "查询近期健康数据",
+            Parameters = new { type = "object", properties = new { type = new { type = "string" }, days = new { type = "integer" } } }
+        }
+    };
+
+    public static readonly ToolDefinition CheckArchiveTool = new()
+    {
+        Function = new() { Name = "check_archive", Description = "查询患者健康档案", Parameters = new { type = "object", properties = new { } } }
+    };
+
+    public static List<ToolDefinition> Tools => [QueryHealthRecordsTool, CheckArchiveTool];
+
+    public static async Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "query_health_records" => await ExecuteQueryHealthRecords(db, userId, args),
+            "check_archive" => await ExecuteCheckArchive(db, userId),
+            _ => new { success = false, message = $"未知工具: {toolName}" }
+        };
+    }
+
+    private static async Task<object> ExecuteQueryHealthRecords(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var type = args.TryGetProperty("type", out var t) ? t.GetString() : null;
+        var days = args.TryGetProperty("days", out var d) ? d.GetInt32() : 7;
+
+        var query = db.HealthRecords.Where(r => r.UserId == userId);
+        if (!string.IsNullOrEmpty(type) && Enum.TryParse<HealthMetricType>(type, ignoreCase: true, out var mt))
+            query = query.Where(r => r.MetricType == mt);
+
+        query = query.Where(r => r.RecordedAt >= DateTime.UtcNow.AddDays(-days));
+
+        var records = await query.OrderByDescending(r => r.RecordedAt).Take(30).Select(r => new
+        {
+            r.Id, Type = r.MetricType.ToString(), r.Systolic, r.Diastolic, r.Value, r.Unit, r.IsAbnormal, r.RecordedAt,
+        }).ToListAsync();
+
+        return new { count = records.Count, records };
+    }
+
+    private static async Task<object> ExecuteCheckArchive(AppDbContext db, Guid userId)
+    {
+        var archive = await db.HealthArchives.FirstOrDefaultAsync(a => a.UserId == userId);
+        if (archive == null) return new { found = false };
+        return new
+        {
+            found = true, archive.Diagnosis, archive.SurgeryType,
+            SurgeryDate = archive.SurgeryDate?.ToString("yyyy-MM-dd"),
+            archive.Allergies, archive.DietRestrictions, archive.ChronicDiseases, archive.FamilyHistory,
+        };
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/consultation_agent_handler.cs

@@ -0,0 +1,27 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// AI 问诊 Agent 工具处理器——转医生
+/// </summary>
+public static class ConsultationAgentHandler
+{
+    public static readonly ToolDefinition RequestDoctorTool = new()
+    {
+        Function = new()
+        {
+            Name = "request_doctor", Description = "请求转接真人医生",
+            Parameters = new { type = "object", properties = new { reason = new { type = "string" }, urgency_level = new { type = "string" } } }
+        }
+    };
+
+    public static List<ToolDefinition> Tools => [CommonAgentHandler.QueryHealthRecordsTool, CommonAgentHandler.CheckArchiveTool, RequestDoctorTool];
+
+    public static Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "query_health_records" or "check_archive" => CommonAgentHandler.Execute(toolName, args, db, userId),
+            _ => Task.FromResult<object>(new { success = false, message = $"未知工具: {toolName}" })
+        };
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/diet_agent_handler.cs

@@ -0,0 +1,23 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 拍饮食 Agent 工具处理器——食物估算
+/// </summary>
+public static class DietAgentHandler
+{
+    public static readonly ToolDefinition EstimateFoodTool = new()
+    {
+        Function = new() { Name = "estimate_food_text", Description = "根据文字描述估算食物份量和热量", Parameters = new { type = "object", properties = new { text = new { type = "string" } }, required = new[] { "text" } } }
+    };
+
+    public static List<ToolDefinition> Tools => [EstimateFoodTool, CommonAgentHandler.CheckArchiveTool];
+
+    public static Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "check_archive" => CommonAgentHandler.Execute(toolName, args, db, userId),
+            _ => Task.FromResult<object>(new { success = false, message = $"未知工具: {toolName}" })
+        };
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/exercise_agent_handler.cs

@@ -0,0 +1,70 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 运动计划 Agent 工具处理器
+/// </summary>
+public static class ExerciseAgentHandler
+{
+    public static readonly ToolDefinition ManageExerciseTool = new()
+    {
+        Function = new()
+        {
+            Name = "manage_exercise", Description = "运动计划管理",
+            Parameters = new { type = "object", properties = new { action = new { type = "string" } }, required = new[] { "action" } }
+        }
+    };
+
+    public static List<ToolDefinition> Tools => [ManageExerciseTool];
+
+    public static async Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "manage_exercise" => await ExecuteManageExercise(db, userId, args),
+            _ => new { success = false, message = $"未知工具: {toolName}" }
+        };
+    }
+
+    private static async Task<object> ExecuteManageExercise(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var action = args.TryGetProperty("action", out var a) ? a.GetString()! : "query";
+        switch (action)
+        {
+            case "create":
+                var weekStart = args.TryGetProperty("week_start_date", out var wsd) ? DateOnly.Parse(wsd.GetString()!) : DateOnly.FromDateTime(DateTime.Now);
+                var plan = new ExercisePlan { Id = Guid.NewGuid(), UserId = userId, WeekStartDate = weekStart };
+                if (args.TryGetProperty("items", out var items))
+                {
+                    foreach (var item in items.EnumerateArray())
+                    {
+                        plan.Items.Add(new ExercisePlanItem
+                        {
+                            Id = Guid.NewGuid(), DayOfWeek = item.GetProperty("day_of_week").GetInt32(),
+                            ExerciseType = item.GetProperty("exercise_type").GetString() ?? "散步",
+                            DurationMinutes = item.GetProperty("duration_minutes").GetInt32(),
+                            IsRestDay = item.TryGetProperty("is_rest_day", out var rd) && rd.GetBoolean(),
+                        });
+                    }
+                }
+                db.ExercisePlans.Add(plan);
+                await db.SaveChangesAsync();
+                return new { success = true, plan_id = plan.Id };
+
+            case "checkin":
+                var itemId = args.TryGetProperty("item_id", out var iid) ? iid.GetGuid() : Guid.Empty;
+                var exerciseItem = await db.ExercisePlanItems.FindAsync([itemId]);
+                if (exerciseItem == null) return new { success = false, message = "条目不存在" };
+                exerciseItem.IsCompleted = true;
+                exerciseItem.CompletedAt = DateTime.UtcNow;
+                await db.SaveChangesAsync();
+                return new { success = true };
+
+            default:
+                var existingPlan = await db.ExercisePlans.Where(p => p.UserId == userId)
+                    .OrderByDescending(p => p.WeekStartDate).FirstOrDefaultAsync();
+                if (existingPlan == null) return new { found = false };
+                var exerciseItems = await db.ExercisePlanItems.Where(i => i.PlanId == existingPlan.Id).OrderBy(i => i.DayOfWeek).ToListAsync();
+                return new { found = true, plan_id = existingPlan.Id, items = exerciseItems.Select(i => new { i.Id, i.DayOfWeek, i.ExerciseType, i.DurationMinutes, i.IsCompleted }) };
+        }
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/health_data_agent_handler.cs

@@ -0,0 +1,79 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 记数据 Agent 工具处理器——录入健康指标
+/// </summary>
+public static class HealthDataAgentHandler
+{
+    public static readonly ToolDefinition RecordHealthDataTool = new()
+    {
+        Function = new()
+        {
+            Name = "record_health_data", Description = "记录健康数据（血压/心率/血糖/血氧/体重）",
+            Parameters = new { type = "object", properties = new { type = new { type = "string" }, systolic = new { type = "integer" }, diastolic = new { type = "integer" }, heart_rate = new { type = "number" }, glucose = new { type = "number" }, spo2 = new { type = "number" }, weight = new { type = "number" } }, required = new[] { "type" } }
+        }
+    };
+
+    public static List<ToolDefinition> Tools => [RecordHealthDataTool, CommonAgentHandler.QueryHealthRecordsTool];
+
+    public static async Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "record_health_data" => await ExecuteRecordHealthData(db, userId, args),
+            "query_health_records" => await CommonAgentHandler.Execute(toolName, args, db, userId),
+            _ => new { success = false, message = $"未知工具: {toolName}" }
+        };
+    }
+
+    private static async Task<object> ExecuteRecordHealthData(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var type = args.TryGetProperty("type", out var t) ? t.GetString()! : "";
+        var record = new HealthRecord
+        {
+            Id = Guid.NewGuid(), UserId = userId, Source = HealthRecordSource.AiEntry,
+            RecordedAt = args.TryGetProperty("recorded_at", out var ra) && ra.TryGetDateTime(out var dt) ? dt : DateTime.UtcNow,
+            CreatedAt = DateTime.UtcNow,
+        };
+
+        switch (type)
+        {
+            case "blood_pressure":
+                record.MetricType = HealthMetricType.BloodPressure;
+                record.Systolic = args.TryGetProperty("systolic", out var s) ? s.GetInt32() : null;
+                record.Diastolic = args.TryGetProperty("diastolic", out var d) ? d.GetInt32() : null;
+                record.Unit = "mmHg";
+                record.IsAbnormal = record.Systolic >= 140 || record.Diastolic >= 90 || record.Systolic <= 89 || record.Diastolic <= 59;
+                break;
+            case "heart_rate":
+                record.MetricType = HealthMetricType.HeartRate;
+                record.Value = args.TryGetProperty("heart_rate", out var hr) ? hr.GetDecimal() : null;
+                record.Unit = "次/分";
+                record.IsAbnormal = record.Value > 100 || record.Value < 60;
+                break;
+            case "glucose":
+                record.MetricType = HealthMetricType.Glucose;
+                record.Value = args.TryGetProperty("glucose", out var g) ? g.GetDecimal() : null;
+                record.Unit = "mmol/L";
+                record.IsAbnormal = record.Value >= 7.0m || record.Value <= 3.8m;
+                break;
+            case "spo2":
+                record.MetricType = HealthMetricType.SpO2;
+                record.Value = args.TryGetProperty("spo2", out var o) ? o.GetDecimal() : null;
+                record.Unit = "%";
+                record.IsAbnormal = record.Value <= 94;
+                break;
+            case "weight":
+                record.MetricType = HealthMetricType.Weight;
+                record.Value = args.TryGetProperty("weight", out var w) ? w.GetDecimal() : null;
+                record.Unit = "kg";
+                break;
+            default:
+                return new { success = false, message = $"未知指标类型: {type}" };
+        }
+
+        db.HealthRecords.Add(record);
+        await db.SaveChangesAsync();
+        return new { success = true, record_id = record.Id, type = record.MetricType.ToString() };
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/medication_agent_handler.cs

@@ -0,0 +1,73 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 药管家 Agent 工具处理器——用药管理
+/// </summary>
+public static class MedicationAgentHandler
+{
+    public static readonly ToolDefinition ManageMedicationTool = new()
+    {
+        Function = new()
+        {
+            Name = "manage_medication", Description = "用药管理",
+            Parameters = new { type = "object", properties = new { action = new { type = "string" }, name = new { type = "string" }, dosage = new { type = "string" } }, required = new[] { "action" } }
+        }
+    };
+
+    public static List<ToolDefinition> Tools => [ManageMedicationTool, CommonAgentHandler.CheckArchiveTool];
+
+    public static async Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "manage_medication" => await ExecuteManageMedication(db, userId, args),
+            "check_archive" => await CommonAgentHandler.Execute(toolName, args, db, userId),
+            _ => new { success = false, message = $"未知工具: {toolName}" }
+        };
+    }
+
+    private static async Task<object> ExecuteManageMedication(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var action = args.TryGetProperty("action", out var a) ? a.GetString()! : "query";
+        return action switch
+        {
+            "create" => await CreateMedication(db, userId, args),
+            "query" => await QueryMedications(db, userId),
+            "confirm" => await ConfirmMedication(db, userId, args),
+            _ => new { success = false, message = $"未知操作: {action}" }
+        };
+    }
+
+    private static async Task<object> CreateMedication(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var med = new Medication
+        {
+            Id = Guid.NewGuid(), UserId = userId,
+            Name = args.TryGetProperty("name", out var n) ? n.GetString()! : "",
+            Dosage = args.TryGetProperty("dosage", out var dg) ? dg.GetString() : null,
+            Source = MedicationSource.AiEntry, IsActive = true,
+        };
+        db.Medications.Add(med);
+        await db.SaveChangesAsync();
+        return new { success = true, medication_id = med.Id, med.Name };
+    }
+
+    private static async Task<object> QueryMedications(AppDbContext db, Guid userId)
+    {
+        var meds = await db.Medications.Where(m => m.UserId == userId && m.IsActive)
+            .Select(m => new { m.Id, m.Name, m.Dosage, m.TimeOfDay }).ToListAsync();
+        return new { count = meds.Count, medications = meds };
+    }
+
+    private static async Task<object> ConfirmMedication(AppDbContext db, Guid userId, JsonElement args)
+    {
+        var medId = args.TryGetProperty("medication_id", out var mid) ? mid.GetGuid() : Guid.Empty;
+        db.MedicationLogs.Add(new MedicationLog
+        {
+            Id = Guid.NewGuid(), MedicationId = medId, UserId = userId,
+            Status = MedicationLogStatus.Taken, ScheduledTime = TimeOnly.FromDateTime(DateTime.Now), ConfirmedAt = DateTime.UtcNow,
+        });
+        await db.SaveChangesAsync();
+        return new { success = true };
+    }
+}

backend/src/Health.Infrastructure/AI/AgentHandlers/report_agent_handler.cs

@@ -0,0 +1,23 @@
+namespace Health.Infrastructure.AI.AgentHandlers;
+
+/// <summary>
+/// 看报告 Agent 工具处理器——报告分析
+/// </summary>
+public static class ReportAgentHandler
+{
+    public static readonly ToolDefinition AnalyzeReportTool = new()
+    {
+        Function = new() { Name = "analyze_report", Description = "分析报告图片", Parameters = new { type = "object", properties = new { image_url = new { type = "string" } }, required = new[] { "image_url" } } }
+    };
+
+    public static List<ToolDefinition> Tools => [AnalyzeReportTool, CommonAgentHandler.QueryHealthRecordsTool];
+
+    public static Task<object> Execute(string toolName, JsonElement args, AppDbContext db, Guid userId)
+    {
+        return toolName switch
+        {
+            "query_health_records" => CommonAgentHandler.Execute(toolName, args, db, userId),
+            _ => Task.FromResult<object>(new { success = false, message = $"未知工具: {toolName}" })
+        };
+    }
+}