docs(cli): forbid high-frequency help dumps
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success

This commit is contained in:
Codex
2026-07-12 01:47:29 +02:00
parent c19ea76e56
commit 3820fcd785
2 changed files with 4 additions and 1 deletions
+2
View File
@@ -4,7 +4,9 @@ UniDesk 的统一 CLI 实现入口是根目录 `scripts/cli.ts`,运行方式
- 高频 CLI 默认输出与帮助输出是直接阅读入口:
- 必须保持有界、低噪声并直接展示,不得触发 `outputTruncated``/tmp/unidesk-cli-output` dump。
- 面向人工的高频 `--help` 必须默认输出紧凑文本;机器 JSON 只能由显式 `--json``-o json` 或等价参数请求,不能把 JSON envelope 当作帮助页直接倾倒。
- 顶层帮助只展示分组索引和可执行的下钻命令,详细合同通过 `<command> --help <operation>` 或等价 scoped help 获取。
- 未知子命令、未知 help scope 和可预测 option 校验失败必须返回紧凑、结构化且无 stack 的输入错误;stack 只允许在显式 debug/raw 错误模式下披露,内部异常不得伪装成输入错误。
- 默认输出或帮助输出触发 dump 视为 CLI 缺陷,必须收敛信息结构,禁止用提高 stdout 阈值掩盖。
- dump 只允许用于用户显式请求的 `--full``--raw`、机器完整输出,或确实无法预先界定的一次性异常证据。