kev/Drawer/AI/Workflow/Executor.cs

using AI.Interface;
using AI.Models;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

namespace AI.Workflow
{
    /// <summary>
    /// 执行结果
    /// </summary>
    public class ExecutionResult
    {
        /// <summary>
        /// 是否成功
        /// </summary>
        public bool IsSuccess { get; set; }

        /// <summary>
        /// 执行结果内容
        /// </summary>
        public string Content { get; set; } = string.Empty;

        /// <summary>
        /// 错误信息（如果失败）
        /// </summary>
        public string? ErrorMessage { get; set; }

        /// <summary>
        /// 是否需要重试
        /// </summary>
        public bool ShouldRetry { get; set; }

        /// <summary>
        /// 观察信息（ReAct 模式）
        /// </summary>
        public string? Observation { get; set; }
    }

    /// <summary>
    /// 步骤执行器 - 使用 ReAct 模式执行步骤：推理-行动-观察
    /// </summary>
    public class Executor
    {
        private readonly IChatBackend _chatBackend;
        private readonly ChatSession _executionSession;
        private readonly WorkflowState _state;
        private readonly List<ReActStep> _reactHistory = new();
        private readonly Action<string, string>? _onThoughtUpdated;

        public Executor(IChatBackend chatBackend, WorkflowState state, Action<string, string>? onThoughtUpdated = null)
        {
            _chatBackend = chatBackend;
            _state = state;
            _executionSession = new ChatSession();
            _onThoughtUpdated = onThoughtUpdated;

            // 初始化 ReAct 提示词
            _executionSession.AddSystemMessage(GetReActPrompt());
        }

        /// <summary>
        /// 使用 ReAct 模式执行单个步骤
        /// </summary>
        /// <param name="step">要执行的步骤</param>
        /// <param name="context">上下文信息（之前的步骤结果）</param>
        /// <param name="maxIterations">最大迭代次数（默认3次）</param>
        /// <param name="cancellationToken">取消令牌</param>
        /// <returns>执行结果</returns>
        public async Task<ExecutionResult> ExecuteStepWithReActAsync(PlanStep step, string? context = null, int maxIterations = 3, CancellationToken cancellationToken = default)
        {
            step.Status = PlanStepStatus.Running;
            step.StartedAt = DateTime.Now;
            step.ErrorMessage = null;

            try
            {
                Debug.WriteLine($"ReAct 模式执行步骤 {step.Order}: {step.Description}");

                var reactStep = new ReActStep
                {
                    StepId = step.Id,
                    StepDescription = step.Description,
                    Context = context
                };

                // ReAct 循环：推理 -> 行动 -> 观察
                for (int iteration = 0; iteration < maxIterations; iteration++)
                {
                    cancellationToken.ThrowIfCancellationRequested();

                    Debug.WriteLine($"ReAct 迭代 {iteration + 1}/{maxIterations}");

                    // 1. 推理（Think）
                    string thought = await ThinkAsync(step, context, reactStep, cancellationToken);
                    reactStep.Thoughts.Add(thought);
                    Debug.WriteLine($"推理: {thought}");

                    // 通知 Thought 更新
                    _onThoughtUpdated?.Invoke(step.Id, thought);

                    // 2. 行动（Act）
                    string action = await ActAsync(step, thought, context, reactStep, cancellationToken);
                    reactStep.Actions.Add(action);
                    Debug.WriteLine($"行动: {action}");

                    // 3. 观察（Observe）
                    string observation = await ObserveAsync(action, reactStep, cancellationToken);
                    reactStep.Observations.Add(observation);
                    Debug.WriteLine($"观察: {observation}");

                    // 检查是否完成
                    if (IsTaskComplete(observation, reactStep))
                    {
                        step.Status = PlanStepStatus.Completed;
                        step.Result = BuildFinalResult(reactStep);
                        step.CompletedAt = DateTime.Now;

                        _reactHistory.Add(reactStep);

                        Debug.WriteLine($"步骤 {step.Order} 执行完成");

                        return new ExecutionResult
                        {
                            IsSuccess = true,
                            Content = step.Result,
                            Observation = observation
                        };
                    }
                }

                // 达到最大迭代次数，返回当前结果
                step.Status = PlanStepStatus.Completed;
                step.Result = BuildFinalResult(reactStep);
                step.CompletedAt = DateTime.Now;

                _reactHistory.Add(reactStep);

                return new ExecutionResult
                {
                    IsSuccess = true,
                    Content = step.Result,
                    Observation = "达到最大迭代次数"
                };
            }
            catch (Exception ex)
            {
                step.Status = PlanStepStatus.Failed;
                step.ErrorMessage = ex.Message;
                step.CompletedAt = DateTime.Now;

                Debug.WriteLine($"步骤 {step.Order} 执行失败: {ex.Message}");

                return new ExecutionResult
                {
                    IsSuccess = false,
                    ErrorMessage = ex.Message,
                    ShouldRetry = true
                };
            }
        }

