WaveTerm 自定义小部件快速上手三步把常用命令变成一键启动【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm你有多久没嫌烦地重输过 speedtest或者手动敲fish开一个新的 shellWaveTerm 的自定义小部件widget即窗口侧边栏里那些点开即用的小图标功能可以把任意常用命令钉在 widget bar 上点一下就跑省掉反复输入和翻找标签页的工夫。 先看效果widget bar 能做什么WaveTerm 窗口左侧有一列小图标官方叫它 widget bar默认内置了终端、文件、网页、AI、系统监控五个。加上自定义小部件之后同一列图标就能变成你的快捷方式栏每个图标对应一个命令或一个页面三步加上你的第一个自定义小部件用编辑器打开WAVETERM_HOME/config/widgets.json——这是所有小部件定义的唯一入口。把下面这段 JSON 复制进文件作为某个键值对注意与已有内容用逗号隔开保存。重启 WaveTerm——widget bar 上多出一个仪表盘图标点它直接跑一次网络测速。speedtest: { icon: gauge-high, label: speed, blockdef: {meta: {view: term, controller: cmd, cmd: speedtest-go --unix}} }原理一句话就能说清blockdef.meta里声明打开一个终端视图执行这条命令剩下的键图标、标签、颜色只影响显示。完整字段表在 docs/docs/customwidgets.mdx不用死记用到再查。配置文件藏在哪示例去哪抄WAVETERM_HOME是 WaveTerm 的主目录config/widgets.json在首次使用小部件功能时生成如果没有这个文件直接新建一个、从{}开始往里加也行。想照抄一个规范写法默认小部件的定义就放在仓库的 pkg/wconfig/defaultconfig/widgets.json 里键名是defwidgetterminal、defwidgetfiles这类。有两个顺手的操作不想要的默认图标在自己文件里把同名键设为null即可移除。想换成常驻会话而非跑一次就结束的命令把controller改成shell再用term:localshellpath指向 shell 路径比如 fish、pwsh。 自定义小部件不生效先查这几个坑很多人会问JSON 明明存了怎么图标没出来高频原因有四个JSON 语法断了少一个逗号或引号整个文件解析失败所有图标都不变。存盘前用任意 JSON 校验工具过一遍。图标名写错icon用的是 Font Awesome 的图标名写错不会报错只是图标渲染不出来。命令路径找不到widget 里的命令和终端行为一致fish若不在系统 PATH 里就要写全路径如/usr/local/bin/fish。改错了文件只有你自己config目录下的widgets.json生效去改仓库里pkg/wconfig/defaultconfig/下的文件打包出来的应用根本不会读它。另外view的值只能是term、web、sysinfo之一填错是最常见的解析失败原因。想一起改进它遇到小部件不生效、或者想加某个现成功能直接在官方仓库提一个 Issue附上widgets.json片段和现象描述就是最有价值的反馈。项目协作方式什么改动受欢迎、什么要先讨论写在 CONTRIBUTING.md 里几分钟能看完。更多配置细节可以翻官方文档站仓库的社区讨论区则是遇到怪问题时最多人搭把手的地方。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/6 22:06:44 · 阅读 1.2k WaveTerm 自定义小部件快速上手：三步把常用命令变成一键启动
WaveTerm 自定义小部件快速上手三步把常用命令变成一键启动【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm你有多久没嫌烦地重输过 speedtest或者手动敲fish开一个新的 shellWaveTerm 的自定义小部件widget即窗口侧边栏里那些点开即用的小图标功能可以把任意常用命令钉在 widget bar 上点一下就跑省掉反复输入和翻找标签页的工夫。 先看效果widget bar 能做什么WaveTerm 窗口左侧有一列小图标官方叫它 widget bar默认内置了终端、文件、网页、AI、系统监控五个。加上自定义小部件之后同一列图标就能变成你的快捷方式栏每个图标对应一个命令或一个页面三步加上你的第一个自定义小部件用编辑器打开WAVETERM_HOME/config/widgets.json——这是所有小部件定义的唯一入口。把下面这段 JSON 复制进文件作为某个键值对注意与已有内容用逗号隔开保存。重启 WaveTerm——widget bar 上多出一个仪表盘图标点它直接跑一次网络测速。speedtest: { icon: gauge-high, label: speed, blockdef: {meta: {view: term, controller: cmd, cmd: speedtest-go --unix}} }原理一句话就能说清blockdef.meta里声明打开一个终端视图执行这条命令剩下的键图标、标签、颜色只影响显示。完整字段表在 docs/docs/customwidgets.mdx不用死记用到再查。配置文件藏在哪示例去哪抄WAVETERM_HOME是 WaveTerm 的主目录config/widgets.json在首次使用小部件功能时生成如果没有这个文件直接新建一个、从{}开始往里加也行。想照抄一个规范写法默认小部件的定义就放在仓库的 pkg/wconfig/defaultconfig/widgets.json 里键名是defwidgetterminal、defwidgetfiles这类。有两个顺手的操作不想要的默认图标在自己文件里把同名键设为null即可移除。想换成常驻会话而非跑一次就结束的命令把controller改成shell再用term:localshellpath指向 shell 路径比如 fish、pwsh。 自定义小部件不生效先查这几个坑很多人会问JSON 明明存了怎么图标没出来高频原因有四个JSON 语法断了少一个逗号或引号整个文件解析失败所有图标都不变。存盘前用任意 JSON 校验工具过一遍。图标名写错icon用的是 Font Awesome 的图标名写错不会报错只是图标渲染不出来。命令路径找不到widget 里的命令和终端行为一致fish若不在系统 PATH 里就要写全路径如/usr/local/bin/fish。改错了文件只有你自己config目录下的widgets.json生效去改仓库里pkg/wconfig/defaultconfig/下的文件打包出来的应用根本不会读它。另外view的值只能是term、web、sysinfo之一填错是最常见的解析失败原因。想一起改进它遇到小部件不生效、或者想加某个现成功能直接在官方仓库提一个 Issue附上widgets.json片段和现象描述就是最有价值的反馈。项目协作方式什么改动受欢迎、什么要先讨论写在 CONTRIBUTING.md 里几分钟能看完。更多配置细节可以翻官方文档站仓库的社区讨论区则是遇到怪问题时最多人搭把手的地方。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考