BANZ文档

12.1 体检与日志

本页内容

banz 的运行状态、体检和日志都在设置的“状态与关于”里。服务器网页上没有这一页,要在运行 banz 的电脑上看。

状态

打开设置的“状态与关于”,上半部分是本机 banz 的基本信息:设备、模式、版本、进程、启动于、数据目录、服务、界面、运行中的会话、更新、语音转文字,以及同步状态。

右上角有“备份本设备”(见 12.3 备份与恢复)和刷新按钮。页面上还有“停止 banz”:停止后 agent 不再接工作,要用 banz web 或桌面应用重新打开。

“状态与关于”:基本信息和体检
“状态与关于”:基本信息和体检

体检

“体检”逐项检查 banz 依赖的东西,每一项是“正常”“注意”或“故障”,有问题的会写明怎么修。点“再检查”重新检查。

检查项 看什么
banz 的存储 本机的数据库能否读写
数据文件夹、临时文件夹 在不在、还剩多少空间
更新 有没有新版本
账号服务器 是否登录、是否连上服务器、是否被另一台设备断开
智能体程序 Claude Code、Codex 等能不能找到、支持哪些功能
秘书 是否开启、能否运行
语音转文字 是否开启、模型是否可用
Claude Code and Codex connected to banz(界面上是英文) 你在 banz 之外运行的 Claude Code、Codex 是否接上了 banz 的工具(见 11.2 在脚本和 agent 里用 banz)

命令行里同样可以看:

banz host doctor   # 体检,最严重的排在最前面
banz host status   # 运行状态

日志

“状态与关于”往下是本机 banz 的日志。“日志级别”可以选“调试及以上”“信息及以上”“警告和错误”“错误”,“搜索日志”可以按文字找。

在前台运行的 banz(比如用 banz serve 启动的)不保留日志,页面上会写“只有在后台运行的 banz 才保留日志。”用桌面应用或 banz web 打开的 banz 都在后台运行,会保留日志。

日志:选了“警告和错误”
日志:选了“警告和错误”

命令行:

banz host logs                      # 最新的在前
banz host logs --level warn         # 只看警告和错误
banz host logs --text 关键词        # 按文字找
banz host logs --limit 50           # 只看最新的 50 条

一个会话为什么出错

会话出错时,输入框下方的状态会写明原因(见 12.2 常见问题)。想看更多细节:

banz session diagnostics 会话ID

它列出这次运行中 banz 记下的问题,以及 agent 程序自己的错误输出(已去掉凭据)。这条命令只能在会话所在的电脑上运行,工作台里没有对应的入口。

Esc

↑↓选择↵打开Esc关闭