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。
典型使用流程
- 执行
fastsim_cli启动界面 - 在左侧选择 VALIDATE CONFIGURATION,填入配置文件路径,点击 EXECUTE COMMAND 校验
- 选择 SHOW CONFIG 确认展开后的完整字段
- 选择 LAUNCH SIMULATION,填入配置路径,执行后在日志区域查看实时输出
- 需要查看可用 API 路由时,选择 SHOW STATIC API
键盘导航
Textual TUI 支持标准终端键盘操作:方向键或 Tab 切换焦点,Enter 触发选中,Ctrl+C 退出。