        /// <summary>
        /// 推理阶段：分析当前情况和需要采取的行动
        /// </summary>
        private async Task<string> ThinkAsync(PlanStep step, string? context, ReActStep reactStep, CancellationToken cancellationToken)
        {
            var prompt = new StringBuilder();
            prompt.AppendLine("【推理阶段】");
            prompt.AppendLine($"当前步骤：{step.Description}");

            if (!string.IsNullOrEmpty(context))
            {
                prompt.AppendLine($"\n上下文信息：");
                prompt.AppendLine(context);
            }

            if (reactStep.Thoughts.Count > 0)
            {
                prompt.AppendLine($"\n之前的推理：");
                for (int i = 0; i < reactStep.Thoughts.Count; i++)
                {
                    prompt.AppendLine($"{i + 1}. {reactStep.Thoughts[i]}");
                }
            }

            if (reactStep.Observations.Count > 0)
            {
                prompt.AppendLine($"\n之前的观察结果：");
                for (int i = 0; i < reactStep.Observations.Count; i++)
                {
                    prompt.AppendLine($"{i + 1}. {reactStep.Observations[i]}");
                }
            }

            prompt.AppendLine($"\n请分析当前情况，思考需要采取什么行动来完成这个步骤。");

            string thought = await _chatBackend.AskAsync(prompt.ToString(), _executionSession, null, cancellationToken);
            return thought;
        }

        /// <summary>
        /// 行动阶段：执行具体的操作
        /// </summary>
        private async Task<string> ActAsync(PlanStep step, string thought, string? context, ReActStep reactStep, CancellationToken cancellationToken)
        {
            var prompt = new StringBuilder();
            prompt.AppendLine("【行动阶段】");
            prompt.AppendLine($"步骤描述：{step.Description}");
            prompt.AppendLine($"\n推理结果：{thought}");

            if (!string.IsNullOrEmpty(context))
            {
                prompt.AppendLine($"\n上下文信息：");
                prompt.AppendLine(context);
            }

            if (reactStep.Actions.Count > 0)
            {
                prompt.AppendLine($"\n之前的行动：");
                for (int i = 0; i < reactStep.Actions.Count; i++)
                {
                    prompt.AppendLine($"{i + 1}. {reactStep.Actions[i]}");
                }
            }

            prompt.AppendLine($"\n请根据推理结果，执行具体的行动来完成这个步骤。");

            string action = await _chatBackend.AskAsync(prompt.ToString(), _executionSession, null, cancellationToken);
            return action;
        }

        /// <summary>
        /// 观察阶段：观察行动的结果
        /// </summary>
        private async Task<string> ObserveAsync(string action, ReActStep reactStep, CancellationToken cancellationToken)
        {
            var prompt = new StringBuilder();
            prompt.AppendLine("【观察阶段】");
            prompt.AppendLine($"刚才的行动：{action}");
            prompt.AppendLine($"\n请观察行动的结果，评估是否完成了步骤目标。如果未完成，说明还需要做什么。");

            string observation = await _chatBackend.AskAsync(prompt.ToString(), _executionSession, null, cancellationToken);
            return observation;
        }

