📚 组件库

lzt 提供了一套现代化的可复用组件库，专注于终端用户界面开发和高性能数据处理。

🎨 Bubble UI 组件库

基于 Bubble Tea 构建的现代化终端用户界面组件库，提供丰富的交互式界面组件。

核心特性

• 🚀 高性能进度条组件 - 支持多种显示模式和并发处理
• 📊 复合组件系统 - 支持多层级任务管理和状态显示
• 🔄 并发处理框架 - 可配置的工作协程池和任务调度
• 💾 内存优化 - 针对大数据集的内存使用优化
• 🎨 现代化主题 - 集成 Catppuccin 颜色主题

组件概览

组件类型	功能描述	应用场景
基础进度条	简单的任务进度显示	文件处理、下载进度
视窗进度条	支持滚动的固定区域显示	日志输出、实时监控
复合进度条	多层级任务（主任务→子任务→子子任务）	复杂构建流程、批量操作
并发进度条	多工作协程的并发任务处理	并行数据处理、多线程下载

便捷 API

// 处理字符串列表
bubble.ProcessStrings(items, processFunc)

// 处理文件列表  
bubble.ProcessFiles(filePaths, processFunc)

// 处理数字范围
bubble.ProcessRange(start, end, processFunc)

// 并发处理
bubble.ProcessConcurrent(tasks, processFunc)

// 复合任务进度条
bubble.RunCompositeProgress(compositeTasks, processFunc)

🚀 快速开始

安装和基础使用

# 查看可用的组件示例
lzt example tea --help

# 运行基础进度条演示
lzt example tea progress

# 运行并发处理演示
lzt example tea worker

# 运行复合组件演示  
lzt example tea composite

性能特性

• ⚡ 高并发处理 - 可配置的并发工作协程
• 📦 智能批处理 - 自动批量处理大数据集
• 🛡️ 速率限制 - 内置 API 请求节流机制
• 💾 内存优化 - 流式处理避免内存溢出
• 🔄 故障恢复 - 单点失败不影响整体处理

📖 文档导航

• 🎨 Bubble UI 组件详细文档 - 完整的组件 API 和使用指南
• 📈 进度条组件 - 各种进度条组件的详细说明
• 🔄 并发处理 - 并发处理框架的使用方法
• ⚡ 性能优化 - 性能调优和最佳实践

🎯 使用场景

DevOps 工具

• 批量文件处理和转换
• 部署脚本进度显示
• CI/CD 流水线状态监控

数据处理

• 大量数据迁移和 ETL 任务
• 批量 API 调用和数据同步
• 文件系统操作和备份

系统管理

• 服务器维护脚本
• 日志分析和处理
• 系统监控和报告

开发工具

• 代码生成器和构建工具
• 测试套件执行器
• 包管理器和依赖分析

---

💡 提示: 这些组件都经过充分测试，包含完整的单元测试和性能基准测试，可以安全地用于生产环境。