Web UI 指南¶
内置的 Web UI 提供了管理 ToolRegistry 的可视化界面。
界面概览¶
Web UI 分为几个部分：
- 工具面板：列出所有已注册的工具，带启用/禁用开关
- 命名空间面板：显示命名空间，支持批量启用/禁用
- 日志面板：显示执行历史，支持过滤选项
- 状态面板：提供导出/导入功能
工具管理¶
- 点击工具旁边的开关来启用/禁用
- 禁用的工具会显示原因（如果提供）
- 点击工具名称可在详情弹窗中查看完整 schema、元数据和权限信息
- 使用搜索栏按名称搜索工具
- 按
ToolTag标签过滤工具（如 READ_ONLY、DESTRUCTIVE、NETWORK）
元数据标签¶
每个工具行显示元数据标签以便快速识别：
- ToolTag 标签（彩色编码）：READ_ONLY、DESTRUCTIVE、NETWORK、FILE_SYSTEM、SLOW、PRIVILEGED
- 位置标签：
local或remote（非any时显示） async：表示该工具为异步工具
运行时元数据控制¶
think_augment 和 defer 属性可直接从 UI 进行运行时切换：
- 工具级复选框：每个工具行有独立的 Think 和 Defer 列，各带一个复选框
- 命名空间级复选框：命名空间标题行包含复选框，应用于命名空间内的所有工具
- 原生声明了
thought参数的工具，其 Think 复选框会灰显（参数始终直接传递） - 更改立即生效，无需重启服务
- 仅
think_augment和defer可在运行时修改（其他元数据字段为只读，确保安全）
工具详情弹窗¶
点击工具名称可打开详情弹窗，包含三个标签页：
- Schema：工具参数的完整 JSON Schema
- Metadata：所有
ToolMetadata字段，think_augment和defer提供交互式开关 - Permissions：权限评估结果，显示适用的规则和决策
命名空间管理¶
- 一键启用/禁用命名空间中的所有工具
- 为命名空间中的所有工具切换
think_augment和defer - 查看每个命名空间的工具数量
- 查看启用/禁用分布
执行日志查看器¶
- 按工具名称或状态过滤日志
- 查看执行详情，包括参数和结果
- 需要时清除日志
- 查看聚合统计
状态导入/导出¶
- 将当前禁用状态导出为 JSON
- 导入之前导出的状态
- 适用于备份/恢复场景
语言切换（i18n）¶
Web UI 支持英文和中文。语言切换下拉框位于页面右上角的标题栏中。
- 选择 EN 切换为英文，选择 中文 切换为中文
- 语言偏好通过
localStorage持久化，下次访问时自动恢复 - 所有 UI 元素即时更新——标签页、表头、按钮、过滤器、提示消息、弹窗对话框和空状态
- 切换语言时，动态内容（工具列表、日志条目、统计数据）会以所选语言重新渲染