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

package/dist/index.js

@@ -4,23 +4,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
-const entity_js_1 = require("./knowledge/entity.js");
-const service_js_1 = require("./knowledge/service.js");
-const sqlsugar_js_1 = require("./knowledge/sqlsugar.js");
-const config_js_1 = require("./knowledge/config.js");
-const plugin_js_1 = require("./knowledge/plugin.js");
-const event_js_1 = require("./knowledge/event.js");
-const attributes_js_1 = require("./knowledge/attributes.js");
-const vue_typescript_js_1 = require("./knowledge/vue-typescript.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+function loadMd(filename) {
+    return (0, fs_1.readFileSync)((0, path_1.join)(__dirname, "../knowledge", filename), "utf-8");
+}
 const KNOWLEDGE_MAP = {
-    entity: entity_js_1.entityGuide,
-    service: service_js_1.serviceGuide,
-    sqlsugar: sqlsugar_js_1.sqlsugarGuide,
-    config: config_js_1.configGuide,
-    plugin: plugin_js_1.pluginGuide,
-    event: event_js_1.eventGuide,
-    attributes: attributes_js_1.attributesGuide,
-    "vue-typescript": vue_typescript_js_1.vueTypescriptGuide,
+    entity: loadMd("entity.md"),
+    service: loadMd("service.md"),
+    sqlsugar: loadMd("sqlsugar.md"),
+    config: loadMd("config.md"),
+    plugin: loadMd("plugin.md"),
+    event: loadMd("event.md"),
+    attributes: loadMd("attributes.md"),
+    "vue-typescript": loadMd("vue-typescript.md"),
 };
 const TOPIC_DESCRIPTIONS = {
     entity: "實體基礎類別階層（EntityBase, EntityBaseDel, EntityBaseTenant...）",
@@ -36,111 +33,109 @@ const server = new mcp_js_1.McpServer({
     name: "admin-net-knowledge",
     version: "1.0.0",
 });
-// 各主題工具（固定回傳對應知識）
 const topicTools = [
-    {
-        name: "get_entity_guide",
-        description: "取得 Admin.NET 實體（Entity）設計指南：EntityBase 類別階層、各屬性說明、如何選擇基礎類別、過濾介面（IDeletedFilter/ITenantIdFilter）",
-        topic: "entity",
-    },
-    {
-        name: "get_service_guide",
-        description: "取得 Admin.NET Service 設計指南：IDynamicApiController 模式、[ApiDescriptionSettings]、BaseService<T> 泛型 CRUD、DTO 命名慣例",
-        topic: "service",
-    },
-    {
-        name: "get_sqlsugar_guide",
-        description: "取得 SqlSugar ORM 指南：AOP 自動填充欄位（CreateTime/UpdateTime/TenantId）、Repository 查詢語法、交易管理（[UnitOfWork]）",
-        topic: "sqlsugar",
-    },
-    {
-        name: "get_config_guide",
-        description: "取得 Admin.NET 設定系統指南：IConfigurableOptions 用法、JSON 設定檔位置（Database.json、App.json）、多租戶策略",
-        topic: "config",
-    },
-    {
-        name: "get_plugin_guide",
-        description: "取得 Admin.NET 插件系統指南：[AppStartup(N)] 優先順序、插件目錄結構、ConfigureServices 範例、現有插件清單",
-        topic: "plugin",
-    },
-    {
-        name: "get_event_guide",
-        description: "取得事件匯流排指南：[EventSubscribe] 訂閱者寫法、IEventSubscriber 必要條件、發布事件語法、系統內建事件常數",
-        topic: "event",
-    },
-    {
-        name: "get_attribute_guide",
-        description: "取得自訂 Attribute 參考表：[Idempotent] 防重複、[DataMask] 遮罩、[Dict] 字典驗證、[SeedData] 種子資料等 20+ 個 Attribute",
-        topic: "attributes",
-    },
-    {
-        name: "get_vue_typescript_guide",
-        description: "取得 Vue 3 + TypeScript 採坑記錄：響應式陷阱、Element Plus 常見問題、Vite 模組系統、Pinia 狀態管理、Snowflake ID 精度問題",
-        topic: "vue-typescript",
-    },
+    { name: "get_entity_guide", description: "取得 Admin.NET 實體（Entity）設計指南：EntityBase 類別階層、各屬性說明、如何選擇基礎類別、過濾介面（IDeletedFilter/ITenantIdFilter）", topic: "entity" },
+    { name: "get_service_guide", description: "取得 Admin.NET Service 設計指南：IDynamicApiController 模式、[ApiDescriptionSettings]、BaseService<T> 泛型 CRUD、DTO 命名慣例", topic: "service" },
+    { name: "get_sqlsugar_guide", description: "取得 SqlSugar ORM 指南：AOP 自動填充欄位（CreateTime/UpdateTime/TenantId）、Repository 查詢語法、交易管理（[UnitOfWork]）", topic: "sqlsugar" },
+    { name: "get_config_guide", description: "取得 Admin.NET 設定系統指南：IConfigurableOptions 用法、JSON 設定檔位置（Database.json、App.json）、多租戶策略", topic: "config" },
+    { name: "get_plugin_guide", description: "取得 Admin.NET 插件系統指南：[AppStartup(N)] 優先順序、插件目錄結構、ConfigureServices 範例、現有插件清單", topic: "plugin" },
+    { name: "get_event_guide", description: "取得事件匯流排指南：[EventSubscribe] 訂閱者寫法、IEventSubscriber 必要條件、發布事件語法、系統內建事件常數", topic: "event" },
+    { name: "get_attribute_guide", description: "取得自訂 Attribute 參考表：[Idempotent] 防重複、[DataMask] 遮罩、[Dict] 字典驗證、[SeedData] 種子資料等 20+ 個 Attribute", topic: "attributes" },
+    { name: "get_vue_typescript_guide", description: "取得 Vue 3 + TypeScript 採坑記錄：響應式陷阱、Element Plus 常見問題、Vite 模組系統、Pinia 狀態管理、Snowflake ID 精度問題", topic: "vue-typescript" },
 ];
-// 註冊所有主題工具
 for (const { name, description, topic } of topicTools) {
     server.registerTool(name, { description }, async () => ({
         content: [{ type: "text", text: KNOWLEDGE_MAP[topic] }],
     }));
 }
-// 列出所有主題
 server.registerTool("list_topics", { description: "列出所有可用的知識主題及其簡短說明" }, async () => {
-    const lines = Object.entries(TOPIC_DESCRIPTIONS).map(([key, desc]) => `- **${key}**: ${desc}`);
+    const lines = Object.entries(TOPIC_DESCRIPTIONS).map(([k, d]) => `- **${k}**: ${d}`);
     return {
-        content: [
-            {
-                type: "text",
-                text: `# Admin.NET + Vue 知識庫主題\n\n${lines.join("\n")}\n\n使用對應的 get_*_guide 工具取得詳細說明。`,
-            },
-        ],
+        content: [{ type: "text", text: `# Admin.NET + Vue 知識庫主題\n\n${lines.join("\n")}\n\n使用對應的 get_*_guide 工具取得詳細說明。` }],
     };
 });
-// 跨主題搜尋
 server.registerTool("search_knowledge", {
     description: "在所有知識庫中搜尋關鍵字，回傳包含該關鍵字的相關說明段落",
-    inputSchema: { keyword: zod_1.z.string().describe("搜尋關鍵字（中文或英文，例如：TenantId、軟刪除、ref、el-dialog）") },
+    inputSchema: { keyword: zod_1.z.string().describe("搜尋關鍵字（例如：TenantId、軟刪除、ref、el-dialog）") },
 }, async ({ keyword }) => {
     const kw = keyword.toLowerCase();
     const results = [];
     for (const [topic, content] of Object.entries(KNOWLEDGE_MAP)) {
         const lines = content.split("\n");
-        const matchingBlocks = [];
+        const blocks = [];
         let i = 0;
         while (i < lines.length) {
             if (lines[i].toLowerCase().includes(kw)) {
                 const start = Math.max(0, i - 2);
                 const end = Math.min(lines.length - 1, i + 4);
-                matchingBlocks.push(lines.slice(start, end + 1).join("\n"));
+                blocks.push(lines.slice(start, end + 1).join("\n"));
                 i = end + 1;
             }
             else {
                 i++;
             }
         }
-        if (matchingBlocks.length > 0) {
-            results.push(`## 來自：${topic}（${TOPIC_DESCRIPTIONS[topic]}）\n\n${matchingBlocks.slice(0, 3).join("\n---\n")}`);
+        if (blocks.length > 0) {
+            results.push(`## 來自：${topic}（${TOPIC_DESCRIPTIONS[topic]}）\n\n${blocks.slice(0, 3).join("\n---\n")}`);
         }
     }
     if (results.length === 0) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `未找到包含「${keyword}」的內容。\n\n可用主題：${Object.keys(KNOWLEDGE_MAP).join("、")}`,
-                },
-            ],
-        };
+        return { content: [{ type: "text", text: `未找到「${keyword}」。可用主題：${Object.keys(KNOWLEDGE_MAP).join("、")}` }] };
     }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `# 搜尋結果：「${keyword}」\n\n${results.join("\n\n---\n\n")}`,
