logtap read

日志风格终端小说阅读器 —— 摸鱼神器，视觉模仿服务器运行日志，低辨识度，支持流式自动滚动、书签、进度记忆、三套主题。

基于 Textual 框架构建，纯终端 UI，无 GUI，兼容 Windows Terminal、iTerm2、Linux 终端。

核心特色

日志伪装设计：外观模拟 Linux 服务日志 / 后端程序输出，章节标题显示为 [WARN] 黄色标签，正文为标准日志文本样式，外人一眼看上去像在排查服务器问题，而非阅读小说。

流式自动滚动：按 Space 启动后文本持续向下滚动（模拟日志实时输出），速度可调，随时暂停/恢复，配合日志样式完美伪装成"正在监控服务器日志"。

隐蔽交互：章节列表、搜索、跳转均为临时悬浮组件，按 ESC 立即消失，不长期占用屏幕空间暴露用途。

安装

pip install logtap

（本地开发调试可直接 pip install -e .）

快速开始

# 直接打开指定文件
logtap read ./novel.txt

快捷键说明

核心创新：动态伪装模式

按 d 键可在三种模式间切换，适应不同摸鱼场景：

模式1：日志模式（默认）

• 正文随机插入日志级别：[INFO]、[DEBUG]、[WARN]、[ERROR]
• 30% 概率给正文行加时间戳前缀：2026-07-28 14:32:15
• 随机插入模拟系统日志噪音（不打断阅读）：
  • [INFO] Database connection pool: 8/20 active
  • [DEBUG] Cache hit ratio: 87.3%
  • [WARN] Memory usage: 1461MB / 2048MB
• 章节标题伪装成关键错误：[ERROR] Critical: 第一章 标题

适用场景：假装在查看服务器日志、排查线上问题

模式2：AI助手模式

• 正文标记为 [assistant] AI回答格式
• 随机将连续 2-3 行渲染成代码 diff 格式：
  • + 新增内容（绿色）
  • - 删除内容（红色）
• 随机插入 AI 思考链路噪音（灰色斜体）：
  • <thinking>分析需求中...</thinking>
  • <thinking>检查代码结构...</thinking>
• 章节标题伪装成任务：## Task: 实现用户认证模块

适用场景：假装在用 Claude Code / Cursor AI 写代码、调试程序

模式3：关闭伪装

• 纯净的日志风格（每行只加 [TEXT] 前缀）
• 适合不需要伪装的私密环境

三套主题

1. 日志仿真模式（默认）：黑底 + 彩色日志标签（[WARN] 黄色、[INFO] 蓝色），模拟服务器日志输出
2. 护眼暗色模式：深灰底 + 暖色调文字，适合长时间阅读
3. 极简黑白模式：纯黑底白字，移除所有颜色，最高隐蔽度

按 t 键循环切换，选择会被记住。

功能特性

• 纯本地文本：只读取本地 .txt 文件，不含任何网络爬虫或在线下载功能。
• 编码自动识别：自动识别 UTF-8 / GBK / GB2312 / BIG5 / UTF-16 等编码； 识别置信度不足时弹出手动选择编码的面板。
• 大文件优化：仅扫描一次建立"行偏移索引"，正文按需 seek 读取，不会 把整本书载入内存，GB 级文本同样流畅。
• 东亚宽字符换行：按终端可视宽度自动换行，中日韩字符按 2 列宽计算， 不会出现超长行溢出。
• 章节粗识别：通过"第 N 章/回/节"标题模式与常见分割线（----、==== 等）自动标记章节，阅读时定时显示当前所在章节。
• 独立进度与书签：每本书按绝对路径独立记录阅读进度和书签列表，下次 打开自动恢复到上次阅读位置。

配置文件

阅读进度、书签、主题设置保存在跨平台配置目录下的 JSON 文件中：

• Windows: %USERPROFILE%\.logtap\read_config.json
• macOS / Linux: ~/.logtap/read_config.json

写入采用"临时文件 + 原子替换"策略，避免程序异常退出导致配置损坏；若配置 文件本身已损坏，会自动备份为 read_config.json.corrupted-<timestamp>.bak 并回退到默认设置，不影响正常启动。

项目结构

logtap/
├── cli.py                # logtap 主命令行入口，分发子命令
└── read/
    ├── __init__.py        # 对外暴露 run(path)
    ├── app.py             # Textual 主应用：自动滚动、快捷键、主题切换
    ├── log_style_render.py # 日志风格文本渲染组件
    ├── reader_core.py      # 编码识别、行索引、宽字符换行、章节识别
    ├── storage.py          # 进度/书签/设置持久化
    └── themes.py           # 三套主题 CSS 样式定义

依赖

• textual：现代化终端 UI 框架
• rich：富文本渲染（Textual 底层依赖）
• chardet：编码检测辅助

开发与测试

pip install -e .
pip install pytest
pytest tests/ -v

设计理念

区别于传统终端阅读器（侧边目录 + 正文区域的常规布局），本项目主打动态伪装系统：

核心差异化

1. 两套伪装模式随时切换（d 键）

   • 日志模式：模拟服务器运行日志，随机插入系统状态噪音
   • AI模式：模拟 Claude Code / Cursor 编程助手输出，带代码 diff 和思考链路

2. 智能噪音注入

   • 15% 概率在正文间插入伪装噪音行（不干扰阅读连续性）
   • 日志模式：30% 概率添加时间戳，随机日志级别分布模拟真实日志
   • AI模式：20% 概率将连续几行渲染成代码 diff（红绿对比）

3. 视觉真实性

   • 章节标题根据模式动态调整（[ERROR] Critical / ## Task:）
   • 噪音行使用 dim 样式，视觉上退居背景
   • 状态栏实时显示当前伪装模式

适用场景

• 工作时摸鱼：日志模式让你看起来在排查线上问题
• 远程会议/屏幕共享：AI模式让你看起来在用编程助手写代码
• 开放式办公区：动态切换模式应对不同路过的同事

与市面上所有终端小说阅读器的根本区别：不是"做了个阅读器顺便能伪装"，而是"做了个伪装系统顺便能看小说"。

许可证

MIT License，详见 LICENSE。