使用 Dashboard 工作台

Dashboard 是同一公开 HTTP API 的图形入口。打开网关 /ui/ 后，先完成安装或连接已有 profile；所有页面仍受当前 SK 限制。

从工作台完成日常任务

首页工作台提供常用入口、收藏和最近使用。用全局搜索找到命令，或进入工具目录逐层浏览，再打开独立调用页。

工作台 → 搜索 / 工具目录 → 命令详情 → 填参数 → 调用与结果

调用页重新读取当前运行时 help 和 schema。参数表单、确认提示、设备投递策略与结果展示共享同一逻辑；读取 schema 失败时应先重试加载。

收藏与最近使用仅属于本机浏览器和当前连接，按 profile 与 gateway 隔离。它们保存入口身份，不保存调用参数、结果或凭证；再次使用仍需实时授权。换浏览器后不会自动同步。

什么时候打开能力树

需要理解节点关系、挂载位置或查看设备状态时，打开能力树。选择节点后 Inspector 展示描述、命令、反馈与允许的操作；命令目录可以进入独立调用页。

能力树按需展开，命令作为 owner 下的虚拟叶子显示。离线设备不会因为 presence 变为 offline 就失去可见性；有 read 权限时仍可发现其 Mailbox-capable 命令。

旧 /ui/nodes/... 深链接仍能进入对应 Inspector；日常调用优先从工具目录、搜索或收藏进入。

添加工具：挂载后继续授权与首次调用

全局“添加工具”向导按来源提供内置集成、MCP、HTTP 和外部 Plugin 步骤。表单来自当前实例 catalog 的逐 export 契约：

• 凭证进入 SecretStore；
• workspace、region 等可回显配置进入 providerConfig；
• path / description 进入节点记录。

向导区分挂载成功、待授权、授权完成和授权失败。获得 authorization URL 只是待授权；OAuth 失败时可从已创建节点继续，不需要重新添加。

挂载成功后按指引检查真实命令并完成首次调用。删除节点不会自动删除可能被复用的 Secret。

设备、Store 与实例管理

任务	页面与 CLI 对照
接入设备、查看 presence 与 Mailbox operation	设备 / tb connect、tb device op
上传、下载与分享对象	Store / tb store
修改配置并确认生效	配置 / tb config
验证和切换 S3 后端	存储后端 / tb storage
本机 Compose 期望设置与任务结果	部署 / tb deployment
数据库、Redis、keyring 维护	维护与密钥 / tb maintenance、tb keys
身份与上游凭证	SK、Secret / tb sk、tb secret

管理能力需要对应 system 路径的 admin。按钮状态仅提供反馈，服务端做最终授权；Dashboard 没有独立的越权管理通道。

设备离线时发起任务

命令声明 delivery: mailbox|both 时，调用页提供对应 policy、TTL 和 idempotency key，并通过同一次 invoke 提交。设备页可查看 operation 列表、详情和取消。

queued 取消会直接终结；claimed 取消只是请求设备协作停止。result_unknown 或可能已执行的 expired 不可盲重试，详见Mailbox。

会话与故障排查

SK 保存在浏览器本地连接资料中。共享机器使用后退出并清理站点数据；可疑泄漏需要立即禁用或轮换 SK。

现象	下一步
页面加载但 API 401	检查当前 profile、SK 到期和禁用状态
节点不可见或 404	用同一 SK 的 tb help 核对路径与 read 权限
参数表单加载失败	原地重新读取 help，不绕过 schema
配置保存后行为未变	核对 apply 和 effective revision
部署显示 pending	检查本机执行器连接及真实 job 状态
/ui/* 刷新 404	修正反向代理的 Dashboard 路由回退

成功标准是 Dashboard 与同一身份的 CLI / HTTP 得到一致资源和错误语义。更多见故障排查。