FishCN Reader
A lightweight novel reader that lives inside your VSCode terminal
藏在 VSCode 终端里的轻量小说阅读器
English · 中文
English
Overview
FishCN Reader turns a VSCode terminal tab into a clean, distraction-free book reader. Open TXT / EPUB / Markdown files, navigate by chapter, take per-chapter notes, drop bookmarks, switch themes — all without leaving the IDE.
Features
- 📚 Bookshelf — manage multiple books with auto-saved reading progress
- 📑 Smart chapter detection — Chinese (
第 X 章, 卷, 回, 序章, 楔子...) and English (Chapter X)
- 🔖 Multi-bookmarks — drop unlimited bookmarks per book, jump anywhere instantly
- 📝 Per-chapter notes — leave a note on any chapter; review them all in a sidebar
- 🎨 5 themes — Warm Yellow, Night, Eye-Care, Paper, Plain White (true-color ANSI)
- 📐 Layout — adjustable line spacing (0-5), page width (40-160), paragraph indent toggle
- ⌨ Keyboard-first — full reading flow from the keyboard, no mouse required
- 🌏 Encoding auto-detect — UTF-8 / UTF-16 (LE/BE) / GBK with BOM detection
- 📦 EPUB built-in — internal zip+inflate parser, no external dependencies
- 💾 Zero network — everything stored locally in
globalState
Requirements
|
|
| VSCode |
≥ 1.75 |
| OS |
Windows, macOS, Linux |
Install
From the marketplace:
ext install fishcn.fishcn-reader
Or from VSIX:
code --install-extension fishcn-reader-0.1.1.vsix
Quick Start
- Click the 📖 Code Reader icon in the activity bar
- In the 📚 书架 (Shelf) title bar, click 📂 Open File and pick a
.txt / .epub / .md
- A terminal tab
📖 Reader opens with the first chapter rendered
- Use
← / → (or sidebar buttons) to navigate chapters
CODE READER [📂 Open] [▶ Reveal] [🎨 Theme]
├─ 📚 书架 (Shelf)
│ └─ <Book title> 60% · ch 24/40 ✏️ 🗑
│
├─ 📑 目录 (Chapters) [← Prev] [→ Next] [🔎 Search]
│ └─ ➜ 24. <Current chapter>
│
├─ 🔖 书签 (Bookmarks) [+ Add]
│ └─ <Chapter title> 2026-05-21 ❌
│
└─ 📝 笔记 (Notes) [+ Add]
└─ <Note preview> ch 24 ❌
Reading Terminal Shortcuts
| Key |
Action |
← / k |
Previous chapter |
→ / j |
Next chapter |
g |
Goto chapter number (input box) |
b |
Add bookmark at current chapter |
n |
Add / edit note for current chapter |
/ |
Search chapter titles |
t |
Pick theme |
+ / - |
Increase / decrease line spacing |
? / h |
Show help screen |
q |
Close current book |
Ctrl+L |
Redraw |
Ctrl + / Ctrl - |
VSCode terminal font zoom |
Themes
| Name |
Best for |
| 暖黄 Warm Yellow |
All-day reading, easy on the eyes |
| 夜间 Night |
Dark VSCode themes |
| 护眼 Eye-Care |
Sustained reading, green-tinted |
| 纸张 Paper |
Sepia, mimics e-ink |
| 白底 Plain White |
Maximum contrast |
Commands
| Command |
Description |
Code Reader: 打开文件 |
Open a TXT / EPUB / MD file |
Code Reader: 显示阅读终端 |
Bring the reader terminal forward |
Code Reader: 上一章 / 下一章 |
Navigate |
Code Reader: 搜索章节 |
Filter chapters by title |
Code Reader: 添加书签 |
Bookmark current chapter |
Code Reader: 添加笔记 |
Note current chapter |
Code Reader: 主题 |
Pick reading theme |
Code Reader: 行距 |
Set line spacing 0-5 |
Code Reader: 页宽 |
Set page width 40-160 |
Code Reader: 切换段首缩进 |
Toggle paragraph indent |
Settings
| Setting |
Default |
Notes |
codeReader.defaultTheme |
暖黄 |
Initial theme; can also be changed at runtime |
Storage
- Bookshelf, bookmarks, notes — VSCode
globalState, persisted across windows
- Books themselves — loaded from their original file path; not copied
- No internet — nothing leaves your machine
Tips
- Font size of the reader = the terminal's font. Adjust with VSCode's built-in
Ctrl + / Ctrl -.
- For best Chinese book layout, pick a CJK-compatible monospace terminal font (e.g., Sarasa Mono, Source Han Mono).
- EPUB without proper chapter headings? It falls back to one "全文" chapter — paginate via line spacing.
中文
简介
FishCN Reader 把 VSCode 终端 tab 变成干净的小说阅读器。打开 TXT / EPUB / Markdown，按章节翻阅，任意章节加笔记 / 书签，5 套主题随心切换 — 全部在 IDE 内完成。
功能
- 📚 书架 — 管理多本书籍，自动保存阅读进度
- 📑 智能切章 — 中文（第 X 章 / 卷 / 回 / 序章 / 楔子 ...）+ 英文（Chapter X）正则
- 🔖 多书签 — 每本书无限书签，一键跳转
- 📝 章节笔记 — 任意章节加笔记，侧边栏统一管理
- 🎨 5 套主题 — 暖黄 / 夜间 / 护眼 / 纸张 / 白底（ANSI 真彩色）
- 📐 排版 — 行距 0-5 / 页宽 40-160 / 段首缩进开关
- ⌨ 全键盘 — 整套阅读流程键盘搞定
- 🌏 编码自适应 — UTF-8 / UTF-16 LE/BE / GBK + BOM 自动嗅探
- 📦 内置 EPUB — 自研 zip + inflate 解析，零依赖
- 💾 完全本地 — 数据存
globalState，不联网
系统要求
|
|
| VSCode |
≥ 1.75 |
| 系统 |
Windows / macOS / Linux |
安装
应用市场：
ext install fishcn.fishcn-reader
VSIX：
code --install-extension fishcn-reader-0.1.1.vsix
快速上手
- 左侧活动栏点 📖 Code Reader
- 在 📚 书架 标题栏点 📂 打开文件，选
.txt / .epub / .md
- 自动打开
📖 Reader 终端 tab 显示第一章
- 用
← / →（或侧边栏按钮）翻章
侧边栏布局
CODE READER [📂 打开] [▶ 显示] [🎨 主题]
├─ 📚 书架
│ └─ <书名> 60% · 第 24/40 章 ✏️ 🗑
│
├─ 📑 目录 [← 上章] [→ 下章] [🔎 搜]
│ └─ ➜ 24. <当前章节>
│
├─ 🔖 书签 [+ 添加]
│ └─ <章节标题> 2026-05-21 ❌
│
└─ 📝 笔记 [+ 添加]
└─ <笔记预览> 第 24 章 ❌
阅读终端快捷键
| 按键 |
作用 |
← / k |
上一章 |
→ / j |
下一章 |
g |
跳转章节（输入框） |
b |
给当前章节加书签 |
n |
当前章节加 / 改笔记 |
/ |
搜索章节标题 |
t |
切换主题 |
+ / - |
行距增 / 减 |
? / h |
帮助页 |
q |
关闭当前书 |
Ctrl+L |
重绘 |
Ctrl + / Ctrl - |
VSCode 终端字号缩放 |
主题
| 名称 |
适用 |
| 暖黄 |
长时间阅读，护眼 |
| 夜间 |
VSCode 黑主题下 |
| 护眼 |
久读绿调 |
| 纸张 |
类 Kindle 米黄 |
| 白底 |
高对比 |
命令
| 命令 |
说明 |
Code Reader: 打开文件 |
打开 TXT / EPUB / MD |
Code Reader: 显示阅读终端 |
切到阅读终端 |
Code Reader: 上一章 / 下一章 |
翻章 |
Code Reader: 搜索章节 |
按标题过滤 |
Code Reader: 添加书签 |
收藏当前章节 |
Code Reader: 添加笔记 |
给当前章节加笔记 |
Code Reader: 主题 |
切换主题 |
Code Reader: 行距 |
0-5 |
Code Reader: 页宽 |
40-160 |
Code Reader: 切换段首缩进 |
开 / 关 |
配置
| 设置项 |
默认 |
说明 |
codeReader.defaultTheme |
暖黄 |
初始主题（运行时可改） |
数据存储
- 书架 / 书签 / 笔记 — 存 VSCode
globalState，跨窗口共享
- 书籍本体 — 按原始路径读取，不复制
- 零联网 — 没有任何外发请求
Tips
- 阅读器字号 = 当前终端字号。
Ctrl + / Ctrl - 调节
- 中文小说建议用 CJK 等宽字体（Sarasa Mono / Source Han Mono）
- EPUB 没有标准章节标题时会作为"全文"一章，可调大行距分段
License
MIT © fishcn
Sister Extensions
- 💬 FishCN Chat — LAN P2P encrypted chat in VSCode terminal
