TXT Status Bar Reader
在 VSCode 状态栏中显示 TXT 文件内容，支持逐行切换和快捷键控制。
功能特性
- ✅ 状态栏显示：在 VSCode 状态栏中显示 TXT 文件内容，每次仅展示一行文本
- ✅ 左右切换按钮：通过点击状态栏的左右箭头按钮切换上一行/下一行
- ✅ 快捷键支持：提供快捷键快速控制显示/隐藏和行切换
- ✅ 自动翻页：支持设置自动翻页，每次翻页间隔可配置
- ✅ 跳页控制：通过快捷键快速跳转到指定行
- ✅ 文件监听：自动监听文件变化并更新内容
- ✅ 配置持久化：记住上次选择的文件路径
- ✅ 友好提示：提供详细的状态反馈和错误提示
- ✅ 跨平台支持：支持 Windows、macOS、Linux
- ✅ 多编码支持：自动检测 UTF-8、GBK、GB2312 等多种编码格式
使用方法
首次使用
- 激活插件后，按下快捷键
Ctrl+Shift+C (Mac: Cmd+Shift+C)
- 系统会弹出文件选择对话框
- 选择要读取的
.txt 文件
- 文件加载后，状态栏会显示第一行内容
基本操作
显示/隐藏
- 快捷键：
Ctrl+Shift+C (Mac: Cmd+Shift+C)
- 命令面板：
TXT Reader: 切换显示/隐藏
切换行
上一行：
- 点击状态栏左侧的
← 上一行 按钮
- 快捷键：
Ctrl+Shift+Z (Mac: Cmd+Shift+Z)
下一行：
- 点击状态栏右侧的
下一行 → 按钮
- 快捷键：
Ctrl+Shift+X (Mac: Cmd+Shift+X)
自动翻页
- 按
Ctrl+Shift+P (Mac: Cmd+Shift+P) 打开命令面板
- 输入
TXT Reader: 切换自动翻页 并回车
- 如果是首次使用，选择一个翻页间隔（1 秒、2 秒、3 秒、5 秒、10 秒）
- 如果已经启用，会直接关闭自动翻页
跳页翻页
- 按
Ctrl+Shift+P (Mac: Cmd+Shift+P)
- 输入
TXT Reader: 跳转到指定行 并回车
- 输入要跳转的行号并回车
选择文件
- 点击状态栏中的文本区域
- 或使用命令：
TXT Reader: 选择 TXT 文件
配置选项
在 settings.json 中可以配置以下选项：
{
// TXT 文件路径
"txtReader.filePath": "",
// 自动刷新间隔（毫秒），0 表示不自动刷新
"txtReader.refreshInterval": 0
}
快捷键说明
| 功能 |
Windows/Linux |
macOS |
| 切换显示/隐藏 |
Ctrl+Shift+T |
Cmd+Shift+T |
| 上一行 |
Ctrl+Shift+Left |
Cmd+Shift+Left |
| 下一行 |
Ctrl+Shift+Right |
Cmd+Shift+Right |
状态栏说明
状态栏包含三个部分：
- 上一行按钮 (
← 上一行)：点击显示上一行内容
- 文本显示区 (
📄 文本内容...)：显示当前行内容，点击可选择新文件
- 下一行按钮 (
下一行 →)：点击显示下一行内容
特性详情
循环浏览
- 当到达第一行时继续向上，会自动跳转到最后一行
- 当到达最后一行时继续向下，会自动跳转到第一行
文件监听
- 当 TXT 文件内容发生变化时，插件会自动重新读取文件
- 尽量保持当前显示的行不变
- 如果文件被删除，会显示警告信息
内容截断
- 状态栏文本长度超过 50 个字符时会自动截断
- 截断时会显示省略号 (...)
- 完整内容可通过悬停提示查看
进度显示
- 每次切换行时，会在底部状态栏显示当前进度
- 格式：
第 X / Y 行
- 显示持续 2 秒
常见问题
Q: 为什么状态栏没有显示？
A: 确保已经选择了 TXT 文件。按 Ctrl+Shift+C 激活插件并选择文件。
Q: 文件更新后内容没有变化？
A: 插件会自动监听文件变化。如果没有更新，可以尝试重新选择文件。
Q: 支持其他文件格式吗？
A: 目前仅支持 .txt 文件格式。
版本历史
1.0.0
- ✨ 初始版本发布
- ✅ 实现基本的文件读取和状态栏显示
- ✅ 支持左右切换按钮
- ✅ 添加快捷键支持
- ✅ 文件监听和自动刷新
- ✅ 友好的错误提示
贡献
欢迎提交 Issue 和 Pull Request！
许可证
MIT License
联系方式
如有问题或建议，请通过 GitHub Issues 联系。
| |
