问题域/PD-189

配置管理

Configuration Management

多层级配置加载、验证、热更新与敏感信息保护

子问题

1.多源配置合并优先级

2.配置校验与友好错误提示

3.敏感信息掩码

4.配置文件多路径自动发现与优先级

5.功能级按需验证(不阻塞无关功能)

6.配置文件嵌套结构到运行时扁平结构的映射

各项目的解法1 solutions

Signals

横向对比

维度md2wechat-skill
加载策略三层覆盖:硬编码默认值 → YAML/JSON 配置文件 → 环境变量
文件发现9 路径自动发现,用户目录优先于项目目录
格式支持YAML + JSON 双格式,按扩展名自动分发
验证机制基础验证 + 功能级按需验证,ConfigError 含 Hint 操作提示
敏感保护maskIf 首尾保留 + SaveConfig 0600 权限
CLI 集成config show/validate/init 三子命令,延迟加载不阻塞 help

最佳实践

1.环境变量>配置文件>默认值三层优先级

2.配置文件加载失败只警告不报错,允许纯环境变量模式

3.SaveConfig 使用 0600 权限保护敏感凭证

4.延迟加载配置,help 等命令无需配置即可运行