---
url: /design/principles-and-scope.md
---
# 规范范围与设计原则

本规范将口述要求整理为可执行规则，并补充布局计算、点击区域、刷新职责、异常状态与验收要求。

为避免不同性质的规则混在一起，本文按三层理解：**视觉设计层**负责 Token、排版、留白与组件外观；**系统交互层**负责导航、分页、按键、菜单与刷新行为；**平台契约层**负责应用画布、Mini App 声明、系统接口与验收约束。三层可以独立演进，当前仍保留在同一份文档中便于评审。

* **必须／禁止**：硬性约束，生成界面和实现组件时必须遵守。
* **建议／默认**：推荐方案；有明确场景时可偏离，但应记录原因。
* **补充建议**：本次新增的设计建议，不代表已经确定的硬件限制或现有系统能力。
* **待验证**：需要在目标固件、字体和面板上实测，不能宣称已经支持。

优先级：用户后续明确决定 > 本规范硬性规则 > 本规范推荐值 > 首页截图与 design.css 示例 > 外部平台参考。后续若发现与真实硬件能力不兼容，必须说明冲突并调整实现，不能假定硬件可以做到。

系统组件尚未实现。本文的组件名称、声明字段、刷新请求与布局接口均为**拟议契约**，不是已经存在的 SDK API。

## 核心设计原则

1. 白底、黑字、清晰字号层级、稳定对齐、充分留白。
2. 内容外沿默认贴齐左右 36 px 的内容线；不要让同层级文字任意漂移。
3. 整页分页，页面切换后有明确的静止终态；禁止自然滚动。
4. 信息层级优先用字号、位置、字重和结构表达，不能依赖灰度差异作为唯一线索。
5. 系统管理系统栏与刷新调度；应用只绘制获分配区域。
6. 小屏优先减少同时展示的内容，通过分页和二级页面容纳信息；不以缩小字号换取密度。
7. 默认不使用装饰性边框、分隔线、阴影、渐变和动画。
8. **组内紧凑、组间留白**：同一信息组内部保持关联性，不为“显得高级”而过度拉开；不同内容组之间保留足够空间，避免小屏信息糊成连续黑块。

## 产品名称与规则状态（补充说明）

Read Pico（小纸 Pico）是目标硬件；JustRead 是适配该硬件的阅读器固件项目。官方 Demo 提供硬件参考，其界面、按键和应用能力不能直接视为 JustRead 的现有实现。

规则性质与实现状态分别记录。一条“必须”规则可以尚未实现；一条已实现的“建议”也不会自动升级为硬性要求。

| 性质 | 含义 | 评审要求 |
| --- | --- | --- |
| 必须 / 禁止 | 原草案的目标设计约束 | 冲突时记录设计变更及影响 |
| 建议 / 默认 | 推荐方案 | 偏离时说明场景与原因 |
| 补充建议 | 本次整理增加的方案 | 待评审后决定是否纳入基线 |
| 拟议契约 | 尚未确认的 SDK 或平台结构 | 不作为现存可调用接口 |
| 待验证 | 需要字体、驱动或实机证据 | 列出条件，保留未验证状态 |

本站拆分和补充不自动升级设计基线；影响硬性规则的修改需记录明确的产品决定。设计文档版本、固件版本和未来声明协议版本分别维护。
