用途:为 LlamaFarm 的配置模块(config/)提供模式与最佳实践,实现 YAML/TOML/JSON 配置的加载、保存与 JSONSchema 校验。
主要能力:datamodel.py 由 JSONSchema 自动生成 Pydantic v2 模型;schema.yaml 为含 $ref 的源模式,compile_schema.py 解引用生成 schema.deref.yaml,generate_types.py 经 datamodel-codegen 生成 Python 类型;validators.py 补充 JSONSchema 无法表达的跨字段约束(如重名检查);helpers/loader.py 负责加载、保存与格式识别,helpers/generator.py 基于模板生成配置。YAML 使用 ruamel.yaml 保留注释与引号。
技术栈:Python 3.11+、Pydantic v2(ConfigDict、Field、约束类型)、JSONSchema Draft-07(jsonref 解引用)、ruamel.yaml、datamodel-codegen。
使用方式:修改 schema.yaml 后运行 nx run generate-types 编译并生成类型;需要新跨字段约束时更新 validators.py;用 uv run python config/validate_config.py path/to/llamafarm.yaml --verbose 校验配置;用 uv run pytest config/tests/ -v 运行测试;用 ruff check config/ --fix 与 ruff format config/ 做检查与格式化。
适用场景:维护 LlamaFarm 配置模式、生成类型、编写自定义校验器及配置加载逻辑。
限制:资料未提供安装步骤、收费信息、平台支持范围及具体性能数据;部分内容依赖共享技能文档(patterns、typing、testing、error-handling、security)与框架清单(pydantic.md、jsonschema.md),这些文档细节暂未提供。