该技能用于开发 Keboola Component 的配置架构与用户界面,聚焦配置架构设计(configSchema.json、configRowSchema.json)、基于 options.dependencies 的条件字段、UI 元素与表单控件、用于动态加载字段的同步动作(sync actions),以及架构测试与校验。
核心原则:条件字段必须使用 Keboola 的 options.dependencies,而不是 JSON Schema 的 dependencies(后者会生成 switcher);所有属性应保持平铺结构,不要把条件属性嵌进 oneOf 或 allOf;布尔依赖用 true/false,多值用数组;加密字段以 # 前缀命名(如 #password、#api_key)并配合 format: password。
支持的 UI 元素包括文本输入、textarea、下拉选择(enum/enum_titles/default)、复选框、数字(integer,含 minimum/maximum)、多选(array + format: select)、按钮(test-connection、sync-action)以及带 async 的同步动作动态选择(支持 label、action、autoload、cache)。典型模式包括:下拉等于某值时显示字段、多值显示、复选勾选显示、多条件 AND 逻辑、加密字段。
工作流程:先明确字段与条件需求,再按平铺结构设计 schema 并添加描述与默认值,随后始终建议用 schema-tester 测试:
Navigate to the schema-tester tool within the plugin
cd tools/schema-tester ./start-server.sh 关键 schema 建议结合 Playwright MCP 做自动化测试。校验清单包括条件字段用 options.dependencies、属性平铺、无 oneOf/allOf 条件逻辑、加密字段带 #、描述清晰、默认值合理、必填项列入 required、布尔依赖类型正确、多值用数组等。
限制:本技能仅覆盖配置架构与 UI,涉及组件架构、API 客户端实现、数据处理逻辑、Keboola API 集成、部署与 CI/CD 时应升级给 component-developer。其他具体价格、平台支持或效果资料暂未提供。