用途:为使用 Textual 框架构建终端应用提供模式、API 约束与可运行示例。当用户询问 Textual、TUI 应用、组件、CSS 样式、响应式属性、测试或并发时激活。
主要能力覆盖:App 类与 run/exit/suspend、标题、CSS 加载;屏幕栈 push/pop/switch、模态屏幕、模式、屏幕返回数据;自定义组件、内置组件、Line API、复合组件与数据流;布局类型(vertical、horizontal、grid)、停靠、层、偏移;CSS 选择器、伪类、组合器、特异性、变量、嵌套;事件、消息队列、冒泡、自定义消息与 @on 装饰器;动作、动作字符串、命名空间与绑定;响应式属性、智能刷新、校验、watch 方法、compute 与数据绑定;使用 run_test 与 Pilot API(press、click、hover、pause)测试,pytest-textual-snapshot 快照测试;Worker(@work、run_worker、线程 Worker、Worker 事件)。
使用方式:按任务类型查阅对应参考文件——App 结构与生命周期、组件、布局与 CSS、事件与动作、响应式、测试与 Worker;共享规则参见 python-engineering 的 Python 开发标准。
适用场景:构建多屏终端应用、自定义组件、样式化布局、处理输入与快捷键、响应式状态管理、编写 UI 测试及避免阻塞的后台任务。
限制:不覆盖 Rich 库内部实现、Textual Web 部署、自定义 CSS 解析器或非 Textual 的终端框架。