Merge pull request #2465 from pikasTech/docs/2452-trans-recovered

docs: 收口 NC01 Target 透传恢复
2026-07-17 21:37:09 +08:00
parent b974bd58d5 88f6fb26af
commit 4d8c379e7a
2 changed files with 21 additions and 1 deletions
@@ -0,0 +1,20 @@
+# R4 NC01 Target 透传恢复报告
+
+## 现象
+
+HWLAB CaseRun L2 收敛期间，trans NC01:/root/unidesk pwd 连续三次在连接建立阶段返回 frontend ssh upstream websocket error。远端命令未执行，Artificer preflight 和 NC01 隔离 worktree 创建被阻塞；问题登记为 UniDesk #2452。
+
+## 恢复证据
+
+- 后续同一只读命令成功返回 /root/unidesk。
+- 通过同一 target-trans route 在 NC01 创建 /root/unidesk/.worktree/2449-service-selection-check。
+- Artificer NC01/nc01-v02 preflight 成功：
+  - workspaceRef valid=true；
+  - gitStateInspected=false；
+  - provider/tool SecretRefs allPresent=true，values 未打印；
+  - task qt_338489c2d6894ad791a1f18594b818f0 自动 dispatch。
+- UniDesk #2452 已关闭。
+
+## 边界
+
+恢复未引入第二 SSH 路径、fallback、运行面 patch 或 Secret 反解；未修改 PaC/Tekton/Argo 共享 CI/CD。故障表现为瞬时 frontend websocket transport 中断，当前没有可复现的持久源码缺陷，因此不提交伪修复。
@@ -13,6 +13,6 @@

 执行 [UniDesk #2380](https://github.com/pikasTech/unidesk/issues/2380)：建立可复用的 Temporal 应用 native-first 敏捷开发闭环，以共享 application dispatcher 保证本地 CLI 与 `--overapi` 同合同，先仅启动 native worker 完成 PostgreSQL、workflow 和 CLI 调试，再经应用 owning YAML、GitHub PR、PaC/GitOps 自动交付独立 API/worker Pod 并线上验收；保留快速本地入口，最终沉淀到 `unidesk-temporal` 和应用专项 skill，完成任务后将详细报告写入[任务报告](./details/platform-infra-runtime-reliability/R3_Task_Report.md)。

-## R4 [in_progress]
+## R4 [completed]

 执行 [UniDesk #2452](https://github.com/pikasTech/unidesk/issues/2452)：修复 NC01 Target 透传在连接建立阶段连续返回 frontend ssh upstream websocket error，恢复 trans host/workspace 只读命令和 Artificer NC01/nc01-v02 preflight；保持既有 target-trans、route 与 SecretRef authority，不新增第二 SSH 路径，不触碰 PaC/Tekton/Argo 共享 CI/CD，不以固定 workspace 写入或人工交付绕过，完成任务后将详细报告写入[任务报告](./details/platform-infra-runtime-reliability/R4_Task_Report.md)。