用途:该技能面向使用 Go 与 Bubbletea 框架开发终端用户界面(TUI)的场景,适用于新建 TUI 应用、为现有应用添加 Bubbletea 组件、修复布局与渲染问题(边框、对齐、溢出)、实现鼠标与键盘交互、构建双栏或多面板布局、添加视觉效果以及排查 TUI 渲染故障。
主要能力:提供生产可用的模板系统与项目结构(main.go、types.go、model.go、update.go、update_keyboard.go、update_mouse.go、view.go、styles.go、config.go),并附带组件目录,包括面板系统(单栏、双栏、多面板、标签页)、列表(简单列表、过滤列表、树视图)、输入(文本、多行、表单、自动补全)、对话框、菜单、状态栏、预览(文本、Markdown、语法高亮、图片、十六进制)、表格等。模板还包含基于物理的动画效果库,如 metaballs、波浪效果、彩虹渐变与 ANSI 感知的多层合成。
使用方式:实现布局前需查阅 references/golden-rules.md 中的四条黄金法则:计算高度时先减去边框占用的 2 行;有边框面板中不要依赖自动换行,需显式截断文本;鼠标检测坐标需与布局方向匹配(水平用 X、垂直用 Y);使用权重而非固定像素进行比例布局。布局实现遵循先计算可用空间、再按权重分配面板尺寸、最后截断文本的流程。配置通过 YAML 支持热重载,从 ~/.config/your-app/config.yaml 与 ./config.yaml 加载。依赖包括 github.com/charmbracelet/bubbletea、lipgloss、bubbles 与 gopkg.in/yaml.v3,可选 glamour、huh、chroma/v2、bubble-table、go-fzf 等。
适用场景与限制:适合需要结构化、可维护的 Go TUI 项目,尤其是涉及复杂布局与交互的场景。资料未提供具体安装命令、收费信息或平台限制;参考文档按需渐进加载,具体效果与兼容性需以实际项目为准。