OA2023/OASystem/OASystem.Api/OAMethodLib/DeepSeekAPI/DeepSeekModels.cs

using System.Text.Json.Serialization;

namespace OASystem.API.OAMethodLib.DeepSeekAPI
{
    public class DeepSeekModels
    {
    }

    /// <summary>
    /// 基础信息
    /// </summary>
    public class DeepSeek
    {
        /// <summary>
        /// ApiKey
        /// </summary>
        public string ApiKey { get; set; }

        /// <summary>
        /// BaseAddress
        /// </summary>
        public string BaseAddress { get; set; }
    }

    /// <summary>
    /// 流式片段阶段（deepseek-reasoner：先 reasoning 再 content；deepseek-chat 通常仅有 Content）
    /// </summary>
    public enum DeepSeekStreamPhase
    {
        /// <summary>思考过程（对应 delta.reasoning_content）</summary>
        Reasoning,

        /// <summary>正式输出（对应 delta.content）</summary>
        Content
    }

    /// <summary>
    /// 单段流式输出，便于前端区分思考与结果
    /// </summary>
    public class DeepSeekStreamChunk
    {
        public DeepSeekStreamPhase Phase { get; set; }

        public string Text { get; set; } = "";
    }

    /// <summary>
    /// 连续对话中的一条上下文消息（纯文本，对应 chat/completions 的 messages 项）。
    /// 调用方按时间顺序传入完整历史（含 system、多轮 user/assistant），每轮流式结束后将 assistant 全文追加再发下一轮。
    /// </summary>
    public class DeepSeekHistoryMessage
    {
        /// <summary>system | user | assistant</summary>
        public string Role { get; set; } = "";

        /// <summary>该轮文本内容</summary>
        public string Content { get; set; } = "";
    }

    /// <summary>
    /// 文件上传到DeepSeek API的请求参数
    /// </summary>
    public class DeepSeekFileUploadRequest
    {
        /// <summary>
        /// 要上传的文件列表
        /// </summary>
        public List<IFormFile> Files { get; set; } = new List<IFormFile>();

        /// <summary>
        /// 用途描述（可选）
        /// </summary>
        public string Purpose { get; set; } = "assistants";

        /// <summary>
        /// 模型名称，默认为 deepseek-chat
        /// </summary>
        public string Model { get; set; } = "deepseek-chat";

        /// <summary>
        /// 是否等待文件处理完成
        /// </summary>
        public bool WaitForProcessing { get; set; } = true;
    }

    /// <summary>
    /// 使用已上传文件提问的请求参数
    /// </summary>
    public class AskWithFilesRequest
    {
        /// <summary>
        /// 已上传的文件ID列表
        /// </summary>
        public List<string> FileIds { get; set; } = new List<string>();

        /// <summary>
        /// 问题描述
        /// </summary>
        public string Question { get; set; }

        /// <summary>
        /// 模型名称
        /// </summary>
        public string Model { get; set; } = "deepseek-chat";

        /// <summary>
        /// 温度参数
        /// </summary>
        public float Temperature { get; set; } = 0.7f;

        /// <summary>
        /// 最大token数
        /// </summary>
        public int MaxTokens { get; set; } = 4000;
    }

    /// <summary>
    /// DeepSeek 文件上传响应
    /// </summary>
    public class DeepSeekFileUploadResponse
    {
        /// <summary>
        /// 文件ID
        /// </summary>
        [JsonPropertyName("id")]
        public string Id { get; set; }

        /// <summary>
        /// 对象类型
        /// </summary>
        [JsonPropertyName("object")]
        public string Object { get; set; }

        /// <summary>
        /// 文件大小（字节）
        /// </summary>
        [JsonPropertyName("bytes")]
        public long Bytes { get; set; }

        /// <summary>
        /// 创建时间戳
        /// </summary>
        [JsonPropertyName("created_at")]
        public long CreatedAt { get; set; }

        /// <summary>
        /// 文件名
        /// </summary>
        [JsonPropertyName("filename")]
        public string Filename { get; set; }

        /// <summary>
        /// 文件用途
        /// </summary>
        [JsonPropertyName("purpose")]
        public string Purpose { get; set; }

        /// <summary>
        /// 文件状态
        /// </summary>
        [JsonPropertyName("status")]
        public string Status { get; set; }

        /// <summary>
        /// 状态详情
        /// </summary>
        [JsonPropertyName("status_details")]
        public object StatusDetails { get; set; }
    }

    /// <summary>
    /// 文件列表响应
    /// </summary>
    public class DeepSeekFileListResponse
    {
        /// <summary>
        /// 对象类型
        /// </summary>
        [JsonPropertyName("object")]
        public string Object { get; set; }

        /// <summary>
        /// 文件数据列表
        /// </summary>
        [JsonPropertyName("data")]
        public List<DeepSeekFileUploadResponse> Data { get; set; }
    }

    /// <summary>
    /// 使用文件进行聊天的请求
    /// </summary>
    public class DeepSeekChatWithFilesRequest
    {
        /// <summary>
        /// 模型名称
        /// </summary>
        [JsonPropertyName("model")]
        public string Model { get; set; }

        /// <summary>
        /// 消息列表
        /// </summary>
        [JsonPropertyName("messages")]
        public List<FileMessage> Messages { get; set; }

        /// <summary>
        /// SSE的形式以流式发送消息增量
        /// 如果设置为 True，将会以 SSE（server-sent events）的形式以流式发送消息增量。消息流以 data: [DONE] 结尾。
        /// </summary>
        [JsonPropertyName("stream")]
        public bool Stream { get; set; } = false;

