用途:配置并验证 QwenCloud API 的认证,处理 API Key 与端点设置,排查 401 鉴权错误。
主要能力:区分三种互斥的密钥/套餐类型——标准按量付费(sk- 开头,端点 dashscope-intl.aliyuncs.com)、Token Plan(sk-sp- 开头,端点 token-plan.ap-southeast-1.maas.aliyuncs.com)、Coding Plan(sk-sp- 开头,端点 coding-intl.dashscope.aliyuncs.com)。凭据按优先级加载:环境变量 DASHSCOPE_API_KEY(或别名 QWEN_API_KEY,两者同时设置时 QWEN_API_KEY 优先),其次当前工作目录与仓库根目录的 .env 文件,已有环境变量不被覆盖。支持 QWEN_BASE_URL 覆盖端点,以及 QWEN_TMP_OSS_BUCKET、QWEN_TMP_OSS_REGION、QWEN_TMP_OSS_AK_ID/AK_SECRET 等自定义 OSS 上传配置。
使用方式:创建 .env 占位符,运行 echo 'DASHSCOPE_API_KEY=sk-your-key-here' >> .env,再由用户自行替换为真实密钥;或设置环境变量 export DASHSCOPE_API_KEY='sk-...'。按量付费可用 curl 向 compatible-mode/v1/chat/completions 发请求验证;Token Plan 不使用 curl,改用目标技能自带的 Python 脚本验证。验证结果保存到 output/qwencloud-ops-auth/。
限制与安全:绝不输出任何 API Key 或 OSS 凭据明文,检测只报告状态(set/not set、valid/invalid、HTTP 状态码)。不得要求用户直接粘贴密钥。所有 qwencloud/qwencloud-ai 脚本需要标准密钥(sk-),Coding Plan 密钥在标准端点会返回 401 invalid_api_key。不得编造计费或控制台 URL,仅使用技能中列出的链接。输出文件不得写入技能安装目录或 skills/ 层级。具体价格、模型清单等细节资料未完整提供。