適用所有指令的全域 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

​

為工具產生機器可讀說明

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

​

為本機除錯保留可讀說明

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 中將其用於正式檢查。