json-config-loader

用途

json-config-loader 是一个 bash 配置解析模式集合，用于把配置文件中的内容加载到 bash 脚本里。它覆盖了配置文件解析的常见做法，帮助脚本以一致的方式读取 key=value、INI 和 JSON 等格式的配置。该技能从 workspace-hub 的配置脚本中抽取而来，版本 1.0.0 于 2026-01-14 首次发布。

主要能力

根据技能说明，其处理范围包括：

• 从文件加载配置到 bash 脚本
• 解析 key=value 或 INI 风格的配置文件
• 使用 jq 处理 JSON 数据
• 从 bash 生成 JSON 报告
• 使用关联数组管理配置
• 支持 key=value、JSON 和环境变量覆盖（见完整示例 Config Manager 的说明）

文档中给出的完整示例是一个通用配置管理器，声明了 CONFIG 关联数组、CONFIG_FILE 与 CONFIG_FORMAT 变量，并包含格式检测函数 detect_format。完整细节被放置在各个子技能中。

使用方式

技能以子技能形式组织，包括：

• 1. Key=Value Configuration Parsing（并含一项额外内容）
• 1. JSON Report Generation
• 1. Multi-Section INI Parsing
• 1. Environment Variable Configuration
• 1. YAML Configuration (via yq)
• 1. Always Provide Defaults（并含四项额外内容）

完整示例以 bash 脚本形式呈现，使用 set -e，并通过 declare -A 定义配置存储。示例中包含格式检测逻辑，根据文件扩展名判断格式。更多实现细节需参见各子技能文档。

适用场景

明确适合的场景包括：

• 需要在 bash 脚本中从文件加载配置
• 需要解析 key=value 或 INI 风格配置
• 需要用 jq 处理 JSON 数据
• 需要从 bash 生成 JSON 报告
• 需要用关联数组管理配置

同时，文档列出了不适合的场景：

• 复杂嵌套配置（建议改用 Python）
• 实时配置变更（建议使用守护进程）
• 带有复杂校验规则的配置

限制

该技能面向 bash 生态，复杂嵌套配置并非其目标场景；实时变更与复杂校验也不在其覆盖范围内，文档明确建议改用其他方案。关于收费、价格等信息，资料中暂未提供。

参考资源

文档列出了 jq Manual、yq Documentation 与 Bash Associative Arrays 三份外部参考链接。