适用于所有命令的全局 CLI 标志

​

全局标志能力

​

全局选项

​

可选的布尔标志

• 裸标志表示启用：extension dev --polyfill
• false、0、no 与 off 表示禁用：extension dev --polyfill false
• true、1 与 yes 表示启用：extension build --zip true

​

退出遥测的选项

# 1. Environment variable (wins over everything else)
EXTENSION_TELEMETRY_DISABLED=1 extension dev
EXTENSION_TELEMETRY=0 extension dev            # back-compat

# 2. Per-run flag
extension build --browser=chrome,firefox --no-telemetry

# 3. Persistent consent command
extension telemetry disable

​

实用示例

​

在 CI 构建中禁用遥测

EXTENSION_TELEMETRY_DISABLED=1 extension build --browser=chrome,firefox

​

为工具生成机器可读的 help

extension dev --ai-help --format=json

​

在本地调试中保留可读 help 输出

extension dev --ai-help --format=pretty

​

行为说明

• CLI 会先解析全局标志，再解析命令特有选项。
• 遥测行为与隐私细节请参见仓库的 TELEMETRY.md 与遥测与隐私。
• 使用 extension telemetry status 检查当前同意状态。
• 命令文档另外说明每个命令的特有标志。
• 全局标志可与命令特有选项组合使用。
• 自动化工具(AI 助手与 CI 脚本) 应该从 dist/extension-js/<browser>/ready.json 读取命令就绪状态，而不是解析终端日志。

​

下一步

• 在 create 与 dev 工作流中应用这些标志。
• 在 start、preview 与 build 中用于生产检查。