Back to Details

qianwen-audio-tts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Agent setup: If your agent doesn't auto-load skills (e.g. Claude Code), see agent-compatibility.md once per session.
Agent 设置：如果你的Agent不会自动加载技能（例如Claude Code）， 请在每个会话中查看agent-compatibility.md。

Qwen Audio TTS (Text-to-Speech)

Qwen Audio TTS (Text-to-Speech)

Synthesize natural speech from text using Qwen TTS models. This skill is part of QianWen-AI/qianwen-ai.
借助Qwen TTS模型将文本合成为自然语音。 此技能属于QianWen-AI/qianwen-ai项目。

Skill directory

技能目录

Use this skill's internal files to execute and learn. Load reference files on demand when the default path fails or you need details.
LocationPurpose
scripts/tts.py
Qwen TTS (HTTP API) — qwen3-tts-flash, qwen3-tts-instruct-flash
scripts/tts_cosyvoice.py
CosyVoice (WebSocket API) — requires 
dashscope
SDK
references/cosyvoice-guide.md
CosyVoice setup, voices, examples, errors
references/execution-guide.md
Fallback: curl (standard, instruct, streaming), code generation
references/prompt-guide.md
Text formatting for speech, instructions templates, voice selection
references/api-guide.md
API supplement
references/sources.md
Official documentation URLs
references/agent-compatibility.md
Agent self-check: register skills in project config for agents that don't auto-load
使用此技能的内部文件来执行操作和学习。当默认路径失效或需要详细信息时，按需加载参考文件。
位置用途
scripts/tts.py
Qwen TTS（HTTP API）—— qwen3-tts-flash、qwen3-tts-instruct-flash
scripts/tts_cosyvoice.py
CosyVoice（WebSocket API）—— 需要
dashscope
SDK
references/cosyvoice-guide.md
CosyVoice设置、语音选项、示例、错误处理
references/execution-guide.md
备选方案：curl（标准、指令式、流式）、代码生成
references/prompt-guide.md
语音文本格式、指令模板、语音选择
references/api-guide.md
API补充说明
references/sources.md
官方文档URL
references/agent-compatibility.md
Agent自检：对于不会自动加载技能的Agent，需在项目配置中注册技能

Security

安全注意事项

NEVER output any API key or credential in plaintext. Always use variable references (
$DASHSCOPE_API_KEY
in shell, 
os.environ["DASHSCOPE_API_KEY"]
in Python). Any check or detection of credentials must be non-plaintext: report only status (e.g. "set" / "not set", "valid" / "invalid"), never the value. Never display contents of 
.env
or config files that may contain secrets.
When the API key is not configured, NEVER ask the user to provide it directly. Instead, help create a 
.env
file with a placeholder (
DASHSCOPE_API_KEY=sk-your-key-here
) and instruct the user to replace it with their actual key from the QianWen Console. Only write the actual key value if the user explicitly requests it.
绝对不要以明文形式输出任何API密钥或凭证。请始终使用变量引用（Shell中用
$DASHSCOPE_API_KEY
，Python中用
os.environ["DASHSCOPE_API_KEY"]
）。任何对凭证的检查或检测都必须非明文：仅报告状态（例如“已设置”/“未设置”、“有效”/“无效”），绝不能泄露密钥值。永远不要显示
.env
或可能包含机密信息的配置文件内容。
当未配置API密钥时，绝对不要直接要求用户提供密钥。相反，应帮助用户创建一个带有占位符的
.env
文件（
DASHSCOPE_API_KEY=sk-your-key-here
），并指导用户从QianWen控制台获取实际密钥后替换占位符。仅当用户明确要求时，才写入实际密钥值。

Key Compatibility

密钥兼容性

Scripts require a standard QianWen API key (
sk-...
). Token Plan 团队版 keys (
sk-sp-...
) target a different endpoint (
token-plan.cn-beijing.maas.aliyuncs.com
) and do not include TTS models. Standard 
sk-
key required for TTS. The script detects 
sk-sp-
keys at startup and prints a warning. If qianwen-ops-auth is installed, see its 
references/tokenplan.md
for full details.
脚本需要标准QianWen API密钥（
sk-...
格式）。Token Plan团队版密钥（
sk-sp-...
格式）针对不同的端点（
token-plan.cn-beijing.maas.aliyuncs.com
），且不包含TTS模型。使用TTS必须使用标准的
sk-
格式密钥。脚本在启动时会检测
sk-sp-
格式的密钥并打印警告。如果已安装qianwen-ops-auth，请查看其
references/tokenplan.md
获取详细信息。

