在 dsh-TUI 的使用过程中,输入编辑、会话历史、视图面板切换等操作主要通过快捷键完成。面对众多键位,记忆成本较高。dsh-tui-keys 插件旨在解决“可发现性”问题,通过一个可视化的面板,让用户无需离开当前上下文即可查询键位。
这是一个全屏、分组、可搜索的快捷键速查表面板,由 FUSU123fusu 维护。它通过 /keys 命令打开,覆盖了输入、会话、视图及模式切换等核心场景的键位。
核心功能¶
- 全屏面板:输入
/keys打开,展示所有键位。 - 交互操作:支持
↑/↓移动、PgUp/PgDn翻页、/搜索、Esc退出。 - 智能跳过:移动时自动跳过分组标题。
- 搜索过滤:输入
/后,可跨键位与中英文描述进行过滤。 - 环境兼容:宿主不支持 scene 时,自动退化为分组文本列表。
- 语言跟随:界面语言跟随当前系统的
/lang设置。 - 零依赖:无运行时依赖。
安装与启用¶
dsh plugin --profile <你的profile> add file:dsh-tui-keys-0.1.0.tgz
典型用法¶
- 打开面板:在 dsh-TUI 中输入
/keys。 - 导航列表:使用方向键
↑和↓浏览,PgUp和PgDn翻页。 - 搜索键位:按下
/进入搜索模式,输入关键词(支持中英文描述)过滤列表。 - 退出面板:按下
Esc,先清空搜索内容,再关闭面板。
适用场景与注意¶
- 适合需要频繁切换模式或进行复杂输入操作的 dsh-TUI 用户。
- 数据快照:键位数据对照 dsh-TUI 0.8.x 核对。由于 TUI 迭代速度快,该清单为当前快照,并非权威来源。
- 若发现键位漂移,欢迎提 issue 或 PR 更新
lib/bindings.js。