SuperAPI AI 工具集

configuration

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:该技能面向 Effect(TypeScript 库)的配置管理,帮助在 Effect 程序中以类型安全方式读取和校验配置。

主要能力:提供 Config.string、Config.number、Config.boolean、Config.integer 等基础类型;支持默认值(Config.withDefault)、可选配置(Config.option)、组合(Config.all)、嵌套(Config.nested);可用 Effect Schema 做复杂校验(Config.mapOrFail);敏感值用 Config.redacted 与 Config.secret 防止日志泄露;支持 Config.map 转换、Config.orElse 回退。

配置来源:默认从环境变量读取,也可用 ConfigProvider.fromJson、ConfigProvider.fromMap 自定义来源,并用 ConfigProvider.orElse 组合多个来源;可通过 Layer.setConfigProvider 注入。

使用方式:在 Effect.gen 中 yield* 配置项,再用 Effect.runPromise 运行;配置可封装进 Layer.effect 供应用使用。测试时用 ConfigProvider.fromMap 提供模拟值,或用 Config.succeed 硬编码。

错误处理:配置失败产生 ConfigError,可用 Effect.catchTag 捕获并转换。

限制:资料未提供具体版本要求、性能数据或收费信息;示例代码需按实际项目调整,完整 API 参考见 ${CLAUDE_PLUGIN_ROOT}/references/llms-full.txt。