mcpField
T
textual-tui-skill

textual-tui-skill

github.com/podo开发29213 次安装1 天前更新
代码仓库

关于 textual-tui-skill

面向 Python 开发者的 Textual 框架参考技能，涵盖构建终端用户界面所需的组件、布局、样式、异步任务和测试，并附带示例应用。

主要功能

  1. 01Textual 组件与布局参考
  2. 02TCSS 样式和响应式属性
  3. 03异步 Worker 与线程安全更新
  4. 04多屏导航和事件处理
  5. 05Pilot API 与 pytest 测试示例
  6. 06四个完整示例应用

适用场景

  1. 01构建 Python 终端界面应用
  2. 02为界面添加响应式布局和样式
  3. 03处理耗时任务并更新界面
  4. 04使用 pytest 模拟界面交互

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/podo/design-agent-skills --skill textual-tui-skill

安装后在 Claude Code 中输入/textual-tui-skill确认已加载。

附带文件stub.yaml

详细介绍

textual-tui-skill

目录占位条目 — 完整技能：aperepel/textual-tui-skill（textual-tui）

决策树

  1. 是否已安装完整技能？ 上游将此技能命名为 textual-tui，因此它会安装在此指针文件旁边（不会替换该指针文件）。

    • 全局：f=~/.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • 项目：f=.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • installed → 技能已作为 textual-tui 安装，调用它并继续
    • pointer → 转到第 2 步

  2. 检测范围，然后安装：

    [ -e ~/.agents/skills/textual-tui-skill ] && echo "global" || echo "project"

    全局：

    npx skills add aperepel/textual-tui-skill --skill textual-tui -g -y

    项目：

    npx skills add aperepel/textual-tui-skill --skill textual-tui -y

    Claude Code： 发送以 ! 开头的命令作为聊天消息，即可在不离开对话的情况下运行命令。

注意事项

  • 需要： Python，以及 textual 和 textual-dev（pip install textual textual-dev），用于运行该技能生成的内容
  • 许可证： MIT

安装后调用

  • 技能名称：textual-tui
  • 触发短语："Textual TUI"、"Textual widget"、"Textual app"、"TCSS styling"、"Textual framework"

功能

全面的 Textual 框架参考，助你构建专业的 Python TUI：

领域涵盖内容
组件内置组件，如 Input、Button、Select、Checkbox、DataTable、Tree、Log、RichLog、Tabs、TabbedContent
布局Vertical、Horizontal、Grid；固定/分数尺寸；响应式模式
样式TCSS 语法、语义颜色系统、外部样式表、边框、内边距
响应性响应式属性、观察器、计算属性、类似 DOM 的组件树
异步用于长时间运行任务的工作器、用于线程安全 UI 更新的 call_from_thread()、取消操作
导航多屏幕应用、模态屏幕、屏幕堆栈管理
事件Mount、Click、Key；键盘绑定；操作方法；消息传播
测试Pilot API、使用 pytest 的异步测试模式、UI 交互模拟
常见问题记录的常见错误：阻塞事件循环、线程安全、工作器选择

附带 references/（组件、布局、样式、官方指南索引）以及 assets/ 下的四个完整示例应用：待办事项应用、系统仪表板、数据查看器和工作器演示。

不适用场景

  • 多框架 TUI 概览（Go/Rust/Python/TS）——使用 tui-design-skill
  • Bubble Tea（Go）——使用 tui-design-skill
  • Ratatui（Rust）——使用 tui-design-skill
  • Ink（TypeScript/React）——使用 tui-design-skill

评论

支持 Markdown