前言
上一篇文章《C#实现控制台多区域输出》中，我们介绍了如何利用 Console 实现类似 Agent CLI 的多区域动态界面。
如果说多区域布局解决的是：
界面如何展示的问题
那么本文要讨论的则是另外一个问题：
用户如何与界面交互
相信体验过Claude Code、OpenCode、Hermes 等工具的同学，经常能够看到类似界面：
请选择模型：> GPT-4.1Claude SonnetGemini Pro
或者：
即将修改以下文件：Program.cs
appsettings.json是否继续？[ 是 ] [ 否 ]
这些效果看起来已经完全不像传统的命令行程序。
相比与：
请输入数字编号：
这种交互方式显然更加直观，交互性更强。
本文就通过两个简单示例，分析这些终端交互效果背后的实现原理：
- 列表菜单
- 确认选择框
看看这些在 Agent CLI 中随处可见的交互组件，如果使用原生的控制台方式究竟是如何实现的。
传统CLI与现代CLI
很多传统的控制台程序都是这样工作的：
请选择操作：1.启动服务
2.停止服务
3.重启服务请输入编号：
用户输入：
2
程序继续执行。
这种交互的模式本质上是：
输入
↓
提交
↓
执行
而现代 CLI 更倾向于：
实时交互
↓
实时反馈
↓
状态更新
例如：
请选择操作：
> 启动服务停止服务重启服务
用户按下方向键时变成：
启动服务
> 停止服务重启服务
整个过程不需要输入任何字符, 这也是各种 Agent CLI 非常喜欢采用的交互方式。
实现一个列表菜单
先来看一个最常见的场景。
例如系统运维工具：
请选择执行操作：
> 启动系统服务停止系统服务重启数据库清理系统缓存查看运行日志退出程序
用户通过↑ ↓随意切换选项, 通过Enter确认选择, 最终返回用户选中的菜单项。
菜单数据定义
首先准备菜单数据：
string[] options =
{"启动系统服务","停止系统服务","重启数据库","清理系统缓存","查看运行日志","退出程序"
};
然后调用菜单组件：
int selectedIndex = ShowSelectionMenu(options);
该方法最终会返回0 1 2 3对应用户选择的菜单项。
菜单核心实现
整个菜单真正核心的代码其实并不多：
static int ShowSelectionMenu(string[] options)
{Console.CursorVisible = false;int selectedIndex = 0;int startY = Console.CursorTop;while (true){DrawMenu(options, selectedIndex, startY);ConsoleKeyInfo keyInfo = Console.ReadKey(true);switch (keyInfo.Key){case ConsoleKey.UpArrow:selectedIndex--;if (selectedIndex < 0){selectedIndex = options.Length - 1;}break;case ConsoleKey.DownArrow:selectedIndex++;if (selectedIndex >= options.Length){selectedIndex = 0;}break;case ConsoleKey.Enter:Console.CursorVisible = true;return selectedIndex;}}
}
整个流程其实非常清晰：
绘制菜单
↓
等待按键
↓
修改状态
↓
重新绘制菜单
不断循环直到用户按下Enter。
菜单绘制逻辑
菜单的绘制代码如下：
static void DrawMenu(string[] options, int selectedIndex, int startY)
{for (int i = 0; i < options.Length; i++){Console.SetCursorPosition(0, startY + i);Console.Write( new string(' ', Console.WindowWidth - 1));Console.SetCursorPosition(0, startY + i);if (i == selectedIndex){Console.BackgroundColor = ConsoleColor.White;Console.ForegroundColor = ConsoleColor.Black;Console.Write($"> {options[i]}");}else{Console.Write($" {options[i]}");}Console.ResetColor();}
}
运行效果：
这里有一个非常重要的细节。
为什么每次都要重绘
很多人第一次写菜单时都会这样：
Console.Write(text);
然后发现界面开始出现残影。
例如：
> Restart Database
切换成：
> Stop
之后可能变成：
> Stopart Database
原因很简单：
Console不会自动清理旧的内容
因此每次刷新之前必须先清空区域：
Console.Write(new string(' ', Console.WindowWidth - 1));
然后重新绘制, 这也是很多终端UI框架的核心思想：
状态变化
↓
区域重绘
而不是：
修改控件
实现确认选择框
菜单实现完成之后, 我们再来看另外一个非常常见的交互组件。
例如：
是否继续执行？[ 是 ] [ 否 ]
这种效果在：
- 文件删除
- 权限授权
- 配置确认
- Agent工具调用
等需要确认的场景中很常见。
确认框核心实现
因为确认框本质上只有两个状态是 否, 因此实现反而更容易实现。
核心代码如下：
static bool ShowConfirmation(string message)
{Console.WriteLine(message);int selectedIndex = 0;int startY = Console.CursorTop;while (true){DrawConfirmation(selectedIndex, startY);ConsoleKeyInfo keyInfo = Console.ReadKey(true);switch (keyInfo.Key){case ConsoleKey.LeftArrow:selectedIndex--;break;case ConsoleKey.RightArrow:selectedIndex++;break;case ConsoleKey.Tab:selectedIndex++;break;case ConsoleKey.Enter:return selectedIndex == 0;}if (selectedIndex < 0){selectedIndex = 1;}if (selectedIndex > 1){selectedIndex = 0;}}
}
上面的方法最终返回true或者false
确认框绘制逻辑
对应的绘制代码：
static void DrawConfirmation(int selectedIndex, int startY)
{Console.SetCursorPosition(0, startY);Console.Write(new string(' ', Console.WindowWidth - 1));Console.SetCursorPosition( 0, startY);if (selectedIndex == 0){Highlight();}Console.Write("[ 是 ]");Console.ResetColor();Console.Write(" ");if (selectedIndex == 1){Highlight();}Console.Write("[ 否 ]");Console.ResetColor();
}
效果如下：
从实现角度来看，与菜单并没有本质区别。
菜单和确认框的共同点
看到这里会发现, 虽然菜单和确认框长得完全不同。
菜单：
> 启动服务停止服务
确认框：
[ 是 ] [ 否 ]
但背后的逻辑完全一致。
第一部分：状态
无论什么交互组件, 都需要维护状态。
例如：
int selectedIndex;
表示：
当前选中了什么
第二部分：渲染
根据状态绘制界面：
DrawMenu();
或者：
DrawConfirmation();
状态决定界面长什么样。
第三部分：输入
等待用户操作：
Console.ReadKey(true);
获取：
↑
↓
←
→
Tab
Enter
第四部分：更新状态
根据按键l来修改状态：
selectedIndex++;
或者：
selectedIndex--;
第五部分：重新渲染
状态发生变化之后：
重新绘制界面
整个过程可以抽象成：
初始化状态
↓
渲染界面
↓
等待输入
↓
更新状态
↓
重新渲染
其实绝大多数终端交互组件都遵循这一模式。
由于篇幅有限，本文只展示了核心实现。 有兴趣的同学可以自行查看完整示例:
https://github.com/softlgl/ConsoleMultiRegion
用这些能力实现一个Agent配置向导
掌握菜单和确认框之后, 其实已经能够实现很多 Agent CLI 中的交互界面。
例如：
请选择模型：
> GPT-4.1Claude SonnetGemini Pro
选择完成：
请选择运行模式：
> 自动模式手动模式
继续：
是否启用联网搜索？
[ 是 ] [ 否 ]
最终：
配置完成
整个过程实际上只是：
菜单
+
确认框
+
状态管理
的组合。
总结
上一篇文章中，我们实现了 Console 的多区域动态布局, 而本文则进一步实现了控制台程序中的交互能力。
通过菜单和确认框两个简单示例，可以发现现代 CLI 的很多交互效果并没有想象中复杂。其核心无非是：
状态管理
↓
键盘输入
↓
区域重绘
所以很多看起来十分高级的交互界面，最终追溯到底层实现，其实都建立在这些最基础的能力之上。