Model Selection

模型选择

Qwen TTS (HTTP API) — use 
scripts/tts.py

Qwen TTS（HTTP API）—— 使用
scripts/tts.py

ModelUse CaseNotes
qwen3-tts-flash
Recommended (standard) — fast, multi-languageCost-effective, widely available
qwen3-tts-instruct-flash
Instruction-guided style controlTone/emotion via instructions
模型使用场景说明
qwen3-tts-flash
推荐（标准款）——快速、多语言性价比高、广泛可用
qwen3-tts-instruct-flash
指令引导的风格控制通过指令调整语气/情感

CosyVoice (WebSocket API) — use 
scripts/tts_cosyvoice.py

CosyVoice（WebSocket API）—— 使用
scripts/tts_cosyvoice.py

ModelUse Case
cosyvoice-v3-flash
High quality, fast
cosyvoice-v3-plus
Highest quality
Note: CosyVoice requires 
dashscope
SDK and uses different voices. See cosyvoice-guide.md.
  1. User specified a model → use the appropriate script: 
    • qwen3-tts-*
      → 
      scripts/tts.py
    • cosyvoice-*
      → 
      scripts/tts_cosyvoice.py
  2. Consult the qianwen-model-selector skill when model choice depends on capability, scenario, or pricing.
  3. No signal, clear task → 
    qwen3-tts-flash
    via 
    tts.py
    (default for standard tasks).
