tmoreader 终端摸鱼阅读器

在 PowerShell / Windows Terminal / Linux 终端中阅读 PDF / EPUB / TXT, 渲染成伪代码 / 伪日志 / 伪 git diff 三种风格,远看就像在认真工作 🥷。

---

✨ 特性

• 📖 支持 PDF / EPUB / TXT (自动识别编码)
• 🎭 三种伪装风格,运行时一键切换
  • code:Java / Kotlin / Python / Go / TypeScript / Rust 伪源码 + 行号 + 注释包裹
  • log :SLF4J 风格日志,时间戳 / 级别 / 线程 / Logger 一应俱全
  • diff:git diff 输出,+ 新增、- 删除上下文
• 🎨 多 syntax 主题 (monokai / one-dark / dracula / nord / ...) t 键切换
• 🔥 老板键:按 b 立刻满屏 Maven / npm / docker / git log 假输出
• 🔖 书签、阅读进度自动保存 (按文件 hash 跨 session 续读)
• 🔎 搜索关键字、章节跳转 (基于 PDF TOC / EPUB 标题)
• 📐 中英文混排折行 (CJK 全角宽度感知)
• 💻 跨平台:Windows PowerShell / Windows Terminal / Linux / macOS

---

🚀 安装

需要 Python 3.9+。

cd D:\workspace\tmoreader
pip install -e .

或者用 pipx(推荐,隔离环境):

pipx install --editable D:\workspace\tmoreader

Windows 中文显示乱码:在 PowerShell 启动时执行 chcp 65001, 或直接使用 Windows Terminal(默认 UTF-8)。

---

🧑‍💻 使用

# 基本用法 (自动续上次进度)
tmoread .\book.pdf

# 选择风格
tmoread .\book.epub --style code --lang kotlin
tmoread .\book.epub --style log
tmoread .\book.epub --style diff

# 自定义宽度 / 主题 / 跳页
tmoread .\book.pdf --width 80 --theme dracula --start-page 42

# 增加真代码片段干扰视觉
tmoread .\book.pdf --style code --inject-fake-code

---

⌨️ 快捷键

键	功能
j Space PgDn →	下一页
k PgUp ←	上一页
g / G	跳到开头 / 末尾
n / p	下一章 / 上一章
1 / 2 / 3	切换 code / log / diff 风格
t	循环切换语法主题
l	循环切换伪装语言 (code 风格)
+ / -	增减页面宽度
/	搜索关键字
s	当前页加 / 取消书签
b	老板键(伪构建输出)
?	帮助
q	保存进度并退出

---

🗂 项目结构

tmoreader/
├── tmoreader/
│   ├── cli.py             # click 命令行入口
│   ├── config.py          # 用户配置 (~/.config/tmoreader/config.json)
│   ├── state.py           # 阅读进度/书签持久化
│   ├── pager.py           # 段落分页
│   ├── parser/            # PDF / EPUB / TXT 解析
│   ├── renderer/          # code / log / diff 三种风格
│   └── ui/                # Textual TUI + 老板键
└── pyproject.toml

---

📦 依赖

用途	库
TUI 框架	textual
终端富文本	rich
PDF	PyMuPDF
EPUB	EbookLib + beautifulsoup4 + lxml
CLI	click
跨平台路径	platformdirs

---

⚠️ 免责声明

本工具仅供摸鱼小憩使用,请勿用于读取受版权保护的电子书或在严肃工作时间影响产出。 作者不对使用本工具被老板抓包负责 ☕。