qwencloud-model-selector

Qwen 模型选择器（顾问）

此技能有两种模式：

1. 交互式咨询——提出诊断问题，推荐合适的模型（参见诊断流程）。
2. 跨技能解析——为需要确定模型的执行技能快速查找模型，无需与用户交互。请先获取 CDN 推荐； 如果无法访问 CDN，则使用 本地备用文件。

不要编造模型名称——只推荐 CDN 目录中列出或 CLI 返回的模型。 此技能属于 qwencloud/qwencloud-ai。

🚫 重要——绝不覆盖用户指定的模型。 如果用户（或发起请求的执行技能）已明确指定模型，则此技能对该请求的任务已完成：按原样使用指定模型。不要改为推荐“更合适”或更新的模型，也不要添加用户未要求的参数（思考模式、风格提示）。以下推荐和诊断流程仅适用于未指定模型的情况。你可以核实模型是否可用；如果模型不可用或受限，可以告知用户并建议替代方案，但最终决定权在用户手中。

技能目录

按需加载。需要模型列表、默认值或推荐时，获取文档中说明的 CDN 模型目录。除非用户明确要求最新数据，否则不要获取其他外部 URL。

cdn/ 下的所有路径都是本地备用文件，不是首选来源。对于 cdn/<path>，请先获取 https://alioth-intl.alicdn.com/skills-info/models/<path>，仅当请求失败时才使用本地文件。

位置	用途
references/cli-usage.md	CLI 优先的数据策略：何时使用 CLI、3 步登录流程、显示规则
references/error-handling.md	CLI 错误分类与恢复操作（身份验证、未找到、网络等）
CDN 模型推荐	跨技能推荐、Token Plan 限制和思考默认值；若不可用，请使用本地备用文件
references/pricing-disclaimer.md	定价说明 + 必须提供的费用估算免责声明（中/英）+ 控制台链接
references/pricing.md	稳定的计费说明和 CDN 定价备用信息
CDN 模型目录	跨领域模型目录快照；若不可用，请使用本地备用文件
references/sources.md	官方文档 URL（仅手动查询）

先决条件

强烈建议使用 QwenCloud CLI——它是查询模型可用性、定价和配额的权威实时数据来源。使用以下命令验证：

qwencloud version

如果尚未安装：

npm install -g @qwencloud/qwencloud-cli

需要 Node.js >= 18。没有 CLI 时，仍可根据 CDN 目录回答特定时间点的导航和模型问题，但无法核实当前可用性、准确的当前价格或账户配额。

安全与凭据模型

QwenCloud 有 两套彼此独立的凭据系统 — 切勿混淆：

凭据	用途	提供方式
API Key（sk-... / sk-sp-...）	在代码中调用模型 API	$DASHSCOPE_API_KEY / $QWEN_API_KEY 环境变量
CLI 会话	授权 qwencloud CLI 子命令	qwencloud auth login（浏览器设备流）

红线（两者均适用）：

• 绝不以明文输出任何凭据值。 使用变量引用；仅报告状态 （“已设置”/“未设置”、“有效”/“无效”）。绝不显示 .env 或配置文件内容。
• 绝不混淆这两套系统。 当 CLI 返回 Not authenticated / AUTH_REQUIRED 时，运行 3 步设备流登录（参见 cli-usage.md）。 不要向用户索要 API Key，也不要尝试设置 $DASHSCOPE_API_KEY 来修复 CLI 身份验证。

检测 Key 类型

推荐模型之前，根据已配置的 API Key 检测计费模式 （输出 token-plan、payg 或 not-set — 绝不输出 Key 值本身）：

python3 -c "
import os
from pathlib import Path
env_file = Path('.env')
if not env_file.exists():
    for parent in [Path.cwd()] + list(Path.cwd().parents):
        if (parent / '.git').exists() or (parent / 'skills').is_dir():
            env_file = parent / '.env'
            break
