用途
Bubbletea 技能用于使用 Go 语言和 Bubbletea 框架构建终端用户界面(TUI)。适用于创建新 TUI 应用、向现有应用添加 Bubbletea 组件、修复布局或渲染问题(边框、对齐、溢出)、实现鼠标或键盘交互、构建双栏或多面板布局、添加视觉效果(如 metaballs、波浪、彩虹文字),以及排查 TUI 渲染问题。
主要能力
该技能提供生产级模板系统,新项目可基于现有模板结构启动。项目结构包含 main.go、types.go、model.go、update.go、update_keyboard.go、update_mouse.go、view.go、styles.go、config.go 等文件,强调单一职责与文件大小控制。
它总结了 4 条布局黄金法则:始终考虑边框(渲染面板前从高度计算中减去 2)、在带边框面板中不要自动换行(应显式截断文本)、鼠标检测需匹配布局(水平布局用 X 坐标,垂直布局用 Y 坐标)、使用权重而非像素(比例布局可完美缩放)。
可用组件包括面板系统(单栏、双栏、多面板、标签式布局)、列表(简单列表、过滤列表、树视图)、输入(文本输入、多行、表单、自动补全)、对话框(确认、输入、进度、模态)、菜单(上下文菜单、命令面板、菜单栏)、状态(状态栏、标题栏、面包屑)、预览(文本、Markdown、语法高亮、图片、十六进制)、表格(简单和交互式表格)。
效果库提供基于物理的动画,如 metaballs、波浪效果、彩虹循环和图层合成器。
使用方式
实现布局时遵循计算可用空间、使用基于权重的面板尺寸、截断文本防止换行的模式。鼠标交互需先检查布局模式,再根据方向使用 X 或 Y 坐标。配置系统支持 YAML 热重载,配置文件从 ~/.config/your-app/config.yaml 或 ./config.yaml 加载。
依赖包括必选的 charm.land/bubbletea/v2、charm.land/lipgloss/v2、charm.land/bubbles/v2、gopkg.in/yaml.v3,以及可选的 glamour、huh、chroma、bubble-table、go-fzf。
适用场景与限制
适用于 Go 语言 TUI 开发,特别是需要复杂布局和交互的应用。技能文档包含黄金法则、组件、故障排查、emoji 宽度修复等参考文件,按需加载。应避免在带边框的 Lipgloss 样式上设置显式 Height(),而应填充内容到精确高度。当前资料未提供具体的收费、价格或平台限制信息。