docs: document tran shell boundary

2026-05-25 23:43:59 +00:00
parent a726b52986
commit 15f5a49375
1 changed files with 4 additions and 0 deletions
@@ -75,6 +75,10 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文
 - 所有计算资源节点上的 k3s server、控制平面、agent 和 worker 必须原生安装在 host OS 或 WSL 发行版内，禁止用 Docker/Compose/`rancher/k3s` 长驻容器承载 k3s；权威规则见 `docs/reference/arch.md`、`docs/reference/microservices.md` 与 `docs/reference/deploy.md`。
 - `k3sctl-adapter` 是 UniDesk 到 k3s 的控制桥，必须作为 UniDesk 直管服务运行在 k3s 故障域外，不得改成 k3s 代管服务；权威规则见 `docs/reference/arch.md` 与 `docs/reference/microservices.md`。

+## Critical Tran Shell Boundary Rule
+
+- P0: `tran <route> ...` 后面禁止裸放本地 shell 续接控制符，包括 `&&`、`;` 和 `|`；需要在远端执行多步命令时，必须使用 `tran <route> script -- '远端完整脚本'`、`tran <route> script <<'SCRIPT'` 或等价的单一 stdin/script 参数，避免后半段被本地 shell 执行或被 CLI 误当成 operation 参数。`apply-patch`、`script`、`py` 等明确 stdin-backed operation 可以使用 heredoc 或 `< patch.diff` 作为本地输入。
+
 ## CLI

 - `bun scripts/cli.ts help`：输出所有可用命令的 JSON 索引，详细规范见 `docs/reference/cli.md`。