跳到主要内容

操作安全

运行前先知道命令可能改变什么

QZX 区分只读诊断和会改变状态的操作。目标是让影响、确认、备份和限制都明确可见,而不是藏在一个听起来友好的命令名后面。

阅读每个命令的安全说明

命令页面会说明操作是否只读、是否需要明确 apply、是否先做备份,以及高级选项下仍然存在什么限制。

  • 意图尚未确认时优先使用可用的 dry-run。
  • 结构化输出不等于没有风险。
  • 检查路径、外部目标以及可能离开本机的数据。

原生执行需要边界

调用系统诊断工具的命令会在契约需要时使用受控的工具列表和参数。用于执行任意脚本的能力则属于不同风险类别,并单独说明。

遥测与网站

网站分析与 CLI 遥测分开记录。若未禁用,CLI 每个版本最多发送一次 version_first_run,并可能发送一个已关闭的 10 天使用窗口;该窗口会先在本地聚合再传输。窗口只包含规范命令名、调用次数、汇总执行时间、活跃天数,以及 TTY、前台状态和近期操作系统输入等粗粒度信号。绝不发送命令参数、终端输入或输出、路径、文件内容、按键、指针坐标或轨迹、点击、原始 HID 事件。使用 QZX_TELEMETRY=0 或 DO_NOT_TRACK=1 可关闭收集。近期输入只是一项弱证据,绝不会单独作为人类存在的证明。