message-chunker

name	message-chunker
description	智能消息分段工具。自动将长消息拆分成多条发送，避免飞书API消息长度限制。当需要发送长消息（如汇报、方案、日志）时自动激活。

Message Chunker - 消息分段工具

智能分段发送长消息，确保每条消息不超过平台限制。

触发条件

当消息满足以下任一条件时自动分段：

• 消息长度超过 4000 字符
• 包含多个独立章节/表格
• 发送失败（Status 400）后重试

平台限制

平台	单条限制	建议
飞书	~4KB	每条≤4000字符
Telegram	4096字符	每条≤4000字符
Discord	2000字符	每条≤1900字符
WhatsApp	65536字符	较宽松

分段规则

1. 按章节分段

## 章节1
内容...

--- 分段 ---

## 章节2
内容...

2. 按表格分段

表格1内容...

--- 分割 ---

表格2内容...

3. 按段落分段

• 优先在 --- 分隔线处分段
• 其次在空行处分段
• 避免在句子中间分段

使用方法

自动模式（推荐）

在回复长消息时，Agent会自动判断并分段：

# 第1条消息（分段1/n）
内容...

# 系统自动发送第2条
内容续...

# 系统自动发送第3条
内容续...

手动标记分段

在消息中插入分段标记：

{{CHUNK}}

Agent会在标记处自动分段。

示例

原始长消息（10KB）：

# 汇报
## 第一部分
[大量内容]
## 第二部分
[大量内容]
## 第三部分
[大量内容]

分段后：

第1条: # 汇报\n## 第一部分\n[大量内容]
第2条: ## 第二部分\n[大量内容]
第3条: ## 第三部分\n[大量内容]

配置

在 TOOLS.md 中可自定义：

message-chunker:
  maxChunkSize: 4000  # 单条最大字符数
  splitOnHeadings: true  # 在标题处分段
  splitOnTables: true  # 表格后分段
  includeContinuation: true  # 添加"续"标记

注意事项

1. 不要过度分段 - 能合并的内容尽量合并
2. 保持完整性 - 单个表格不要拆分
3. 添加续接标记 - 让用户知道还有下文
4. 重试机制 - 分段后仍失败则记录到失败队列

---

创建时间: 2026-03-10 创建者: 01-老鹰