tui

name	tui
description	使用 agent-finance 的 selected-symbol 终端查看实时报价、OHLCV K 线、账户、诊断和分阶段交易工作流，支持键盘与鼠标。

agent-finance TUI

实时观察、可视化检查 OHLCV、查看账户或谨慎准备交易时使用 TUI。Agent 需要稳定结构化结果时，使用 market ... --json 或 tui --dump-state --json，不要解析屏幕文本。

启动

agent-finance tui --symbols AAPL,CRDO,BTCUSDT
agent-finance tui --symbols CRDO,LITE,AAOI --chart-preset auto
agent-finance tui --symbols BTC/USDT,ETH/USDT --chart-preset 1d
agent-finance tui --symbols CRDO --profile default
agent-finance tui --symbols CRDO --no-persist
agent-finance tui --symbols CRDO --dump-state --json

除非使用 --no-persist，TUI 会保存观察列表、刷新频率、provider、图表、主题、语言和所选交易 profile。启动时始终使用干净的 Market 工作区，不恢复已经过时的窗口几何状态。

界面模型

• Market 是主 selected-symbol 终端：标的标题与报价、大幅 K 线、紧凑观察列表，以及按 capability 显示 sessions、evidence、research 或预测信号的右侧 rail。
• 点击观察列表标题旁的铅笔可打开编辑浮层；可在同一处添加、删除、拖动排序、撤销和保存。仅调整顺序不会切换主图当前标的。
• Orders 只负责活动订单及撤单/交易入口，不复制 Market K 线。
• Portfolio 负责余额、持仓、仓位，以及明确的划转和合约状态入口。
• Research 汇总证据、新闻和预测市场上下文。
• Settings 只保留简洁的持久设置；Account Setup 与 Profile / Risk 使用专注浮层。
• 交易抽屉 可从标的标题、图表参考价、观察列表、持仓或活动订单打开。诊断把健康、路由、实时状态和任务活动合并成一个带 tab 的浮层。

按 : 打开命令面板，/ 搜索标的，p 打开诊断，Esc 关闭最上层浮层。只有真实可交互的行和控件才会在鼠标下高亮。

实时与 Provider 证据

• 路由以 capability 为先，并与 market ... 命令共用。
• 美股和 ETF 的 auto 在可用时优先 Binance Stocks WebSocket。必须读取界面上的 provider、session、latency 和 fallback；配置偏好本身不能证明实际数据源。
• 符合条件的美股观察标的复用同一个实时会话。已连接 只证明 WebSocket transport 正常；只有当前标的收到新鲜更新后才显示 实时。切换已覆盖标的不应重连，过期市场时间也不能伪装成新鲜数据。
• WebSocket 失败时可能回退到 REST。诊断会展示重连、gap、route health 和任务证据，但不能替代当前报价或 K 线。
• 只有解析出的 crypto provider 具备所需 stream capability 时才启动 crypto realtime。
• 图表 preset 会适应 provider。回退后应记录界面显示的实际 provider、range、interval、session 和 bar 数量。

K 线

• selected-symbol 图表在完全相同的终端列中绘制 OHLCV candle 与 volume。悬停会显示十字线和 O/H/L/C/V，不会擦除 candle。
• 滚轮缩放可见窗口，拖拽选择时间窗口，h/l 或方向键移动 candle cursor，[/] 缩放。
• 工具栏可调整 range、interval 和 glyph mode；provider 不支持的 interval 会显示但不可操作。
• j/k 选择 current price、previous close、当日 O/H/L、活动订单或持仓成本等参考价，Enter 将所选价格复制到交易抽屉。
• 点击图表价格只会填充草稿，绝不会自动暂存、提交或启用真实写入。
• Provider 只返回 close 时，应把图表视为降级数据；依赖 intrabar 形态前用另一个具备 OHLCV 能力的 provider 验证。

交易抽屉

工作流为 草稿 -> 本地校验 -> 风险摘要 -> 暂存 -> 审核 -> 确认 -> 既有提交路径 -> 审计。

• 入口上下文可以安全预填 symbol、market、side、未成交数量、price、order kind、TIF、reduce-only 或 position side；预填绝不等于提交。
• 不支持的字段和操作必须隐藏或禁用，并给出 capability、permission 或 profile 原因；不能从占位 UI 推断能力。
• s 暂存有效草稿，审核仍在抽屉内完成。Market/live/transfer/futures-state/高风险操作继续使用强化确认，必要时要求键入确认词。
• 活动订单撤单走 staged cancel。只有 provider 确实声明 capability 时才显示 replace/amend 或复合保护单。
• render/input 路径绝不直接调用 provider write；不能用真实资金订单测试 UI。

签名操作前先读取 profile 指南：

agent-finance skills get profile --full

Agent 合约

agent-finance tui --symbols CRDO --dump-state --json

Dump 会暴露 selected-symbol 市场状态、交易抽屉 open/phase/source/draft/risk summary、staged changes、pending confirmation、profile validation、账户快照、realtime diagnostics、route diagnostics 和 task events。优先使用该合约，不要 OCR 或抓取终端字符。

任何入场、止损、止盈或订单质量判断都必须同时检查日线和分钟线；保存实际 provider/session/range/interval 证据，并在依赖订单或持仓 overlay 前刷新过期账户快照。