Skip to content

ANBUZHIDAO/my-terminator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

my-terminator

terminator with autosuggestion

简介

本项目是在 terminator 基础上,开发了自动提示功能的功能。 zsh-autosuggestion使用起来实际上已经很方便了,但是zsh在个人电脑上安装居多,一般在其他服务器及sftp等情况下不能提示。
此项目是在终端工具terminator基础上实现了扩展, 在ssh远程登录到服务器或者在sftp、redis等各类命令行下仍然可以进行提示。

使用

自动提示的使用

请看gif图

tip1.gif

基本原理

主要处理 vte的key-press-event 和commit事件和contents-changed 事件

处理key-press-event、 terminal_commit 事件,
当有key-press和commit(也即敲击键盘输入内容)时判断输入是否是可见字符,最终引发contents-changed 事件后
来决定是否应该展示命令提示框。 提示框位置跟随光标,在光标下方展示,当超出屏幕范围时,展示在光标上方 默认最多展示10条提示,可自己修改tip.py中的配置 SUGGESTION_NUM

当选择了提示命令后,根据匹配情况使用VT100控制码移动光标并插入选择的命令

处理 contents-changed 事件,获取光标位置记录 光标行列
当 contents-changed 时,判读 当前光标的行数 与 之前行数 是否发生了变化,发生变化则认为是执行了命令引起了内容行数发生变化,
通过 get_text_content 获取 之前行数 上的文本内容作为历史命令并记录。

自动提示功能是基于历史输入来的,没记录过的命令无法提示。 自动提示功能会根据历史输入记录,当历史记录中在某个情况下,输入一个命令后,紧接着输入过另一个则会自动弹出并选中第一个
这样某些比较连贯的命令某些时候可以输入后直接Enter,Enter..... 目前此功能有些情况下还是可以用的。

另外有 Shift+空格 快捷键,此快捷键会在当前行暂时关闭提示功能。
如果感觉当前受到了干扰,可暂时关闭提示框,下一行会自动开启。

提示框非遮罩,在任何情况下,继续输入字符或粘贴都可以继续正常输入,提示框只会处理Up,Down,Enter三个键。

想看相关debug日志的,可修改utils.py中DEBUG_ENABLE = True
然后命令行下 terminator 来启动 terminator即可看到一些deug日志

安装方法

将相关python文件复制到terminator的插件目录

mkdir -p $HOME/.config/terminator/plugins
cp .*.py $HOME/.config/terminator/plugins/

然后重新打开terminator,右键打开配置文件首选项,点击插件即可开启插件。
enable-plugin

其他说明

terminator安装后建议把窗口下的带颜色的标题栏给去掉。 remove-title 还可以设置透明度等等,可自己搜索资料设置。

匹配模式

1、startswith: 'cd b'' 匹配 'cd bin'
2、中间模糊匹配 'bi' 匹配 'cd bin'
3、命令完全匹配,变量模糊匹配 'cd i' 匹配 'cd bin'

自动提示的推荐算法

基于5个维度来计算得分,每个维度的得分都在0-1之间,总得分最高的排在前面
window title: 窗口标题
prefix: 命令输入的前缀,比如 sftp,比如 $PS1
precmd: 前一条输入
count: 命令出现的总次数
last_time: 命令出现的最后时间

记录的历史命令总数大于一定数量时删除最早的部分,这样也可以遗忘掉很老的可能不再使用的历史命令
这个推荐算法是我自己瞎琢磨的,肯定会有更好的算法。。。

历史记录的保存

历史记录保存于 $HOME/.terminator.db 这个sqlite数据库。

删除错误记录

1、如果输入错误或bug导致记录历史有误,可右键 View Hostory查看历史,搜索并删除这一条输入错误的历史命令 因为 View Hostory 的目的就是为了删除错误命令的,因此只有总的记录次数小于5的才被搜索展示出来,并可以删除。

已知问题

VTE并没有现成的可靠的API可以获取输入及输出,还要处理很多特殊情况,因此自动提示功能并不十分正确。
目前我个人只在Ununtu16、Ubuntu18上使用过,目前已知的问题
1、比如处于top命令等类似场景下,
比如输入ls然后两次tab后,因为目前记录输入是记录当前行的最小列开始作为用户输入的命令。
最小列之前的字符串作为前缀。
输入ls再两次tab后,如果不主动把光标移动到最左,是不知道最左是在哪里的,则会从ls后面开始记录。
也可以记录最后的用户输入是tab并主动用VT100控制码来移动到最左再回到最右来针对性的解决这种情况,但是感觉没必要,不做了。
2、自动提示功能对zsh的兼容不好,推荐使用bash
3、换行的处理并不可靠,处于换行时历史记录可能会出错
4、自动提示命令推荐的算法基于历史输入的统计,并不太智能。
5、自动提示命令框可能有时候会对视线造成一点干扰,可Shift+空格暂时关闭。关闭后可Shift+空格在当前行再次开启。
6、目前使用过程中并未发现性能问题,出现了自动提示缓慢的情况可以先调小tip.py里的最大历史记录数量再想办法解决性能问题。

参考

链接地址 说明
http://www.climagic.org/mirrors/VT100_Escape_Codes.html VT100控制码表
https://lazka.github.io/pgi-docs/index.html#Gtk-3.0 Python GTK3.0
https://lazka.github.io/pgi-docs/index.html#Vte-2.91 Vte 2.91
https://python-gtk-3-tutorial.readthedocs.io/en/latest/ Python GTK+ 3 Tutorial

Releases

No releases published

Packages

No packages published

Languages