feat: 引入 Viper 实现多层配置管理

引入 Viper 配置管理框架，支持 CLI 参数、环境变量、配置文件和默认值四种配置方式。

主要变更：
- 引入 Viper、pflag、validator、mapstructure 依赖
- 实现配置优先级：CLI > ENV > File > Default
- 所有 13 个配置项支持 CLI 参数和环境变量
- 规范化命名：server.port → NEX_SERVER_PORT → --server-port
- 使用结构体验证器进行配置验证
- 添加配置摘要输出功能

新增能力：
- cli-config: 命令行参数配置支持
- env-config: 环境变量配置支持（符合 12-Factor App）
- config-priority: 配置优先级管理

修改能力：
- config-management: 扩展为多层配置源支持

使用示例：
  ./server --server-port 9000 --log-level debug
  export NEX_SERVER_PORT=9000 && ./server
  ./server --config /path/to/custom.yaml

openspec/specs/cli-config/spec.md

@@ -0,0 +1,106 @@
+# CLI Config
+
+## Purpose
+
+提供命令行参数配置支持，允许用户通过 CLI 参数临时覆盖配置，方便测试、调试和一次性使用场景。
+
+## Requirements
+
+### Requirement: 命令行参数配置支持
+
+系统 SHALL 支持通过命令行参数设置所有配置项。
+
+#### Scenario: 基本参数解析
+
+- **WHEN** 应用启动时传入命令行参数
+- **THEN** SHALL 解析所有 CLI 参数
+- **THEN** SHALL 将参数值应用到对应配置项
+
+#### Scenario: 参数命名规范
+
+- **WHEN** 使用命令行参数
+- **THEN** SHALL 使用 kebab-case 命名（如 `--server-port`）
+- **THEN** SHALL 保持完整的层次结构（如 `--database-max-idle-conns`）
+- **THEN** SHALL 与配置文件路径对应（`database.max_idle_conns` → `--database-max-idle-conns`）
+
+#### Scenario: 参数类型支持
+
+- **WHEN** 解析不同类型的参数
+- **THEN** SHALL 支持 int 类型（如 `--server-port 9000`）
+- **THEN** SHALL 支持 string 类型（如 `--database-path /data/nex.db`）
+- **THEN** SHALL 支持 duration 类型（如 `--server-read-timeout 60s`）
+- **THEN** SHALL 支持 bool 类型（如 `--log-compress`）
+
+### Requirement: 配置文件路径参数
+
+系统 SHALL 支持通过 CLI 参数指定配置文件路径。
+
+#### Scenario: 自定义配置文件路径
+
+- **WHEN** 启动时指定 `--config /path/to/custom.yaml`
+- **THEN** SHALL 从指定路径加载配置文件
+- **THEN** SHALL NOT 使用默认路径 `~/.nex/config.yaml`
+
+#### Scenario: 未指定配置文件路径
+
+- **WHEN** 启动时未指定 `--config` 参数
+- **THEN** SHALL 使用默认路径 `~/.nex/config.yaml`
+
+### Requirement: 完整配置覆盖
+
+系统 SHALL 支持通过 CLI 参数覆盖所有配置项。
+
+#### Scenario: 服务器配置参数
+
+- **WHEN** 使用服务器相关参数
+- **THEN** SHALL 支持 `--server-port`
+- **THEN** SHALL 支持 `--server-read-timeout`
+- **THEN** SHALL 支持 `--server-write-timeout`
+
+#### Scenario: 数据库配置参数
+
+- **WHEN** 使用数据库相关参数
+- **THEN** SHALL 支持 `--database-path`
+- **THEN** SHALL 支持 `--database-max-idle-conns`
+- **THEN** SHALL 支持 `--database-max-open-conns`
+- **THEN** SHALL 支持 `--database-conn-max-lifetime`
+
+#### Scenario: 日志配置参数
+
+- **WHEN** 使用日志相关参数
+- **THEN** SHALL 支持 `--log-level`
+- **THEN** SHALL 支持 `--log-path`
+- **THEN** SHALL 支持 `--log-max-size`
+- **THEN** SHALL 支持 `--log-max-backups`
+- **THEN** SHALL 支持 `--log-max-age`
+- **THEN** SHALL 支持 `--log-compress`
+
+### Requirement: 参数帮助信息
+
+系统 SHALL 提供完整的参数帮助信息。
+
+#### Scenario: 帮助文档生成
+
+- **WHEN** 使用 `--help` 参数
+- **THEN** SHALL 显示所有支持的参数
+- **THEN** SHALL 按功能分组展示参数（服务器、数据库、日志）
+- **THEN** SHALL 显示每个参数的默认值
+- **THEN** SHALL 显示每个参数的说明
+
+### Requirement: 参数错误处理
+
+系统 SHALL 正确处理参数错误。
+
+#### Scenario: 无效参数值
+
+- **WHEN** 传入无效的参数值（如 `--server-port abc`）
+- **THEN** SHALL 返回明确的错误信息
+- **THEN** SHALL 指示参数名称和期望类型
+- **THEN** SHALL NOT 启动应用
+
+#### Scenario: 未知参数
+
+- **WHEN** 传入未定义的参数（如 `--unknown-param value`）
+- **THEN** SHALL 返回错误信息
+- **THEN** SHALL 指示未知参数名称
+- **THEN** SHALL NOT 启动应用

