mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: tidy opencode smoke post-task guidance

Browse Source
This commit is contained in:
Codex
2026-06-30 11:29:46 +00:00
parent 2c6b2bf6ae
commit 8fb5233bae
5 changed files with 25 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/hwlab.md
+2 -2
View File
@@ -117,9 +117,9 @@ Workbench prompt、TraceTimeline、final response、详情弹窗、session 切
HWLAB 接入 OpenCode 时，默认采用独立 `opencode-server` Pod 和独立 public hostname，通过 Cloud Web 的 `/opencode` 导航与 iframe 集成；不要把 OpenCode UI 与 HWLAB Cloud Web 合并到同一个 Pod，也不要让 public OpenCode hostname 直接暴露 OpenCode Basic Auth。Cloud Web 继续拥有 HWLAB 登录态和同源 session，OpenCode public hostname 应先经过 Cloud Web 鉴权代理；未登录访问 OpenCode host 的健康或 API 路径时，预期是 Cloud Web 的鉴权失败响应，而不是浏览器 Basic Auth 弹窗。
OpenCode provider/model、public hostname、SecretRef 和 extra FRP proxy 都必须从 issue/CLI 选中的 node/lane YAML 与目标 HWLAB repo render 读取；长期参考不硬编码当前模型或端口。关闭 OpenCode 集成、provider profile 或微前端入口类 issue 时，最小证据应来自选中 node/lane 的 `web-probe script`：登录 HWLAB public origin，打开 `/opencode`，确认 iframe origin、OpenCode `/global/health`、`/config` 中的 provider/model、`/session` 创建，以及 `/session/:id/message` 返回的 providerID、modelID、terminal finish 和最终 assistant text。只看到 `opencode-server` Pod ready、Caddy hostname 200 或 Secret 存在，不能替代这个浏览器入口 smoke。
OpenCode provider/model、public hostname、SecretRef 和 extra FRP proxy 都必须从 issue/CLI 选中的 node/lane YAML 与目标 HWLAB repo render 读取；长期参考不硬编码当前模型或端口。关闭 OpenCode 集成、provider profile 或微前端入口类 issue 时，最小浏览器证据优先使用选中 node/lane 的 `web-probe opencode-smoke`：登录 HWLAB public origin，打开 `/opencode`，定位 iframe/direct OpenCode origin，打开 project/composer，点击可见 submit，确认最终 assistant 文本和 EventSource 终态事件。只有需要额外核对 `/global/health`、`/config` 或底层 `/session/:id/message` payload 时，才补 `web-probe script` 做 bounded API drill-down。只看到 `opencode-server` Pod ready、Caddy hostname 200 或 Secret 存在，不能替代浏览器入口 smoke。
排查 OpenCode 对话长时间停在 `Thinking` 或无 assistant 文本时，先拆分 provider 完成、Cloud Web 代理长连接和 UI live state 三层事实。provider 侧必须按 `opencode-provider-proxy` service 明确查 OTel，确认 `/v1/chat/completions` 状态、耗时、content chunk、reasoning-only drop 和 done line；Cloud Web 侧必须能看到 `/global/event` 的 `opencode.proxy.stream.start` span，以及 `opencode.proxy.sse.directory_rewrite_enabled`、`from=/workspace`、`to=/`、`ticket_accepted=true` 等属性。关闭证据必须包含浏览器 DOM 最终 assistant 文本、没有残留 `Thinking`，以及 EventSource 收到 `message.part.updated`、`step-finish`、`session.idle` 等事件；provider 200 或 `/session/:id/message` 返回 terminal 不能单独证明 UI 已收敛。OpenCode composer smoke 应优先点击可见的 `[data-action='prompt-submit']` 提交按钮；只依赖 Enter 在 contenteditable 状态下不稳定。
排查 OpenCode 对话长时间停在 `Thinking` 或无 assistant 文本时，先拆分 provider 完成、Cloud Web 代理长连接和 UI live state 三层事实。provider 侧必须按 `opencode-provider-proxy` service 明确查 OTel，确认 `/v1/chat/completions` 状态、耗时、content chunk、reasoning-only drop 和 done line；Cloud Web 侧必须能看到 `/global/event` 的 `opencode.proxy.stream.start` span，以及 `opencode.proxy.sse.directory_rewrite_enabled`、`from=/workspace`、`to=/`、`ticket_accepted=true` 等属性。关闭证据必须包含 `web-probe opencode-smoke` 或等价浏览器 DOM 的最终 assistant 文本、没有残留 `Thinking`，以及 EventSource 收到 `message.part.updated`、`step-finish`、`session.idle` 等事件；provider 200 或 `/session/:id/message` 返回 terminal 不能单独证明 UI 已收敛。OpenCode composer smoke 应优先点击可见的 `[data-action='prompt-submit']` 提交按钮；只依赖 Enter 在 contenteditable 状态下不稳定。
## HWLAB FRP 维护