mirror of
https://github.com/hectorqin/reader.git
synced 2026-11-12 05:50:54 +08:00
Kiro Agent
858a7479bf
Implements docs/prototypes/Reader V3 主题语义令牌.md (v3.1): - 暖陶 (default), 雾蓝, 青绿 app themes plus the reading-only 黑白灰, each light and dark. Components read --color-* tokens from styles/theme-tokens.css, selected by data-theme + data-mode; the TypeScript mirror lives in shared/theme/theme.ts. - Brand is split per the spec: brand/ch-* only fill (with on-brand/on-ch on top), brand-text/ch-*-text for text. --reader-accent/--media-accent are now brand text; --reader-fill/--media-fill are brand fills. Selected segmented controls use brand-soft + brand-text. - One preference per server+account (reader.theme.v2): app theme, mode (system/light/dark), the follow-system light/dark pair, and the reading theme. V3 choices migrate per spec §8 (rose falls back to 暖陶 light). - 外观与主题 rebuilt from prototype 23: follow-system switch with the light/dark pair, app-theme cards with light/dark previews, and the reading theme (跟随应用 / 黑白灰). - Reader: 黑白灰 is set on the reader container only; the appearance panel offers 跟随应用/黑白灰 and 明暗; day/night sets the mode; the e-ink preset uses 黑白灰 light. - Video and music players wear the current theme's dark values (§4.7). - Removed the legacy light/sepia/green/dark palettes and the <html data-theme> writes from reader settings, which would now collide with data-theme="green". - Tests: theme-tokens.test.ts keeps CSS and TS values identical and checks the §5 contrast pairs for all 8 palettes; theme.test.tsx covers migration, resolution, the controller and the settings page.
文档中心 · Documentation
项目首页介绍阅读与影音能力；安装、日常使用、运维和开发步骤分别放在下面的指南中。 The project README introduces reader. Use the guides below for installation, everyday use, operations, and development.
使用与部署 · Using and deploying reader
| 内容 / Topic | 简体中文 | English |
|---|---|---|
| 安装、首次登录、添加书籍、更新 / Installation and first steps | 入门指南 | Getting started |
| 书架、阅读、朗读、来源和离线 / Shelves, reading, TTS, sources, offline | 使用手册 | Chinese only |
| 电影、剧集、音乐与有声书 / Movies, series, music and audiobooks | 影音手册 | Chinese only |
| 远端媒体目录 / Remote media directories | OpenList 接入 | Chinese only |
| 安装到桌面、离线启动和版本更新 / PWA installation, offline startup and updates | PWA 指南 | Chinese only |
| 环境变量、目录权限、HTTPS、排错 / Settings, permissions, HTTPS, troubleshooting | 部署配置 | Configuration |
| 页面业务配置、服务连接与迁移 / Business settings, service connections and migration | 业务配置 | Chinese only |
| 数据备份、校验与恢复 / Data backup, verification and restore | 备份恢复 | Chinese only |
| 本地开发、验证、镜像与 Android 构建 / Development, checks, Docker and Android builds | 开发指南 | Development |
技术参考 · Technical reference
以下参考文档目前以中文维护。The following reference documents are currently maintained in Chinese.
| 文档 / Document | 内容 / Contents |
|---|---|
| 架构与数据边界 / Architecture | 数据目录、身份、同步和客户端架构 / Data boundaries, identity, sync, client architecture |
| 前端 React 架构 | Web 入口、Provider、路由、feature 边界和长生命周期资源 |
| API | 鉴权、书籍、资源、进度、文件管理、OPDS 与影音 / Auth, books, resources, progress, file management, OPDS and media |
| 界面规范 / UI guidelines | 布局、交互、可访问性 / Layout, interaction, accessibility |
验证记录 · Review records
特定功能的验证产物写入被 Git 忽略的 artifacts/ 目录；当前结果以对应提交的测试和 CI 输出为准。
Feature review artifacts are written to the ignored artifacts/ directory. Use tests and CI for the current commit's results.