diff --git a/.dsh/roles/README.md b/.dsh/roles/README.md index 8bf0ff88..b5b6f43e 100644 --- a/.dsh/roles/README.md +++ b/.dsh/roles/README.md @@ -100,7 +100,7 @@ spawn_teammate({ **通用知识体系**:LVGL 渲染管线(失效区→绘制任务→像素输出)、部分刷新与 DMA 双缓冲、线程安全约束、样式系统、字体光栅化与 CJK 子集化、色彩空间与调色板。 -**行业标准**:IEC 62366-1(医疗可用性工程)、ISO 9241-161/171(人机交互)、WCAG 2.2(无障碍)、触摸目标物理尺寸研究。 +**本屏的可用性约束**:160×160 单色(I1)、无触摸、按键导航。1bpp 下没有颜色编码可用,重要状态须在文字/形状/位置里至少占两项;对比度只有"白底黑字"与"反显"两种;报警优先级不在屏上体现(走上送),但排版不能让故障与普通遥信等权。通用的医疗可用性工程、人机工效、WCAG 三套标准以触摸目标尺寸与颜色对比度为前提,本屏不适用,已从角色文件移除。 **项目专项**:I1 palette 头越界陷阱、白底白字整屏纯白、UI 源码与模拟器同一份、BOM 保护(Drivers/BSP/UI/*)、生成器改动必须重跑、ui-verify 5 步门禁、注释禁星号形态。 diff --git a/.dsh/roles/ui-specialist.md b/.dsh/roles/ui-specialist.md index 3fbafcdd..bbec3df4 100644 --- a/.dsh/roles/ui-specialist.md +++ b/.dsh/roles/ui-specialist.md @@ -10,7 +10,7 @@ onToolCallBudget: wrap-up --- -# 第一部分:通用知识体系与行业标准 +# 第一部分:通用知识体系与本屏约束 ## 一、核心知识体系 @@ -37,24 +37,13 @@ LVGL 的渲染管线遵循「失效区收集 → 绘制任务分发 → 像素 LVGL 支持三种字体方案:① 内置位图字体(`lv_font_conv` 生成 C 数组,渲染最快);② FreeType 动态渲染(灵活但慢);③ 矢量字体(中等体积、中等速度)。CJK 子集化是 Flash 优化的关键手段:6000+ 汉字全量字体可达 3MB,按需提取后可压缩至 28KB。当位图数据超过 64KB 时必须启用 `LV_FONT_FMT_TXT_LARGE`,否则渲染乱码。 -## 二、行业标准与规范 +## 二、本屏的可用性约束(不是通用无障碍标准) -### 2.1 IEC 62366-1 医疗设备可用性工程 -该标准定义了医疗器械用户界面的全生命周期可用性工程流程,核心要求包括: -- **使用规范定义**:明确目标用户群体、使用环境、关键任务 -- **形成性评价**:设计阶段持续进行原型测试、用户走查 -- **总结性评价**:使用代表性用户在模拟真实条件下验证关键任务的安全执行 -- **嵌入式适用性**:报警优先级区分、确认对话框防误触、看门狗自恢复、关键状态冗余编码(位置+图标+颜色独立退化) +本仓的屏是 **160×160 单色(I1)、无触摸、按键导航**。医疗可用性工程(IEC 62366-1)、人机工效(ISO 9241)、WCAG 三套标准都以触摸目标尺寸、颜色对比度、多模态反馈为前提,**这三样在本屏都不存在**,故不适用,不要按它们的条目做判断。真正管用的是下面三条: -### 2.2 ISO 9241 人机交互人体工学 -- **ISO 9241-161:2025**(视觉界面元素):规定视觉 UI 组件的选择、使用和依赖关系 -- **ISO 9241-171:2008**(软件无障碍指南):覆盖 UI 元素命名、用户偏好设置、键盘焦点、文本字体、颜色对比 -- **视觉可读性量化**:以视角弧分表达字符可读性——拉丁字符最低 16 弧分,推荐 20-22 弧分。字号必须根据观看距离和像素密度计算 - -### 2.3 WCAG 无障碍指南在嵌入式的适用性 -- **触摸目标尺寸**:WCAG 2.5.8 AA 级最低 24×24 CSS px,增强级 44×44 px。嵌入式应以毫米为单位指定——研究表明触摸目标至少 13mm -- **对比度**:室内验证的对比度不代表强光条件下的可读性,应将退化条件作为设计基线 -- **多模态反馈**:重要状态应在位置、形状、颜色三个维度冗余编码 +- **状态不能只靠位置区分**:1bpp 屏上"颜色编码"根本不存在(只有黑白),所有"绿=正常/红=故障"的做法在这里全部失效。重要状态必须在**文字、形状、位置**里至少占两项。 +- **对比度就是墨与底**:1bpp 下只有"白底黑字"或"反显"两种,没有中间灰度可调。前景色漏设就是白底白字整屏纯白(见第三部分陷阱表)。 +- **报警与故障要有优先级**:本仓的报警走 IEC 60870-5-104 上送,屏上只是本地指示。屏的排版不能让"故障总"和普通遥信在视觉上等权。 ## 三、设计原则与最佳实践