        /// <summary>
        /// 判断任务是否完成
        /// </summary>
        private bool IsTaskComplete(string observation, ReActStep reactStep)
        {
            // 简单的完成判断：如果观察结果包含完成相关的关键词
            var completionKeywords = new[] { "完成", "成功", "已达成", "已完成", "done", "completed", "success" };
            var lowerObservation = observation.ToLower();

            foreach (var keyword in completionKeywords)
            {
                if (lowerObservation.Contains(keyword.ToLower()))
                {
                    return true;
                }
            }

            return false;
        }

        /// <summary>
        /// 构建最终结果
        /// </summary>
        private string BuildFinalResult(ReActStep reactStep)
        {
            var result = new StringBuilder();
            result.AppendLine("执行过程：");

            for (int i = 0; i < reactStep.Thoughts.Count; i++)
            {
                result.AppendLine($"\n迭代 {i + 1}:");
                result.AppendLine($"推理: {reactStep.Thoughts[i]}");
                if (i < reactStep.Actions.Count)
                {
                    result.AppendLine($"行动: {reactStep.Actions[i]}");
                }
                if (i < reactStep.Observations.Count)
                {
                    result.AppendLine($"观察: {reactStep.Observations[i]}");
                }
            }

            return result.ToString();
        }

        /// <summary>
        /// 获取 ReAct 提示词
        /// </summary>
        private string GetReActPrompt()
        {
            return @"你是一个使用 ReAct（推理-行动-观察）模式执行任务的智能助手。

【ReAct 工作模式】
ReAct 是一种迭代式的问题解决方法，通过不断循环以下三个步骤来完成任务：

1. **推理（Think）**：深入分析当前情况
   - 理解当前步骤的目标和要求
   - 分析已有的上下文信息和历史记录
   - 识别需要解决的问题和可能的障碍
   - 制定具体的行动计划
   - 推理过程要逻辑清晰、条理分明

2. **行动（Act）**：执行具体的操作
   - 根据推理结果，采取明确的行动
   - 行动要具体、可执行、有针对性
   - 如果涉及工具调用，确保参数正确
   - 行动描述要清晰，便于后续观察

3. **观察（Observe）**：评估行动结果
   - 仔细分析行动产生的结果
   - 判断是否达到了预期目标
   - 识别成功点和失败点
   - 评估是否需要继续迭代
   - 观察要客观、准确、全面

【执行原则】
- **迭代优化**：如果任务未完成，基于观察结果进行下一轮推理，不断优化策略
- **目标导向**：始终牢记当前步骤的最终目标，不要偏离方向
- **充分利用上下文**：仔细分析之前步骤的结果和观察，避免重复工作
- **明确完成标准**：当任务完成时，明确说明已完成，并总结关键成果

【推理质量要求】
- 推理要深入，不能停留在表面
- 要分析问题的根本原因，而不仅仅是症状
- 要考虑多种可能的解决方案，选择最优的
- 要预测行动可能的结果，提前规避风险

【行动执行要求】
- 行动要具体，避免模糊的描述
- 要充分利用可用的工具和资源
- 要确保行动的可执行性和有效性
- 如果遇到障碍，要灵活调整策略

【观察评估要求】
- 要全面评估结果，不能只看表面
- 要识别成功的关键因素和失败的根因
- 要判断是否真正完成了目标
- 要为下一轮迭代提供有价值的反馈

请严格按照 ReAct 模式执行任务，确保推理深入、行动有效、观察准确。";
        }

        /// <summary>
        /// ReAct 步骤记录
        /// </summary>
        internal class ReActStep
        {
            public string StepId { get; set; } = string.Empty;
            public string StepDescription { get; set; } = string.Empty;
            public string? Context { get; set; }
            public List<string> Thoughts { get; } = new List<string>();
            public List<string> Actions { get; } = new List<string>();
            public List<string> Observations { get; } = new List<string>();
        }
    }
}