gonglingrui/text-truncator

文本截断工具

功能

智能截断文本，在保持内容完整性和语义连贯性的前提下，将文本截断至指定长度。

使用场景

• 对超出长度限制的文本进行预处理，使其符合智能体的输入要求。
• 在展示文本预览或生成摘要时，截取关键部分以提高效率和可读性。
• 辅助内容创作，对生成的长文本进行智能裁剪，避免冗余。

核心能力

• 语义优先截断: 优先在自然语义边界（如句号、问号、感叹号）处进行截断，最大限度地保持句子的完整性。
• 段落完整性: 在语义边界不足时，优先考虑在段落末尾或换行符处截断，避免破坏段落结构。
• 精确长度控制: 严格遵守用户指定的最大长度限制，确保输出文本不会超限。
• 截断标记插入（可选）: 可以在截断文本的末尾自动添加自定义截断标记（如"..."），以指示内容有删节。

输入要求

• 文本内容: 待截断的原始文本（字符串）。
• 最大长度限制: 文本截断后的最大长度（整数，如字符数或 token 数）。
• 截断标记（可选）: 自定义截断标记，如 "..." 或 "[内容已截断]"。

输出格式

【文本截断报告】

- 原始文本长度: [整数] 字/Token
- 截断后长度: [整数] 字/Token
- 截断位置: [位置描述，如 "在第X句末尾"] 或 "未截断"

### 截断后的文本
[截断后的文本内容]

约束条件

• 截断后的文本长度必须严格符合最大长度限制。
• 确保截断后的文本在语义上尽可能连贯和完整。
• 如果文本未达到最大长度，则不进行截断，返回原始文本。
• 输出格式必须结构化，清晰展示截断前后的长度信息和截断后的文本内容。

示例

参见 {baseDir}/references/examples.md 目录获取更多详细示例:

• examples.md - 包含不同长度、不同截断标记和复杂文本结构的截断示例。

详细文档

参见 {baseDir}/references/examples.md 获取关于文本截断工具的详细指导与案例。

版本历史

| 版本 | 日期 | 变更 | |------|------|------| | 2.1.0 | 2026-01-11 | 优化 description 字段，使其更精简并符合命令式语言规范；模型更改为 opus；优化功能、核心能力、输入要求、输出格式的描述，使其更符合命令式语言规范；添加使用场景、约束条件、示例和详细文档部分。 | | 2.0.0 | 2026-01-11 | 按官方规范重构 | | 1.0.0 | 2026-01-10 | 初始版本 |