黄中银 2 dni temu
rodzic
commit
eea27be9dc

+ 9 - 4
docs/site/.vitepress/config.ts

@@ -98,12 +98,17 @@ export default defineConfig({
     },
     
     socialLinks: [
-      { icon: 'github', link: 'https://github.com/aspect-ratio/Apq.Cfg' }
+      {
+        icon: {
+          svg: '<svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg"><path d="M512 1024C229.222 1024 0 794.778 0 512S229.222 0 512 0s512 229.222 512 512-229.222 512-512 512z m259.149-568.883h-290.74a25.293 25.293 0 0 0-25.292 25.293l-0.026 63.206c0 13.952 11.315 25.293 25.267 25.293h177.024c13.978 0 25.293 11.315 25.293 25.267v12.646a75.853 75.853 0 0 1-75.853 75.853h-240.23a25.293 25.293 0 0 1-25.267-25.293V417.203a75.853 75.853 0 0 1 75.827-75.853h353.946a25.293 25.293 0 0 0 25.267-25.292l0.077-63.207a25.293 25.293 0 0 0-25.268-25.293H417.152a189.62 189.62 0 0 0-189.62 189.645V771.15c0 13.977 11.316 25.293 25.294 25.293h372.94a170.65 170.65 0 0 0 170.65-170.65V480.384a25.293 25.293 0 0 0-25.293-25.267z" fill="currentColor"/></svg>'
+        },
+        link: 'https://gitee.com/apq/Apq.Cfg'
+      }
     ],
     
     footer: {
       message: '基于 MIT 许可发布',
-      copyright: 'Copyright © 2024 Apq.Cfg'
+      copyright: `Copyright © ${new Date().getFullYear()} Apq.Cfg`
     },
     
     search: {
@@ -145,8 +150,8 @@ export default defineConfig({
     },
     
     editLink: {
-      pattern: 'https://github.com/aspect-ratio/Apq.Cfg/edit/main/docs/site/:path',
-      text: '在 GitHub 上编辑此页'
+      pattern: 'https://gitee.com/apq/Apq.Cfg/edit/main/docs/site/:path',
+      text: '在 Gitee 上编辑此页'
     }
   },
   

+ 1 - 1
docs/site/DEPLOY.md

@@ -1,4 +1,4 @@
-# Apq.Cfg 文档站点部署指南
+# Apq.Cfg 文档站点部署指南
 
 本文档介绍如何将 Apq.Cfg 文档站点部署到腾讯云 CloudBase 静态网站托管。
 

+ 6 - 6
docs/site/api/cfg-builder.md

@@ -1,4 +1,4 @@
-# CfgBuilder API
+# CfgBuilder API
 
 `CfgBuilder` 是配置构建器,用于组合多个配置源并创建配置实例。
 
@@ -49,8 +49,8 @@ public CfgBuilder AddJsonFile(string path, bool optional = false, bool reloadOnC
 **示例:**
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile("appsettings.local.json", optional: true, reloadOnChange: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile("config.local.json", optional: true, reloadOnChange: true)
     .Build();
 ```
 
@@ -181,11 +181,11 @@ var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?
 
 var cfg = new CfgBuilder()
     // 基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     // 环境特定配置
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
+    .AddJsonFile($"config.{environment}.json", optional: true)
     // 本地覆盖
-    .AddJsonFile("appsettings.local.json", optional: true, reloadOnChange: true)
+    .AddJsonFile("config.local.json", optional: true, reloadOnChange: true)
     // 远程配置
     .AddConsul("http://consul:8500", "myapp/config", optional: true)
     // 环境变量

+ 4 - 4
docs/site/api/extensions.md

@@ -1,4 +1,4 @@
-# 扩展方法
+# 扩展方法
 
 本页列出 Apq.Cfg 提供的所有扩展方法。
 
@@ -293,7 +293,7 @@ public static IServiceCollection AddApqCfg(
 **示例:**
 ```csharp
 services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables());
 ```
 
@@ -317,7 +317,7 @@ services.ConfigureApqCfg<DatabaseOptions>("Database");
 ```csharp
 // 构建配置
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddYamlFile("config.yaml", optional: true)
     .AddConsul("http://consul:8500", "myapp/config", watch: true)
     .AddEnvironmentVariables("MYAPP_")
@@ -338,7 +338,7 @@ cfg.OnChange(keys =>
 
 // 依赖注入
 services.AddApqCfg(builder => builder
-    .AddJsonFile("appsettings.json"));
+    .AddJsonFile("config.json"));
 services.ConfigureApqCfg<DatabaseOptions>("Database");
 ```
 

+ 1 - 1
docs/site/api/icfg-root.md

@@ -1,4 +1,4 @@
-# ICfgRoot API
+# ICfgRoot API
 
 `ICfgRoot` 是配置根接口,提供配置读取的核心功能。
 

+ 2 - 2
docs/site/api/icfg-section.md

@@ -1,4 +1,4 @@
-# ICfgSection API
+# ICfgSection API
 
 `ICfgSection` 是配置节接口,表示配置的一个子节。
 
@@ -204,7 +204,7 @@ cfg.GetSection("Database").Bind(dbConfig);
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 // 获取配置节

+ 1 - 1
docs/site/api/index.md

@@ -1,4 +1,4 @@
-# API 概述
+# API 概述
 
 本节提供 Apq.Cfg 的完整 API 参考文档。
 

+ 1 - 1
docs/site/changelog.md

@@ -1,4 +1,4 @@
-# 更新日志
+# 更新日志
 
 ## v1.0.5 (2024-12-28)
 

+ 1 - 1
docs/site/config-sources/consul.md

@@ -1,4 +1,4 @@
-# Consul 配置源
+# Consul 配置源
 
 Consul 是 HashiCorp 的分布式服务发现和配置管理工具。
 

+ 6 - 6
docs/site/config-sources/index.md

@@ -1,4 +1,4 @@
-# 配置源概述
+# 配置源概述
 
 Apq.Cfg 支持多种配置源,可以灵活组合使用。
 
@@ -39,8 +39,8 @@ Apq.Cfg 支持多种配置源,可以灵活组合使用。
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile("appsettings.Development.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile("config.Development.json", optional: true)
     .AddEnvironmentVariables()
     .Build();
 ```
@@ -51,7 +51,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")  // 基础配置
+    .AddJsonFile("config.json")  // 基础配置
     .AddConsul("http://consul:8500", "myapp/config")  // 动态配置
     .AddVault("https://vault:8200", "secret/myapp")   // 敏感配置
     .Build();
@@ -62,9 +62,9 @@ var cfg = new CfgBuilder()
 ```csharp
 var cfg = new CfgBuilder()
     // 本地基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     // 环境特定配置
-    .AddJsonFile($"appsettings.{env}.json", optional: true)
+    .AddJsonFile($"config.{env}.json", optional: true)
     // 远程配置(可选,用于动态更新)
     .AddConsul("http://consul:8500", "myapp/config", optional: true)
     // 环境变量覆盖

+ 10 - 10
docs/site/config-sources/json.md

@@ -1,4 +1,4 @@
-# JSON 配置源
+# JSON 配置源
 
 JSON 是最常用的配置格式,Apq.Cfg 核心包内置支持。
 
@@ -16,7 +16,7 @@ dotnet add package Apq.Cfg
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 ```
 
@@ -24,8 +24,8 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile("appsettings.local.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile("config.local.json", optional: true)
     .Build();
 ```
 
@@ -33,7 +33,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
+    .AddJsonFile("config.json", optional: false, reloadOnChange: true)
     .Build();
 ```
 
@@ -158,14 +158,14 @@ var cfg = new CfgBuilder()
 var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile($"config.{environment}.json", optional: true)
     .Build();
 ```
 
 ### 配置文件示例
 
-**appsettings.json** (基础配置):
+**config.json** (基础配置):
 ```json
 {
   "Logging": {
@@ -178,7 +178,7 @@ var cfg = new CfgBuilder()
 }
 ```
 
-**appsettings.Development.json** (开发环境):
+**config.Development.json** (开发环境):
 ```json
 {
   "Logging": {
@@ -187,7 +187,7 @@ var cfg = new CfgBuilder()
 }
 ```
 
-**appsettings.Production.json** (生产环境):
+**config.Production.json** (生产环境):
 ```json
 {
   "Database": {

+ 1 - 1
docs/site/config-sources/redis.md

@@ -1,4 +1,4 @@
-# Redis 配置源
+# Redis 配置源
 
 Redis 是高性能的键值存储,适合作为配置中心使用。
 

+ 2 - 2
docs/site/config-sources/yaml.md

@@ -1,4 +1,4 @@
-# YAML 配置源
+# YAML 配置源
 
 YAML 是一种人类友好的数据序列化格式,适合复杂配置。
 
@@ -144,7 +144,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddYamlFile("config.yaml", optional: true)
     .AddEnvironmentVariables()
     .Build();

+ 3 - 3
docs/site/examples/basic.md

@@ -1,4 +1,4 @@
-# 基础示例
+# 基础示例
 
 本页展示 Apq.Cfg 的基础用法示例。
 
@@ -31,7 +31,7 @@
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 // 使用索引器
@@ -227,7 +227,7 @@ using Apq.Cfg;
 
 // 创建配置
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 // 读取应用配置

+ 4 - 4
docs/site/examples/complex-scenarios.md

@@ -1,4 +1,4 @@
-# 复杂场景示例
+# 复杂场景示例
 
 本文档提供了 Apq.Cfg 在复杂场景下的使用示例,帮助开发者解决实际项目中的配置管理挑战。
 
@@ -18,13 +18,13 @@ public static class ConfigurationBuilder
         var builder = new CfgBuilder();
 
         // 0层:基础配置,所有环境共享
-        builder.AddJson("appsettings.json", level: 0, optional: true);
+        builder.AddJson("config.json", level: 0, optional: true);
 
         // 1-3层:环境特定配置
-        builder.AddJson($"appsettings.{environment}.json", level: 1, optional: true);
+        builder.AddJson($"config.{environment}.json", level: 1, optional: true);
 
         // 4层:机器特定配置(可选)
-        builder.AddJson($"appsettings.{environment}.{Environment.MachineName}.json", 
+        builder.AddJson($"config.{environment}.{Environment.MachineName}.json", 
                      level: 4, optional: true);
 
         // 5层:环境变量,可覆盖任何文件配置

+ 7 - 7
docs/site/examples/di-integration.md

@@ -1,4 +1,4 @@
-# 依赖注入集成示例
+# 依赖注入集成示例
 
 本页展示如何将 Apq.Cfg 集成到 ASP.NET Core 依赖注入系统。
 
@@ -11,8 +11,8 @@ var builder = WebApplication.CreateBuilder(args);
 
 // 方式一:使用 AddApqCfg
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile($"config.{builder.Environment.EnvironmentName}.json", optional: true)
     .AddEnvironmentVariables());
 
 var app = builder.Build();
@@ -73,7 +73,7 @@ var builder = WebApplication.CreateBuilder(args);
 
 // 注册配置
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables());
 
 // 绑定选项
@@ -254,7 +254,7 @@ builder.Services.AddSingleton<IValidateOptions<DatabaseOptions>, DatabaseOptions
 ## 命名选项
 
 ```csharp
-// appsettings.json
+// config.json
 {
   "Databases": {
     "Primary": {
@@ -296,8 +296,8 @@ var builder = WebApplication.CreateBuilder(args);
 
 // 配置 Apq.Cfg
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile($"config.{builder.Environment.EnvironmentName}.json", optional: true)
     .AddConsul("http://consul:8500", "myapp/config", watch: true, optional: true)
     .AddEnvironmentVariables("MYAPP_"));
 

+ 2 - 2
docs/site/examples/dynamic-reload.md

@@ -1,4 +1,4 @@
-# 动态重载示例
+# 动态重载示例
 
 本页展示如何实现配置的动态重载(热更新)。
 
@@ -285,7 +285,7 @@ var builder = WebApplication.CreateBuilder(args);
 
 // 配置动态重载
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json", reloadOnChange: true)
+    .AddJsonFile("config.json", reloadOnChange: true)
     .AddConsul("http://consul:8500", "myapp/config", watch: true, optional: true)
     .ConfigureReload(options =>
     {

+ 4 - 4
docs/site/examples/index.md

@@ -1,4 +1,4 @@
-# 示例概述
+# 示例概述
 
 本节提供 Apq.Cfg 的各种使用示例。
 
@@ -26,7 +26,7 @@
 using Apq.Cfg;
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 var appName = cfg["App:Name"];
@@ -37,7 +37,7 @@ Console.WriteLine($"应用名称: {appName}");
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddYamlFile("config.yaml", optional: true)
     .AddEnvironmentVariables()
     .Build();
@@ -62,7 +62,7 @@ Console.WriteLine($"数据库: {dbConfig.Host}:{dbConfig.Port}");
 var builder = WebApplication.CreateBuilder(args);
 
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables());
 
 builder.Services.Configure<DatabaseConfig>(

+ 19 - 19
docs/site/examples/multi-source.md

@@ -1,4 +1,4 @@
-# 多配置源示例
+# 多配置源示例
 
 本页展示如何组合使用多个配置源。
 
@@ -8,7 +8,7 @@
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables()
     .Build();
 ```
@@ -33,11 +33,11 @@ var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")
 
 var cfg = new CfgBuilder()
     // 基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     // 环境特定配置
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
+    .AddJsonFile($"config.{environment}.json", optional: true)
     // 本地开发覆盖(不提交到版本控制)
-    .AddJsonFile("appsettings.local.json", optional: true)
+    .AddJsonFile("config.local.json", optional: true)
     // 环境变量(最高优先级)
     .AddEnvironmentVariables()
     .Build();
@@ -45,7 +45,7 @@ var cfg = new CfgBuilder()
 
 ### 配置文件示例
 
-**appsettings.json**(基础配置):
+**config.json**(基础配置):
 ```json
 {
   "App": {
@@ -62,7 +62,7 @@ var cfg = new CfgBuilder()
 }
 ```
 
-**appsettings.Development.json**(开发环境):
+**config.Development.json**(开发环境):
 ```json
 {
   "Logging": {
@@ -74,7 +74,7 @@ var cfg = new CfgBuilder()
 }
 ```
 
-**appsettings.Production.json**(生产环境):
+**config.Production.json**(生产环境):
 ```json
 {
   "Database": {
@@ -90,7 +90,7 @@ var cfg = new CfgBuilder()
 ```csharp
 var cfg = new CfgBuilder()
     // 本地基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     // 远程动态配置
     .AddConsul("http://consul:8500", "myapp/config", watch: true)
     // 环境变量覆盖
@@ -102,7 +102,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddRedis("localhost:6379", "config:myapp", subscribeChanges: true)
     .AddEnvironmentVariables()
     .Build();
@@ -112,7 +112,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddApollo("http://apollo:8080", "myapp", "application")
     .AddEnvironmentVariables()
     .Build();
@@ -125,7 +125,7 @@ var cfg = new CfgBuilder()
 ```csharp
 var cfg = new CfgBuilder()
     // 普通配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddConsul("http://consul:8500", "myapp/config")
     // 敏感配置(密码、密钥等)
     .AddVault("https://vault:8200", "secret/myapp")
@@ -137,7 +137,7 @@ var cfg = new CfgBuilder()
 ### 配置结构
 
 ```
-appsettings.json:
+config.json:
 {
   "Database": {
     "Host": "localhost",
@@ -200,10 +200,10 @@ var cfg = new CfgBuilder()
 // 6. 命令行参数
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")                    // 优先级 1
-    .AddJsonFile($"appsettings.{env}.json", optional: true)  // 优先级 2
+    .AddJsonFile("config.json")                    // 优先级 1
+    .AddJsonFile($"config.{env}.json", optional: true)  // 优先级 2
     .AddConsul("http://consul:8500", "myapp/config")    // 优先级 3
-    .AddJsonFile("appsettings.local.json", optional: true)   // 优先级 4
+    .AddJsonFile("config.local.json", optional: true)   // 优先级 4
     .AddEnvironmentVariables("MYAPP_")                  // 优先级 5
     .AddCommandLine(args)                               // 优先级 6
     .Build();
@@ -221,11 +221,11 @@ var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")
 
 var cfg = new CfgBuilder()
     // 基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddYamlFile("config.yaml", optional: true)
     
     // 环境特定
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
+    .AddJsonFile($"config.{environment}.json", optional: true)
     
     // 远程配置(生产环境)
     .AddConsul("http://consul:8500", "myapp/config", 
@@ -233,7 +233,7 @@ var cfg = new CfgBuilder()
         optional: environment != "Production")
     
     // 本地覆盖(开发环境)
-    .AddJsonFile("appsettings.local.json", optional: true)
+    .AddJsonFile("config.local.json", optional: true)
     
     // 环境变量
     .AddEnvironmentVariables("MYAPP_")

+ 5 - 5
docs/site/guide/architecture.md

@@ -1,4 +1,4 @@
-# 架构设计
+# 架构设计
 
 本文档详细说明 Apq.Cfg 的架构设计、核心组件和交互流程。
 
@@ -159,9 +159,9 @@ public class CfgBuilder
 配置源按 `Level` 属性排序,数值越大优先级越高:
 
 ```
-Level 0:  appsettings.json          (基础配置)
-Level 1:  appsettings.{env}.json    (环境配置)
-Level 2:  appsettings.local.json    (本地覆盖)
+Level 0:  config.json          (基础配置)
+Level 1:  config.{env}.json    (环境配置)
+Level 2:  config.local.json    (本地覆盖)
 Level 10: Consul/Nacos/Etcd         (远程配置)
 Level 15: Vault                     (密钥配置)
 Level 20: 环境变量                   (最高优先级)
@@ -357,7 +357,7 @@ public static class ServiceCollectionExtensions
 ### 编译时代码生成
 
 ```csharp
-[CfgSection("AppSettings")]
+[CfgSection("config")]
 public partial class AppConfig
 {
     public string? Name { get; set; }

+ 7 - 7
docs/site/guide/basic-usage.md

@@ -1,4 +1,4 @@
-# 基础用法
+# 基础用法
 
 本页详细介绍 Apq.Cfg 的基础用法。
 
@@ -18,8 +18,8 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile("appsettings.local.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile("config.local.json", optional: true)
     .AddYamlFile("config.yaml", optional: true)
     .AddEnvironmentVariables()
     .Build();
@@ -30,12 +30,12 @@ var cfg = new CfgBuilder()
 后添加的配置源优先级更高,会覆盖先添加的同名配置:
 
 ```csharp
-// appsettings.json: { "Key": "value1" }
-// appsettings.local.json: { "Key": "value2" }
+// config.json: { "Key": "value1" }
+// config.local.json: { "Key": "value2" }
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")        // 优先级低
-    .AddJsonFile("appsettings.local.json")  // 优先级高
+    .AddJsonFile("config.json")        // 优先级低
+    .AddJsonFile("config.local.json")  // 优先级高
     .Build();
 
 Console.WriteLine(cfg["Key"]); // 输出: value2

+ 11 - 11
docs/site/guide/best-practices.md

@@ -1,4 +1,4 @@
-# 最佳实践
+# 最佳实践
 
 本指南总结了使用 Apq.Cfg 的最佳实践。
 
@@ -8,11 +8,11 @@
 
 ```
 config/
-├── appsettings.json           # 基础配置
-├── appsettings.Development.json  # 开发环境
-├── appsettings.Staging.json      # 预发布环境
-├── appsettings.Production.json   # 生产环境
-└── appsettings.local.json        # 本地覆盖(gitignore)
+├── config.json           # 基础配置
+├── config.Development.json  # 开发环境
+├── config.Staging.json      # 预发布环境
+├── config.Production.json   # 生产环境
+└── config.local.json        # 本地覆盖(gitignore)
 ```
 
 ### 配置加载顺序
@@ -21,9 +21,9 @@ config/
 var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
-    .AddJsonFile("appsettings.local.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile($"config.{environment}.json", optional: true)
+    .AddJsonFile("config.local.json", optional: true)
     .AddEnvironmentVariables()
     .AddCommandLine(args)
     .Build();
@@ -117,7 +117,7 @@ var config = DatabaseConfig.FromConfiguration(cfg);
 
 // ✅ 推荐:使用环境变量或密钥管理
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables("MYAPP_")  // MYAPP_Database__Password
     .AddVault("https://vault.example.com", "secret/myapp")
     .Build();
@@ -127,7 +127,7 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .ConfigureEncryption(options =>
     {
         options.EncryptedKeys = new[] { "Database:Password", "Api:Secret" };

+ 6 - 6
docs/site/guide/config-merge.md

@@ -1,4 +1,4 @@
-# 配置合并
+# 配置合并
 
 Apq.Cfg 支持从多个配置源加载配置,并按优先级合并。
 
@@ -83,8 +83,8 @@ var cfg = new CfgBuilder()
 var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile($"appsettings.{environment}.json", optional: true)
+    .AddJsonFile("config.json")
+    .AddJsonFile($"config.{environment}.json", optional: true)
     .AddEnvironmentVariables()
     .Build();
 ```
@@ -104,9 +104,9 @@ var cfg = new CfgBuilder()
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
-    .AddJsonFile("appsettings.Development.json", optional: true)
-    .AddJsonFile("appsettings.local.json", optional: true)  // gitignore
+    .AddJsonFile("config.json")
+    .AddJsonFile("config.Development.json", optional: true)
+    .AddJsonFile("config.local.json", optional: true)  // gitignore
     .Build();
 ```
 

+ 4 - 4
docs/site/guide/dependency-injection.md

@@ -1,4 +1,4 @@
-# 依赖注入
+# 依赖注入
 
 Apq.Cfg 完美集成 Microsoft.Extensions.DependencyInjection。
 
@@ -11,12 +11,12 @@ var builder = WebApplication.CreateBuilder(args);
 
 // 方式一:使用 AddApqCfg 扩展方法
 builder.Services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddEnvironmentVariables());
 
 // 方式二:手动注册
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 builder.Services.AddSingleton<ICfgRoot>(cfg);
 ```
@@ -133,7 +133,7 @@ public class MyService : IDisposable
 支持同一类型的多个配置实例:
 
 ```csharp
-// appsettings.json
+// config.json
 {
   "Databases": {
     "Primary": { "Host": "primary.db.local" },

+ 1 - 1
docs/site/guide/dynamic-reload-design.md

@@ -1,4 +1,4 @@
-# 动态配置重载设计方案
+# 动态配置重载设计方案
 
 本文档详细说明 Apq.Cfg 动态配置重载功能的设计与实现。
 

+ 2 - 2
docs/site/guide/dynamic-reload.md

@@ -1,4 +1,4 @@
-# 动态重载
+# 动态重载
 
 Apq.Cfg 支持配置的动态重载,无需重启应用即可更新配置。
 
@@ -8,7 +8,7 @@ Apq.Cfg 支持配置的动态重载,无需重启应用即可更新配置。
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
+    .AddJsonFile("config.json", optional: false, reloadOnChange: true)
     .AddYamlFile("config.yaml", optional: true, reloadOnChange: true)
     .Build();
 ```

+ 1 - 1
docs/site/guide/encoding-workflow.md

@@ -1,4 +1,4 @@
-# 编码处理流程
+# 编码处理流程
 
 本文档描述 Apq.Cfg 库在读取和写入配置文件时的完整编码处理流程。
 

+ 1 - 1
docs/site/guide/encoding.md

@@ -1,4 +1,4 @@
-# 编码处理
+# 编码处理
 
 Apq.Cfg 提供强大的文件编码检测和处理能力。
 

+ 9 - 9
docs/site/guide/extension.md

@@ -1,4 +1,4 @@
-# 扩展开发
+# 扩展开发
 
 本指南介绍如何开发自定义配置源和扩展功能。
 
@@ -322,7 +322,7 @@ public static class HttpApiCfgBuilderExtensions
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddHttpApi(options =>
     {
         options.BaseUrl = "http://config-server:5000";
@@ -573,9 +573,9 @@ public static class CfgBuilderExtensions
         var path = string.IsNullOrEmpty(basePath) ? "" : basePath + "/";
         
         return builder
-            .AddJson($"{path}appsettings.json", level: 0)
-            .AddJson($"{path}appsettings.{environment}.json", level: 1, optional: true)
-            .AddJson($"{path}appsettings.local.json", level: 2, optional: true, writeable: true)
+            .AddJson($"{path}config.json", level: 0)
+            .AddJson($"{path}config.{environment}.json", level: 1, optional: true)
+            .AddJson($"{path}config.local.json", level: 2, optional: true, writeable: true)
             .AddEnvironmentVariables(prefix: "APP_", level: 10);
     }
     
@@ -585,8 +585,8 @@ public static class CfgBuilderExtensions
     public static CfgBuilder AddDevelopmentConfig(this CfgBuilder builder)
     {
         return builder
-            .AddJson("appsettings.json", level: 0)
-            .AddJson("appsettings.Development.json", level: 1, optional: true)
+            .AddJson("config.json", level: 0)
+            .AddJson("config.Development.json", level: 1, optional: true)
             .AddEnv(".env", level: 2, optional: true)
             .AddEnv(".env.local", level: 3, optional: true)
             .AddEnvironmentVariables(prefix: "APP_", level: 10);
@@ -601,8 +601,8 @@ public static class CfgBuilderExtensions
         string serviceName)
     {
         return builder
-            .AddJson("appsettings.json", level: 0)
-            .AddJson("appsettings.Production.json", level: 1, optional: true)
+            .AddJson("config.json", level: 0)
+            .AddJson("config.Production.json", level: 1, optional: true)
             .AddConsul(options =>
             {
                 options.Address = consulAddress;

+ 3 - 3
docs/site/guide/index.md

@@ -1,4 +1,4 @@
-# 简介
+# 简介
 
 Apq.Cfg 是一个高性能的 .NET 配置管理库,旨在提供统一、灵活、高效的配置管理解决方案。
 
@@ -30,7 +30,7 @@ Apq.Cfg 是一个高性能的 .NET 配置管理库,旨在提供统一、灵活
 
 ```csharp
 services.AddApqCfg(cfg => cfg
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddConsul("http://localhost:8500", "myapp/config"));
 
 // 使用 IOptions 模式
@@ -65,7 +65,7 @@ dotnet add package Apq.Cfg
 using Apq.Cfg;
 
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 // 读取配置

+ 1 - 1
docs/site/guide/installation.md

@@ -1,4 +1,4 @@
-# 安装
+# 安装
 
 本页介绍如何安装 Apq.Cfg 及其扩展包。
 

+ 259 - 132
docs/site/guide/performance.md

@@ -2,217 +2,344 @@
 
 本指南介绍 Apq.Cfg 的性能优化策略和最佳实践。
 
-## 内置优化
+## 性能基准
 
-### 值缓存
+| 场景 | 性能指标 | 说明 |
+|------|----------|------|
+| 基本读写 | 17-22 ns | Get/Set 操作纳秒级响应 |
+| 类型转换 | 67-136 ns | 支持所有标准类型 |
+| 批量操作(回调) | 零堆分配 | 比返回字典版本快 43-50% |
+| 并发读取 | 14-19 μs (16线程) | 高并发场景性能提升 19% |
+| 缓存命中 | 1.5-1.7 μs | 缓存性能提升 12% |
+| 配置节 | 18-29 ns | GetSection 操作 |
+| 源生成器 | 2.1-2.7 μs | 比反射绑定快约 100 倍 |
+| DI 解析 | 6-12 ns | Scoped 解析性能极佳 |
 
-Apq.Cfg 内置值缓存机制,避免重复解析:
+## 优化策略
 
-```csharp
-// 第一次访问:解析并缓存
-var value1 = cfg.GetValue<int>("Database:Port");
+### 1. 使用高性能批量操作
 
-// 后续访问:直接从缓存读取
-var value2 = cfg.GetValue<int>("Database:Port"); // 更快
-```
+#### ❌ 低效方式:多次单独调用
 
-### 快速集合
+```csharp
+// 每次调用都有锁开销
+var host = cfg.Get("Database:Host");
+var port = cfg.Get<int>("Database:Port");
+var name = cfg.Get("Database:Name");
+var timeout = cfg.Get<int>("Database:Timeout");
+```
 
-内部使用优化的数据结构:
+#### ✅ 高效方式:批量获取(返回字典)
 
-- 键查找:O(1) 哈希表
-- 子节遍历:优化的迭代器
-- 内存分配:对象池复用
+```csharp
+var keys = new[] { "Database:Host", "Database:Port", "Database:Name", "Database:Timeout" };
+var values = cfg.GetMany(keys);
 
-## 配置缓存策略
+var host = values["Database:Host"];
+var port = int.Parse(values["Database:Port"] ?? "5432");
+```
 
-### 启用缓存
+#### ✅✅ 最高效方式:批量获取(回调,零堆分配)
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddJsonFile("config.json")
-    .ConfigureCache(options =>
+string? host = null;
+int port = 5432;
+string? name = null;
+int timeout = 30;
+
+cfg.GetMany(new[] { "Database:Host", "Database:Port", "Database:Name", "Database:Timeout" }, 
+    (key, value) =>
     {
-        options.Enabled = true;
-        options.MaxSize = 1000;        // 最大缓存条目
-        options.ExpireAfter = TimeSpan.FromMinutes(5);
-    })
-    .Build();
+        switch (key)
+        {
+            case "Database:Host": host = value; break;
+            case "Database:Port": port = int.TryParse(value, out var p) ? p : 5432; break;
+            case "Database:Name": name = value; break;
+            case "Database:Timeout": timeout = int.TryParse(value, out var t) ? t : 30; break;
+        }
+    });
 ```
 
-### 缓存预热
+### 2. 使用配置节减少键路径解析
 
-启动时预加载常用配置:
+#### ❌ 低效方式:重复的长键路径
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddJsonFile("config.json")
-    .ConfigureCache(options =>
-    {
-        options.PreloadKeys = new[]
-        {
-            "Database:ConnectionString",
-            "Database:Timeout",
-            "App:Name"
-        };
-    })
-    .Build();
+var host = cfg.Get("Application:Services:Database:Connection:Host");
+var port = cfg.Get<int>("Application:Services:Database:Connection:Port");
+var name = cfg.Get("Application:Services:Database:Connection:Name");
 ```
 
-## 延迟加载
-
-### 按需加载配置源
+#### ✅ 高效方式:使用配置节
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddJsonFile("base.json")
-    .AddJsonFile("optional.json", optional: true, lazy: true) // 延迟加载
-    .Build();
+var dbSection = cfg.GetSection("Application:Services:Database:Connection");
+var host = dbSection.Get("Host");
+var port = dbSection.Get<int>("Port");
+var name = dbSection.Get("Name");
 ```
 
-### 延迟绑定
+### 3. 使用源生成器(Native AOT 支持)
+
+#### ❌ 低效方式:反射绑定
 
 ```csharp
-// 延迟绑定,首次访问时才解析
-var lazyConfig = new Lazy<DatabaseConfig>(() => 
-    cfg.GetSection("Database").Get<DatabaseConfig>());
+// 运行时反射,性能较差
+var options = cfg.GetSection("Database").Get<DatabaseOptions>();
+```
+
+#### ✅ 高效方式:源生成器(编译时生成)
 
-// 需要时才访问
-if (needDatabase)
+```csharp
+// 1. 定义配置类
+[CfgSection("Database")]
+public partial class DatabaseOptions
 {
-    var config = lazyConfig.Value;
+    public string? Host { get; set; }
+    public int Port { get; set; } = 5432;
+    public string? Name { get; set; }
 }
+
+// 2. 使用生成的绑定方法(零反射)
+var options = DatabaseOptions.BindFrom(cfg.GetSection("Database"));
 ```
 
-## 批量操作
+**性能对比**:源生成器比反射绑定快约 **100 倍**。
 
-### 批量读取
+### 4. 优化热重载配置
+
+#### 调整防抖时间
 
 ```csharp
-// 低效:多次访问
-var host = cfg["Database:Host"];
-var port = cfg["Database:Port"];
-var database = cfg["Database:Database"];
+var msConfig = cfg.ToMicrosoftConfiguration(new DynamicReloadOptions
+{
+    DebounceMs = 200,  // 增加防抖时间,减少重载频率
+    EnableDynamicReload = true
+});
+```
 
-// 高效:一次绑定
-var dbConfig = cfg.GetSection("Database").Get<DatabaseConfig>();
+#### 按需启用热重载
+
+```csharp
+var cfg = new CfgBuilder()
+    // 基础配置不需要热重载
+    .AddJson("config.json", level: 0, reloadOnChange: false)
+    // 只对需要动态更新的配置启用热重载
+    .AddJson("dynamic-config.json", level: 1, reloadOnChange: true)
+    .Build();
 ```
 
-### 批量监听
+### 5. 减少配置源数量
+
+#### ❌ 低效方式:过多配置源
 
 ```csharp
-// 低效:多个监听器
-cfg.OnChange("Database:Host", _ => { });
-cfg.OnChange("Database:Port", _ => { });
+var cfg = new CfgBuilder()
+    .AddJson("config1.json", level: 0)
+    .AddJson("config2.json", level: 1)
+    .AddJson("config3.json", level: 2)
+    .AddJson("config4.json", level: 3)
+    .AddJson("config5.json", level: 4)
+    // ... 更多配置源
+    .Build();
+```
 
-// 高效:监听整个节
-cfg.OnChange("Database", changes => { });
+#### ✅ 高效方式:合理组织配置源
+
+```csharp
+var cfg = new CfgBuilder()
+    .AddJson("config.json", level: 0)           // 基础配置
+    .AddJson($"config.{env}.json", level: 1)    // 环境配置
+    .AddEnvironmentVariables(prefix: "APP_", level: 2) // 覆盖配置
+    .Build();
 ```
 
-## 内存优化
+### 6. 缓存配置值
 
-### 配置对象复用
+#### 对于频繁访问的配置
 
 ```csharp
-// 使用 IOptionsMonitor 复用配置对象
-public class MyService
+public class ConfigCache
 {
-    private readonly IOptionsMonitor<DatabaseConfig> _options;
+    private readonly ICfgRoot _cfg;
+    private string? _cachedConnectionString;
+    private int _cachedTimeout;
+    private bool _initialized;
     
-    public MyService(IOptionsMonitor<DatabaseConfig> options)
+    public ConfigCache(ICfgRoot cfg)
     {
-        _options = options;
+        _cfg = cfg;
+        RefreshCache();
+        
+        // 订阅变更,自动刷新缓存
+        _cfg.ConfigChanges.Subscribe(_ => RefreshCache());
     }
     
-    // CurrentValue 返回缓存的对象
-    public DatabaseConfig Config => _options.CurrentValue;
+    private void RefreshCache()
+    {
+        _cachedConnectionString = _cfg.Get("Database:ConnectionString");
+        _cachedTimeout = _cfg.Get<int>("Database:Timeout");
+        _initialized = true;
+    }
+    
+    public string? ConnectionString => _cachedConnectionString;
+    public int Timeout => _cachedTimeout;
 }
 ```
 
-### 避免频繁绑定
+### 7. 选择合适的运行时
+
+| 运行时 | 相对性能 | 建议 |
+|--------|----------|------|
+| .NET 6.0 | 基准 | 生产可用 |
+| .NET 8.0 | +35-45% | 推荐 |
+| .NET 9.0 | +40-55% | 最佳性能 |
+
+**建议**:优先使用 .NET 8.0 或 .NET 9.0 以获得最佳性能。
+
+## 场景优化建议
+
+### 高并发读取场景
 
 ```csharp
-// 避免在循环中绑定
-// ❌ 低效
-for (int i = 0; i < 1000; i++)
-{
-    var config = cfg.GetSection("Database").Get<DatabaseConfig>();
-    // 使用 config
-}
+// 1. 使用批量操作减少锁竞争
+cfg.GetMany(keys, (key, value) => { /* 处理 */ });
 
-// ✅ 高效
-var config = cfg.GetSection("Database").Get<DatabaseConfig>();
-for (int i = 0; i < 1000; i++)
-{
-    // 使用 config
-}
-```
+// 2. 考虑使用本地缓存
+var cache = new ConcurrentDictionary<string, string?>();
+cfg.ConfigChanges.Subscribe(_ => cache.Clear());
 
-## 远程配置优化
+// 3. 使用源生成器避免反射开销
+var options = AppConfig.BindFrom(cfg.GetSection("App"));
+```
 
-### 连接池
+### 大量配置项场景
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddConsul("http://localhost:8500", "myapp/config", options =>
-    {
-        options.MaxConnections = 10;
-        options.ConnectionTimeout = TimeSpan.FromSeconds(5);
-    })
-    .Build();
+// 1. 使用 JSON 模式而非 KV 模式(远程配置中心)
+.AddConsul(options =>
+{
+    options.DataFormat = ConsulDataFormat.Json;
+    options.SingleKey = "app-config";
+})
+
+// 2. 合理划分配置节
+var dbSection = cfg.GetSection("Database");
+var loggingSection = cfg.GetSection("Logging");
 ```
 
-### 本地缓存
+### 启动性能优化
 
 ```csharp
+// 1. 延迟加载远程配置
 var cfg = new CfgBuilder()
-    .AddConsul("http://localhost:8500", "myapp/config", options =>
-    {
-        options.LocalCacheEnabled = true;
-        options.LocalCachePath = "./config-cache";
-        options.LocalCacheExpiry = TimeSpan.FromHours(1);
-    })
+    .AddJson("config.json", level: 0)  // 本地配置先加载
     .Build();
+
+// 应用启动后异步加载远程配置
+_ = Task.Run(async () =>
+{
+    await LoadRemoteConfigAsync();
+});
+
+// 2. 使用可选配置源
+.AddJson("optional-config.json", level: 1, optional: true)
 ```
 
-### 故障转移
+### 内存优化
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddConsul("http://consul1:8500", "myapp/config")
-    .AddConsul("http://consul2:8500", "myapp/config", fallback: true)
-    .AddJsonFile("config.fallback.json", fallback: true)
+// 1. 使用回调方式批量获取(零堆分配)
+cfg.GetMany(keys, (key, value) => { /* 处理 */ });
+
+// 2. 及时释放不再使用的配置
+await using var cfg = new CfgBuilder()
+    .AddJson("config.json")
     .Build();
+
+// 3. 避免频繁创建配置实例
+// ❌ 每次请求创建新实例
+// ✅ 使用单例或 Scoped 生命周期
 ```
 
 ## 性能监控
 
-### 启用指标
+### 添加性能日志
 
 ```csharp
-var cfg = new CfgBuilder()
-    .AddJsonFile("config.json")
-    .ConfigureMetrics(options =>
-    {
-        options.Enabled = true;
-        options.OnMetrics = metrics =>
-        {
-            Console.WriteLine($"缓存命中率: {metrics.CacheHitRate:P}");
-            Console.WriteLine($"平均读取时间: {metrics.AverageReadTime.TotalMicroseconds}μs");
-        };
-    })
-    .Build();
+var sw = Stopwatch.StartNew();
+var value = cfg.Get("SomeKey");
+sw.Stop();
+
+if (sw.ElapsedMilliseconds > 10)
+{
+    _logger.LogWarning("配置读取耗时过长: {Key} - {ElapsedMs}ms", "SomeKey", sw.ElapsedMilliseconds);
+}
 ```
 
-## 基准测试结果
+### 监控热重载频率
+
+```csharp
+var reloadCount = 0;
+cfg.ConfigChanges.Subscribe(_ =>
+{
+    Interlocked.Increment(ref reloadCount);
+    _logger.LogInformation("配置重载次数: {Count}", reloadCount);
+});
+```
+
+## 性能测试
+
+运行性能基准测试:
+
+```bash
+cd benchmarks/Apq.Cfg.Benchmarks
+dotnet run -c Release
+```
+
+主要测试类:
+- `GetSectionBenchmarks` - 配置节性能
+- `BatchOperationBenchmarks` - 批量操作性能
+- `ConcurrencyBenchmarks` - 并发性能
+- `SourceGeneratorBenchmarks` - 源生成器性能
+- `TypeConversionBenchmarks` - 类型转换性能
+
+## 常见性能问题
+
+### 问题 1:配置读取缓慢
+
+**可能原因**:
+- 配置源过多
+- 未使用批量操作
+- 热重载过于频繁
+
+**解决方案**:
+- 减少配置源数量
+- 使用 `GetMany` 批量获取
+- 增加防抖时间
+
+### 问题 2:内存占用过高
+
+**可能原因**:
+- 大量配置项
+- 频繁创建配置实例
+- 未释放配置资源
+
+**解决方案**:
+- 使用 JSON 模式存储配置
+- 使用单例模式
+- 正确实现 `IDisposable`
+
+### 问题 3:启动时间过长
+
+**可能原因**:
+- 远程配置中心连接慢
+- 大量配置文件
 
-| 操作 | 耗时 | 内存分配 |
-|------|------|----------|
-| 索引器读取(缓存命中) | ~50ns | 0 |
-| GetValue&lt;int&gt;(缓存命中) | ~100ns | 0 |
-| GetSection | ~200ns | 24B |
-| Get&lt;T&gt; 绑定(小对象) | ~1μs | 64B |
-| Get&lt;T&gt; 绑定(大对象) | ~5μs | 256B |
+**解决方案**:
+- 本地配置优先加载
+- 异步加载远程配置
+- 使用可选配置源
 
 ## 下一步
 

+ 5 - 5
docs/site/guide/quick-start.md

@@ -1,4 +1,4 @@
-# 快速开始
+# 快速开始
 
 本教程将帮助您在 5 分钟内上手 Apq.Cfg。
 
@@ -15,7 +15,7 @@ dotnet add package Apq.Cfg
 
 ## 创建配置文件
 
-创建 `appsettings.json`:
+创建 `config.json`:
 
 ```json
 {
@@ -44,7 +44,7 @@ using Apq.Cfg;
 
 // 1. 创建配置构建器并加载配置
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .Build();
 
 // 2. 读取简单值
@@ -116,9 +116,9 @@ Apq.Cfg 支持从多个来源加载配置:
 ```csharp
 var cfg = new CfgBuilder()
     // 基础配置
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     // 环境特定配置(覆盖基础配置)
-    .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")}.json", optional: true)
+    .AddJsonFile($"config.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")}.json", optional: true)
     // 环境变量(最高优先级)
     .AddEnvironmentVariables()
     .Build();

+ 15 - 15
docs/site/guide/source-selection.md

@@ -1,4 +1,4 @@
-# 配置源选择指南
+# 配置源选择指南
 
 本文档帮助您根据不同场景选择合适的配置源。
 
@@ -40,8 +40,8 @@
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
-    .AddJson($"appsettings.{env}.json", level: 1, optional: true)
+    .AddJson("config.json", level: 0)
+    .AddJson($"config.{env}.json", level: 1, optional: true)
     .AddEnvironmentVariables(prefix: "APP_", level: 2)
     .Build();
 ```
@@ -53,7 +53,7 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddConsul(options => {
         options.Address = "http://consul:8500";
         options.KeyPrefix = $"services/{serviceName}/";
@@ -69,7 +69,7 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddYaml("/config/app-config.yaml", level: 1, reloadOnChange: true)
     .AddEnvironmentVariables(level: 2)
     .Build();
@@ -82,7 +82,7 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddNacos(options => {
         options.ServerAddresses = "mse-xxx.nacos.mse.aliyuncs.com:8848";
         options.AccessKey = Environment.GetEnvironmentVariable("NACOS_AK");
@@ -100,7 +100,7 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddApollo(options => {
         options.AppId = "my-app";
         options.MetaServer = "http://apollo-meta:8080";
@@ -118,7 +118,7 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     .AddVaultAppRole(
         address: "https://vault.example.com:8200",
         roleId: Environment.GetEnvironmentVariable("VAULT_ROLE_ID")!,
@@ -155,8 +155,8 @@ var cfg = new CfgBuilder()
 **推荐配置**:
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json", level: 0)
-    .AddJson("appsettings.Development.json", level: 1, optional: true)
+    .AddJson("config.json", level: 0)
+    .AddJson("config.Development.json", level: 1, optional: true)
     .AddEnv(".env", level: 2, optional: true)
     .AddEnv(".env.local", level: 3, optional: true)
     .AddEnvironmentVariables(prefix: "APP_", level: 4)
@@ -180,13 +180,13 @@ level 20+:   环境变量/命令行(覆盖配置)
 ```csharp
 var cfg = new CfgBuilder()
     // 基础配置(打包在应用中)
-    .AddJson("appsettings.json", level: 0)
+    .AddJson("config.json", level: 0)
     
     // 环境特定配置(可选)
-    .AddJson($"appsettings.{env}.json", level: 1, optional: true)
+    .AddJson($"config.{env}.json", level: 1, optional: true)
     
     // 本地覆盖(开发用,不提交版本控制)
-    .AddJson("appsettings.local.json", level: 2, optional: true, writeable: true)
+    .AddJson("config.local.json", level: 2, optional: true, writeable: true)
     
     // 远程配置中心(生产环境)
     .AddConsul(options => { /* ... */ }, level: 10)
@@ -228,7 +228,7 @@ var cfg = new CfgBuilder()
 
 ## 迁移建议
 
-### 从 appsettings.json 迁移到配置中心
+### 从 config.json 迁移到配置中心
 
 1. **保持本地配置作为默认值**
 2. **配置中心只存储需要动态修改的配置**
@@ -241,7 +241,7 @@ Apq.Cfg 兼容 `Microsoft.Extensions.Configuration`,可以通过 `ToMicrosoftC
 
 ```csharp
 var cfg = new CfgBuilder()
-    .AddJson("appsettings.json")
+    .AddJson("config.json")
     .Build();
 
 // 转换为 IConfiguration,兼容现有代码

+ 3 - 3
docs/site/index.md

@@ -1,4 +1,4 @@
----
+---
 layout: home
 
 hero:
@@ -14,7 +14,7 @@ hero:
       link: /guide/
     - theme: alt
       text: 在 Gitee 上查看
-      link: https://gitee.com/AlanPoon/Apq.Cfg
+      link: https://gitee.com/apq/Apq.Cfg
 
 features:
   - icon: 🚀
@@ -69,7 +69,7 @@ using Apq.Cfg;
 
 // 创建配置
 var cfg = new CfgBuilder()
-    .AddJsonFile("appsettings.json")
+    .AddJsonFile("config.json")
     .AddYamlFile("config.yaml", optional: true)
     .AddEnvironmentVariables()
     .Build();