SuperAPI AI 工具集

textual-tui-skill

设计与创作

查看项目

更新于 10-16 03:44

技能介绍

用途:为构建专业级 Python 终端界面(TUI)提供 Textual 框架的系统性参考。

主要能力:控件方面涵盖 40+ 内置组件,如 Input、Button、Select、Checkbox、DataTable、Tree、Log、RichLog、Tabs、TabbedContent;布局支持 Vertical、Horizontal、Grid,固定与分数尺寸及响应式模式;样式涵盖 TCSS 语法、语义化颜色系统、外部样式表、边框与内边距;响应式编程包含 reactive 属性、watcher、计算属性与类 DOM 的控件树;异步方面支持用 worker 处理长任务、call_from_thread() 线程安全更新 UI 及取消;导航支持多屏应用、模态屏与屏幕栈管理;事件涵盖 Mount、Click、Key、键盘绑定、action 方法与消息传播;测试提供 Pilot API、基于 pytest 的异步测试与 UI 交互模拟;并记录 10 个常见陷阱,如阻塞事件循环、线程安全、worker 选择。附约 1100 行、4 个可运行示例应用:待办应用、系统仪表盘、数据查看器、worker 演示。

使用方式:可克隆仓库后运行 quickstart.sh,或将预编译技能文件直接安装到代理的 skills 目录(全局 ~/.agents/skills 或项目 .agents/skills),用 curl 下载 SKILL.md。

git clone https://github.com/aperepel/textual-tui-skill cd textual-tui-skill bash quickstart.sh

curl -o ~/.agents/skills/textual-tui-skill/SKILL.md
https://raw.githubusercontent.com/aperepel/textual-tui-skill/main/skill/SKILL.md

适用场景:Python 终端应用的界面搭建、样式与交互、异步任务、多屏导航及 UI 测试。

限制:不适合跨框架 TUI 概览(Go/Rust/Python/TS),也不针对 Bubble Tea(Go)、Ratatui(Rust)、Ink(TypeScript/React),这些应参考 tui-design-skill。费用、价格与平台等细节暂未提供。