📄 qq-reply-format-rules.md

🏠 首页 / docs
⬇️ 下载文件

QQ Bot 回复格式规范

✨ 核心原则

  1. 清晰分段 - 每个主要观点独立成段
  2. 控制长度 - 每段消息不超过QQ长度限制（建议<1000字）
  3. 高可读性 - 使用合适的格式标记（如：1️⃣、✅、粗体）
  4. 适时拆分 - 长内容拆分为多条消息发送

📏 格式规范

1️⃣ 标题层级

## 📋 主标题（居中显示）

### 第一层标题

#### 第二层标题

**重点内容**（加粗强调）

普通正文...

---  # 分隔线（用于区分大段落）

✅ 正确示例:

📋 主标题

这是总体说明...

第一部分

详细内容...

第二部分

详细内容...

2️⃣ 列表格式

有序列表（使用1️⃣ 2️⃣ 3️⃣）

1️⃣ 项目名称 - 简短说明

2️⃣ 项目名称 - 简短说明

3️⃣ 项目名称 - 简短说明

无序列表（使用•、✅、❌）

✅ 功能特性: 支持的功能点

❌ 限制: 不支持的功能点

• 普通项目符号

✅ 正确示例:

接下来为您介绍三大功能：

1️⃣ 定时提醒 - 支持5分钟后、1小时后等相对时间

2️⃣ 周期性任务 - 每天、每周、每月循环执行

3️⃣ 指定时间 - 精确到年月日时分秒的绝对时间

3️⃣ 表格格式

使用Markdown表格，简洁清晰：

参数 说明 示例
--at 触发时间 "5m"
--cron 周期规则 "0 8 * * *"

✅ 正确示例:

参数说明：

参数 说明 示例
targetId 用户OpenID "33558EFB..."
fileType 文件类型 "image"

4️⃣ 代码块格式

代码块使用```包裹，并注明语言（可选）：

# 这是bash代码
openclaw cron add --at "5m"

// 这是JavaScript代码
await sendQQFile({
  targetId: "..."
});

📝 回复拆分规则

规则1：内容长度判断

当单次回复内容超过800-1000字符时，必须拆分为多条消息

❌ 错误示例（单条消息过长）:

这是第一部分内容...（非常长）然后第二部分内容...（非常长）然后第三部分内容...（非常长）全部挤在一起，用户阅读困难。

✅ 正确示例（拆分为多条）:

消息1: 这是第一部分内容...详细说明...

消息2: 这是第二部分内容...详细说明...

消息3: 这是第三部分内容...详细说明...

规则2：主题拆分

每个主要主题独立成段，必要时拆分为多条消息

示例:

如果有"功能介绍"、"参数说明"、"使用示例"三个大主题：

消息1: 功能介绍（2-3个要点）

消息2: 参数说明（表格形式）

消息3: 使用示例（代码块）

规则3：列表项数控制

每段消息的列表项不超过5-7个

❌ 错误（列表太长）:

十个功能点

  1. 功能一...（内容）
  2. 功能二...（内容）
  3. 功能三...（内容）
    ...
  4. 功能十...（内容）

（用户阅读到底部时已忘记前面的内容）

✅ 正确（分页显示）:

消息1：

功能点（1-5）

1️⃣ 功能一...（简短说明）

2️⃣ 功能二...（简短说明）

3️⃣ 功能三...（简短说明）

4️⃣ 功能四...（简短说明）

5️⃣ 功能五...（简短说明）

消息2：

功能点（6-10）

6️⃣ 功能六...（简短说明）

7️⃣ 功能七...（简短说明）

...

🎯 实际案例对比

❌ 优化前（密集格式）

搜索结果:1. vlm - 功能:通用AI识别,使用场景:各种图片识别,使用方法:...
2. docling - 功能:文档提取,使用场景:PDF/Word/表格提取,使用方法:...
表格对比:skill1|功能|场景,skill2|功能|场景...

（单条消息，信息密度过高，阅读困难）

✅ 优化后（清晰分段）

消息1:

📸 AI识图类Skill

找到4个相关skill：

1️⃣ vlm - 通用AI识别
支持各种图片识别和理解

2️⃣ openai-image-vision - OpenAI视觉
基于GPT-4V，识别精度高

消息2:

📄 文档提取类Skill

找到3个相关skill：

1️⃣ docling - 最强文档提取
支持PDF、Word、表格识别
2️⃣ docx - Word处理
3️⃣ pdf - PDF处理

消息3:

🛠️ 已安装的Skill

✅ Agent Browser - 浏览器截图识别
✅ Image Table Extractor - OCR表格提取

（拆分为3条消息，每条聚焦一个主题，更清晰易读）

💬 特殊场景处理

场景1：回复包含图片

文字说明放在第一条消息，图片单独发送：

消息1:
为您找到相关skill，详情如下：
...
消息2: <qqimg>/path/to/file.jpg</qqimg>

❌ 错误：图片和大量文字混在一条消息

场景2：长列表

拆分为多条消息，并添加序号提示：

消息1:
搜索结果（第1-3个）：
...
消息2:
搜索结果（第4-6个）：
...

场景3：代码示例多

每个代码示例独立成段，不要堆叠：

✅ 正确:

消息1: 基础用法示例：

# 基础命令
openclaw cron add --at "5m"

消息2: 高级用法示例：

# 高级命令
openclaw cron add --at "5m" --cron "0 8 * * *" --tz "Asia/Shanghai"

📏 长度检查清单

在发送每条消息前，问自己：

  • 这条消息是否超过1000字符？（如果超过，拆分）
  • 是否包含多个主题？（如果是，拆分）
  • 列表项是否超过7个？（如果是，拆分）
  • 是否有清晰的标题？（如果没有，添加）
  • 是否使用了合适的格式标记？（1️⃣、✅、粗体）
  • 用户阅读这条消息是否需要滚动很久？（如果需要，拆分）

🎨 最佳实践总结

✅ 应该做的

  1. 段落清晰：每段聚焦一个主题
  2. 标题明确：用标题引导用户阅读
  3. 格式丰富：使用1️⃣、✅、粗体等标记
  4. 适时拆分：单条消息控制在800字以内
  5. 代码高亮：用```包裹代码
  6. 表格对齐：使用Markdown表格

❌ 不应该做的

  1. 单条过长：超过1000字不拆分
  2. 主题混杂：一条消息讲多个主题
  3. 纯文本：不使用任何格式标记
  4. 列表冗长：超过10个列表项不分页
  5. 代码混乱：不用代码块包裹
  6. 无标题：全文只有一个标题

🔧 工具支持

在回复中使用这些标记组合：

  • 标题: ## 📋 主标题
  • 分层标题: ### 子标题
  • 强调: 加粗文本
  • 列表: 1️⃣ 有序、• 无序、✅ 正向、❌ 负向
  • 代码: ```包裹
  • 表格: | 表头 | 表头 |
  • 分隔: --- 分隔线

💡 记住核心口诀

三短三有

  • 三短: 段落短、句子短、消息短
  • 三有: 有标题、有格式、有拆分

每次回复前，先拆分再发送。