feat: add qwen-long sample

ikesnowy · ikesnowy · commit 866ba20d0e6a · 2025-10-26T20:16:53.000+08:00
diff --git a/README.zh-Hans.md b/README.zh-Hans.md
@@ -67,6 +67,13 @@ public class YourService(IDashScopeClient client)
 ## 支持的 API
 
 - [文本生成](#文本生成) - QWen3, DeepSeek 等，支持推理/工具调用/网络搜索/翻译等场景
+    - [多轮对话](#多轮对话)
+    - [深度思考](#深度思考)
+    - [联网搜索](#联网搜索)
+    - [工具调用](#工具调用)
+    - [前缀续写](#前缀续写)
+    - [长上下文（Qwen-Long）](#长上下文（Qwen-Long）)
+
 - [多模态](#多模态) - QWen-VL，QVQ 等，支持推理/视觉理解/OCR/音频理解等场景
 - [语音合成](#语音合成) - CosyVoice，Sambert 等，支持 TTS 等应用场景
 - [图像生成](#图像生成) - wanx2.1 等，支持文生图，人像风格重绘等应用场景
@@ -1129,15 +1136,170 @@ Usage: in(31)/out(34)/reasoning()/total(65)
  */
 ```
 
+### 长上下文（Qwen-Long）
+
+尽管 QWen-Long 支持直接传入字符串，但还是推荐先将文件上传后再通过 FileId 的形式传入 `message` 数组中。
+
+上传文件，使用 `UploadFileAsync()` 方法传入文件（注意不是 `UploadTemporaryFileAsync`， 后者是用于上传媒体文件的）：
+
+```csharp
+var file1 = await client.UploadFileAsync(File.OpenRead("1024-1.txt"), "file1.txt");
+```
+
+然后将文件作为 `system` 消息传入消息数组中，注意第一条 `system` 消息不能省略，否则模型可能会将文件里的内容当作 System prompt 。
+
+```csharp
+var messages = new List<TextChatMessage>();
+messages.Add(TextChatMessage.System("You are a helpful assistant"));
+messages.Add(TextChatMessage.File(file1.Id));
+messages.Add(TextChatMessage.File(file2.Id));
+// 也可以传入文件数组 messages.Add(TextChatMessage.File([file1.Id, file2.Id]));
+```
+
+再以 `user` 消息添加与文件内容相关的问题。
+
+```csharp
+messages.Add(TextChatMessage.User("这两篇文章分别讲了什么？"));
+```
+
+最后向模型发送请求，注意这个接口获得的文件 ID 只有 `qwen-long` 模型可以访问，其他模型是访问不到的。
+
+```csharp
+var completion = client.GetTextCompletionStreamAsync(
+    new ModelRequest<TextGenerationInput, ITextGenerationParameters>()
+    {
+        Model = "qwen-long",
+        Input = new TextGenerationInput() { Messages = messages },
+        Parameters = new TextGenerationParameters()
+        {
+            ResultFormat = "message",
+            IncrementalOutput = true
+        }
+    });
+```
+
+最后可以通过 `DeleteFileAsync()` 方法删除上传的文件
+
+```csharp
+var result = await client.DeleteFileAsync(file1.Id);
+Console.WriteLine(result.Deleted ? "Success" : "Failed");
+```
+
+完整示例
+
+```csharp
+Console.WriteLine("Uploading file1...");
+var file1 = await client.UploadFileAsync(File.OpenRead("1024-1.txt"), "file1.txt");
+Console.WriteLine("Uploading file2...");
+var file2 = await client.UploadFileAsync(File.OpenRead("1024-2.txt"), "file2.txt");
+Console.WriteLine($"Uploaded, file1 id: {file1.Id.ToUrl()},  file2 id: {file2.Id.ToUrl()}");
+
+var messages = new List<TextChatMessage>();
+messages.Add(TextChatMessage.System("You are a helpful assistant"));
+messages.Add(TextChatMessage.File(file1.Id));
+messages.Add(TextChatMessage.File(file2.Id));
+messages.Add(TextChatMessage.User("这两篇文章分别讲了什么？"));
+
+messages.ForEach(m => Console.WriteLine($"{m.Role} > {m.Content}"));
+var completion = client.GetTextCompletionStreamAsync(
+    new ModelRequest<TextGenerationInput, ITextGenerationParameters>()
+    {
+        Model = "qwen-long",
+        Input = new TextGenerationInput() { Messages = messages },
+        Parameters = new TextGenerationParameters()
+        {
+            ResultFormat = "message",
+            IncrementalOutput = true
+        }
+    });
+var reply = new StringBuilder();
+var reasoning = false;
+TextGenerationTokenUsage? usage = null;
+await foreach (var chunk in completion)
+{
+    var choice = chunk.Output.Choices![0];
+    if (string.IsNullOrEmpty(choice.Message.ReasoningContent) == false)
+    {
+        // reasoning
+        if (reasoning == false)
+        {
+            Console.Write("Reasoning > ");
+            reasoning = true;
+        }
+
+        Console.Write(choice.Message.ReasoningContent);
+        continue;
+    }
+
+    if (reasoning)
+    {
+        reasoning = false;
+        Console.WriteLine();
+        Console.Write("Assistant > ");
+    }
+
+    Console.Write(choice.Message.Content);
+    reply.Append(choice.Message.Content);
+    usage = chunk.Usage;
+}
+
+Console.WriteLine();
+messages.Add(TextChatMessage.Assistant(reply.ToString()));
+if (usage != null)
+{
+    Console.WriteLine(
+        $"Usage: in({usage.InputTokens})/out({usage.OutputTokens})/reasoning({usage.OutputTokensDetails?.ReasoningTokens})/total({usage.TotalTokens})");
+}
+
+// Deleting files
+Console.Write("Deleting file1...");
+var result = await client.DeleteFileAsync(file1.Id);
+Console.WriteLine(result.Deleted ? "Success" : "Failed");
+Console.Write("Deleting file2...");
+result = await client.DeleteFileAsync(file2.Id);
+Console.WriteLine(result.Deleted ? "Success" : "Failed");
+
+/*
+Uploading file1...
+Uploading file2...
+Uploaded, file1 id: fileid://file-fe-b87a5c12cc354533bd882f04,  file2 id: fileid://file-fe-f5269f9996d544c4aecc5f80
+system > You are a helpful assistant
+system > fileid://file-fe-b87a5c12cc354533bd882f04
+system > fileid://file-fe-f5269f9996d544c4aecc5f80
+user > 这两篇文章分别讲了什么？
+这两篇文章都围绕“中国程序员节”的设立展开，但内容侧重点不同：
+
+**第一篇文章《file1.txt》：**
+这篇文章是一篇征求意见稿，标题为《中国程序员节，10月24日，你同意吗？》。文章回顾了此前关于设立中国程序员节的讨论背景——受俄罗斯程序员节（每年第256天）启发，有网友提议设立中国的程序员 节。文中提到曾有人建议定在10月10日（因为“1010”类似二进制），但作者认为10月24日更具意义：
+- 因为1024 = 2^10，是计算机中“1K”的近似值；
+- 1024在二进制、八进制和十六进制中都有特殊表示；
+- 节日时间上避开国庆后的调整期。
+因此，文章向读者征求是否同意将**10月24日**作为中国程序员节，并邀请大家参与投票和提出庆祝活动建议。
+
+**第二篇文章《file2.txt》：**
+这篇文章是第一篇的后续，标题为《程序员节，10月24日！》，属于正式 announcement（公告）。它宣布：
+- 根据前一次讨论的反馈结果，正式确定将**每年的10月24日**定为“中国程序员节”；
+- 博客园将在该日组织线上庆祝活动；
+- 文章进一步升华主题，强调程序员的社会价值和责任感，呼吁尊重程序员群体，肯定他们是“用代码改变世界的人”，并表达了对技术创造力的敬意。
+
+**总结：**
+- 第一篇是**征求意见**，探讨是否将10月24日设为中国程序员节；
+- 第二篇是**正式确认**节日日期，并倡导庆祝与认同程序员的价值。
+Usage: in(513)/out(396)/reasoning()/total(909)
+Deleting file1...Success
+Deleting file2...Success
+*/
+```
+
 
 
-### 多模态
+## 多模态
 
 使用 `dashScopeClient.GetMultimodalGenerationAsync` 和 `dashScopeClient.GetMultimodalGenerationStreamAsync` 来访问多模态文本生成接口。
 
 相关文档：[多模态_大模型服务平台百炼(Model Studio)-阿里云帮助中心](https://help.aliyun.com/zh/model-studio/multimodal)
 
-#### 视觉理解/推理
+### 视觉理解/推理
 
 使用 `MultimodalMessage.User()` 可以快速创建对应角色的消息。
 
@@ -1198,7 +1360,7 @@ await foreach (var modelResponse in response)
 }
 ```
 
-### 语音合成
+## 语音合成
 
 通过 `dashScopeClient.CreateSpeechSynthesizerSocketSessionAsync()` 来创建一个语音合成会话。
 
@@ -1235,9 +1397,9 @@ Console.WriteLine($"audio saved to {file.FullName}, token usage: {tokenUsage}");
 break;
 ```
 
-### 图像生成
+## 图像生成
 
-#### 文生图
+### 文生图
 
 我们针对通义万相提供了快捷 API `dashScopeClient.CreateWanxImageSynthesisTaskAsync()` 和 `GetWanxImageSynthesisTaskAsync()`。
 
@@ -1286,7 +1448,7 @@ Console.WriteLine($"Task timout, taskId: {task.TaskId}");
 
 图像背景生成 - `CreateWanxBackgroundGenerationTaskAsync` 和 `GetWanxBackgroundGenerationTaskAsync`
 
-### 应用调用
+## 应用调用
 
 `GetApplicationResponseAsync` 用于进行应用调用。
 
@@ -1354,7 +1516,7 @@ var response = await client.GetApplicationResponseAsync("your-application-id", r
 Console.WriteLine(response.Output.Text);
 ```
 
-### 文本向量
+## 文本向量
 
 使用 `GetTextEmbeddingsAsync` 来调用文本向量接口。
 
diff --git a/sample/Cnblogs.DashScope.Sample/1024-1.txt b/sample/Cnblogs.DashScope.Sample/1024-1.txt
@@ -0,0 +1,22 @@
+﻿中国程序员节，10月24日，你同意吗？
+大家好！
+
+国庆长假之后，我们来确定一下中国程序员节的日子吧。
+
+9月份的时候，我们针对中国程序员节进行了讨论与投票。
+
+起因是一条新闻“今天是程序员节”，俄罗斯把每年的第256(0x100th)天作为程序员节，通常是9月12日，也有可能是9月13日。
+
+园友贤达在评论中说：
+
+想想这么多年中国程序员这么辛苦，怎么就没有个法定的程序员节日呢？
+可执行文件的代码只有0和1，希望有一个10.10为中国程序员节。
+于是，很多朋友支持把10月10日作为中国程序员节。
+
+但10月10日紧接着中秋节与国庆节之后，大家正在恢复调整进入工作状态之中。
+
+所以我们觉得10月24日可能更合适（今年的10月24日是星期天），1024是很有意义的一个数字，1K=1024，1024=2的10次方，二进制10000000000，八进制2000，十六进制0x400。
+
+所以在这里征询一下大家意见，如果你同意10月24日作为中国程序员节，请点击随笔下面的推荐按钮，如果不同意，请点击反对按钮。
+
+如果确定了中国程序员节，我们会在那天组织网上的庆贺活动。如果大家对活动形式有好的建议，也欢迎在这里提出。
diff --git a/sample/Cnblogs.DashScope.Sample/1024-2.txt b/sample/Cnblogs.DashScope.Sample/1024-2.txt
@@ -0,0 +1,4 @@
+﻿程序员节，10月24日！
+根据大家在“中国程序员节，10月24日，你同意吗”中的反馈，现在确定中国程序员节放在每年的10月24日。博客园将在10月24日那天组织网上庆祝活动。
+
+希望通过程序员节，代表着我们的一种努力，努力将程序员们凝聚在一起，为社会创造更多价值，得到更多的认可。我们是程序员，不是代码工人，不是IT民工，是一群用代码改变世界的人。我们的代码可以给社会带来进步，也可能给社会带来灾难，我们的责任重于泰山；我们生活于现实世界，却在创造虚拟世界，我们的创造力无限...如果阿基米德是程序员，他会说“给我一台电脑，我就能改变世界”。
diff --git a/sample/Cnblogs.DashScope.Sample/Cnblogs.DashScope.Sample.csproj b/sample/Cnblogs.DashScope.Sample/Cnblogs.DashScope.Sample.csproj
@@ -20,6 +20,12 @@
     <None Update="Lenna.jpg">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
+    <None Update="1024-1.txt">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+    <None Update="1024-2.txt">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
   </ItemGroup>
 
   <ItemGroup>
diff --git a/sample/Cnblogs.DashScope.Sample/Text/LongContextSample.cs b/sample/Cnblogs.DashScope.Sample/Text/LongContextSample.cs
@@ -0,0 +1,112 @@
+﻿using System.Text;
+using Cnblogs.DashScope.Core;
+
+namespace Cnblogs.DashScope.Sample.Text;
+
+public class LongContextSample : ISample
+{
+    /// <inheritdoc />
+    public string Description => "File upload and long context model sample";
+
+    /// <inheritdoc />
+    public async Task RunAsync(IDashScopeClient client)
+    {
+        Console.WriteLine("Uploading file1...");
+        var file1 = await client.UploadFileAsync(File.OpenRead("1024-1.txt"), "file1.txt");
+        Console.WriteLine("Uploading file2...");
+        var file2 = await client.UploadFileAsync(File.OpenRead("1024-2.txt"), "file2.txt");
+        Console.WriteLine($"Uploaded, file1 id: {file1.Id.ToUrl()},  file2 id: {file2.Id.ToUrl()}");
+
+        var messages = new List<TextChatMessage>();
+        messages.Add(TextChatMessage.System("You are a helpful assistant"));
+        messages.Add(TextChatMessage.File(file1.Id));
+        messages.Add(TextChatMessage.File(file2.Id));
+        messages.Add(TextChatMessage.User("这两篇文章分别讲了什么？"));
+
+        messages.ForEach(m => Console.WriteLine($"{m.Role} > {m.Content}"));
+        var completion = client.GetTextCompletionStreamAsync(
+            new ModelRequest<TextGenerationInput, ITextGenerationParameters>()
+            {
+                Model = "qwen-long",
+                Input = new TextGenerationInput() { Messages = messages },
+                Parameters = new TextGenerationParameters() { ResultFormat = "message", IncrementalOutput = true }
+            });
+        var reply = new StringBuilder();
+        var reasoning = false;
+        TextGenerationTokenUsage? usage = null;
+        await foreach (var chunk in completion)
+        {
+            var choice = chunk.Output.Choices![0];
+            if (string.IsNullOrEmpty(choice.Message.ReasoningContent) == false)
+            {
+                // reasoning
+                if (reasoning == false)
+                {
+                    Console.Write("Reasoning > ");
+                    reasoning = true;
+                }
+
+                Console.Write(choice.Message.ReasoningContent);
+                continue;
+            }
+
+            if (reasoning)
+            {
+                reasoning = false;
+                Console.WriteLine();
+                Console.Write("Assistant > ");
+            }
+
+            Console.Write(choice.Message.Content);
+            reply.Append(choice.Message.Content);
+            usage = chunk.Usage;
+        }
+
+        Console.WriteLine();
+        messages.Add(TextChatMessage.Assistant(reply.ToString()));
+        if (usage != null)
+        {
+            Console.WriteLine(
+                $"Usage: in({usage.InputTokens})/out({usage.OutputTokens})/reasoning({usage.OutputTokensDetails?.ReasoningTokens})/total({usage.TotalTokens})");
+        }
+
+        // Deleting files
+        Console.Write("Deleting file1...");
+        var result = await client.DeleteFileAsync(file1.Id);
+        Console.WriteLine(result.Deleted ? "Success" : "Failed");
+        Console.Write("Deleting file2...");
+        result = await client.DeleteFileAsync(file2.Id);
+        Console.WriteLine(result.Deleted ? "Success" : "Failed");
+    }
+}
+
+/*
+Uploading file1...
+Uploading file2...
+Uploaded, file1 id: fileid://file-fe-b87a5c12cc354533bd882f04,  file2 id: fileid://file-fe-f5269f9996d544c4aecc5f80
+system > You are a helpful assistant
+system > fileid://file-fe-b87a5c12cc354533bd882f04
+system > fileid://file-fe-f5269f9996d544c4aecc5f80
+user > 这两篇文章分别讲了什么？
+这两篇文章都围绕“中国程序员节”的设立展开，但内容侧重点不同：
+
+**第一篇文章《file1.txt》：**
+这篇文章是一篇征求意见稿，标题为《中国程序员节，10月24日，你同意吗？》。文章回顾了此前关于设立中国程序员节的讨论背景——受俄罗斯程序员节（每年第256天）启发，有网友提议设立中国的程序员 节。文中提到曾有人建议定在10月10日（因为“1010”类似二进制），但作者认为10月24日更具意义：
+- 因为1024 = 2^10，是计算机中“1K”的近似值；
+- 1024在二进制、八进制和十六进制中都有特殊表示；
+- 节日时间上避开国庆后的调整期。
+因此，文章向读者征求是否同意将**10月24日**作为中国程序员节，并邀请大家参与投票和提出庆祝活动建议。
+
+**第二篇文章《file2.txt》：**
+这篇文章是第一篇的后续，标题为《程序员节，10月24日！》，属于正式 announcement（公告）。它宣布：
+- 根据前一次讨论的反馈结果，正式确定将**每年的10月24日**定为“中国程序员节”；
+- 博客园将在该日组织线上庆祝活动；
+- 文章进一步升华主题，强调程序员的社会价值和责任感，呼吁尊重程序员群体，肯定他们是“用代码改变世界的人”，并表达了对技术创造力的敬意。
+
+**总结：**
+- 第一篇是**征求意见**，探讨是否将10月24日设为中国程序员节；
+- 第二篇是**正式确认**节日日期，并倡导庆祝与认同程序员的价值。
+Usage: in(513)/out(396)/reasoning()/total(909)
+Deleting file1...Success
+Deleting file2...Success
+ */
diff --git a/src/Cnblogs.DashScope.Core/IDashScopeClient.cs b/src/Cnblogs.DashScope.Core/IDashScopeClient.cs
@@ -208,11 +208,11 @@ public Task<ModelResponse<BackgroundGenerationOutput, BackgroundGenerationUsage>
             CancellationToken cancellationToken = default);
 
     /// <summary>
-    /// Upload file for model to reference.
+    /// OpenAI compatible upload api, for model to reference.
     /// </summary>
     /// <param name="file">File data.</param>
     /// <param name="filename">Name of the file.</param>
-    /// <param name="purpose">Purpose of the file, use "file-extract" to allow model access the file.</param>
+    /// <param name="purpose">Purpose of the file, use "file-extract" to allow model access the file. Use "batch" for uploading batch operations .jsonl file.</param>
     /// <param name="cancellationToken">The cancellation token to use.</param>
     /// <returns></returns>
     public Task<DashScopeFile> UploadFileAsync(