openspec/specs/config-management/spec.md

@@ -8,10 +8,16 @@
 
 #### Scenario: 配置文件路径
 
-- **WHEN** 应用启动
+- **WHEN** 应用启动且未指定 `--config` 参数
 - **THEN** SHALL 从 `~/.nex/config.yaml` 加载配置
 - **THEN** SHALL 解析 YAML 格式
 
+#### Scenario: 自定义配置文件路径
+
+- **WHEN** 应用启动且指定 `--config /path/to/custom.yaml`
+- **THEN** SHALL 从指定路径加载配置文件
+- **THEN** SHALL NOT 使用默认路径 `~/.nex/config.yaml`
+
 #### Scenario: 配置文件结构
 
 - **WHEN** 加载配置文件
@@ -24,14 +30,14 @@
 
 #### Scenario: 配置文件不存在
 
-- **WHEN** 应用启动且 `~/.nex/config.yaml` 不存在
+- **WHEN** 应用启动且配置文件不存在
 - **THEN** SHALL 自动创建配置文件
 - **THEN** SHALL 写入默认配置值
 - **THEN** SHALL 记录日志提示已创建
 
 #### Scenario: 配置文件已存在
 
-- **WHEN** 应用启动且 `~/.nex/config.yaml` 已存在
+- **WHEN** 应用启动且配置文件已存在
 - **THEN** SHALL 直接加载配置文件
 - **THEN** SHALL NOT 覆盖现有配置
 
@@ -49,8 +55,9 @@
 
 - **WHEN** 加载配置
 - **THEN** SHALL 验证端口号范围（1-65535）
-- **THEN** SHALL 验证日志级别有效性
+- **THEN** SHALL 验证日志级别有效性（debug/info/warn/error）
 - **THEN** SHALL 验证路径有效性
+- **THEN** SHALL 验证数值范围（如 max_idle_conns ≥ 1）
 
 #### Scenario: 配置错误处理
 
@@ -121,3 +128,85 @@
 - **THEN** SHALL 应用新配置到可动态调整的参数
 
 注：当前版本不支持，仅为未来扩展预留接口。
