banner
约 900 字
3 分钟

cmdp v0.3.0 发布:更清晰的配置编辑器与上下文帮助

摘要

cmdp v0.3.0 聚焦 TUI 使用体验:配置编辑器更清爽,命令和参数帮助在面板底部显示,多行命令模板真正保留换行执行,并补充了本地命令配置说明。

cmdp v0.3.0 发布了。这一版的重点不是增加更多命令,而是把配置编辑、命令说明、多行模板和本地配置这几块打磨到更稳定、更容易理解的状态。

这轮修改都围绕一个目标:在终端里编辑命令配置时,界面应该尽量清楚,真正需要编辑的内容才出现,辅助说明应该出现在当前操作位置附近,而不是分散到用户需要额外猜测的地方。

配置编辑器更清爽

配置编辑界面的参数、选项和片段列表现在只展示 label。以前这些位置会直接露出较长的模板或配置片段,信息量太大,容易把列表变成一块难读的 TOML 预览。现在列表用于识别条目,真正编辑时仍然可以进入对应字段查看和修改完整内容。

编辑器里的鼠标滚轮问题也修掉了:当鼠标选中某一项后再滚动,正在编辑的文字不会跟着滚轮错位移动。模板属性弹窗也同步处理了同类行为,避免焦点和滚动互相干扰。

文本编辑光标改成了更接近终端的宽块光标。这个变化很小,但在 TUI 里很直接:当前插入位置更明显,编辑参数值、命令模板、说明文本时都更容易判断光标所在位置。

多行命令模板

v0.3.0 增加了对多行文本的支持,不只是在配置编辑界面能输入多行,配置文件里的跨行命令也能保留换行并正确参与渲染和执行。

这对复杂命令很有用。比如需要写多行 shell 片段、带缩进的命令块,或者把一组相关操作放在同一个模板里时,不再需要强行压缩成一行。渲染器现在会保留模板里的换行和缩进,让配置文件里的结构和最终执行的命令更接近。

帮助信息放在操作位置下面

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

命令说明会显示在命令列表下方,位置和参数、选项页里的说明一致,不再挤在命令栏内部。参数页的帮助只会在参数页获得焦点时显示,避免用户切到别的面板时仍然看到不相关的参数说明。

命令帮助和参数帮助的颜色也统一成蓝色。这样它们在视觉上属于同一类信息:不是可编辑值,也不是警告,而是当前条目的解释和提示。

本地配置补充说明

这次也同步优化了 ~/.config/cmdp 里的命令配置。对容易造成疑惑的命令参数补充了 help 字段,覆盖 Git、Rust、搜索、磁盘、压缩、Flatpak、dnf、systemd、文件大小等常用命令组。

这些帮助会直接被 v0.3.0 的新 UI 读出来,显示在参数页底部。换句话说,配置文件里的说明不再只是给维护者看的注释,而会成为实际使用时的上下文提示。

文档、翻译和提交

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

这轮修改按功能拆分提交:配置编辑器列表展示、滚轮和焦点修复、宽光标、多行命令模板、上下文帮助分别提交,方便之后回看每一项行为变化。

END