Textual 终端界面快速脚手架
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2fd890c9/textual。
技能介绍
要解决什么问题
很多 Python 脚本已经能跑通逻辑,但交互仍停留在 argparse 或零散 print,内部工具、运维脚本和数据分析小工具往往缺一块「在终端里能点、能输、能看列表」的界面。从零读 Textual 文档再搭 App、compose() 和事件命名,成本不低;本技能把重点放在骨架生成:你描述组件和布局,它输出可运行的 my_app.py。
技能如何工作
触发意图通常包含 textual、tui、终端界面、脚手架 等。你需要尽量说清楚:
- 组件清单(按钮、输入框、静态文本、列表、数据表格、页签、头尾栏等)
- 布局偏好(垂直/水平、网格、滚动区域)
- 可选的主题色与界面要做什么(事件行为可写在描述里,业务细节仍由你实现)
生成物默认包含:App 子类、compose() 布局、常用事件方法骨架(如 on_button_pressed)、内嵌基础 CSS。信息不足时会出现 [需核实:字段] 占位,而不是猜测默认值。运行方式是标准的 python my_app.py(需已安装 textual)。
适用边界与注意点
能做:常见组件与容器布局、基础样式类、常用事件骨架的单文件应用。
不能做:复杂 Canvas/动画、像素级绝对定位、自动补全业务逻辑、自动建虚拟环境与打包可执行文件。生产级重度异步、与 Tkinter/PyQt 混用、海量动态刷新等场景需自行按官方文档扩展;文档中的 FAQ 反模式(CSS 作用域、事件方法命名、run_worker 处理阻塞等)值得在改骨架前先扫一眼。
使用场景
- 值班排查时要把现有日志脚本改成带滚动日志区与「暂停/继续」按钮的终端界面,先按组件清单生成骨架再接入日志源。
- 内部分析工具需从纯命令行改为:路径输入框、中间 DataTable、底部确认按钮,用自然语言描述布局后得到可运行的 `my_app.py`。
- 团队要求运维小工具用 TUI 交付,需要带头尾栏和多页签的面板结构,避免从零手写 `compose()` 与基础 CSS。
- 学习 Textual 时想先拿到含 `App` 子类、事件方法名与内嵌样式的完整单文件,再对照官方文档逐项改业务逻辑。
适合人员
- 在 Linux 服务器上维护 Python 运维脚本的 SRE,想把子命令或主机选择做成终端里的按钮与列表而非一长串参数。
- 编写内网批处理或查询小工具的数据分析师,需要在终端中展示表格并让用户输入过滤条件后触发查询骨架。
- 负责把 legacy CLI 升级为交互工具的后端开发,熟悉 Python 但尚未系统阅读 Textual 的 `compose` 与消息路由约定。
- 维护内部发布平台的工程师,要给现有命令行工具加「设置 / 关于」页签和版本展示,先快速生成可改动的 TUI 架子。