Thief-Book插件完全支持中文文档阅读,纯本地解析txt/md文件,按字数自动分页(默认300字),优化中英文混排断句;支持UTF-8编码(需手动处理BOM),自动归一化Windows换行符,不渲染Markdown语法,每次打开重新读取磁盘内容。

Thief Book 插件是否支持中文文档阅读
完全支持,且对中文文本做了针对性优化。它不依赖外部翻译服务,纯本地解析,直接加载 .txt 或 .md 文件,自动按字数(非字符数)分页,避免中英文混排时断句错乱。默认分页长度按「中文习惯」设为 300 字,可在设置中手动调整 thiefBook.pageLength。
中文换行与编码问题怎么处理
常见错误是打开 UTF-8-BOM 编码的中文文档时出现乱码或首行空白。Thief Book 默认使用 utf8 编码读取,但不自动 strip BOM。解决方法:
- 用 VSCode 打开文档 → 右下角点击编码名(如「UTF-8 with BOM」)→ 选择「Save with Encoding」→ 改为
UTF-8 - 或在插件配置中显式指定:
"thiefBook.fileEncoding": "utf8" - 若文档含 Windows 风格换行(
\r\n),插件会自动 normalize,无需额外处理
快捷键冲突导致无法唤起阅读面板
Mac 上默认快捷键 Cmd+M 常被系统或其他插件占用(比如「最小化窗口」),触发后无响应。这不是插件故障,而是快捷键未生效:
- 打开
Cmd+Shift+P→ 输入Preferences: Open Keyboard Shortcuts - 搜索
thiefBook.open,双击修改为未被占用的组合,例如Cmd+Alt+O - 确认该快捷键未出现在「When' 列中限定为特定上下文(如 editorTextFocus),否则在侧边栏或终端激活时失效
为什么 Markdown 中的中文标题渲染异常
Thief Book 仅做纯文本分页,不解析 Markdown 语法。所以 # 标题 会被当作普通文字显示,不会加粗或缩进。这不是 bug,而是设计边界:
- 想保留格式?用
Preview功能(右键 →Open Preview)替代,但会跳出当前编辑器 - 想边读边查?把 Markdown 转成纯文本再导入(可用
Markdown All in One插件导出为.txt) - 插件本身不提供富文本渲染,体积控制在
2MB内正是为此牺牲部分展示能力
实际用起来最常被忽略的是:它不缓存文件内容,每次打开都重新读取磁盘——这意味着你改完文档后,必须手动刷新阅读面板(Cmd+R 或点击重载按钮),不然看到的是旧内容。


