+
+### Requirement: 多层配置源支持
+
+系统 SHALL 支持多种配置源。
+
+#### Scenario: 配置源类型
+
+- **WHEN** 加载配置
+- **THEN** SHALL 支持命令行参数配置源
+- **THEN** SHALL 支持环境变量配置源
+- **THEN** SHALL 支持配置文件配置源
+- **THEN** SHALL 支持默认值配置源
+
+#### Scenario: 配置源合并
+
+- **WHEN** 多个配置源同时存在
+- **THEN** SHALL 合并所有配置源
+- **THEN** SHALL 按优先级处理冲突
+- **THEN** SHALL 生成最终配置
+
+### Requirement: 配置加载流程
+
+系统 SHALL 实现标准化的配置加载流程。
+
+#### Scenario: 加载步骤
+
+- **WHEN** 应用启动
+- **THEN** SHALL 按以下顺序加载配置：
+  1. 解析 CLI 参数（获取 --config 路径）
+  2. 初始化配置管理器
+  3. 设置默认值
+  4. 绑定 CLI 参数
+  5. 绑定环境变量
+  6. 读取配置文件
+  7. 反序列化到结构体
+  8. 验证配置
+  9. 打印配置摘要
+
+#### Scenario: 加载失败处理
+
+- **WHEN** 配置加载过程中发生错误
+- **THEN** SHALL 返回明确的错误信息
+- **THEN** SHALL 指示失败步骤
+- **THEN** SHALL NOT 启动应用
+
+### Requirement: 配置摘要输出
+
+系统 SHALL 在启动时输出配置摘要。
+
+#### Scenario: 摘要内容
+
+- **WHEN** 配置加载完成
+- **THEN** SHALL 打印关键配置项（端口、数据库路径、日志级别等）
+- **THEN** SHALL 打印配置文件路径
+- **THEN** SHALL 打印环境变量数量
+- **THEN** SHALL 打印 CLI 参数数量
+
+#### Scenario: 摘要格式
+
+- **WHEN** 打印配置摘要
+- **THEN** SHALL 使用清晰的格式化输出
+- **THEN** SHALL 使用分隔线和分组
+- **THEN** SHALL 易于阅读和理解
+
+### Requirement: 配置结构体验证
+
+系统 SHALL 使用结构体 tag 进行配置验证。
+
+#### Scenario: 验证规则定义
+
+- **WHEN** 定义配置结构体
+- **THEN** SHALL 使用 `validate` tag 定义验证规则
+- **THEN** SHALL 支持 `required` 规则
+- **THEN** SHALL 支持 `min`、`max` 规则
+- **THEN** SHALL 支持 `oneof` 规则
+
+#### Scenario: 验证执行
+
+- **WHEN** 加载配置后
+- **THEN** SHALL 自动执行结构体验证
+- **THEN** SHALL 返回验证错误
+- **THEN** SHALL NOT 启动应用（如果验证失败）

openspec/specs/config-priority/spec.md

