name: qq-url-guard description: Use when sending replies to QQ where URL-like text (for example xx.xx, USER.md, markdown links, or http URLs) may trigger code 40034028 and get blocked. description_zh: 用于 QQ 回复场景,避免类 URL 文本、Markdown 链接、文件名或 http 地址触发 QQ 风控拦截。
QQ URL Guard
Use this skill for QQ outbound replies (private/group/guild) when content may contain URL-like tokens.
Why
QQ may reject messages with:
code(40034028)请求参数不允许包含url
Common risky patterns:
xx.xx(domain-like text)USER.md/README.md(file-like token treated as URL)- markdown links:
[text](https://...) - plain URLs:
https://.../www...
Output Rules
- Prefer plain text over markdown for QQ replies.
- Avoid raw URL-like strings in final QQ message.
- Replace risky parts with safe placeholders when needed:
- URL ->
[link] .mdtoken ->[file]
- URL ->
- Keep the sentence readable after replacement.
Safe Rewrite Examples
Source: USER.md->Source: [file]详情见 https://example.com->详情见 [link][文档](https://example.com)->文档(链接已省略)
Operator Hint
If QQ send fails with 40034028, retry with sanitized plain text immediately.