终端界面

通过 AQE 的终端界面，你无需打开 AQS，即可监控回测或实时策略。该界面读取本地运行时快照，展示指标、交易信号、变量、监视项和事件。

启用界面

在策略项目的 AQE 依赖中启用 tui；它也会启用 runtime：

aq-engine = { git = "https://github.com/algoquantstudio/aq-engine", features = ["tui"] }

请使用与策略兼容的 AQE 版本。以下控件说明以当前 0.2.0 开发版源代码为准，可能与已安装版本不同。

在交互式终端中使用 cargo run --release 运行项目。标准输出和标准错误都连接到终端时，TUI 会启动。如需保留控制台输出，请运行 cargo run --release -- --no-tui。输出被重定向时（包括通常由 AQS 捕获输出的情况），程序仍以无界面方式运行。

查找所需信息

面板	检查内容
Metrics	净值、收益率、已平仓交易、胜率、回撤、未平仓敞口和回测进度。
Insights	活跃交易信号、其状态，以及显示数量/总数量。
Inspector	所选交易信号的订单标识、价格、数量和近期状态历史。
Variables	嵌套策略值；打开对象或数组以检查子项。
Watch	希望持续显示的变量路径。
Events	保留的运行时消息及其时间戳。

活跃信号预览最多包含最近更新的 128 个活跃交易信号。Inspector 最多显示 25 条近期历史记录。如需查看完整历史，请使用持久化结果和 AQS；预览中没有某个信号，并不代表它从未存在。

导航与检查

按键	操作
Tab / Shift+Tab	在面板间循环切换
m, i, d, v, e	聚焦 Metrics、Insights、Inspector、Variables 或 Events
z	展开当前聚焦面板
Esc	优先退出展开模式或诊断模式
方向键 / PageUp / PageDown	在当前面板中选择或滚动
Enter / Right	打开嵌套变量
Left / Backspace	返回父变量
Variables 中的 w	添加或移除所选监视项
Watch 中的 Delete	移除监视项
s	打开运行时和同步诊断
q	请求正常停止；运行停止后关闭界面

终端小于 120 列或 30 行时，界面只显示当前聚焦面板，而不会将所有面板挤在终端中。

解读诊断信息

请对比快照距今的时间、市场时钟，以及发布器样本距今的时间。市场时间戳与屏幕刷新时间反映的是不同环节，不能混为一谈。

诊断信息包括本地传递模式、排队中的关键事件、合并后的遥测数据和本地确认延迟。**本地已接收不代表云端已持久化，也不代表桌面端已显示。**终端可能无法看到远程队列和执行记录核对状态；请结合运行时主机或网关的诊断信息与 AQS 进行排查。

日志和变量预览都有上限。你可以根据保留数量和显示数量，判断当前界面是否只展示了部分内容。

正常停止

按 q 请求正常策略关闭。等待进入已停止或已完成状态，然后再次按 q 关闭界面。在非展开模式、非诊断模式下，Esc 也遵循现有停止/关闭行为。

无人值守运行时，使用 --no-tui 并保留执行主机日志。有关恢复和监控，请参阅实时运行时。