# JustRead

> JustRead 阅读器固件的使用说明、开发指南、组件查询与设计规范。

设计规范以 v0.2.1 草案为基线，系统组件和 Mini App 接口仍属拟议契约。请先阅读 /design/overview.md，再按目录查询具体主题；使用说明和开发指南中仍有待补充页面。

## 文档目录

### 项目入门

- [文档导航](/guide/overview.md)
- [产品与版本](/guide/product-and-versions.md)
- [快速开始](/guide/quick-start.md)

### 使用说明

- [使用说明总览](/user/overview.md)
- [首次使用](/user/getting-started.md)
- [阅读与文件管理](/user/reading-and-files.md)
- [设置与更新](/user/settings-and-updates.md)
- [故障排查](/user/troubleshooting.md)

### 开发指南

- [开发总览](/developer/overview.md)
- [开发环境搭建](/developer/setup.md)
- [构建、烧录与调试](/developer/build-flash-debug.md)
- [代码结构](/developer/codebase.md)
- [Lua 插件 API](/developer/lua-plugin-api.md)
- [贡献与发布](/developer/contributing-and-release.md)

### 组件查询

- [组件目录](/components.md)
- [显示与刷新](/components/display.md)
- [输入与按键](/components/input.md)
- [存储与文件](/components/storage.md)
- [界面组件](/components/ui.md)

### 开发指南

- [开发总览](/developer/overview.md)
- [开发环境搭建](/developer/setup.md)
- [构建、烧录与调试](/developer/build-flash-debug.md)
- [代码结构](/developer/codebase.md)
- [Lua 插件 API](/developer/lua-plugin-api.md)
- [贡献与发布](/developer/contributing-and-release.md)

### 组件查询

- [组件目录](/components.md)
- [显示与刷新](/components/display.md)
- [输入与按键](/components/input.md)
- [存储与文件](/components/storage.md)
- [界面组件](/components/ui.md)

### 基线与设备

- [设计规范总览](/design/overview.md)
- [规范范围与设计原则](/design/principles-and-scope.md)
- [设备基准与像素单位](/design/device-and-units.md)
- [设计分层与系统职责](/design/architecture.md)

### 视觉与布局

- [视觉 Token、排版与留白](/design/visual-and-typography.md)
- [Lucide SVG 点阵生成与高清化](/design/lucide-bitmap-assets.md)
- [系统栏、应用画布与热区](/design/system-layout.md)
- [系统组件留白与区域分配](/design/spacing-and-regions.md): 系统栏、设置行、宫格、小组件与分页控件的留白职责、推荐间距和完整布局示例。
- [分隔线与边界的有限例外](/design/separators.md)

### 启动与错误状态

- [OOBE 与警告页](/design/oobe-and-warnings.md)

### 交互与刷新

- [导航、分页与交互状态](/design/interaction-and-states.md)
- [按键、菜单、截图与电源行为](/design/system-actions.md)
- [刷新调度与功耗约束](/design/refresh-and-power.md)

### 组件与平台设计

- [系统组件设计目录](/design/components.md)
- [首页与小组件设计](/design/home-and-widgets.md)
- [Mini App 声明与平台契约草案](/design/mini-app-contract.md)
- [设备适配与困难内容](/design/adaptation.md)

### 评审与维护

- [设计与实机验收](/design/acceptance.md)
- [AI 辅助设计与交付约定](/design/agent-workflow.md)
- [旧截图与 CSS 的迁移检查](/design/migration-notes.md)
- [设计术语表](/design/glossary.md)
- [来源与待定事项](/design/sources-and-decisions.md)

### Other

- [固件实机排版映射](/design/firmware-type-mapping.md)
- [固件系统栏与应用画布](/design/firmware-system-chrome.md)
- [在线刷写 JustRead](/flash.md): 为小纸 Pico ESP32-S3 设计的浏览器刷机界面。