@@ -0,0 +1,117 @@
+# Config Priority
+
+## Purpose
+
+实现配置优先级管理，确保多层配置源的正确合并和覆盖，提供配置来源追踪和透明性。
+
+## Requirements
+
+### Requirement: 配置优先级管理
+
+系统 SHALL 实现明确的配置优先级机制。
+
+#### Scenario: 优先级顺序
+
+- **WHEN** 同一配置项在多个配置源中设置
+- **THEN** SHALL 按以下优先级顺序（从高到低）：
+  1. CLI 参数
+  2. 环境变量
+  3. 配置文件
+  4. 默认值
+
+#### Scenario: CLI 参数最高优先级
+
+- **WHEN** 配置文件设置 `server.port: 9826`
+- **AND** 环境变量设置 `NEX_SERVER_PORT=9000`
+- **AND** CLI 参数设置 `--server-port 8080`
+- **THEN** SHALL 使用 CLI 参数值 8080
+
+#### Scenario: 环境变量次高优先级
+
+- **WHEN** 配置文件设置 `server.port: 9826`
+- **AND** 环境变量设置 `NEX_SERVER_PORT=9000`
+- **AND** 未设置 CLI 参数
+- **THEN** SHALL 使用环境变量值 9000
+
+#### Scenario: 配置文件次低优先级
+
+- **WHEN** 配置文件设置 `server.port: 9826`
+- **AND** 未设置环境变量
+- **AND** 未设置 CLI 参数
+- **THEN** SHALL 使用配置文件值 9826
+
+#### Scenario: 默认值最低优先级
+
+- **WHEN** 配置文件中未设置某配置项
+- **AND** 未设置环境变量
+- **AND** 未设置 CLI 参数
+- **THEN** SHALL 使用默认值
+
+### Requirement: 配置来源追踪
+
+系统 SHALL 追踪每个配置值的来源。
+
+#### Scenario: 来源记录
+
+- **WHEN** 加载配置完成
+- **THEN** SHALL 记录每个配置项的来源（CLI/ENV/File/Default）
+- **THEN** SHALL 在配置摘要中显示来源信息
+
+#### Scenario: 来源统计
+
+- **WHEN** 打印配置摘要
+- **THEN** SHALL 统计来自 CLI 参数的配置项数量
+- **THEN** SHALL 统计来自环境变量的配置项数量
+- **THEN** SHALL 统计来自配置文件的配置项数量
+- **THEN** SHALL 统计使用默认值的配置项数量
+
+### Requirement: 配置覆盖透明性
+
+系统 SHALL 提供配置覆盖的透明信息。
+
+#### Scenario: 覆盖提示
+
+- **WHEN** CLI 参数覆盖配置文件值
+- **THEN** SHALL 在日志中记录覆盖信息
+- **THEN** SHALL 显示被覆盖的配置项名称
+
+#### Scenario: 配置摘要展示
+
+- **WHEN** 应用启动完成
+- **THEN** SHALL 打印配置摘要
+- **THEN** SHALL 显示关键配置项的最终值
+- **THEN** SHALL 显示配置文件路径
+- **THEN** SHALL 显示环境变量数量
+- **THEN** SHALL 显示 CLI 参数数量
+
+### Requirement: 部分配置覆盖
+
+系统 SHALL 支持部分配置覆盖。
+
+#### Scenario: 混合配置源
+
+- **WHEN** 配置文件设置完整配置
+- **AND** CLI 参数仅覆盖部分配置项
+- **THEN** SHALL 合并所有配置源
+- **THEN** SHALL 使用 CLI 参数覆盖指定项
+- **THEN** SHALL 保留配置文件中的其他配置项
+
+#### Scenario: 配置项独立覆盖
+
+- **WHEN** 仅通过 CLI 参数设置 `--server-port 9000`
+- **THEN** SHALL 仅覆盖 server.port 配置项
+- **THEN** SHALL NOT 影响其他配置项
+- **THEN** SHALL 其他配置项使用配置文件或默认值
+
+### Requirement: 配置优先级不可变性
+
+系统 SHALL 确保配置优先级在运行时不可变。
+
+#### Scenario: 启动后配置锁定
+
+- **WHEN** 应用启动完成
+- **THEN** SHALL 锁定配置值
+- **THEN** SHALL NOT 支持运行时修改配置优先级
+- **THEN** SHALL NOT 支持运行时添加新配置源
+
+注：配置热重载为未来扩展功能，当前版本不支持。

openspec/specs/env-config/spec.md

