| 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]
.md token -> [file]
- 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.