⚠️ Important: The model list above is a point-in-time snapshot and may be outdated. Model availability changes frequently. Always check the official model list for the authoritative, up-to-date catalog before making model decisions.
Model details: For more information about a specific model, direct the user to its detail page: 
https://www.qianwenai.com/models/<model-name>
(replace 
<model-name>
with the exact model ID, e.g. 
qwen3-tts-flash
→ https://www.qianwenai.com/models/qwen3-tts-flash). NEVER modify or guess the model name in the URL.
Dynamic model queries: If the qianwen-model-selector skill or QianWen CLI (
qianwen models info <model>
) is available, use it for real-time model data. CLI requires authentication — see the qianwen-usage skill for login flow.
模型使用场景
cosyvoice-v3-flash
高质量、快速
cosyvoice-v3-plus
最高质量
注意：CosyVoice需要
dashscope
SDK，且使用不同的语音选项。请查看cosyvoice-guide.md。
  1. 用户指定模型 → 使用对应的脚本： 
    • qwen3-tts-*
      → 
      scripts/tts.py
    • cosyvoice-*
      → 
      scripts/tts_cosyvoice.py
  2. 当模型选择取决于能力、场景或定价时，请咨询qianwen-model-selector技能。
  3. 无指定模型但任务明确 → 通过
    tts.py
    使用
    qwen3-tts-flash
    （标准任务的默认选择）。
⚠️ 重要提示：上述模型列表是当前时间点的快照，可能已过时。模型可用性会频繁变化。在做出模型选择前，请务必查看官方模型列表获取权威的最新目录。
模型详情：如需了解特定模型的更多信息，请引导用户访问其详情页面：
https://www.qianwenai.com/models/<model-name>
（将
<model-name>
替换为确切的模型ID，例如
qwen3-tts-flash
→ https://www.qianwenai.com/models/qwen3-tts-flash）。绝对不要修改或猜测URL中的模型名称。
动态模型查询：如果qianwen-model-selector技能或QianWen CLI（
qianwen models info <model>
）可用，请使用它们获取实时模型数据。CLI需要身份验证——请查看qianwen-usage技能了解登录流程。

Available Voices

可用语音

VoiceDescriptionScript
Cherry, Ethan, SerenaQwen TTS system voices
tts.py
longanyang, longanhuan, longhuhu_v3CosyVoice verified voices
tts_cosyvoice.py
Full lists: api-guide.md (Qwen TTS) · cosyvoice-guide.md (CosyVoice)
语音描述脚本
Cherry, Ethan, SerenaQwen TTS系统语音
tts.py
longanyang, longanhuan, longhuhu_v3CosyVoice认证语音
tts_cosyvoice.py
完整列表：api-guide.md（Qwen TTS）· cosyvoice-guide.md（CosyVoice）

Execution

执行说明

⚠️ Multiple artifacts: When generating multiple files in a single session, you MUST append a numeric suffix to each filename (e.g. 
out_1.wav
, 
out_2.wav
) to prevent overwrites.
⚠️ 多文件生成：当在单个会话中生成多个文件时，必须为每个文件名添加数字后缀（例如
out_1.wav
、
out_2.wav
）以防止覆盖。

Qwen TTS (HTTP API) — 
tts.py

Qwen TTS（HTTP API）—— 
tts.py

Prerequisites

前置条件

  • API Key: Check that 
    DASHSCOPE_API_KEY
    (or 
    QIANWEN_API_KEY
    ) is set using a non-plaintext check only (e.g. in shell: 
    [ -n "$DASHSCOPE_API_KEY" ]
    ; report only "set" or "not set", never the key value). If not set: run the qianwen-ops-auth skill if available; otherwise guide the user to obtain a key from QianWen Console and set it via 
    .env
    file (
    echo 'DASHSCOPE_API_KEY=sk-your-key-here' >> .env
    in project root or current directory) or environment variable. The script searches for 
    .env
    in the current working directory and the project root. Skills may be installed independently — do not assume qianwen-ops-auth is present.
  • Python 3.9+ (stdlib only, no pip install needed)
  • API密钥：仅通过非明文方式检查
    DASHSCOPE_API_KEY
    （或
    QIANWEN_API_KEY
    ）是否已设置（例如在Shell中：
    [ -n "$DASHSCOPE_API_KEY" ]
    ；仅报告“已设置”或“未设置”，绝不能泄露密钥值）。如果未设置：如果qianwen-ops-auth技能可用，则运行该技能；否则引导用户从QianWen控制台获取密钥，并通过
    .env
    文件（在项目根目录或当前目录执行
    echo 'DASHSCOPE_API_KEY=sk-your-key-here' >> .env
    ）或环境变量进行设置。脚本会在当前工作目录和项目根目录中查找
    .env
    文件。技能可能独立安装——不要假设qianwen-ops-auth已存在。
  • Python 3.9+（仅需标准库，无需pip安装）

Environment Check

环境检查

Before first execution, verify Python is available:
bash
python3 --version  # must be 3.9+
If 
python3
is not found, try 
python --version
or 
py -3 --version
. If Python is unavailable or below 3.9, skip to Path 2 (curl) in execution-guide.md.
首次执行前，验证Python是否可用：
bash
python3 --version  # 必须为3.9+
如果找不到
python3
，尝试
python --version
或
py -3 --version
。如果Python不可用或版本低于3.9，请跳转到execution-guide.md中的路径2（curl）。

Default: Run Script

默认方式：运行脚本

Script path: Scripts are in the 
scripts/
subdirectory of this skill's directory (the directory containing this SKILL.md). You MUST first locate this skill's installation directory, then ALWAYS use the full absolute path to execute scripts. Do NOT assume scripts are in the current working directory. Do NOT use 
cd
to switch directories before execution.
Execution note: Run all scripts in the foreground — wait for stdout; do not background.
Discovery: Run 
python3 <this-skill-dir>/scripts/tts.py --help
first to see all available arguments.
bash
python3 <this-skill-dir>/scripts/tts.py \
  --request '{"text":"Hello, this is a test.","voice":"Cherry"}' \
  --output output/qianwen-audio-tts/ \
  --print-response
ArgumentDescription
--request '{...}'
JSON request body
--file path.json
Load request from file
--output dir/
Save audio and response JSON to directory
--print-response
Print response to stdout
--model ID
Override model
--voice NAME
Override voice
脚本路径：脚本位于此技能目录（包含此SKILL.md的目录）的
scripts/
子目录中。必须先找到此技能的安装目录，然后始终使用完整绝对路径执行脚本。不要假设脚本在当前工作目录中。执行前不要使用
cd
切换目录。
执行注意：所有脚本都要在前台运行——等待标准输出；不要后台运行。
查看帮助：先运行
python3 <this-skill-dir>/scripts/tts.py --help
查看所有可用参数。
bash
python3 <this-skill-dir>/scripts/tts.py \
  --request '{"text":"Hello, this is a test.","voice":"Cherry"}' \
  --output output/qianwen-audio-tts/ \
  --print-response
参数描述
--request '{...}'
JSON请求体
--file path.json
从文件加载请求
--output dir/
将音频和响应JSON保存到指定目录
--print-response
将响应打印到标准输出
--model ID
覆盖默认模型
--voice NAME
覆盖默认语音

Verify Result

验证结果

  • Exit code 
    0
    + output contains valid JSON with 
    output.audio
    field → success
  • Non-zero exit, HTTP error, empty response, or error JSON → fail
  • Post-execution check: Verify the output audio file exists and has non-zero size (
    ls -la <output_dir>
    )
  • MANDATORY — stderr signal check: After confirming the result, scan the command's stderr output for 
    [ACTION_REQUIRED]
    or 
    [UPDATE_AVAILABLE]
    . If either signal is present, you MUST follow the instructions in Update Check below before responding to the user.
  • 退出码
    0
    + 输出包含带有
    output.audio
    字段的有效JSON → 成功
  • 非零退出码、HTTP错误、空响应或错误JSON → 失败
  • 执行后检查：验证输出音频文件是否存在且大小非零（
    ls -la <output_dir>
    ）
  • 必须执行——标准错误信号检查：确认结果后，扫描命令的标准错误输出中是否包含
    [ACTION_REQUIRED]
    或
    [UPDATE_AVAILABLE]
    。如果存在其中任一信号，必须按照下面更新检查中的说明操作后再回复用户。

On Failure

失败处理

If the script fails, match the error output against the diagnostic table below to determine the resolution. If no match, read execution-guide.md for alternative paths: curl commands (Path 2 — standard, instruct, streaming), code generation (Path 3), and autonomous resolution (Path 5).
If Python is not available at all → skip directly to Path 2 (curl) in execution-guide.md.
如果脚本执行失败，请将错误输出与下面的诊断表匹配以确定解决方案。如果无匹配项，请阅读execution-guide.md了解备选路径：curl命令（路径2——标准、指令式、流式）、代码生成（路径3）和自主解决（路径5）。
如果完全没有Python环境 → 直接跳转到execution-guide.md中的路径2（curl）。

CosyVoice — 
tts_cosyvoice.py

CosyVoice —— 
tts_cosyvoice.py

CosyVoice requires 
dashscope
SDK. Quick start:
bash
pip install dashscope>=1.24.6
python3 <this-skill-dir>/scripts/tts_cosyvoice.py --text "Hello"
Full guide: cosyvoice-guide.md (setup, voices, examples, errors)
Error PatternDiagnosisResolution
command not found: python3
Python not on PATHTry 
python
or 
py -3
; install Python 3.9+ if missing
Python 3.9+ required
Script version check failedUpgrade Python to 3.9+
SyntaxError
near type hints		Python < 3.9Upgrade Python to 3.9+
QIANWEN_API_KEY/DASHSCOPE_API_KEY not found
Missing API keyObtain key from QianWen Console; add to 
.env
: 
echo 'DASHSCOPE_API_KEY=sk-...' >> .env
; or run qianwen-ops-auth if available
HTTP 401
Invalid or mismatched keyRun qianwen-ops-auth (non-plaintext check only); verify key is valid
SSL: CERTIFICATE_VERIFY_FAILED
SSL cert issue (proxy/corporate)macOS: run 
Install Certificates.command
; else set 
SSL_CERT_FILE
env var
URLError
/ 
ConnectionError
Network unreachableCheck internet; set 
HTTPS_PROXY
if behind proxy
HTTP 429
Rate limitedWait and retry with backoff
HTTP 5xx
Server errorRetry with backoff
PermissionError
Can't write outputUse 
--output
to specify writable directory
CosyVoice需要
dashscope
SDK。快速开始：
bash
pip install dashscope>=1.24.6
python3 <this-skill-dir>/scripts/tts_cosyvoice.py --text "Hello"
完整指南：cosyvoice-guide.md（设置、语音选项、示例、错误处理）
错误模式诊断解决方案
command not found: python3
Python不在PATH中尝试
python
或
py -3
；如果缺失则安装Python 3.9+
Python 3.9+ required
脚本版本检查失败将Python升级到3.9+
SyntaxError
near type hints		Python版本低于3.9将Python升级到3.9+
QIANWEN_API_KEY/DASHSCOPE_API_KEY not found
缺少API密钥从QianWen控制台获取密钥；添加到
.env
文件：
echo 'DASHSCOPE_API_KEY=sk-...' >> .env
；如果可用则运行qianwen-ops-auth技能
HTTP 401
密钥无效或不匹配如果可用则运行qianwen-ops-auth技能（仅非明文检查）；验证密钥是否有效
SSL: CERTIFICATE_VERIFY_FAILED
SSL证书问题（代理/企业环境）macOS：运行
Install Certificates.command
；其他系统设置
SSL_CERT_FILE
环境变量
URLError
/ 
ConnectionError
网络不可达检查网络；如果在代理后设置
HTTPS_PROXY
HTTP 429
请求频率受限等待后重试并使用退避策略
HTTP 5xx
服务器错误等待后重试并使用退避策略
PermissionError
无法写入输出使用
--output
指定可写入的目录

Quick Reference

快速参考

Request Fields

请求字段

FieldTypeDescription
text
stringRequired — text to synthesize (max 600 chars)
voice
stringRequired — voice ID (e.g. 
Cherry
, 
Ethan
)
model
stringModel ID (default: 
qwen3-tts-flash
)
language_type
string
Auto
, 
Chinese
, 
English
, 
Japanese
, 
Korean
, 
French
, 
German
, etc.
instructions
stringTone/style instructions (instruct model only)
stream
boolEnable streaming (Base64 chunks)
字段类型描述
text
string必填——待合成的文本（最多600字符）
voice
string必填——语音ID（例如
Cherry
、
Ethan
）
model
string模型ID（默认：
qwen3-tts-flash
）
language_type
string
Auto
、
Chinese
、
English
、
Japanese
、
Korean
、
French
、
German
等
instructions
string语气/风格指令（仅适用于指令式模型）
stream
bool启用流式传输（Base64分块）

Response Fields

响应字段

FieldDescription
audio_url
URL of generated audio (valid 24h)
audio_format
Format (e.g. wav)
sample_rate
Sample rate (e.g. 24000)
usage
Character usage
字段描述
audio_url
生成的音频URL（有效期24小时）
audio_format
音频格式（例如wav）
sample_rate
采样率（例如24000）
usage
字符使用量

Important Notes

重要说明

  • text: Max 600 characters per request.
  • instructions: Only works with 
    qwen3-tts-instruct-flash
    .
  • language_type: 
    Auto
    for mixed language; specify for better pronunciation.
  • audio_url: Valid for 24 hours — download promptly.
  • Real-time/streaming TTS: For WebSocket-based real-time TTS (CosyVoice, qwen3-tts-flash-realtime), a WebSocket client is required. This skill covers the HTTP-based non-real-time API. For real-time streaming use cases, refer to the official docs in sources.md.
  • text：每个请求最多600字符。
  • instructions：仅适用于
    qwen3-tts-instruct-flash
    模型。
  • language_type：混合语言使用
    Auto
    ；指定语言可获得更好的发音效果。
  • audio_url：有效期24小时——请及时下载。
  • 实时/流式TTS：对于基于WebSocket的实时TTS（CosyVoice、qwen3-tts-flash-realtime），需要WebSocket客户端。此技能覆盖基于HTTP的非实时API。如需实时流式传输用例，请参考sources.md中的官方文档。

Cross-Skill Chaining

跨技能联动

When passing generated audio to another skill (e.g., video-gen audio overlay):
  • Pass 
    audio_url
    directly     — scripts detect URL prefixes and pass through without re-upload
  • Use 
    audio_file
    only for local playback or non-API operations
当将生成的音频传递给其他技能（例如视频生成的音频叠加）时：
  • 直接传递
    audio_url
    ——脚本会检测URL前缀并直接传递，无需重新上传
  • 仅在本地播放或非API操作时使用
    audio_file

Error Handling

错误处理

ErrorCauseAction
401 Unauthorized
Invalid or missing API keyRun qianwen-ops-auth if available; else prompt user to set key (non-plaintext check only)
400
Invalid parameters (missing text/voice)Validate request body
429
/ 
5xx
Rate limit or server errorRetry with backoff
Usage & billing: Use the qianwen-usage skill to check usage, free tier quota, and billing directly. Alternatively, the user can visit the QianWen console: Usage Analytics | Pay-as-you-go Billing | Token Plan 团队版 Subscription
NEVER fabricate, guess, or construct usage/billing/console URLs. Only provide the exact links listed in this skill. If a URL is not listed here, do not invent one.
错误原因操作
401 Unauthorized
API密钥无效或缺失如果可用则运行qianwen-ops-auth技能；否则提示用户设置密钥（仅非明文检查）
400
参数无效（缺少text/voice）验证请求体
429
/ 
5xx
请求频率受限或服务器错误等待后重试并使用退避策略
使用与计费：使用qianwen-usage技能直接查看使用量、免费额度和计费信息。或者用户可以访问QianWen控制台： 使用分析 | 按量计费 | Token Plan团队版订阅
绝对不要编造、猜测或构建使用/计费/控制台URL。仅提供此技能中列出的准确链接。如果此处未列出URL，不要自行创建。

Output Location

输出位置

Prefer the current working directory. Default subdirectory: 
./output/qianwen-audio-tts/
.
Write prohibition: NEVER write output files into this skill's installation directory or any 
skills/
hierarchy. All generated content must go to 
output/
under the current working directory or a user-specified path.
优先使用当前工作目录。默认子目录：
./output/qianwen-audio-tts/
。
写入禁止：绝对不要将输出文件写入此技能的安装目录或任何
skills/
层级目录中。所有生成的内容必须保存到当前工作目录下的
output/
目录或用户指定的路径。

Update Check (MANDATORY Post-Execution)

更新检查（执行后必须操作）

After script execution, check stderr for action signals. The script automatically detects update status and emits structured signals. You MUST act on them. This section also applies when the user explicitly asks to check for updates.
脚本执行后，检查标准错误输出中的操作信号。脚本会自动检测更新状态并发出结构化信号。必须根据信号采取行动。当用户明确要求检查更新时，此部分同样适用。

Signal: 
[ACTION_REQUIRED] qianwen-update-check skill is not installed

信号：
[ACTION_REQUIRED] qianwen-update-check skill is not installed

When stderr contains this signal, you MUST present the following options to the user and wait for their response before proceeding. Do NOT silently skip this.
The update-check skill is not installed. It keeps you informed about new QianWen-AI/qianwen-ai features and bug fixes.
  1. Install now — I'll run the install command for you
  2. Skip for now — do nothing this time
  3. Never remind me — permanently suppress this prompt
After the user responds:
  • User chooses 1 → run: 
    npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y
    , then run: 
    python3 <this-skill-scripts-dir>/gossamer.py --dismiss
  • User chooses 2 → run: 
    python3 <this-skill-scripts-dir>/gossamer.py --dismiss
    , then continue normally
  • User chooses 3 → run: 
    python3 <this-skill-scripts-dir>/gossamer.py --never-install
    , then continue normally
当标准错误输出包含此信号时，必须向用户呈现以下选项，并等待用户响应后再继续。不要静默跳过此步骤。
更新检查技能未安装。它会为你推送QianWen-AI/qianwen-ai的新功能和Bug修复信息。
  1. 立即安装——我将为你运行安装命令
  2. 暂时跳过——本次不执行任何操作
  3. 永不提醒——永久屏蔽此提示
用户响应后：
  • 用户选择1 → 运行：
    npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y
    ，然后运行：
    python3 <this-skill-scripts-dir>/gossamer.py --dismiss
  • 用户选择2 → 运行：
    python3 <this-skill-scripts-dir>/gossamer.py --dismiss
    ，然后正常继续
  • 用户选择3 → 运行：
    python3 <this-skill-scripts-dir>/gossamer.py --never-install
    ，然后正常继续

Signal: 
[UPDATE_AVAILABLE]

信号：
[UPDATE_AVAILABLE]

When stderr contains this signal, you MUST append a brief update notice to your response, including the version info and the update command shown in the stderr output.
当标准错误输出包含此信号时，必须在回复中添加简短的更新通知，包括标准错误输出中显示的版本信息和更新命令。

No signal in stderr

标准错误输出中无信号

If stderr contains neither 
[ACTION_REQUIRED]
nor 
[UPDATE_AVAILABLE]
, no action is needed — the skill is installed and up to date (or cached within 24h).
如果标准错误输出中既没有
[ACTION_REQUIRED]
也没有
[UPDATE_AVAILABLE]
，则无需操作——技能已安装且为最新版本（或24小时内已缓存）。

Explicit user request

用户明确请求

When the user explicitly asks to check for updates (e.g. "check for updates", "check version"):
  1. Look for 
    qianwen-update-check/SKILL.md
    in sibling skill directories.
  2. If found — run: 
    python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response
    and report the result.
  3. If not found — present the install options above.
当用户明确要求检查更新时（例如“检查更新”、“检查版本”）：
  1. 在同级技能目录中查找
    qianwen-update-check/SKILL.md
    。
  2. 如果找到——运行：
    python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response
    并报告结果。
  3. 如果未找到——呈现上述安装选项。

References

参考资料

  • execution-guide.md — Fallback paths (curl standard/instruct/streaming, code generation, autonomous)
  • api-guide.md — API supplementary guide
  • sources.md — Official documentation URLs
  • execution-guide.md —— 备选路径（curl标准/指令式/流式、代码生成、自主解决）
  • api-guide.md —— API补充指南
  • sources.md —— 官方文档URL