用途:对界面描述进行 UX 气味审查,即在用户测试前发现设计问题的命名反模式。
主要能力:覆盖 6 个类别共 8 种气味——efficiency(overloaded-screen、click-cemetery)、error-prevention(form-graveyard)、feedback(silent-errors、dead-end-states)、learnability(mystery-navigation)、accessibility(contrast-blindness)、consistency(inconsistent-actions)。每种气味带症状、检测方式与编号修复配方。输出为结构化 JSON,不含散文式报告。
使用方式:技能按固定流程执行——先从描述中提取信号(元素数量、标签、布局、反馈、颜色对比、移动/桌面),再将信号映射至气味类别,然后调用 API 获取气味数据,匹配症状,评定严重程度(critical、warning、suggestion),最后输出 JSON。
API 调用(需设置 UXUI_API_KEY): curl -s -H "Authorization: Bearer ${UXUI_API_KEY}" "https://uxuiprinciples.com/api/v1/smells?category={category}" curl -s -H "Authorization: Bearer ${UXUI_API_KEY}" "https://uxuiprinciples.com/api/v1/smells?id={smell_id}" 未设置密钥时使用内部分类知识,并将 api_enriched 设为 false。
输出字段:interface_description_summary、smells_detected、smells_suspected、clean_areas、priority_order、api_enriched、api_note。检测到气味时 matched_symptoms 至少一项、recipe_steps 至少三步;无检测结果时 clean_areas 至少两条。
限制:仅基于文本描述判断,未描述的错误状态不应假设,而是放入 smells_suspected;计数模糊时按约定值处理("several" 5-7、"a few" 3-4、"many" 8+);移动端阈值更严。具体收费与价格暂未提供。