使用者痛点

• 输入消息不便，缺乏快捷键与一键发送功能。
• AI 正在思考时无动态反馈，导致使用者等待无所适从。
• 工具调用过程不可视化，无法了解进度与结果。话说回来，
• 错误信息不明确，缺少恢复方法。
• 多轮对话历史不易查看，滚动体验差。
• 长文本阅读需要手动滚动，增加疲劳感。
• Token 计数、API 用量不透明。
• CJK 输入法兼容性差，候选窗口遮挡输入框。
• 视觉层级混乱，难以快速定位关键信息。老实说，

主要需求

布局设计概览

┌─────────────────────────────────────────────────────┐
│ 状态栏: 🤖 AI Chat | 模型: MockLLM- | 就绪 │ ← 固定行
├─────────────────────────────────────────────────────┤
│ │
│ ┌─ 消息历史 ────────────────────────────────────────┐ │
│ │ 👤 使用者: 你好 │ │
│ │ 🤖 AI: 你好！
有什么可以帮助你的，│ │ ← 可滚动
│ └─ 🔧 工具调用 ────────────────────────────────┘ │
│ get_wear │
│ ⏳ 执行中…│
│ ❌ 错误: 服务不可用 │
│ 🤖 AI: 正在生成回答…▊ │
├─────────────────────────────────────────────────────┤
│> 输入消息... ← 固定行
├─────────────────────────────────────────────────────┤
│ Ctrl+S 发送 Ctrl+Q 退出 Ctrl+C 取消 ↑↓ 滚动 ← 固定行
└─────────────────────────────────────────────────────┘

组件树结构

// 布局结构screen
├── statusBar
├── chatBox
│ ├── userMessage
│ ├── assistantMessage
│ ├── toolCallCard
│ ├── toolResultCard
│ ├── errorCard
│ ├── thinkingSpinner
│ └── spacers // 消息间隔
├── inputBox // 输入区
└── helpBar // 帮助栏
// code example omitted for brevity – see original snippet for full implementation.
`}

自适应布局策略表格

色彩设计原则 & 示例主题

// Normal Theme 配置示例：
const Theme = {
再看user。{fg:'#88ccff',bg:'#1a1a1a',prefix:'👤 使用者'},assistant:{fg:'#88ff88',bg:'#1a1a1a',prefix:'🤖 AI'},system:{fg:'#ffaa44',bg:'#1a1a1a',prefix:'💬 程序'},toolCall:{fg:'#cc88ff',bg:'#1a1a1a',prefix:'🔧 工具调用'},toolResult:{fg:'#66bbaa',bg:'#1a1a1a',prefix:'✅ 工具结果'},error:{fg:'#ff4444',bg:'#1a1a1a',prefix:'❌ 错误'},thinking:{fg:'#ffaa00',bg:'#1a1a1a',prefix:'💭 思考'},input:{border:'#44aa44',focus:'#66dd66'},status:{bg:'#2255aa',fg:'white'}
};`}

色彩设计原则：

1. 语义化颜色：- 红表示错误、绿表示正常、黄表示警告、紫表示工具。
2. 高对比度：- 前景与背景至少满足 WCAG AA 标准。
3. 有限调色板：- 主色 ≤6 种。按理说，
4. 暗色优先：- 深色背景降低视觉疲劳。
5. 一致性：- 相同语义使用相同颜色贯穿全界面。

The message schema includes role,token count。tool call metadata and streaming flag. Rendering uses helper functions to format each role’s prefix and emoji plus optional timestamp / token count based on visual level config.

The state machine tracks transitions from idle → thinking → streaming/tool_call/... → done/error/idle again. It enforces legal transitions and logs changes for debugging purposes.