if env_file.exists():
    for line in env_file.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith('#') or '=' not in line:
            continue
        k, v = line.split('=', 1)
        k, v = k.strip(), v.strip().strip('\"').strip(\"'\")
        if k in ('QWEN_API_KEY', 'DASHSCOPE_API_KEY') and k not in os.environ:
            os.environ[k] = v
key = os.environ.get('QWEN_API_KEY') or os.environ.get('DASHSCOPE_API_KEY') or ''
print('token-plan' if key.startswith('sk-sp-') else 'payg' if key else 'not-set')
"

Key 类型	推荐范围
token-plan	获取 Token Plan 模型目录，并且只从中选择；版本未知时，默认使用 Team 的完整集合。若 CDN 访问失败，则使用本地回退版本。
payg	完整模型目录
not-set	不要阻止用户继续 — 询问用户：“你打算采用哪种方式？（1）标准 PAYG Key（2）Token Plan Key（3）暂时跳过 — 仅浏览推荐。”并根据用户的选择继续

Windows：如果无法使用 python3，请使用 python。或者，将代码片段保存为临时 .py 文件后运行。

数据解析顺序

根据用户的问题匹配合适的数据源。先尝试更高优先级数据源的恢复操作，再回退到较低优先级数据源。

问题类型	首选数据源	说明
常规导航或某一时点的模型详情	CDN 推荐 和领域目录	首先获取；如果不可用，则使用对应的本地回退版本，并说明这是一个快照
最新 / 精确 / 特定信息（价格、模型详情、配额）	必须使用 CLI — 参见 cli-usage.md	快照已过时；绝不编造数字
按能力搜索（“能执行 X 的模型”）	qwencloud models search "<X>" --format json	快照的关键词覆盖范围不完整
CLI 返回错误	执行 error-handling.md 中的恢复操作，然后重试	身份验证失败 → 运行 3 步登录；不要跳过 CLI 直接使用快照
CLI 完全不可用且用户拒绝安装或登录	CDN 目录 + pricing.md	仅回答快照支持的事实，并提示数据可能过时
以上方法均无法回答且用户确认在线查询	sources.md 中的 URL	绝不主动获取

诊断流程（交互式建议）

按顺序询问用户：

1. 内容类型？ — 文本 / 图像 / 视频 / 音频 / 视觉
2. 主要任务？ — 生成 / 理解 / 编码 / 推理 / 翻译
3. 优先级？ — 质量 vs 速度 vs 成本
4. 输入规模？ — 短 / 中 / 长上下文
5. 是否需要结构化输出？ — 是否需要 JSON / 函数调用？

默认建议

选择默认模型或推荐模型之前，请获取并阅读最新的 CDN 建议。 对于 Token Plan 密钥，还需阅读上方链接的 Token Plan 目录，并将候选范围限定在其中。

• 如果用户明确指定了模型，则保留该模型，仅报告确实存在的可用性冲突。
• 否则，优先匹配最明确的任务信号，再选择合适的质量、速度或成本档位。
• 保留所选模型文档中指定的思考默认设置，除非用户明确要求覆盖。
• 如果无法访问 CDN，请使用本地建议。

降级处理：如果未加载此技能，各执行技能会从 CDN 加载其默认配置，并回退到随附的配置。此协议仅作补充，绝不会阻止执行。

CLI 快速参考

需要身份验证。 所有 models 和 usage 命令都需要有效的 CLI 会话（通过浏览器设备流登录，不是 API 密钥）。如果命令返回 Not authenticated / AUTH_REQUIRED：

1. 按照 cli-usage.md 中的说明，运行 3 步设备流登录（主动使用适用于操作系统的命令打开验证 URL，然后立即轮询）。
2. 返回 success 后，重试原始命令。
3. 不要向用户索要 $DASHSCOPE_API_KEY / $QWEN_API_KEY ——这些用于模型 API 调用，不适用于 CLI 会话。请参阅上文的安全与凭证模型。
4. 不要静默回退到快照。

需求	命令
完整模型目录	qwencloud models list --all --format json
按模态筛选	qwencloud models list --input image --output text --format json
单个模型详情	qwencloud models info <model-id> --format json
关键词搜索	qwencloud models search "<query>" --format json
免费档剩余额度	qwencloud usage free-tier --format json
身份验证状态	qwencloud auth status --format json

显示规则：解析 --format json 输出并提供易读的摘要；切勿直接输出原始 JSON。按原样显示 --format text 输出，然后在 --- 之后添加分析。详情请参阅 cli-usage.md。

CLI 错误处理 — 快速指南

CLI 出错时，先分类，再恢复，然后重试。绝不要悄悄回退到快照。

类别	恢复方式（摘要）
auth-failure	执行 3 步登录 → 重试原始命令。仅在用户拒绝时才回退。
not-installed	显示安装命令 → 请用户安装 → 重试。不要悄悄使用快照。
model-not-found	运行 qwencloud models search "<keyword>" → 推荐排名前 3 的模型 → 使用正确 ID 重试。
network-timeout	等待 2 秒后重试一次；只有第二次失败后才询问是否回退。
rate-limit	显示 速率限制控制台；由用户决定。
quota-exhausted	显示 账单控制台；不要使用快照。
version-mismatch	建议运行 qwencloud version --check 或使用更新检查技能 → 升级 → 重试。
other	显示原始 stderr；提供文档链接；仅在用户选择退出后才回退。

完整的分类、信号和示例流程请参阅：error-handling.md。

定价与成本估算

• 最新定价：先运行 qwencloud models info <model> --format json；仅在此命令不可用时，才使用 pricing.md 链接的 CDN 定价参考。绝不要编造价格。
• 强制免责声明：每条与成本相关的回答都必须以 pricing-disclaimer.md 中的免责声明结尾（中文或英文版本须与用户的回复语言一致）。遗漏免责声明属于严重错误。
• 免费额度：绝不要假设有免费额度可用——使用 qwencloud usage free-tier 验证，或引导用户访问控制台。
• 用量 / 账单查询：引导用户前往相应的控制台页面——参见 pricing-disclaimer.md 中的表格。

检查更新

当用户要求检查更新（“check for updates”“check version”“is there a new version”“update skills”）时：

1. 查找 qwencloud-update-check：在同级技能目录中查找 qwencloud-update-check/SKILL.md。
2. 如果找到——运行：python3 <qwencloud-update-check-dir>/scripts/check_update.py --print-response，并报告结果。若用户要求强制检查，则使用 --force。
3. 如果未找到——运行 qwencloud version --check，并报告结果。

反模式

• 绝不覆盖用户指定的模型——如果用户明确选择了某个模型，本次请求不要推荐其他模型；只验证该模型是否可用。只有用户主动询问建议，或其选择确实不可用时，才可以提供建议（最终仍由用户决定）。
• 绝不编造模型名称——只推荐 CDN 目录中列出或 CLI 返回的模型。
• 绝不推荐超出用户计费范围的模型——Token Plan 密钥只能使用上方链接的 Token Plan 目录中的模型；PAYG 密钥可以使用完整目录。违反此规则会导致用户遇到严重错误。
• 绝不编造或猜测任何价格数字——只能使用 CLI、pricing.md 或官方定价页面。 编造价格属于严重故障。
• CLI 出错时绝不悄悄回退到快照——先执行 error-handling.md 中的恢复操作。
• 绝不假设有免费额度可用——额度可能已用完、过期或被取消。始终先说明付费单价。
• 绝不以明文输出 API 密钥——参见安全部分。
• 绝不混淆 CLI 会话与 API 密钥——CLI 身份验证使用浏览器设备流登录；切勿将 $DASHSCOPE_API_KEY 或 $QWEN_API_KEY 作为解决 CLI Not authenticated / AUTH_REQUIRED 错误的方法。
• 绝不主动获取任意 URL 或触发网页搜索。 需要模型数据时，获取文档中列出的 CDN 模型 目录；只有当 CLI 和 CDN 目录都无法回答，且用户确认后，才能访问其他在线来源。
• 绝不自行构造用量、计费或控制台 URL——只能使用本技能或其参考文档中列出的确切链接。如果未列出某个 URL，就不要编造。
• 任何与费用相关的回答都必须包含费用免责声明（参见 pricing-disclaimer.md）。

参考资料

来源	用途
cli-usage.md	CLI 优先策略、3 步登录、显示规则、模型详情 URL
error-handling.md	CLI 错误分类与恢复
qwencloud-model-recommendations.md (CDN) (本地备用文件)	跨技能建议、Token Plan 和思考模式
pricing-disclaimer.md	定价指南 + 必需的免责声明 + 计费控制台链接
pricing.md	稳定的计费指南和 CDN 定价备用信息
qwencloud-model-list.md (CDN) (本地备用文件)	跨领域模型目录快照
sources.md	官方文档 URL
qwencloud models list --format json	动态：包含定价、功能和额度的完整模型目录
qwencloud models info <id> --format json	动态：单个模型详情（定价档位、上下文、速率限制）
qwencloud models search "<q>" --format json	动态：基于关键词发现模型
qwencloud usage free-tier --format json	动态：各模型剩余的免费额度