banner
约 1,500 字
5 分钟

cmdp v0.3.0:把那些用起来别扭的小地方修顺了

摘要

cmdp v0.3.0 主要是一次体验打磨:配置编辑器更干净,多行命令模板终于能自然保留换行,命令和参数说明也放到了更顺手的位置。没有很炫的新功能,但这些改动都是日常使用里真的会碰到的细节。

cmdp v0.3.0 发布了。

这一版我没有继续往里面加一堆新命令,而是回头处理了一些之前用着用着就会觉得别扭的地方。

比如配置编辑界面里信息太多,列表看起来有点吵;比如命令和参数的说明位置不够顺手,有时候要多猜一下当前选项到底是干什么的;再比如多行命令模板以前不够自然,明明配置文件里想写得清楚一点,最后却还是容易被压成一坨。

这些都不是那种一眼看上去很大的功能,但它们会影响一个终端工具的手感。cmdp 本来就是为了少记命令、少复制粘贴、少在终端里来回翻找,所以这次 v0.3.0 的重点就是把这些小摩擦磨掉。

配置编辑器安静了一点#

配置编辑器里,参数、选项和片段列表现在只展示 label。

以前这些地方会直接露出比较长的模板内容或配置片段。刚开始看起来好像信息很全,但配置一多,列表就会变成一大块很难读的 TOML 预览。

我后来觉得,列表最重要的事情其实不是展示全部内容,而是帮我快速找到“我要改哪一项”。真正需要编辑完整内容的时候,再进去看字段就够了。

所以这一版把列表收干净了。它现在更像一个目录,而不是把每一页内容都摊在你面前。

顺手也修了一个编辑时挺烦的小问题:鼠标选中某一项之后再滚动,正在编辑的文字不会再跟着滚轮错位移动。模板属性弹窗里类似的焦点和滚动问题也一起处理了。

还有一个很小的变化:文本编辑光标换成了更接近终端习惯的宽块光标。

这个改动写在更新日志里可能只是一句话,但实际用的时候挺明显。编辑参数值、命令模板或者说明文字时,光标在哪里会更清楚,不用盯着细细的一条线找半天。

多行命令模板终于像它本来该有的样子#

v0.3.0 加了多行文本支持。

这里的“多行”不只是编辑框里能换行,而是配置文件里的跨行命令模板也能保留换行和缩进,并且正常渲染、正常执行。

这个改动对我来说挺重要。

有些命令本来就不适合写成一行。比如一段 shell 片段,或者一组相关操作,硬压成一行之后既不好读,也不好改。以前为了让模板能跑,有时候只能牺牲一点可读性。

现在可以直接按更自然的方式写:

一行是一行,缩进是缩进,配置文件里怎么看,最终渲染出来也更接近那个样子。

这让 cmdp 不只是“能执行命令”,也更适合拿来整理那些稍微复杂一点的日常工作流。

帮助信息放到了眼睛更容易看到的地方#

命令和参数现在都可以在面板底部显示帮助信息。

我之前用的时候,经常会遇到一种情况:选中了一个命令或者参数,但说明的位置不够统一,有时候要多看一眼才知道它到底在解释谁。

这次把命令说明放到命令列表下方,参数说明放到参数页底部。位置更固定,也更贴近当前正在操作的内容。

参数页的帮助信息也只会在参数页获得焦点时显示。也就是说,当你切到别的面板时,不会还留着一段不相关的参数说明在那里干扰你。

颜色也统一成了蓝色。它表达的是“这是提示信息”,不是警告,也不是可编辑内容。这个细节不大,但在 TUI 里能让界面少一点误会。

本地配置也补了一些真正会看的说明#

这次还更新了 ~/.config/cmdp 里的命令配置。

我给一些容易停顿的参数补上了 help 字段,覆盖 Git、Rust、搜索、磁盘、压缩、Flatpak、dnf、systemd、文件大小等常用命令组。

这件事的意义是:这些说明不再只是配置文件里的注释。

v0.3.0 会把它们读出来,直接显示在参数页底部。你选到某个参数时,就能看到它是做什么的、应该怎么填、什么时候会用到。

这比写一堆文档然后让人自己去翻要顺手得多。说明就应该出现在需要它的地方。

文档和提交也顺了一遍#

文档和翻译也同步更新了,包括 README、示例配置、界面文案,还有 AGENTS.md 里和项目协作、测试、配置加载相关的说明。

这轮修改我按功能拆成了几次提交:配置编辑器列表展示、滚轮和焦点修复、宽块光标、多行命令模板、上下文帮助分别处理。

这样之后回头看某个行为为什么变了,也不至于在一大坨提交里翻半天。

小结#

cmdp v0.3.0 不是那种“看起来很大”的版本。

它更像是我自己用了一段时间之后,把那些心里记下来的小别扭一个个处理掉:哪里太吵,就收干净一点;哪里要猜,就补一段说明;哪里写起来不自然,就让它按更自然的方式工作。

这些改动不一定会让截图变得多惊艳,但我觉得它们会让 cmdp 更像一个可以长期放在终端里用的小工具。

少一点打断,少一点猜测,多一点顺手。

这就是 v0.3.0 最想做的事。

END

评论