C#接入DeepSeek实战指南：从零开始构建AI应用

1次阅读

没有评论

共计 3220 个字符，预计需要花费 9 分钟才能阅读完成。

DeepSeek 作为新一代 AI 服务平台，提供文本生成、代码补全、对话交互等能力。其特色在于：

支持超长上下文（最高 128K tokens）
提供比常规 API 更低的延迟响应
允许商用场景下免费调用（需遵守条款）

典型应用场景包括智能客服对话增强、自动生成技术文档、辅助代码编写等。我们项目中使用其 API 实现需求文档自动摘要功能，处理效率提升 60%。

实际开发中遇到的主要挑战：

认证复杂度：与常规 API 不同，需要同时处理 API Key 和动态签名
版本管理：v1/v2 接口混用导致响应格式不一致
流式响应：大文本生成时需特殊处理 Chunked 传输
性能瓶颈：同步请求造成线程阻塞

确保项目满足：
– .NET 6+ SDK
– NuGet 包Microsoft.Extensions.Http

// 在 Program.cs 中配置服务
builder.Services.AddHttpClient("DeepSeek", client => 
{client.BaseAddress = new Uri("https://api.deepseek.com/v1");
    client.DefaultRequestHeaders.Add("Accept", "application/json");
});

// 签名生成工具类
public class AuthSigner
{public static string GenerateSignature(string apiKey, string secret, long timestamp)
    {using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(secret));
        var signStr = $"{apiKey}:{timestamp}";
        var hash = hmac.ComputeHash(Encoding.UTF8.GetBytes(signStr));
        return BitConverter.ToString(hash).Replace("-", "").ToLower();}
}

public class DeepSeekService
{
    private readonly IHttpClientFactory _clientFactory;

    public async Task<string> GenerateTextAsync(string prompt)
    {var client = _clientFactory.CreateClient("DeepSeek");

        // 1. 准备认证头
        var timestamp = DateTimeOffset.UtcNow.ToUnixTimeSeconds();
        var signature = AuthSigner.GenerateSignature(
            _config.ApiKey, 
            _config.Secret,
            timestamp);

        // 2. 构建请求体
        var request = new HttpRequestMessage(HttpMethod.Post, "/completions")
        {
            Content = new StringContent(
                JsonSerializer.Serialize(new {
                    model = "deepseek-chat",
                    prompt = prompt,
                    max_tokens = 2000
                }), 
                Encoding.UTF8, 
                "application/json")
        };

        request.Headers.Add("X-API-KEY", _config.ApiKey);
        request.Headers.Add("X-SIGNATURE", signature);
        request.Headers.Add("X-TIMESTAMP", timestamp.ToString());

        // 3. 处理流式响应（关键代码）using var response = await client.SendAsync(request, 
            HttpCompletionOption.ResponseHeadersRead);

        await using var stream = await response.Content.ReadAsStreamAsync();
        using var reader = new StreamReader(stream);

        StringBuilder resultBuilder = new();
        while (!reader.EndOfStream)
        {var line = await reader.ReadLineAsync();
            if (!string.IsNullOrEmpty(line))
            {resultBuilder.Append(line);
            }
        }

        return resultBuilder.ToString();}
}

// 在 Startup 中优化 HttpClient
services.AddHttpClient("DeepSeek")
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
    {PooledConnectionLifetime = TimeSpan.FromMinutes(5),
        PooledConnectionIdleTimeout = TimeSpan.FromMinutes(2),
        MaxConnectionsPerServer = 20
    });

推荐使用 Polly 实现：

services.AddHttpClient("DeepSeekWithRetry")
    .AddTransientHttpErrorPolicy(policy => 
        policy.WaitAndRetryAsync(new[]
        {TimeSpan.FromSeconds(1),
            TimeSpan.FromSeconds(3),
            TimeSpan.FromSeconds(5)
        }));

建议方案：
1. 开发环境使用 User Secrets
2. 生产环境使用 Azure Key Vault
3. 禁止将密钥硬编码在代码中

[Fact]
public async Task GenerateText_ShouldReturnValidResponse()
{
    // Arrange
    var mockFactory = new Mock<IHttpClientFactory>();
    // 设置 mock 行为...

    // Act
    var service = new DeepSeekService(mockFactory.Object);
    var result = await service.GenerateTextAsync("Hello");

    // Assert
    Assert.NotNull(result);
    Assert.Contains("response", result);
}

DeepSeekIntegration/
│   ├── Services/
│   │   ├── DeepSeekService.cs      # 核心服务类
│   │   └── Interfaces/             # 抽象接口
│   ├── Utils/
│   │   └── AuthSigner.cs           # 签名工具
│   ├── Configs/                    
│   │   └── ApiConfig.cs            # 配置模型
│   └── Tests/
│       └── DeepSeekServiceTests.cs # 单元测试