pikasTech-HWLAB/web/hwlab-cloud-web/help.md

云工作台内部使用说明

本页面说明当前 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 服务端口说明不改变浏览器入口。