TUI 交互式启动

fastsim_cli 是基于 Textual 构建的终端交互界面(TUI),提供与 fastsim 命令行完全相同的功能,以可视化的表单与实时日志替代手动输入参数。

bash
fastsim_cli

界面结构

TUI 启动后分为两个区域:

  • 左侧边栏:列出所有可用命令,点击选中后右侧显示对应的参数表单
  • 右侧主面板:上方为参数输入区,下方为实时日志输出区(SYSTEM LOG)

可用命令

TUI 中的命令与 fastsim CLI 完全一致:

命令执行模式说明
LAUNCH SIMULATION子进程启动仿真,日志实时流式输出到 LOG 区域
VALIDATE CONFIGURATION函数调用校验配置文件,结果打印到 LOG
SHOW CONFIG函数调用展开完整配置并打印
SHOW REGISTERY函数调用打印已注册的 stereotype 列表
SHOW STATIC API函数调用打印所有 HTTP API 路由
SHOW STEREOTYPE PARAMS函数调用查看指定 stereotype 的完整参数

两种执行模式

TUI 内部区分两种执行方式:

  • 函数调用(function):在 TUI 进程内同步执行,输出重定向到日志区域。适合轻量操作(校验、查看配置等)。
  • 子进程(process):以独立子进程启动,stdout 实时流入日志区域。launch_simulation 使用此模式,避免仿真进程阻塞 TUI 界面。

同一时刻只能运行一个子进程;若尝试重复启动,日志区域会提示 A process is already running

典型使用流程

  1. 执行 fastsim_cli 启动界面
  2. 在左侧选择 VALIDATE CONFIGURATION,填入配置文件路径,点击 EXECUTE COMMAND 校验
  3. 选择 SHOW CONFIG 确认展开后的完整字段
  4. 选择 LAUNCH SIMULATION,填入配置路径,执行后在日志区域查看实时输出
  5. 需要查看可用 API 路由时,选择 SHOW STATIC API

键盘导航

Textual TUI 支持标准终端键盘操作:方向键或 Tab 切换焦点,Enter 触发选中,Ctrl+C 退出。