[Feature]: Desktop app: books reader
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 20/100
- Issue 类型
- 功能
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- rust, typescript
- 领域
- desktop, full-stack
调研方向
Read the epic #80 and its prerequisites #82 and #83, then use the web reader files under web/src/books/ and the routes/book.$id.tsx and routes/read.$id.tsx routes as the specification. Start by porting packages/shared/src/books.ts and its books.test.ts tests to Rust. Done means long EPUB and FB2 books read like they do on the web, positions sync to the same sentence across window sizes, and quotes sync between web and desktop.
由索引模型根据 Issue 内容生成。
描述
[!NOTE]
This issue was written by Claude (Claude Opus 5.5) from a planning session with @PhrolovaMoe. Part of #80, builds on #82 and #83. Read the epic first.
Area
Desktop app
Problem
The web has a novel reader with positions shared across devices and quotes (highlights stored as clips). It's part of parity.
Proposed solution
The web is the spec: web/src/books/ (Library.tsx, Reader.tsx, components.tsx, focus.ts, quotes.tsx), routes/book.$id.tsx, routes/read.$id.tsx.
- Port
packages/shared/src/books.tsto Rust with its tests (books.test.ts): the content model (/api/books/{id}/contentJSON, with style flagsBOLD,ITALIC… as bits) and positions counted in characters of text, so the same position lands on the same sentence on web, Android and desktop, at any size. - Layout and text with iced's text stack (cosmic-text), in Geist and whatever font choices the web reader offers. Images through
/api/books/{id}/files/{*name}, covers through/api/books/{id}/cover. - Every reading mode and setting the web reader has (paging/scrolling, sizes, margins, themes within the app's scheme), the focus behaviour of
focus.ts, and keyboard navigation. - Progress: the same mutations and cadence as the web, so switching devices continues where you were.
- Quotes: selecting text and saving a quote (a highlight stored as a clip), showing existing highlights, the quotes list, as on web.
- The book's details page (
book.$id): metadata, cover, continue reading.
Done when
A long EPUB and an FB2 read the same as on web. Positions round-trip between web and app to the same sentence at different window sizes, and quotes made in either show up in both.
- 主要语言
- TypeScript
- 星标
- 4
- 派生
- 1
- 平均合并
- 4 小时 49 分钟
- 30 天内合并 PR
- 5
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
tinystream-dev/tinystream 的其他 Issue
-
bug
难度 2/5 1-3 小时 新手友好度 82/100
tinystream-dev/tinystream#132 ·
-
bug
难度 2/5 1-3 小时 新手友好度 82/100
tinystream-dev/tinystream#131 ·
-
bug
难度 1/5 1 小时以内 新手友好度 88/100
tinystream-dev/tinystream#129 ·
-
bug
难度 2/5 1-3 小时 新手友好度 76/100
tinystream-dev/tinystream#128 ·
-
bug
难度 2/5 1-3 小时 新手友好度 78/100
tinystream-dev/tinystream#124 ·
查看 tinystream-dev/tinystream 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 86/100
sandbox-quantum/switch#2163 ·
维护者通常 1 天内回复
-
automated issue report
难度 1/5 1 小时以内 新手友好度 78/100
维护者通常 1 天内回复
-
area/dashboard kind/bug QA/dev-automation
难度 1/5 1 小时以内 新手友好度 75/100
维护者通常 1 天内回复
-
bug pydanty:is-working
难度 2/5 1-3 小时 新手友好度 82/100
pydantic/pydantic-ai#13939 ·
维护者通常 1 天内回复
-
self-host
难度 2/5 1-3 小时 新手友好度 70/100
funmusicplace/mirlo#2625 ·
维护者通常 1 天内回复