-            },
-        ],
-    };
+    return { content: [{ type: "text", text: `# 搜尋結果：「${keyword}」\n\n${results.join("\n\n---\n\n")}` }] };
+});
+// ── Furion 教學文件工具 ──────────────────────────────────────────
+const FURION_DIR = (0, path_1.join)(__dirname, "../knowledge/Furion_Teaching_Manual");
+server.registerTool("list_furion_docs", { description: "列出所有 Furion 教學文件的檔名，用於了解有哪些主題可查詢" }, async () => {
+    const files = (0, fs_1.readdirSync)(FURION_DIR).filter(f => f.endsWith(".md")).sort();
+    const list = files.map(f => `- ${f.replace(".md", "")}`).join("\n");
+    return { content: [{ type: "text", text: `# Furion 教學文件清單（${files.length} 份）\n\n${list}\n\n使用 get_furion_doc 取得完整內容，或用 search_furion_docs 搜尋關鍵字。` }] };
+});
+server.registerTool("get_furion_doc", {
+    description: "取得指定 Furion 教學文件的完整內容。先用 list_furion_docs 取得檔名清單。",
+    inputSchema: { filename: zod_1.z.string().describe("檔名（例如：10-1-SqlSugar整合 或 22-事件匯流排EventBus，不需要 .md 副檔名）") },
+}, async ({ filename }) => {
+    const target = filename.endsWith(".md") ? filename : `${filename}.md`;
+    const files = (0, fs_1.readdirSync)(FURION_DIR);
+    const match = files.find(f => f === target || f.toLowerCase() === target.toLowerCase());
+    if (!match) {
+        const suggestions = files.filter(f => f.toLowerCase().includes(filename.toLowerCase().replace(".md", ""))).slice(0, 5);
+        const hint = suggestions.length > 0 ? `\n\n相似檔名：\n${suggestions.map(f => `- ${f}`).join("\n")}` : "";
+        return { content: [{ type: "text", text: `找不到「${filename}」。${hint}\n\n使用 list_furion_docs 查看完整清單。` }] };
+    }
+    const content = (0, fs_1.readFileSync)((0, path_1.join)(FURION_DIR, match), "utf-8");
+    return { content: [{ type: "text", text: content }] };
+});
+server.registerTool("search_furion_docs", {
+    description: "在所有 Furion 教學文件中搜尋關鍵字，回傳包含該關鍵字的段落和來源檔案",
+    inputSchema: { keyword: zod_1.z.string().describe("搜尋關鍵字（例如：動態API、多租戶、SqlSugar、EventBus）") },
+}, async ({ keyword }) => {
+    const kw = keyword.toLowerCase();
+    const files = (0, fs_1.readdirSync)(FURION_DIR).filter(f => f.endsWith(".md")).sort();
+    const results = [];
+    for (const file of files) {
+        const lines = (0, fs_1.readFileSync)((0, path_1.join)(FURION_DIR, file), "utf-8").split("\n");
+        const blocks = [];
+        let i = 0;
+        while (i < lines.length) {
+            if (lines[i].toLowerCase().includes(kw)) {
+                const start = Math.max(0, i - 1);
+                const end = Math.min(lines.length - 1, i + 5);
+                blocks.push(lines.slice(start, end + 1).join("\n"));
+                i = end + 1;
+            }
+            else {
+                i++;
+            }
+        }
+        if (blocks.length > 0) {
+            results.push(`## ${file.replace(".md", "")}\n\n${blocks.slice(0, 2).join("\n---\n")}`);
+        }
+    }
+    if (results.length === 0) {
+        return { content: [{ type: "text", text: `未找到「${keyword}」。使用 list_furion_docs 瀏覽所有主題。` }] };
+    }
+    return { content: [{ type: "text", text: `# Furion 文件搜尋：「${keyword}」（${results.length} 個檔案有結果）\n\n${results.join("\n\n---\n\n")}` }] };
 });
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();

