tech
屏幕缓冲区错误
# 运行 `hermes chat` 时提示 `NoConsoleScreenBufferError`，怎么解决？
有朋友在 Windows 上成功安装了 Hermes Agent，但尝试运行对话模式时报错：
```bash
hermes chat -q "hello"
```
如果你看到的报错和下面这段一致，那就是同一个问题：
```
prompt_toolkit.output.win32.NoConsoleScreenBufferError: No Windows console found. Are you running cmd.exe?
```
先说结论：**Hermes 的交互式界面依赖 prompt_toolkit，这个库需要在真正的 Windows 控制台中运行，不能在无控制台的环境（如某些 IDE 终端、后台脚本）中使用。**
## 为什么会这样
Hermes 使用了 `prompt_toolkit` 来提供漂亮的交互式终端界面。这个库需要直接操作 Windows 的控制台屏幕缓冲区（console screen buffer），如果检测不到标准的 Windows 控制台就会报错。
常见触发场景：
1. 在 VS Code 的内置终端运行
2. 在 Windows Terminal 之外的其他终端运行
3. 通过脚本或任务计划程序后台运行
4. 在 CI/CD 环境或远程 SSH 会话中运行
## 解决方法
**方法一：使用 Windows Terminal 或 cmd（推荐）**
不要用 VS Code 终端或 PowerShell ISE，改用：
- Windows Terminal（微软商店下载）
- 传统的 cmd.exe
- 新版 PowerShell 7（但不是 Windows PowerShell ISE）
**方法二：使用非交互式模式**
如果你只是想测试或脚本调用，可以用 `-z` 参数（one-shot 模式）：
```bash
hermes -z "你的问题"
```
或者设置环境变量告诉 Hermes 这是非交互式环境：
```bash
$env:HERMES_NONINTERACTIVE=1
hermes -z "hello"
```
**方法三：使用 TUI 模式（如果支持）**
某些版本的 Hermes 支持 `--tui` 参数，尝试：
```bash
hermes --tui chat -q "hello"
```
## 验证是否解决
在 Windows Terminal 中打开新标签页，运行：
```bash
hermes chat -q "hello"
```
如果正常进入对话界面，说明问题解决了。
## 补充排查
如果换终端还是不行，检查这几点：
1. **是否使用了正确的 PowerShell？** Windows PowerShell ( powershell.exe ) 和 PowerShell 7 ( pwsh.exe ) 表现不同，建议都试试
2. **是否以管理员身份运行？** 某些终端功能需要管理员权限
3. **系统是否禁用了控制台？** 某些企业环境会限制控制台访问
## 长期建议
如果经常在非交互式环境使用 Hermes，建议：
- 主要用 `-z` 参数进行单次查询
- 用 `hermes config` 设置默认模型，避免每次都要交互选择
- 配置好 `.env` 文件，避免运行时询问 API Key
