From 15f5a49375af96d03af1f83a6da4a3d06b877623 Mon Sep 17 00:00:00 2001 From: Codex Date: Mon, 25 May 2026 23:43:59 +0000 Subject: [PATCH] docs: document tran shell boundary --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 0ea57e71..366ac2f4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 ...` 后面禁止裸放本地 shell 续接控制符，包括 `&&`、`;` 和 `|`；需要在远端执行多步命令时，必须使用 `tran script -- '远端完整脚本'`、`tran 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`。