@elf-express/admin-net-mcp 1.0.0 → 1.1.0

package/knowledge/Furion_Teaching_Manual/19-1-HTTP/351/201/240/347/253/257/350/253/213/346/261/202/345/237/272/347/244/216/344/275/277/347/224/250.md

@@ -0,0 +1,621 @@
+# 19.Ⅰ HTTP 遠端請求 — 基礎使用
+
+> **版本說明**：以下內容僅適用於 Furion 4.9.6+ 版本（採用 HttpAgent 請求代理），且不支援 .NET8 以下版本。
+
+---
+
+## 19.1 概述
+
+HTTP 遠端請求是指客戶端透過 HTTP 協定向遠端伺服器傳送請求以取得所需資源的過程。應用場景包括：資源取得、資料抓取、檔案傳輸、API 對接、系統整合、微服務通訊、負載均衡、壓力測試、請求代理等。
+
+> **安裝包說明**：Furion 框架已內建該功能。若使用非 Furion 框架，可安裝 `HttpAgent`（任何 .NET 應用）或 `HttpAgent.AspNetCore`（Web 應用）。
+
+---
+
+## 19.2 快速入門
+
+### 註冊服務
+
+```csharp
+services.AddHttpRemote();
+// 或 builder.Services.AddHttpRemote();
+```
+
+### 注入使用
+
+```csharp
+public class YourService(IHttpRemoteService httpRemoteService)
+{
+    // 使用 httpRemoteService
+}
+```
+
+非相依性注入環境：
+
+```csharp
+// Furion 框架
+var httpRemoteService = App.GetRequiredService<IHttpRemoteService>();
+
+// Console/WinForms/WPF
+var result = await HttpRemoteClient.Service.GetAsStringAsync("https://furion.net/");
+```
+
+### 19.2.1 取得網站內容
+
+```csharp
+// 最簡方式
+var content = await httpRemoteService.GetAsStringAsync("https://furion.net");
+
+// 建構器方式
+var content = await httpRemoteService.SendAsStringAsync(HttpRequestBuilder.Get("https://furion.net"));
+
+// 泛型方式
+var content = await httpRemoteService.SendAsAsync<string>(HttpRequestBuilder.Get("https://furion.net"));
+
+// 取得 HttpRemoteResult<T>
+var result = await httpRemoteService.SendAsync<string>(HttpRequestBuilder.Get("https://furion.net"));
+var content = result.Result;
+
+// 取得 HttpResponseMessage
+var response = await httpRemoteService.SendAsync(HttpRequestBuilder.Get("https://furion.net"));
+var content = await response.Content.ReadAsStringAsync();
+```
+
+### 19.2.2 攜帶請求資料
+
+```csharp
+var content = await httpRemoteService.PostAsAsync<YourRemoteModel>(
+    "https://localhost:7044/HttpRemote/AddModel",
+    builder => builder
+        .WithQueryParameters(new { query1 = 1, query2 = "furion" })
+        .SetJsonContent(new { id = 1, name = "furion" }));
+```
+
+### 19.2.3 Form 表單提交
+
+**multipart/form-data：**
+
+```csharp
+var content = await httpRemoteService.PostAsAsync<YourRemoteFormResult>(
+    "https://localhost:7044/HttpRemote/AddForm?id=1",
+    builder => builder.SetMultipartContent(multipart => multipart
+        .AddJson(new { id = 1, name = "furion" })
+        .AddFileAsStream(@"C:\Workspaces\httptest.jpg", "file")));
+```
+
+`SetMultipartContent` 支援的方法包括：`AddJson`、`AddFormItem`、`AddHtml`、`AddXml`、`AddText`、`AddObject`、`AddFileFromRemote`、`AddFileFromBase64String`、`AddFileAsStream`、`AddFileWithProgressAsStream`、`AddFileAsByteArray`、`AddFile`（MultipartFile/IFormFile）、`AddFiles`、`AddStream`、`AddByteArray`、`Add`。
+
+**application/x-www-form-urlencoded：**
+
+```csharp
+var content = await httpRemoteService.PostAsAsync<YourRemoteModel>(
+    "https://localhost:7044/HttpRemote/AddURLForm",
+    builder => builder.SetFormUrlEncodedContent(new { id = 1, name = "furion" }));
+
+// 使用 StringContent 解決編碼問題
+builder.SetFormUrlEncodedContent(new { id = 1, name = "furion" }, useStringContent: true);
+```
+
+### 19.2.4 下載網路資源
+
+```csharp
+var result = await httpRemoteService.DownloadFileAsync(
+    "https://example.com/file.exe",
+    @"C:\Workspaces\",
+    async progress =>
+    {
+        progress.UpdateConsoleProgress(); // 主控台進度條
+        await Task.CompletedTask;
+    },
+    fileExistsBehavior: FileExistsBehavior.Overwrite);
+```
+
+`FileExistsBehavior`：`CreateNew`（預設，已存在則拋例外）、`Overwrite`（覆蓋）、`Skip`（跳過）。
+
+`FileTransferProgress` 屬性：`FilePath`、`FileName`、`FileSize`、`Transferred`、`PercentageComplete`、`TransferRate`、`TimeElapsed`、`EstimatedTimeRemaining`。
+
+### 19.2.5 上傳檔案資源（OSS）
+
+**Form 表單方式：**
+
+```csharp
+await httpRemoteService.PostAsync("https://localhost:7044/HttpRemote/AddFile",
+    builder => builder.SetMultipartContent(multipart => multipart
+        .AddFileAsStream(@"C:\Workspaces\httptest.jpg", "file")));
+```
+
+**非 Form 表單方式（OSS）：**
+
+```csharp
+var fileStream = File.OpenRead("檔案路徑");
+await httpRemoteService.PutAsync("https://localhost:7044/HttpRemote/AddFile",
+    builder => builder.SetContent(fileStream));
+```
+
+**UploadFile 擴充方法（帶進度）：**
+
+```csharp
+await httpRemoteService.UploadFileAsync(
+    "https://localhost:7044/HttpRemote/AddFile",
+    @"C:\Workspaces\httptest.jpg", "file",
+    async progress =>
+    {
+        progress.UpdateConsoleProgress();
+        await Task.CompletedTask;
+    });
+```
+
+### 19.2.6 HTTP 宣告式請求（代理方式）
+
+```csharp
+public interface IHttpService : IHttpDeclarative
+{
+    [Get("https://furion.net")]
+    Task<string> GetWebSiteContent();
+
+    [Post("https://localhost:7044/HttpRemote/AddModel")]
+    [Query("query1", 1)]
+    Task<YourRemoteModel> PostData([Query(AliasAs = "query2")] string param,
+        [Body(MediaTypeNames.Application.Json)] object data);
+
+    [Post("https://localhost:7044/HttpRemote/AddForm?id=1")]
+    Task<YourRemoteFormResult> PostForm(Action<HttpMultipartFormDataBuilder> multipart);
+}
+
+// 註冊
+services.AddHttpRemote(builder =>
+{
+    builder.AddHttpDeclarative<IHttpService>();
+    // 或掃描程式集批次註冊（推薦）
+    // builder.AddHttpDeclarativesFromAssemblies([Assembly.GetEntryAssembly()]);
+});
+```
+
+### 19.2.7 請求分析工具 ✨
+
+```csharp
+await httpRemoteService.GetAsync("https://furion.net",
+    builder => builder.Profiler());
+
+// 全域啟用
+services.AddHttpClient(string.Empty).AddProfilerDelegatingHandler();
+
+// 生產環境停用
+services.AddHttpClient(string.Empty)
+    .AddProfilerDelegatingHandler(disableInProduction: true);
+```
+
+> ⚠️ 生產環境應停用請求分析工具。
+
+### 19.2.8 新增授權憑證
+
+```csharp
+// JWT
+builder.AddJwtBearerAuthentication("your token");
+
+// Basic
+builder.AddBasicAuthentication("username", "password");
+
+// Digest
+builder.AddDigestAuthentication("username", "password");
+
+// 自訂
+builder.AddAuthentication(new AuthenticationHeaderValue("X-Token", "your token"));
+```
+
+全域授權可透過自訂 `DelegatingHandler` 實現。
+
+### 19.2.9 設定 Cookie
+
+```csharp
+// 單次請求
+builder.WithCookie("name", "value").WithCookies(new { k1 = "v1", k2 = "v2" });
+
+// HttpClient 全域設定（自動登入）
+var cookieContainer = new CookieContainer();
+services.AddHttpClient(string.Empty)
+    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
+    {
+        CookieContainer = cookieContainer,
+        UseCookies = true,
+        AllowAutoRedirect = true
+    });
+```
+
+### 19.2.10 例外處理（例外抑制）
+
+```csharp
+// 抑制所有例外
+builder.SuppressExceptions();
+
+// 僅抑制特定例外
+builder.SuppressExceptions([typeof(TimeoutException), typeof(TaskCanceledException)]);
+
+// 抑制但仍捕獲例外資訊
+builder.SuppressExceptions()
+    .SetOnRequestFailed((ex, res) => Console.WriteLine(ex.Message));
+```
+
+### 19.2.11 壓力與模擬測試
+
+```csharp
+var result = await httpRemoteService.StressTestHarnessAsync("https://furion.net/");
+Console.WriteLine(result.ToString());
+
+// 自訂參數
+var result = await httpRemoteService.SendAsync(
+    HttpRequestBuilder.StressTestHarness("https://furion.net/")
+        .SetNumberOfRequests(1000)
+        .SetNumberOfRounds(5)
+        .SetMaxDegreeOfParallelism(500));
+```
+
+### 19.2.12 長輪詢 Long Polling
+
+```csharp
+await httpRemoteService.LongPollingAsync("https://localhost:7044/HttpRemote/LongPolling",
+    async (responseMessage, token) =>
+    {
+        Console.WriteLine(await responseMessage.Content.ReadAsStringAsync(token));
+        await Task.CompletedTask;
+    }, cancellationToken: cancellationToken);
+```
+
+### 19.2.13 Server-Sent Events 單向通訊
+
+```csharp
+await httpRemoteService.ServerSentEventsAsync("https://localhost:7044/HttpRemote/Events",
+    async (data, token) =>
+    {
+        Console.WriteLine(data.Data.ToString());
+        await Task.CompletedTask;
+    }, cancellationToken: cancellationToken);
+```
+
+`ServerSentEventsData` 屬性：`Event`、`Data`、`Id`、`Retry`、`CustomFields`。
+
+> ⚠️ 發送 SSE 請求時應關閉請求分析工具。
+
+### 19.2.14 WebSocket 雙工通訊
+
+```csharp
+using var webSocketClient = new WebSocketClient("wss://localhost:7044/ws");
+
+webSocketClient.Connected += (sender, s) => Console.WriteLine("連線成功");
+webSocketClient.TextReceived += (sender, s) => Console.WriteLine(s.Message);
+
+await webSocketClient.ConnectAsync(cancellationToken);
+await webSocketClient.SendAsync("Hello", cancellationToken: cancellationToken);
+await webSocketClient.CloseAsync(cancellationToken);
+```
+
+### 19.2.15 HttpContext 轉發和代理
+
+```csharp
+services.AddHttpContextAccessor();
+app.UseEnableBuffering();
+
+[HttpGet]
+public Task<IActionResult?> ForwardToWebSite()
+{
+    return httpContextAccessor.HttpContext.ForwardAsResultAsync("https://github.com");
+}
+```
+
+### 19.2.16 WebService 介面請求（SOAP）
+
+SOAP 1.1 需設定 `SOAPAction` 標頭並使用 `text/xml`；SOAP 1.2 使用 `application/soap+xml`。
+
+### 19.2.17 HTTP 請求斷言（Assert）
+
+```csharp
+HttpRequestBuilder.Get("https://furion.net")
+    .EnableAssertions()
+    .Asserts(ast => ast.StatusCode(200)
+                      .HeaderExists("encoding")
+                      .DurationUnder(5000));
+```
+
+內建斷言方法：`StatusCode`、`StatusCodeIn`、`IsSuccessStatusCode`、`ContentContains`、`HeaderExists`、`HeaderEquals`、`HeaderContains`、`DurationUnder`、`AddAssertion`。
+
+### 19.2.18 JSON 回應反序列化包裝器
+
+```csharp
+services.AddHttpClient(string.Empty)
+    .ConfigureOptions(options =>
+    {
+        options.JsonResponseWrapper = new JsonResponseWrapper(typeof(ApiResult<>), nameof(ApiResult<>.Data));
+        options.UseJsonResponseWrapping = true; // 全域啟用
+    });
+
+// 使用時無需指定 ApiResult<T>
+var content = await httpRemoteService.SendAsAsync<string>(
+    HttpRequestBuilder.Get("https://example.com"));
+```
+
+### 19.2.19 服務發現（ServiceDiscovery）
+
+```csharp
+services.AddServiceDiscovery();
+services.AddHttpRemote()
+    .ConfigureHttpClientDefaults(b => b.AddServiceDiscovery());
+```
+
+設定檔：
+
+```json
+{
+  "Services": {
+    "furion": { "https": ["localhost:5001", "furion.net"] }
+  }
+}
+```
+
+### 19.2.20 HttpRemoteResult\<TResult\> 回傳型別
+
+```csharp
+var httpResult = await httpRemoteService.GetAsync<string>("https://furion.net/");
+
+// 解構表示式
+var (result, response) = await httpRemoteService.GetAsync<string>("https://furion.net/");
+var (result, response, isSuccess, statusCode) = await httpRemoteService.GetAsync<string>("https://furion.net/");
+```
+
+屬性：`ResponseMessage`、`ContentType`、`StatusCode`、`IsSuccessStatusCode`、`Result`、`RequestDuration`、`Headers`、`RawSetCookies`、`SetCookies` 等。
+
+### 19.2.21 DeepSeek 官方對接 ✨
+
+**標準輸出（非串流）：**
+
+```csharp
+var result = await httpRemoteService.SendAsync<string>(HttpRequestBuilder
+    .Post("https://api.deepseek.com/chat/completions")
+    .Profiler(false)
+    .AddJwtBearerAuthentication("您的 APIKEY")
+    .SetJsonContent("""
+        {
+            "model": "deepseek-chat",
+            "messages": [
+                {"role": "system", "content": "你是一個專業的 C# 領域人才。"},
+                {"role": "user", "content": "Furion 框架未來前景？"}
+            ],
+            "stream": false
+        }
+        """), cancellationToken);
+
+dynamic clay = Clay.Parse(result.Result, ClayOptions.Flexible);
+var content = clay.choices[0].message.content;
+```
+
+**串流輸出（SSE）：** 將 `stream` 設為 `true`，使用 `HttpRequestBuilder.ServerSentEvents` 接收串流資料。
+
+---
+
+## 19.3 HttpRequestBuilder 請求建構器 ✨
+
+> **小貼士**：嫌 `HttpRequestBuilder` 太長？用 `HttpBuilder` 更清爽！
+
+### 建立實例
+
+```csharp
+// 請求謂詞靜態方法（推薦）
+HttpRequestBuilder.Get("https://furion.net/");
+HttpRequestBuilder.Post("https://furion.net/");
+HttpRequestBuilder.Put / Delete / Options / Trace / Patch ...
+
+// Create 靜態方法
+HttpRequestBuilder.Create("GET", "https://furion.net/");
+HttpRequestBuilder.Create(HttpMethod.Get, "https://furion.net/");
+
+// 從 JSON 設定建立
+HttpRequestBuilder.FromJson("""{ "url": "https://furion.net/", "method": "GET" }""");
+```
+
+### 方法命名原則
+
+- `Set` / `Use` 開頭：設定操作，重複呼叫會覆蓋
+- `With` / `Add` 開頭：疊加操作，重複呼叫會累加
+
+### 常用方法速查
+
+| 方法 | 說明 |
+|------|------|
+| `.SetJsonContent(obj)` | 設定 JSON 請求內容 |
+| `.SetFormUrlEncodedContent(obj)` | 設定 URL 編碼表單 |
+| `.SetMultipartContent(multipart => {})` | 設定多部分表單 |
+| `.SetContent(obj, contentType)` | 設定任意請求內容 |
+| `.WithHeader(key, value)` | 新增請求標頭 |
+| `.WithQueryParameter(key, value)` | 新增查詢參數 |
+| `.WithPathParameter(key, value)` | 替換路徑範本參數 |
+| `.WithCookie(key, value)` | 設定 Cookie |
+| `.SetTimeout(ms)` | 設定逾時時間 |
+| `.SetHttpClientName(name)` | 指定 HttpClient 名稱 |
+| `.SetBaseAddress(url)` | 設定請求基底位址 |
+| `.AddJwtBearerAuthentication(token)` | JWT 授權 |
+| `.AddBasicAuthentication(user, pass)` | Basic 授權 |
+| `.Profiler()` | 啟用請求分析工具 |
+| `.DisableCache()` | 停用 HTTP 快取 |
+| `.EnsureSuccessStatusCode()` | 確保請求成功 |
+| `.SuppressExceptions()` | 例外抑制 |
+| `.SimulateBrowser()` | 模擬瀏覽器環境 |
+| `.PerformanceOptimization()` | 啟用效能最佳化 |
+| `.AutoSetHostHeader()` | 自動 Host 標頭 |
+| `.SetReferer(url)` | 設定來源位址（防盜鏈） |
+| `.SetVersion(HttpVersion.Version20)` | 設定 HTTP 版本 |
+| `.EnableAssertions()` | 啟用斷言 |
+| `.JsonResponseWrapping()` | 啟用 JSON 回應包裝器 |
+| `.When(condition, b => {})` | 條件化設定 |
+| `.WithStatusCodeHandler(code, handler)` | 回應狀態碼處理 |
+| `.WithPathSegment(segment)` | 新增路徑片段 |
+| `.SetFragment(fragment)` | 設定片段識別符 |
+
+### 設定路徑參數（範本/設定參數）
+
+```csharp
+// {key} 範本語法
+HttpRequestBuilder.Get("https://furion.net?id={id}&name={name}")
+    .WithPathParameter("id", 1)
+    .WithPathParameter("name", "Furion");
+
+// [[key]] 設定參數語法（從 appsettings.json 讀取）
+HttpRequestBuilder.Get("https://furion.net?id=[[id]]&name=[[name]]");
+```
+
+設定參數支援：`[[key]]`、`[[key:sub]]`、`[[notfound | bak]]`、`[[notfound || default]]`。
+
+### 回應狀態碼處理程式
+
+```csharp
+HttpRequestBuilder.Get("https://furion.net/")
+    .WithStatusCodeHandler(200, async (res, ct) => { /* ... */ })
+    .WithStatusCodeHandler("200-299", async (res, ct) => { /* ... */ })
+    .WithStatusCodeHandler(">=500", async (res, ct) => { /* ... */ })
+    .WithAnyStatusCodeHandler(async (res, ct) => { /* ... */ })
+    .WithSuccessStatusCodeHandler(async (res, ct) => { /* ... */ });
+```
+
+---
+
+## 19.4 HttpMultipartFormDataBuilder 表單建構器
+
+透過 `SetMultipartContent` 方法取得實例：
+
+```csharp
+HttpRequestBuilder.Post("https://furion.net")
+    .SetMultipartContent(multipart =>
+    {
+        multipart.SetBoundary("--------------------")  // 設定邊界
+            .AddFormItem(1, "id")                       // 單個表單項
+            .AddJson(new { name = "furion" })            // JSON 內容
+            .AddObject(new { age = 30 })                 // 物件內容
+            .AddFileAsStream(@"path\file.jpg", "file")   // 本地檔案（串流）
+            .AddFileAsByteArray(@"path\file.jpg", "file") // 本地檔案（位元組陣列）
+            .AddFileFromRemote("https://...", "files")   // 網際網路檔案
+            .AddFileFromBase64String("base64...", "files", "test.txt") // Base64 檔案
+            .AddFile(MultipartFile.CreateFromPath(@"path\file.jpg", "files")) // MultipartFile
+            .AddFile(formFile)                           // IFormFile
+            .AddStream(stream, "data")                   // 串流
+            .AddByteArray(bytes, "data")                 // 位元組陣列
+            .SetFormNameTransformer(FormNamingPolicy.CamelCase); // 表單名稱策略
+    });
+```
+
+---
+
+## 19.5 HTTP 宣告式請求 ✨
+
+### 介面定義與註冊
+
+```csharp
+public interface IHttpService : IHttpDeclarative
+{
+    [Get("https://furion.net/")]
+    Task<string> GetMethodAsync();
+
+    [Post("https://furion.net/")]
+    Task<string> PostMethodAsync();
+}
+
+services.AddHttpRemote(builder =>
+{
+    builder.AddHttpDeclarativesFromAssemblies([Assembly.GetEntryAssembly()]);
+});
+```
+
+### 常用宣告式特性速查
+
+| 特性 | 說明 | 作用範圍 |
+|------|------|----------|
+| `[Get]` / `[Post]` / `[Put]` / `[Delete]` ... | HTTP 請求方法 | 方法 |
+| `[Query(name, value)]` | 查詢參數 | 介面/方法/參數 |
+| `[Header(name, value)]` | 請求標頭 | 介面/方法/參數 |
+| `[Cookie(name, value)]` | Cookie | 介面/方法/參數 |
+| `[Path(name, value)]` | 路徑參數 | 介面/方法 |
+| `[PathSegment(segment)]` | 路徑片段 | 介面/方法/參數 |
+| `[Body(contentType)]` | 請求內容 | 參數 |
+| `[JsonBody]` / `[FormUrlEncodedBody]` | 快速 Body 標記 | 參數 |
+| `[Multipart]` | 多部分表單項 | 參數 |
+| `[MultipartObject]` | 物件作為表單項 | 參數 |
+| `[MultipartForm(boundary)]` | 多部分表單設定 | 方法 |
+| `[HttpClientName(name)]` | HttpClient 名稱 | 介面/方法 |
+| `[BaseAddress(url)]` | 請求基底位址 | 介面/方法 |
+| `[Timeout(ms)]` | 逾時時間 | 介面/方法 |
+| `[TraceIdentifier(id)]` | 追蹤識別碼 | 介面/方法 |
+| `[Profiler]` | 請求分析工具 | 介面/方法 |
+| `[DisableCache]` | 停用快取 | 介面/方法 |
+| `[EnsureSuccessStatusCode]` | 確保成功 | 介面/方法 |
+| `[SimulateBrowser]` | 模擬瀏覽器 | 介面/方法 |
+| `[PerformanceOptimization]` | 效能最佳化 | 介面/方法 |
+| `[AutoSetHostHeader]` | 自動 Host | 介面/方法 |
+| `[AcceptLanguage(lang)]` | 語言偏好 | 介面/方法 |
+| `[Referer(url)]` | 來源位址 | 介面/方法 |
+| `[HttpVersion(ver)]` | HTTP 版本 | 介面/方法 |
+| `[SuppressExceptions]` | 例外抑制 | 介面/方法 |
+| `[Property(name, value)]` | HttpRequestMessage 屬性 | 介面/方法/參數 |
+| `[RequestEventHandler(type)]` | 請求處理程式 | 介面/方法 |
+| `[JsonResponseWrapping]` | JSON 回應包裝器 | 介面/方法 |
+| `[Authentication]` (自訂) | 授權 | 介面/方法 |
+| `[Required]` / `[MinLength]` 等 | 參數驗證 | 參數 |
+
+### 凍結參數型別
+
+在宣告式介面方法中，以下型別為凍結參數，專門服務於特定操作：
+
+| 型別 | 說明 |
+|------|------|
+| `Action<HttpRequestBuilder>` | 額外設定建構器 |
+| `Action<HttpMultipartFormDataBuilder>` | 額外設定多部分表單 |
+| `Action<HttpRequestMessage>` | 額外設定 HttpRequestMessage |
+| `HttpCompletionOption` | 回應讀取方式 |
+| `CancellationToken` | 取消操作 |
+
+```csharp
+public interface IHttpService : IHttpDeclarative
+{
+    [Post("https://furion.net/")]
+    Task<string> PostAsync([Query] int id, [Body("application/json")] object body,
+        Action<HttpRequestBuilder>? configure = null,
+        CancellationToken cancellationToken = default);
+}
+
+// 呼叫時
+await httpService.PostAsync(1, new { name = "furion" },
+    builder => builder.AddJwtBearerAuthentication("token"),
+    cancellationToken);
+```
+
+### 自訂 HTTP 宣告提取器
+
+```csharp
+// 1. 定義特性
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Interface)]
+public sealed class AcceptAttribute : Attribute
+{
+    public AcceptAttribute(string accept) => Accept = accept;
+    public string Accept { get; set; }
+}
+
+// 2. 實作提取器
+public sealed class AcceptDeclarativeExtractor : IHttpDeclarativeExtractor
+{
+    public void Extract(HttpRequestBuilder httpRequestBuilder, HttpDeclarativeExtractorContext context)
+    {
+        if (!context.IsMethodDefined<AcceptAttribute>(out var attr, true)) return;
+        httpRequestBuilder.WithHeader("Accept", attr.Accept, replace: true);
+    }
+}
+
+// 3. 註冊
+services.AddHttpRemote(builder =>
+{
+    builder.AddHttpDeclarativeExtractors(() => [new AcceptDeclarativeExtractor()]);
+});
+
+// 4. 使用
+[Accept("text/html")]
+public interface IHttpService : IHttpDeclarative
+{
+    [Get("https://furion.net/")]
+    Task<string> GetStringAsync();
+}
+```