        /// <summary>
        /// 温度参数
        /// </summary>
        [JsonPropertyName("temperature")]
        public float Temperature { get; set; }

        /// <summary>
        /// 最大token数
        /// </summary>
        [JsonPropertyName("max_tokens")]
        public int MaxTokens { get; set; }

        /// <summary>
        /// 核采样参数，范围一般为 0~1
        /// </summary>
        [JsonPropertyName("top_p")]
        public decimal TopP { get; set; } = 1.0M;

        /// <summary>
        /// 频率惩罚，降低重复内容
        /// </summary>
        [JsonPropertyName("frequency_penalty")]
        public decimal FrequencyPenalty { get; set; } = 0M;

        /// <summary>
        /// 存在惩罚，鼓励引入新内容
        /// </summary>
        [JsonPropertyName("presence_penalty")]
        public decimal PresencePenalty { get; set; } = 0M;
    }

    /// <summary>
    /// 包含文件引用的消息
    /// </summary>
    public class FileMessage
    {
        /// <summary>
        /// 消息角色
        /// </summary>
        [JsonPropertyName("role")]
        public string Role { get; set; }

        /// <summary>
        /// 消息内容
        /// </summary>
        [JsonPropertyName("content")]
        public object Content { get; set; }
    }

    /// <summary>
    /// 文件内容块
    /// </summary>
    public class FileContent
    {
        /// <summary>
        /// 内容类型
        /// </summary>
        [JsonPropertyName("type")]
        public string Type { get; set; } = "text";

        /// <summary>
        /// 文本内容
        /// </summary>
        [JsonPropertyName("text")]
        public string Text { get; set; }
    }

    /// <summary>
    /// API响应结果
    /// </summary>
    public class ApiResponse
    {
        /// <summary>
        /// 是否成功
        /// </summary>
        public bool Success { get; set; }

        /// <summary>
        /// 响应消息
        /// </summary>
        public string Message { get; set; }

        /// <summary>
        /// 文件上传结果
        /// </summary>
        public List<FileUploadResult> FileResults { get; set; } = new List<FileUploadResult>();

        /// <summary>
        /// 回答内容（如果包含提问）
        /// </summary>
        public string Answer { get; set; }

        /// <summary>
        /// 使用的token数量
        /// </summary>
        public int TokensUsed { get; set; }
    }

    /// <summary>
    /// 文件上传结果
    /// </summary>
    public class FileUploadResult
    {
        /// <summary>
        /// 文件名
        /// </summary>
        public string FileName { get; set; }

        /// <summary>
        /// 文件ID
        /// </summary>
        public string FileId { get; set; }

        /// <summary>
        /// 文件大小
        /// </summary>
        public long FileSize { get; set; }

        /// <summary>
        /// 是否上传成功
        /// </summary>
        public bool Success { get; set; }

        /// <summary>
        /// 状态消息
        /// </summary>
        public string Message { get; set; }

        /// <summary>
        /// 文件状态
        /// </summary>
        public string Status { get; set; }
    }

    /// <summary>
    /// 文件删除请求
    /// </summary>
    public class DeleteFileRequest
    {
        /// <summary>
        /// 要删除的文件ID
        /// </summary>
        public string FileId { get; set; }
    }

    /// <summary>
    /// 项目文件读取请求
    /// </summary>
    public class ProjectFileReadRequest
    {
        /// <summary>
        /// 要读取的文件相对路径列表（相对于项目根目录）
        /// </summary>
        public List<string> FilePaths { get; set; } = new List<string>();

        /// <summary>
        /// 是否递归读取子目录
        /// </summary>
        public bool Recursive { get; set; } = false;

        /// <summary>
        /// 文件搜索模式（例如：*.cs）
        /// </summary>
        public string SearchPattern { get; set; } = "*.cs";

        /// <summary>
        /// 文件用途
        /// </summary>
        public string Purpose { get; set; } = "assistants";
    }

    /// <summary>
    /// 项目文件信息
    /// </summary>
    public class ProjectFileInfo
    {
        /// <summary>
        /// 文件相对路径
        /// </summary>
        public string RelativePath { get; set; }

        /// <summary>
        /// 文件完整路径
        /// </summary>
        public string FullPath { get; set; }

        /// <summary>
        /// 文件大小（字节）
        /// </summary>
        public long FileSize { get; set; }

        /// <summary>
        /// 最后修改时间
        /// </summary>
        public DateTime LastModified { get; set; }

        /// <summary>
        /// 是否成功读取
        /// </summary>
        public bool Success { get; set; }

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

        /// <summary>
        /// 转换后的IFormFile（如果成功）
        /// </summary>
        public IFormFile FormFile { get; set; }
    }

    /// <summary>
    /// 项目文件读取响应
    /// </summary>
    public class ProjectFileReadResponse
    {
        /// <summary>
        /// 是否成功
        /// </summary>
        public bool Success { get; set; }

        /// <summary>
        /// 响应消息
        /// </summary>
        public string Message { get; set; }

        /// <summary>
        /// 读取的文件信息列表
        /// </summary>
        public List<ProjectFileInfo> FileInfos { get; set; } = new List<ProjectFileInfo>();

        /// <summary>
        /// 成功读取的文件数量
        /// </summary>
        public int SuccessCount => FileInfos.Count(f => f.Success);

        /// <summary>
        /// 失败的文件数量
        /// </summary>
        public int FailureCount => FileInfos.Count(f => !f.Success);
    }
}