3步定制你自己的终端工具箱WaveTerm Widgets 配置、原理与社区参与【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm你有没有遇到过这样的场景常用的 fish 终端、网络测速工具、远程服务器会话每次都要敲命令或手动连接窗口越开越多WaveTerm一款开源的 AI 集成跨平台终端的 Widgets小组件功能就是把这些工具变成侧边栏上一个点一下就开的图标。整个过程只需要编辑一个 JSON 配置文件不涉及任何编程。功能全景Widget 栏是什么Widget 栏位于窗口右侧WaveTerm 预置了 5 个默认组件terminal终端、files文件浏览、web网页、aiAI 助手和 sysinfo系统监控图。每个图标代表一个块BlockWave 中承载内容的独立窗口单元点击就在当前标签页中打开对应工具。你可以随时增删、拖动、调整大小把它变成只属于自己的工具箱。最简配置步骤3步加上你的第一个 Widget第 1 步找到配置文件。打开WAVETERM_HOME/config/widgets.jsonWAVETERM_HOME是 Wave 的配置主目录文件不存在时手动创建即可。第 2 步添加一段 JSON。以固定启动 fish 终端为例在文件顶层加一个条目fish: { icon: fish, label: fish, blockdef: { meta: { view: term, controller: shell, term:localshellpath: fish } } }第 3 步点击新图标验证。Widget 栏会出现一条带图标的 fish点开就是一个 fish 终端。外层的icon、label、blockdef是所有 Widget 共用的通用字段内层meta里的view、controller、term:localshellpath才决定它具体干什么。这种外壳 内核的拆分方式就是整个配置体系的设计思路。幕后拆解一段 JSON 如何变成图标想弄清每个字段的作用可以直接看仓库里的两处文件schema/widgets.json字段定义的 JSON Schema配置时编辑器会基于它做提示和校验docs/docs/customwidgets.mdx官方完整文档逐字段列出了controller、cmd:*、cmd:env等可选项其中controller是最关键的开关设为shell表示打开一个可交互的持久终端会话设为cmd表示只执行一条命令此时还能配cmd: speedtest-go --unix等具体命令标题栏会出现刷新按钮供你重跑。进阶玩法让 Widget 更强网页书签 Widgetview: web配合url和pinnedurl主页按钮指向的地址把常用网站做成一键直达远程终端 Widgetmeta里加connection: userhost图标点击直接连上远程 SSH 会话WSL 则是wsl://Ubuntu形式覆盖或删除默认组件五个默认 Widget 的键名是defwidgetterminal等把某个键设为null即可从栏中移除系统监控定制view: sysinfo可指定graph:numpoints图表时间窗口秒数和sysinfo:type如CPU Mem参与社区从文档开始贡献Wave 欢迎小步、聚焦的贡献比如文档勘误、示例补充、明确的 bug 修复。入门路径git clone https://gitcode.com/GitHub_Trending/wa/waveterm cd waveterm然后阅读 CONTRIBUTING.md小的修改拼写、文档可直接提 PR较大的改动建议先在项目社区讨论对齐方向。首次提交 PR 时需要签署 CLA贡献者许可协议本地构建参考 BUILD.md。避坑清单动手前先看这几条注意远程 Widget 的connection值必须使用规范名称如userremotehost不要使用你在下拉菜单里看到的自定义display:name否则图标点不开。注意term:localshellpath写的是fish、pwsh这类命令名时要求它已在系统 PATH 中。如果找不到就改成绝对路径例如/usr/local/bin/fish。Tipwidgets.json 是标准 JSON多一个逗号都会让配置加载失败。改完建议先用任何 JSON 校验工具检查一下再重启 Wave。Tipcmd:clearonstart: true能让命令型 Widget 每次重跑时清空旧输出测速这类反复执行的场景体验会好很多。速查问答Q: 配置文件放哪里A:WAVETERM_HOME/config/widgets.json。没有就新建字段可对照 schema/widgets.json 检查。Q: 默认的 5 个组件能删吗A: 能。把defwidgetfiles这类键的值设为null即可移除也可以复制它的定义再改名修改。Q: 图标支持哪些样式A: 支持 Font Awesome 图标名可用solidhouse、brandsyoutube这类前缀切换实心、描边和品牌风格。Widget 配置就藏在一个 JSON 文件里门槛比你想象的更低。打开你本地的widgets.json把今天最常用的一条命令变成图标——这是你定制 WaveTerm 的第一步。【免费下载链接】wavetermAn open-source, AI-integrated, cross-platform terminal for seamless workflows项目地址: https://gitcode.com/GitHub_Trending/wa/waveterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
