用途：melange-qcom 用于在 ZETIC Melange 平台上完成 Qualcomm 端侧 AI 的完整工作流，与 melange 共享账号、凭据、仓库和本地状态，但报告与目标展示会过滤为已审核的 Qualcomm 设备集合。
主要能力：支持模型上传与导入（含 Hugging Face 模型）、转换状态查询、Qualcomm 基准报告查看、目标产物选择、部署代码生成，以及中断上传的恢复。可用 CLI 或 MCP 服务器，优先使用已连接的 Qualcomm MCP 服务器，用 melange-qcom mcp 启动；CLI 用于认证、本地下载、高级上传或原始 API 访问。
使用方式：认证用 melange-qcom auth login，状态用 melange-qcom auth status --json；无头环境可用 MELANGE_API_KEY 或 MELANGE_API_KEY_FILE，脚本中加 --no-input。退出码：0 成功、1 API/操作错误、2 调用错误、4 认证错误、130 中断。用 --json 或 --jq 便于代理处理。上传前检查配额：melange-qcom plan --jq .plan 与 melange-qcom usage quotas --json。创建仓库后先 --dry-run 验证，再上传；Hugging Face 模型用 melange-qcom model import ORG/MODEL -R "$repo" --json。报告用 melange-qcom report view，目标用 melange-qcom model targets，下载需用户授权后加 --yes。部署代码支持 android-kotlin、android-java 和 flutter，拒绝 ios-swift。
限制：api 命令是未过滤的逃生通道，不得将其报告、目标、设备或部署数据描述为 Qualcomm 过滤结果。Qualcomm 报告与目标命令返回带 qualcomm_filter 元数据的重新封装过滤信封，并非字节级 API 透传。匹配集是已审核的 Qualcomm 设备集合，不代表所有 Qualcomm 设备。公开进度为 null，不得编造百分比。失败时按 .stage 和 .failure_code 原样报告。不要重试退出码 2 或 4。标识符需按 ACCOUNT/REPO、MODEL_KEY、TARGET_ID 顺序解析，不得解析不透明标识符。保留 YOUR_PERSONAL_KEY 占位符，不得插值、打印或持久化活动凭据。