roadmap

configx Roadmap（2026-03）

定位

configx 是分层配置加载与校验组件，不是完整配置中心。

• 保持配置源合并行为可预测。
• 保持校验策略显式、可解释。

当前状态

• 已具备 dotenv/文件/环境变量加载、默认值、优先级控制、校验能力。
• 已提供可选可观测性接入点。
• 主要缺口：源冲突诊断、优先级/校验策略决策指引、可插拔远程源扩展路径。

版本规划（建议）

• v0.3：优先级与校验实践文档 + 诊断增强
• v0.4：冲突/解码/校验错误可见性强化
• v0.5：可选远程/密钥管理源插件化

优先级建议

P0（当前）

• 完成源优先级与常见模式文档。
• 给出实用校验模板（strict/lenient/service-cli）。
• 强化解码/校验失败错误提示。

P1（下一阶段）

• 增强多源覆盖同键的冲突诊断。
• 提供有效值来源追踪（source metadata）。
• 完善 load/reload/validate 生命周期可观测性事件。

P2（后续）

• 在不耦合核心包的前提下支持可插拔远程配置源。
• 增加 secret source 适配并保持依赖边界清晰。

非目标

• 不做重型运行时配置中心。
• 不提供隐式热更新语义（必须显式启用）。
• 不绑定单一云厂商配置源。

迁移来源

• 内容汇总自 ArcGo 全局 roadmap 草案与当前包状态。
• 本页为 docs 内维护的正式 roadmap。