@@ -0,0 +1,111 @@
+# Env Config
+
+## Purpose
+
+提供环境变量配置支持，符合 12-Factor App 原则，便于容器化部署和多环境配置管理。
+
+## Requirements
+
+### Requirement: 环境变量配置支持
+
+系统 SHALL 支持通过环境变量设置所有配置项。
+
+#### Scenario: 环境变量读取
+
+- **WHEN** 应用启动时存在环境变量
+- **THEN** SHALL 自动读取所有 `NEX_` 前缀的环境变量
+- **THEN** SHALL 将环境变量值应用到对应配置项
+
+#### Scenario: 环境变量命名规范
+
+- **WHEN** 使用环境变量配置
+- **THEN** SHALL 使用 `NEX_` 前缀
+- **THEN** SHALL 使用大写字母和下划线分隔（如 `NEX_SERVER_PORT`）
+- **THEN** SHALL 保持完整层次结构（如 `NEX_DATABASE_MAX_IDLE_CONNS`）
+- **THEN** SHALL 与配置文件路径对应（`database.max_idle_conns` → `NEX_DATABASE_MAX_IDLE_CONNS`）
+
+#### Scenario: 环境变量类型转换
+
+- **WHEN** 解析不同类型的环境变量
+- **THEN** SHALL 支持 int 类型（如 `NEX_SERVER_PORT=9000`）
+- **THEN** SHALL 支持 string 类型（如 `NEX_DATABASE_PATH=/data/nex.db`）
+- **THEN** SHALL 支持 duration 类型（如 `NEX_SERVER_READ_TIMEOUT=60s`）
+- **THEN** SHALL 支持 bool 类型（如 `NEX_LOG_COMPRESS=true`）
+
+### Requirement: 完整配置覆盖
+
+系统 SHALL 支持通过环境变量覆盖所有配置项。
+
+#### Scenario: 服务器配置环境变量
+
+- **WHEN** 设置服务器相关环境变量
+- **THEN** SHALL 支持 `NEX_SERVER_PORT`
+- **THEN** SHALL 支持 `NEX_SERVER_READ_TIMEOUT`
+- **THEN** SHALL 支持 `NEX_SERVER_WRITE_TIMEOUT`
+
+#### Scenario: 数据库配置环境变量
+
+- **WHEN** 设置数据库相关环境变量
+- **THEN** SHALL 支持 `NEX_DATABASE_PATH`
+- **THEN** SHALL 支持 `NEX_DATABASE_MAX_IDLE_CONNS`
+- **THEN** SHALL 支持 `NEX_DATABASE_MAX_OPEN_CONNS`
+- **THEN** SHALL 支持 `NEX_DATABASE_CONN_MAX_LIFETIME`
+
+#### Scenario: 日志配置环境变量
+
+- **WHEN** 设置日志相关环境变量
+- **THEN** SHALL 支持 `NEX_LOG_LEVEL`
+- **THEN** SHALL 支持 `NEX_LOG_PATH`
+- **THEN** SHALL 支持 `NEX_LOG_MAX_SIZE`
+- **THEN** SHALL 支持 `NEX_LOG_MAX_BACKUPS`
+- **THEN** SHALL 支持 `NEX_LOG_MAX_AGE`
+- **THEN** SHALL 支持 `NEX_LOG_COMPRESS`
+
+### Requirement: 环境变量优先级
+
+系统 SHALL 确保环境变量优先级高于配置文件但低于 CLI 参数。
+
+#### Scenario: 环境变量覆盖配置文件
+
+- **WHEN** 配置文件设置 `server.port: 9826`
+- **AND** 环境变量设置 `NEX_SERVER_PORT=9000`
+- **THEN** SHALL 使用环境变量值 9000
+
+#### Scenario: CLI 参数覆盖环境变量
+
+- **WHEN** 环境变量设置 `NEX_SERVER_PORT=9000`
+- **AND** CLI 参数设置 `--server-port 8080`
+- **THEN** SHALL 使用 CLI 参数值 8080
+
+### Requirement: 12-Factor App 合规
+
+系统 SHALL 符合 12-Factor App 配置原则。
+
+#### Scenario: 配置与代码分离
+
+- **WHEN** 应用部署到不同环境
+- **THEN** SHALL 通过环境变量区分环境配置
+- **THEN** SHALL NOT 修改代码或配置文件
+
+#### Scenario: 敏感信息保护
+
+- **WHEN** 配置包含敏感信息（如密钥、密码）
+- **THEN** SHALL 通过环境变量传递
+- **THEN** SHALL NOT 存储在配置文件中
+
+### Requirement: 环境变量错误处理
+
+系统 SHALL 正确处理环境变量错误。
+
+#### Scenario: 无效环境变量值
+
+- **WHEN** 环境变量值格式无效（如 `NEX_SERVER_PORT=abc`）
+- **THEN** SHALL 返回明确的错误信息
+- **THEN** SHALL 指示环境变量名称和期望类型
+- **THEN** SHALL NOT 启动应用
+
+#### Scenario: 环境变量缺失
+
+- **WHEN** 必需配置项既无配置文件也无环境变量
+- **THEN** SHALL 使用默认值
+- **THEN** SHALL 正常启动应用