# 云工作台内部使用说明

本页面说明当前 Cloud Workbench 的前端区域与状态含义。默认 `/` 进入工作台；本说明只通过活动栏的 `使用说明` 入口打开。

## 活动栏与默认工作区

- `工作台` 回到 Agent 对话与 Device Pod 看板；`内部复核` 打开只读复核表；`使用说明` 打开本说明。
- 默认首屏不再放资源树、旧硬件拓扑面板、接线面板或可信记录面板，右侧只展示 Device Pod summary 与纯文本事件流。
- 浏览器内输入只发送给 Code Agent；真实 Device Pod 操作必须由受控后端流程执行，前端不提供泛化硬件写入口。

## 中间 Agent 对话与输入区

- Agent 对话区保留会话、trace、运行路径和 Code Agent 状态摘要。
- 底部快捷按钮只填充输入框，点击 `发送` 后才提交；Device Pod 快捷用例默认只读，聚焦 status、profileHash、chip-id、UART tail 和事件流。
- 无新事件超时、Gateway 命令超时和模型通道由输入栏控件显式选择，当前浏览器会话会保存用户选择。

## 右侧 Device Pod 看板

- 右侧看板内部不使用展开/收起；所有卡片只显示 summary。
- 点击或键盘激活 summary 卡片后，通过弹窗查看 JSON 细节；弹窗关闭后返回原看板，不改变看板布局。
- `Pod Summary` 展示 `devicePodId`、`targetId`、`profile` 和 freshness；Target、Workspace、Debug、IO 四张卡片只展示关键一句话。
- 事件流是一个不需要展开的纯文本窗口，持续更新时不会抢走用户正在滚动的位置；开启 `跟随` 或点击新事件提示后才跳到最新事件。
- 当前 `hwlab-device-pod` 只提供内部 executor 边界；Device Pod 的用户可见 profile、grant 和 job authority 由 `hwlab-cloud-api` 提供，未授权或无 gateway 时显示 blocker，不称为真实硬件通过。

## 内部复核页

- `内部复核` 页面只有一个只读主表和少量过滤、搜索、刷新控件。
- 表格数据来自 same-origin `/v1/diagnostics/gate` live 后端聚合；不可用时显示明确 blocker，不用静态拓扑冒充 live 结果。
- 该页不提供 Agent 对话、Device Pod 操作或资源选择入口。

## 来源标签含义

- `SOURCE`：来自仓库内静态配置或已签入摘要，用于解释当前界面。
- `LOCAL`：只存在于当前浏览器会话的本地输入或草稿。
- `DRY-RUN`：演练或 fixture 证据，不能声称真实设备闭环已经通过。
- `DEV-LIVE`：必须来自同源 live 探测或可信记录，并满足当前 Device Pod 判定标准。
- `BLOCKED`：当前前置条件未满足、探测失败、证据不足，或不能把静态/本地/演练证据升级为 live 结果。

## 端口与只读边界

- 前端入口保持 `:16666`，API / edge 入口保持 `:16667`。
- 浏览器内 API 访问保持 same-origin `/v1`、只读 `/json-rpc` 与 `/health/live`。
- 旧公网 `:6666` / `:6667` 不是当前前端验收口径；内部 k3s 服务端口说明不改变浏览器入口。
