Agent Viewer 帮助文档

Agent Viewer 是 Hawa Code 的 Web 端实时观测面板。开启后，它会启动一个本地 HTTP + WebSocket 服务，你可以在浏览器里同步查看主 Agent 以及各个 SubAgent 的运行消息，效果与终端 CLI 保持一致。

1. 启用 Agent Viewer

在全局 settings.json 中新增 webServer 配置：

{
  "webServer": {
    "enabled": true,
    "port": 3210,
    "host": "127.0.0.1"
  }
}

配置说明：

重启 Hawa Code 后服务会自动启动。

新版 Agent Viewer 采用左右分栏布局：

Agent Viewer 主界面

元素	说明
折叠按钮（`≡` / `≫`）	点击可收起或展开侧边栏；收起后仅显示 Agent 状态圆点与设置图标。
Hawa Code 标题	侧边栏顶部的品牌标识。
Agent 标签列表	列出 `main` 主 Agent 与所有活跃 SubAgent，点击即可切换。
统计信息	显示当前 Agent 总数与正在运行的数量，例如 `Agents: 7 (0 active)`。
Settings 按钮	点击打开右侧设置面板。

元素	说明
标题栏	显示当前视图名称（`Agent Viewer` 或 `Settings`），以及消息数量、WebSocket 连接状态。
消息列表	按时间顺序展示当前 Agent 的对话消息、工具调用、执行结果、思考过程等。
自动滚动恢复按钮	手动向上滚动查看历史后，点击可恢复自动跟随到底部。
Prompt 输入框	在 `main` Agent 下可直接输入指令并发送；支持普通文本、斜杠命令（`/`）与 Bash 快捷模式（`!`）。

当 Hawa Code 启用 Agent Team 或多 Agent 协作时，左侧 Agent 标签列表会显示所有活跃的 Agent：

点击对应标签即可切换查看该 Agent 的消息流。

点击左侧边栏的 Settings 按钮，右侧主内容区会切换为设置面板，支持直接在浏览器中管理 Hawa Code 配置：

提示：保存设置后，部分配置项需要重启 Hawa Code 才会生效。

在 main Agent 下，底部的输入框可用于向 Hawa Code 发送指令：

当 Agent 执行需要权限确认的工具（如 Bash、PowerShell、Write、Edit 等）时，页面会弹出确认卡片：

顶部显示工具名称与待处理数量（多个确认时会显示 N pending）。
中间展示命令或文件路径摘要、工具说明、风险提示（低 / 中 / 高）。
底部提供以下选项：
- Yes：允许本次执行。
- Yes, and don’t ask again…：允许本次并在当前会话内对同类操作不再询问。
- No, and tell Hawa Code what to do differently (esc)：拒绝执行并给出反馈。

提示：当页面处于后台时，Agent Viewer 会尝试发送浏览器系统通知，避免错过确认请求。首次使用时可根据弹窗提示点击 Enable notifications 开启通知权限。

当 Agent 通过 AskUserQuestion、EnterPlanMode 等工具向你提问时，消息列表中会直接嵌入交互表单。你可以在表单中选择选项或输入内容并提交，无需回到 CLI 终端操作。提交后的响应会同步到 Hawa Code 后端。