层级配置管理
Hierarchical Configuration Management
解决 AI CLI 工具在多环境、多项目场景下的配置优先级和覆盖问题
子问题
1.多层配置优先级
2.环境变量映射
3.配置文件格式
4.文件过滤规则
5.敏感信息保护
6.跨平台系统级配置路径适配
7.环境变量命名约定优先级排序
8.上下文记忆文件的模块化导入与循环检测
各项目的解法1 solutions
Signals
横向对比
| 维度 | iflow-cli |
|---|---|
| 配置层级数 | 6 层：默认值→用户→项目→系统→环境变量→CLI参数 |
| 环境变量策略 | IFLOW_ 前缀 + 4 种命名约定（camelCase/UNDERSCORE × 大小写前缀） |
| 配置文件格式 | JSON（settings.json），支持 $VAR/${VAR} 环境变量引用 |
| 文件过滤规则 | .iflowignore 独立于 .gitignore，兼容 gitignore 语法 |
| 上下文记忆层级 | IFLOW.md 三层（全局→项目→子目录）+ @ 导入 + 循环检测 |
| 跨平台适配 | 系统级配置路径按 Linux/macOS/Windows 自动选择 |
| 企业管控 | 系统级 settings.json + IFLOW_CLI_SYSTEM_SETTINGS_PATH 自定义路径 |
最佳实践
1.实现多层配置优先级
2.支持环境变量引用
3.提供 .ignore 文件过滤
4.用命名空间前缀隔离环境变量避免冲突
5.系统级配置路径支持环境变量自定义覆盖
6.记忆文件支持 @ 导入实现模块化管理