package/knowledge/Furion_Teaching_Manual/04-1-/351/205/215/347/275/256.md

@@ -0,0 +1,442 @@
+# 4.1 配置
+
+## 自定义配置特别注意
+
+如 `xxxx.json`，必须在 VS Studio 中右键属性设置**复制输出目录**为 `如果较新则复制`，**生成操作**为 `内容`。
+
+如果 `.json` 文件配置在多个项目层，也必须保证命名唯一，不然编译后出现相互覆盖的情况。
+
+> **中文乱码问题**：默认情况下 `.json` 文件并未采用 `utf-8` 编码，所以如果存在中文读取后就会出现乱码情况，只需要修改 `.json` 文件编码为 `utf-8` 即可。
+
+---
+
+## 4.1.1 什么是配置
+
+简单来说，配置将系统应用可动态调配的选项放在统一地方管理，通过不同的配置让系统做出动态调整。
+
+在 ASP.NET Core 应用程序启动时默认加载启动项目下的 `appsettings.json` 作为应用配置。同时还支持不同的运行环境加载对应的配置文件：
+
+- **Development**：加载 `appsettings.Development.json`
+- **Staging**：加载 `appsettings.Staging.json`
+- **{Environment}**：`appsettings.{Environment}.json`
+
+---
+
+## 4.1.2 配置的使用
+
+假设我们需要在系统运行时获取系统名称、版本号及版权信息，这些信息可能随时变化而且需要在多个地方使用。
+
+### 4.1.2.1 配置 appsettings.json 信息
+
+```json
+{
+  "AppInfo": {
+    "Name": "Furion",
+    "Version": "1.0.0",
+    "Company": "Baiqian"
+  }
+}
+```
+
+> **特别注意**：`appsettings.json` 复制输出目录为 `如果较新则复制`，生成操作为 `内容`。
+>
+> 另外，某些 Linux 系统不支持读取带注释的 JSON 文件，直接读取将会报错。需要将 JSON 内的注释全部删除才能正常读取。
+
+### 4.1.2.2 读取 appsettings.json 信息
+
+在 Furion 框架中，提供了两种读取方式：
+
+**方式一：通过 `App.Configuration[path]` 读取**
+
+```csharp
+using Microsoft.AspNetCore.Mvc;
+
+namespace Furion.Web.Entry.Controllers
+{
+    [Route("api/[controller]")]
+    public class DefaultController : ControllerBase
+    {
+        [HttpGet]
+        public string Get()
+        {
+            return $@"名称：{App.Configuration["AppInfo:Name"]}，
+                      版本：{App.Configuration["AppInfo:Version"]}，
+                      公司：{App.Configuration["AppInfo:Company"]}";
+        }
+    }
+}
+```
+
+**方式二：依赖注入 `IConfiguration` 对象读取**
+
+```csharp
+// 构造函数注入方式
+private readonly IConfiguration _configuration;
+public DefaultController(IConfiguration configuration)
+{
+    _configuration = configuration;
+}
+
+// 参数注入方式
+public string Get([FromServices] IConfiguration configuration)
+{
+}
+
+// 属性注入方式
+public IConfiguration Configuration { get; set; }
+```
+
+### 4.1.2.3 如何选择读取方式
+
+- 在可依赖注入类中，依赖注入 `IConfiguration` 读取
+- 在静态类/非依赖注入类中，选择 `App.Configuration[path]` 读取
+
+### 4.1.2.4 读取配置并转换成特定类型
+
+```csharp
+// ASP.NET Core
+var data = Configuration.GetSection("配置节点").Get<类型>();
+
+// Furion，推荐！！！
+var data = App.GetConfig<类型>("配置节点");
+```
+
+---
+
+## 4.1.3 路径符查找节点
+
+在 ASP.NET Core 中，配置采用 `:` 分隔符来读取分层配置数据。如 `AppInfo:Name`。如有更多层级数据则只需要通过 `:` 进入下一层节点即可。
+
+假设有以下配置信息：
+
+```json
+{
+  "AppInfo": {
+    "Name": "Furion",
+    "Version": "1.0.0",
+    "Company": {
+      "Name": "Baiqian",
+      "Address": {
+        "City": "中国",
+        "Province": "广东省",
+        "Detail": "中山市东区紫马公园西门"
+      }
+    }
+  }
+}
+```
+
+读取示例：
+
+```csharp
+var name = App.Configuration["AppInfo:Name"];                        // => Furion
+var companyName = App.Configuration["AppInfo:Company:Name"];          // => Baiqian
+var city = App.Configuration["AppInfo:Company:Address:City"];         // => 中国
+```
+
+### 4.1.3.1 查找数组节点
+
+可以通过 `App.Configuration["array:0"]` 获取，`0` 是索引数字。
+
+---
+
+## 4.1.4 自定义配置文件
+
+> **XML 配置说明**：Furion v2.8.0 版本移除了 `.xml` 文件自动扫描配置，改为手动添加配置。
+
+大多情况下，配置只需要在 `appsettings.json` 中配置即可，但一些特殊情况下可能需要独立的配置文件。Furion 目前支持 `.json` 和 `.xml` 两种方式。
+
+**JSON 示例：**
+
+```json
+// Furion.Web.Entry/emailsetting.json
+{
+  "outlook": {
+    "smtp": {
+      "server": "smtp.office365.com",
+      "port": "587",
+      "ssl": "STARTTLS"
+    },
+    "pop": {
+      "server": "outlook.office365.com",
+      "port": "995",
+      "ssl": "TLS"
+    }
+  }
+}
+```
+
+**XML 示例：**
+
+```xml
+<?xml version="1.0" encoding="utf-8" ?>
+<configuration>
+  <MyKey>MyXMLFile Value</MyKey>
+  <Position>
+    <Title>Title from MyXMLFile</Title>
+    <Name>Name from MyXMLFile</Name>
+  </Position>
+</configuration>
+```
+
+> **XML 配置事项**：如果采用 XML 配置，那么文件名必须以 `.config.xml` 结尾（不区分大小写）。
+
+> **特别说明**：Furion 框架会在启动时自动扫描每一个项目层根目录下的 `*.json` 文件加入配置中，所以无需手工配置。新增 `*.json` 文件的属性**复制到输出目录**设置为 `始终复制` 或 `较新复制`，否则不会载入。另外配置文件不能出现重名。
+
+在 v2.16.7+ 版本之后，支持自定义配置扫描目录：
+
+```json
+{
+  "ConfigurationScanDirectories": ["目录1名称", "目录1名称/子目录名称"]
+}
+```
+
+### 4.1.4.1 读取 emailsetting.json 配置
+
+读取自定义配置文件和读取 `appsettings.json` 一致，系统会自动从多个配置文件中读取：
+
+```csharp
+var smtpServer = App.Configuration["outlook:smtp:server"]; // => smtp.office365.com
+```
+
+### 4.1.4.2 排除特定配置文件
+
+在启动层 `appsettings.json` 中添加 `IgnoreConfigurationFiles` 节点：
+
+```json
+{
+  "IgnoreConfigurationFiles": ["runtime.json"]
+}
+```
+
+> **通配符支持**（Furion 4.8.8.22+）：
+
+```json
+{
+  "IgnoreConfigurationFiles": ["seed_*.json"]
+}
+```
+
+---
+
+## 4.1.5 不同环境读取
+
+在实际应用开发中，可能会根据不同的环境加载不同的配置文件，只需要遵循特定命名规范 `{name}.{Environment}.json` 即可：
+
+- `appsettings.Development.json`
+- `appsettings.Staging.json`
+- `appsettings.Production.json`
+- `emailsetting.Development.json`
+- `emailsetting.Staging.json`
+- `emailsetting.Production.json`
+
+ASP.NET Core 会在应用启动时自动加载不同环境的配置文件。
+
+---
+
+## 4.1.6 配置更改通知（热更新）
+
+在 .NET Core 应用程序中，配置支持更改通知，也就是热更新操作。一旦监听到配置文件发生变动，就会触发 `OnChange` 方法：
+
+```csharp
+var appInfoConfiguration = App.Configuration.GetSection("AppInfo");
+ChangeToken.OnChange(() => App.Configuration.GetReloadToken(), () =>
+{
+    var name = appInfoConfiguration["Name"];      // 实时的最新值
+    var version = appInfoConfiguration["Version"]; // 实时的最新值
+});
+
+// 默认情况下，ChangeToken.OnChange 可能会触发两次，
+// 所以在 Furion v4.9.6+ 可更改为以下方式
+ChangeToken.OnChange(() => App.Configuration.GetReloadToken(), ((Action)(() =>
+{
+    var name = appInfoConfiguration["Name"];
+    var version = appInfoConfiguration["Version"];
+})).Debounce()); // 添加了防抖操作
+```
+
+> **监听对象**：如果监听全局配置文件传入 `App.Configuration.GetReloadToken()`，如果只需要监听特定节点，传入 `App.Configuration.GetSection("AppInfo")`。
+
+---
+
+## 4.1.7 手动添加配置文件
+
+> **获取路径说明**：
+> - 获取项目目录：`AppContext.BaseDirectory`
+> - 获取网站根目录：`Directory.GetCurrentDirectory()`
+
+有些时候配置文件没有放在项目的根目录下，需要手动载入。
+
+**方式一：appsettings.json 中（推荐，v2.16.7+）**
+
+```json
+{
+  "ConfigurationScanDirectories": ["目录1名称", "目录1名称/子目录名称"]
+}
+```
+
+**方式二：.NET5 中 Program.cs 中配置**
+
+```csharp
+public class Program
+{
+    public static void Main(string[] args)
+    {
+        CreateHostBuilder(args).Build().Run();
+    }
+
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureAppConfiguration((hostingContext, config) =>
+            {
+                config.AddJsonFile("MyConfig.json", optional: true, reloadOnChange: true);
+            })
+            .ConfigureWebHostDefaults(webBuilder =>
+            {
+                webBuilder.UseStartup<Startup>();
+            });
+}
+```
+
+**方式三：.NET6 中 Program.cs 中配置**
+
+```csharp
+var builder = WebApplication.CreateBuilder(args);
+builder.Configuration.AddJsonFile("MyConfig.json", optional: true, reloadOnChange: true);
+// 注意先添加配置再初始化 Furion
+builder.Inject();
+var app = builder.Build();
+app.Run();
+```
+
+如果使用 `Serve.Run()` 模式：
+
+```csharp
+Serve.Run(RunOptions.Default.ConfigureConfiguration((env, configuration) => {
+    configuration.AddJsonFile("MyConfig.json", optional: true, reloadOnChange: true);
+}));
+```
+
+---
+
+## 4.1.8 配置的优缺点
+
+**优点：**
+
+- 能够在系统运行时快速读取
+- 无需额外配置
+
+**缺点：**
+
+- 存在重复读取
+- 通过硬编码字符串读取，容易出错
+- 不能设置默认值
+- 不能在运行环境中动态配置
+- 不能验证配置有效性
+- 不支持更改通知
+
+---
+
+## 4.1.9 配置使用场景
+
+如果只需要一次性读取配置信息，则使用配置，否则应该使用**选项（4.2 选项）**代替。
+
+---
+
+## 4.1.10 实现配置中心
+
+ASP.NET Core 除了通过配置文件读取配置信息外，还支持自定义配置提供程序，通过配置提供程序可以实现配置中心，比如通过数据库提供配置。
+
+具体实现查看微软官方文档：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/configuration/?view=aspnetcore-5.0#custom-configuration-provider
+
+> **使用 Nacos**：若使用 Nacos 可参考相关 Issue：https://gitee.com/dotnetchina/Furion/issues/I6G02W
+
+### 集成 AgileConfig 示例
+
+> **版本说明**：仅限 Furion 4.4.9+ 版本使用。
+
+**Serve.Run 方式：**
+
+```csharp
+Serve.Run(RunOptions.Default.WithArgs(args)
+    .ConfigureInject((builder, options) =>
+    {
+        options.ConfigureAppConfiguration((_, cfb) =>
+        {
+            cfb.AddAgileConfig(new AgileConfig.Client.ConfigClient(builder.Configuration), obj =>
+            {
+                Console.WriteLine($"{obj}");
+            });
+        });
+
+        options.ConfigureWebServices((_, services) =>
+        {
+            services.AddAgileConfig();
+        });
+    })
+);
+```
+
+**.NET6+ 方式：**
+
+```csharp
+var builder = WebApplication.CreateBuilder(args)
+    .Inject((builder, options) =>
+    {
+        options.ConfigureAppConfiguration((_, cfb) =>
+        {
+            cfb.AddAgileConfig(new AgileConfig.Client.ConfigClient(builder.Configuration), obj =>
+            {
+                Console.WriteLine($"{obj}");
+            });
+        });
+        options.ConfigureWebServices((_, services) =>
+        {
+            services.AddAgileConfig();
+        });
+    });
+```
+
+**.NET5 方式：**
+
+```csharp
+public class Program
+{
+    public static void Main(string[] args)
+    {
+        CreateHostBuilder(args).Build().Run();
+    }
+
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(webBuilder =>
+            {
+                webBuilder
+                .Inject((builder, options) =>
+                {
+                    options.ConfigureAppConfiguration((_, cfb) =>
+                    {
+                        cfb.AddAgileConfig(new AgileConfig.Client.ConfigClient(cfb.Build()), obj =>
+                        {
+                            Console.WriteLine($"{obj}");
+                        });
+                    });
+                    options.ConfigureWebServices((_, services) =>
+                    {
+                        services.AddAgileConfig();
+                    });
+                })
+                .UseStartup<Startup>();
+            });
+}
+```
+
+---
+
+## 4.1.11 重载配置
+
+Furion 会在应用启动的时候对 `IConfiguration` 进行静态缓存，如果使用了 `App.Configuration` 静态属性且配置数据已发生变更，则调用以下方法刷新即可：
+
+```csharp
+App.Configuration.Reload();
+```