vscode-book-saver
在 VS Code 状态栏中阅读书籍的扩展。
功能
- 状态栏显示书籍内容
- 注释模式：在光标位置插入多行注释块显示书籍内容，原有代码被挤到注释块下方
- 自动检测文件编码
j / k 键翻页，空格键隐藏- 支持跳转到指定位置
- 自动保存阅读进度
使用
- 设置
vscode-book-saver.filePath 为书籍文件路径
- 执行命令
Show Book
- 执行命令
Toggle Display Mode (Status Bar / Comment) 可在两种显示方式间切换，并持久化到用户设置
配置
| 配置项 |
类型 |
默认值 |
说明 |
vscode-book-saver.filePath |
string |
- |
书籍文件路径 |
vscode-book-saver.displayMode |
string |
statusBar |
显示方式：statusBar 底部状态栏 / comment 光标处注释样式 |
vscode-book-saver.size |
number |
20 |
状态栏模式每页字符数 |
vscode-book-saver.commentLines |
number |
4 |
注释模式显示行数 |
vscode-book-saver.commentCharsPerLine |
number |
30 |
注释模式每行字符数 |
注释模式下，从光标位置插入一个真正的多行注释块（C 系语言用 /* ... */，Python/SQL 等用对应行注释逐行拼接），每一行都对齐到光标列，光标之后的代码会被挤到注释块下方；翻页大小为 commentLines × commentCharsPerLine 个字符，翻页时原地替换注释块内容。
注释块是插入文件的真实文本：按空格隐藏、切换显示模式、切换编辑器或停用扩展时会自动删除；保存文件前也会自动移除（保存后按 j 可重新显示）。注意翻页和隐藏操作会进入文件的撤销历史。
打包与发布
前置要求
# 安装 vsce 工具（首次需要）
pnpm add -g @vscode/vsce
# 登录 VS Code 市场（首次需要）
vsce login <publisher-name>
# 会提示输入 Personal Access Token
# 在 https://dev.azure.com/your-org/_usersSettings/tokens 创建 Token
# 需要 Marketplace > Manage 权限
打包
# 编译
pnpm run compile
# 打包为 .vsix 文件
pnpm run package
# 生成 vscode-book-saver-0.1.0.vsix
本地安装测试
code --install-extension vscode-book-saver-0.1.0.vsix
发布到 VS Code 市场
# 方式 1：直接发布
pnpm run publish
# 方式 2：先打包再发布
vsce publish
版本更新
# 更新补丁版本 (0.1.0 -> 0.1.1) 并发布
vsce publish patch
# 更新次版本 (0.1.0 -> 0.2.0) 并发布
vsce publish minor
# 更新主版本 (0.1.0 -> 1.0.0) 并发布
vsce publish major
开发
# 安装依赖
pnpm install
# 监听编译
pnpm run watch
# 按 F5 启动调试
| |
