#how i ai# 周末用CodeX+GPT5.4 vibe coding了一个儿童护眼阅读器的android电视端+web端书城管理支持epub，pdf，txt等主流图书格式。
首先是需求的必要性，传统观念认为看纸质书不伤眼，看电视伤眼。实际上，85寸电视，5 米远属于 “远眺级”，眼睛几乎不用调焦；30cm 看书是高强度近距离工作。研究：近距离用眼的近视风险是远距离的 2.3 倍。电视上字号可远大于书本，无需精细聚焦，眼疲劳更轻。蓝光模式可以通过电视模式调节。
电视端可以更有效的控制阅读时长（15分钟强制休息5分钟）和阅读书籍的质量，家长可以选书给孩子，也可以看到孩子的阅读进度。（图1 是图文混排图书的实际效果，吐槽一下调这个图文混排样式 占整个项目的时间差不多一半，纯文本的可以字体和间距更大）
项目开源地址 github.com/kangjinshan/readbook
# 儿童电视护眼阅读器产品需求文档（V1\.0 一期定稿）
**阅读终端**：小米电视 Android 客户端
**管理终端**：Web 网页家长后台
**服务端部署**：Microsoft Azure
**一期范围**：纯阅读、书籍管理、进度 / 时长记录、书签、家长管控
**二期规划**：选词模式、分词、名词解释、生词本（本期不实现）
---
## 1\. 项目概述
### 1\.1 产品定位
专为儿童设计的**远距离护眼电视阅读产品**，孩子在小米电视上安静阅读，家长通过网页后台统一管理书籍、控制阅读时长、查看阅读数据，解决儿童近距离看电子屏幕伤眼问题。
### 1\.2 终端角色
- 小米电视端：儿童专用阅读界面，仅遥控器操作，无任何系统级设置权限
- Web 家长后台：书籍管理、设备绑定、阅读控制、数据统计、权限配置
- Azure 服务端：数据存储、书籍分发、阅读记录、跨端同步、权限校验
### 1\.3 核心约束
- 电视端仅使用遥控器按键：**上、下、左、右、OK、返回、菜单**
- 全文纯文本阅读，**无拼音、无动画、无广告**
- 选词解释、名词解释、生词本功能统一纳入二期，本期不开发
---
## 2\. 小米电视端功能需求
### 2\.1 设备绑定与启动
1. 应用首次启动展示**6 位数字设备绑定码**，居中大字号显示，10 分钟有效
2. 家长在 Web 后台输入绑定码完成设备绑定
3. 绑定成功后自动同步授权书籍、阅读进度、家长配置
4. 非首次启动直接进入儿童书架
5. 断网状态可阅读已缓存书籍，联网后自动同步数据
### 2\.2 书架页面
1. 仅展示家长后台已授权书籍，无推荐、无外链、无广告
2. 大封面卡片布局，包含：书籍封面、书名、简易阅读进度条
3. 遥控器上下键切换书籍卡片，OK 键进入阅读，返回键退出书架
4. 焦点卡片高亮放大，3 米外可清晰识别
5. 默认排序：最近阅读优先
### 2\.3 阅读页面（核心）
#### 2\.3\.1 默认阅读模式按键定义
- 左键 ←：上一页
- 右键 →：下一页，长按快速连续翻页
- 短按 OK：无操作
- 长按 OK：为当前页添加书签
- 返回键：退出阅读，返回书架
- 菜单键：弹出阅读功能菜单
#### 2\.3\.2 翻页效果
淡入淡出过渡动画，时长 0\.3s，无滑动、无翻书、无闪烁效果。
#### 2\.3\.3 阅读功能菜单
菜单包含以下 3 项，遥控器上下选择，OK 进入：
1. 阅读设置
2. 书签列表
3. 目录跳转
返回键关闭菜单，回到阅读页。
#### 2\.3\.4 阅读设置
支持调整两项内容：
- 字号：小号 \(36dp\) / 中号 \(42dp，默认\) / 大号 \(48dp\)
- 主题：护眼黄 / 白天模式 / 夜间模式
操作规则：
- 上下键切换设置项
- 左右键修改参数
- 修改后即时生效并自动保存
#### 2\.3\.5 书签
- 长按 OK 一键添加当前页书签
- 书签列表展示页码信息，OK 键跳转对应页面
- 支持删除单条书签
- 所有书签实时同步至服务端
#### 2\.3\.6 目录与进度
- 展示书籍章节列表，支持按章节跳转
- 阅读进度实时同步云端
- 重新打开书籍自动定位到上次阅读位置
- 页面底部显示极简进度条，右上角显示页码
### 2\.4 防沉迷与护眼控制
1. 每日阅读时长达到家长设定上限后，自动退出阅读
2. 连续阅读达到设定时长，强制锁屏休息
3. 夜间禁止时段内无法启动应用
4. 阅读界面锁定，儿童无法退出到电视桌面
5. 界面低蓝光、无频闪、高对比度，符合远距离阅读护眼标准
---
## 3\. Web 家长管理后台功能需求
### 3\.1 账号与子账号管理
- 管理员账号密码登录
- 支持创建多个儿童子账号
- 每个子账号独立权限、独立阅读数据、独立时长控制
### 3\.2 电视设备管理
- 查看已绑定小米电视设备信息（名称、在线状态、绑定时间）
- 生成设备绑定码，支持绑定、解绑、重命名设备
- 支持远程退出阅读、远程锁屏、远程重启应用
### 3\.3 书籍管理
- 支持上传 EPUB / PDF / TXT 格式书籍
- 自动解析书名、作者、封面、目录、总页数
- 支持书籍分类、自定义封面、信息编辑
- 按子账号授权书籍，支持批量授权 / 取消授权
- 支持书籍内容在线预览
### 3\.4 阅读管控配置
- 为每个孩子设置每日最大阅读时长
- 设置连续阅读时长与强制休息间隔
- 设置夜间禁止阅读时间段
- 配置电视端允许使用的字号、主题范围
### 3\.5 阅读数据与统计
- 实时查看当前阅读状态（书籍、页码、已读时长）
- 历史阅读记录查询（时间、书籍、时长、进度）
- 日 / 周 / 月阅读时长统计图表
- 书籍阅读完成率统计
- 支持阅读数据导出为 Excel
### 3\.6 书签管理
- 查看所有子账号的全部书签
- 按书籍维度归类展示
- 支持网页端跳转预览、删除书签
---
## 4\. Azure 服务端需求
1. 用户、子账号、电视设备信息管理
2. 书籍文件存储、解析、分发与缓存管理
3. 阅读进度、书签、阅读时长数据存储与同步
4. 书籍授权权限校验
5. 防沉迷策略下发与时长计算
6. 数据统计、报表生成接口
7. 电视端与 Web 后台数据实时一致
---
## 5\. 小米电视端 UI 视觉规范
### 5\.1 布局规范
- 屏幕比例：16:9 固定
- 内容区域：左右留白 12%，上下留白 10%
- 不全屏铺满，避免边缘反光
- 正文左对齐，无多余装饰元素
### 5\.2 字体规范
- 正文字体：**微软雅黑 / 思源黑体 Noto Sans CJK SC**
- 正文：Regular（常规）
- 标题：Bold（加粗）
- 禁止使用：宋体、楷体、书法体、艺术字体
### 5\.3 字号规范（dp）
- 正文小号：36
- 正文默认：42
- 正文大号：48
- 书籍 / 章节标题：52（加粗）
- 菜单文字：40
- 页码及辅助提示：24
### 5\.4 颜色主题规范
#### 主题 1：护眼黄（系统默认）
- 背景色：`\#FFF8DC`
- 正文颜色：`\#2A2A2A`
- 辅助文字 / 页码：`\#888888`
#### 主题 2：柔和白天模式
- 背景色：`\#FAFAFA`
- 正文颜色：`\#1A1A1A`
- 辅助文字 / 页码：`\#777777`
#### 主题 3：夜间护眼模式
- 背景色：`\#222222`
- 正文颜色：`\#E0E0E0`
- 辅助文字 / 页码：`\#AAAAAA`
### 5\.5 排版与控件
- 正文行高：1\.8 倍
- 段落间距：2 倍行高
- 底部进度条高度：4dp，颜色：`\#5B9BD5`
- 页码固定显示在右上角
- 菜单弹窗居中，圆角简洁样式
---
## 6\. 二期功能规划（本期不实现）
- 选词模式
- 客户端中文分词（jieba\-android）
- 名词解释弹窗展示
- 生词本采集与管理
- 家长后台自定义名词解释词库
- 词语语音朗读
---
## 7\. 非功能需求
1. 电视端翻页、加载无卡顿，响应延迟 ≤ 100ms
2. 阅读进度同步延迟 ≤ 1s
3. 支持已缓存书籍离线阅读
4. 界面护眼、无频闪、无蓝光刺激
5. 儿童无法绕过家长防沉迷管控
6. 兼容主流小米电视机型
7. 数据加密存储，保障用户隐私安全
