用途：在 Go 中使用 Bubbletea、Lipgloss 与 Bubbles 构建终端用户界面（TUI），适用于新建 TUI 应用、为现有应用添加 Bubbletea 组件、修复布局与渲染问题（边框、对齐、溢出）、实现鼠标与键盘交互、构建双栏或多面板布局、添加视觉效果以及排查 TUI 渲染故障。
主要能力：提供生产级项目模板与架构约定，main.go 保持精简（约 21 行），类型、模型、更新、视图、样式、配置分文件管理，单文件建议不超过 800 行（理想小于 500 行），支持 YAML 配置与热重载。组件目录涵盖面板系统（单栏、双栏、多面板、标签页）、列表（简单、过滤、树形）、输入（文本、多行、表单、自动补全）、对话框、菜单、状态栏、预览（文本、Markdown、语法高亮、图片、十六进制）与表格。效果库包含 metaballs、波浪、彩虹渐变与 ANSI 多层合成。
必要用法：实现布局前先查阅 references/golden-rules.md 的四条黄金法则：高度计算先减去边框的 2 行；有边框面板中显式截断文本而非依赖自动换行；鼠标检测坐标与布局方向匹配（水平用 X、垂直用 Y）；使用权重而非像素做比例布局。布局按“计算可用空间→按权重分配面板尺寸→截断文本”的顺序实现，鼠标处理前先判断布局模式。避免对有边框的 Lipgloss 样式设置显式 Height()，改为填充内容到精确高度。
依赖：github.com/charmbracelet/bubbletea、lipgloss、bubbles 与 gopkg.in/yaml.v3 为必需；glamour、huh、chroma/v2、bubble-table、go-fzf 为可选。
限制：资料未提供具体安装命令、版本要求、收费与价格信息，也未说明支持平台范围，这些内容暂未提供。