1) 函数基本信息
- 函数名称：generate_summary_cn
- 参数说明：
- text: String，50-5000字中文正文，可含标题/正文/标点/括号/英文缩写/百分比/表格符号；需先去除多余空白后参与处理
- target_length: Integer，目标摘要字数，取值80-180，超界需钳制到[80,180]
- style: String，取值为“简洁”/“资讯”/“科普”，控制措辞与信息密度
- focus_keywords: String[]，0-5项，需去重后不超过5个，优先覆盖的主题词
- language: String，固定“zh-CN”
- 返回值类型：String（UTF-8），单段输出，中文标点规范化，无多余换行或前后空格
2) 测试场景总览
- P0（核心功能/高风险）
- 正常流程：资讯风格，120字目标，包含关键词且覆盖动作事实
- 目标字数下限钳制：target_length=50 → 钳制到80并满足容差
- 目标字数上限钳制：target_length=200 → 钳制到180并满足容差
- 文本清洗：重复段落与广告噪声去除
- 英文缩写与百分比保留：如 LEO、25%
- 结尾不完整：合理收束，避免续写新事实，句末规范
- 返回值格式：单段、UTF-8可编码、无首尾空格、无换行
- 性能：1200字在300ms内完成，内存占用<20MB（以增量近似）
- P1（重要但次优先）
9. 风格变体：简洁
10. 风格变体：科普
11. 语言固定：zh-CN 正常通过
12. 语言非法值：传入非 zh-CN 亦应容错地返回中文摘要
13. 文本长度下界：50字输入可正常输出
14. 文本长度上界：5000字输入可正常输出（不强制性能断言）
3) 详细测试用例
// __tests__/generate_summary_cn.spec.ts
import { generate_summary_cn } from "../src/generate_summary_cn";
const CN_PERIOD = "。";
function includesOne(s: string, arr: string[]) {
return arr.some(k => s.includes(k));
}
function isSingleParagraph(s: string) {
return !/\r|\n/.test(s);
}
function inRange(len: number, target: number, tolerance = 20) {
return len >= target - tolerance && len <= target + tolerance;
}
function clampTarget(t: number) {
return Math.min(180, Math.max(80, t));
}
function hasChinese(s: string) {
return /[\u4e00-\u9fa5]/.test(s);
}
function makeBaseParagraph(): string {
return "【标题】新一代气象卫星发射及在轨测试进展。2025年11月18日08时36分，海南文昌航天发射场由长征七号运载火箭成功发射“天穹一号”气象卫星，进入LEO近地轨道（高度700km），由中国航天科技集团五院研制。卫星搭载X-Band载荷，成像分辨率达到10m，数据下行速率提升25%。后续开展在轨测试，验证姿态控制与热控指标。任务指挥部宣布发射圆满成功。";
}
function makeNoisyParagraph(): string {
return makeBaseParagraph() + " 点击阅读原文了解更多，扫描二维码参与活动！重复：任务指挥部宣布发射圆满成功。";
}
function repeatToLength(seed: string, minLen: number): string {
let s = seed;
while (s.length < minLen) s += " " + seed;
return s;
}
const text_1200 = (() => {
// 包含重复段落与噪声
const p1 = makeBaseParagraph();
const p2 = makeNoisyParagraph();
const corpus = (p1 + " " + p2 + " " + p1 + " " + p2);
return repeatToLength(corpus, 1200).replace(/\s+/g, " ");
})();
const text_800 = repeatToLength(makeBaseParagraph(), 800);
const text_50 = "2025年11月，文昌成功发射气象卫星，进入轨道，任务顺利推进。";
const text_5000 = repeatToLength(makeNoisyParagraph(), 5000);
const compact_core_text = "2025年11月18日，文昌发射新一代气象卫星，进入LEO轨道，高度700km，X-Band载荷稳定，数据下行速率提升25%，在轨测试验证姿态与热控，发射圆满成功。";
describe("generate_summary_cn 基础功能与边界", () => {
test("TC01 正常流程_资讯风格_120字_包含关键词与动作", async () => {
const kw = ["气象","卫星","轨道"];
const target = 120;
const res = await generate_summary_cn(text_1200, target, "资讯", kw, "zh-CN");
expect(typeof res).toBe("string");
expect(isSingleParagraph(res)).toBe(true);
expect(res.trim()).toBe(res);
expect(inRange(res.length, target, 20)).toBe(true);
expect(includesOne(res, kw)).toBe(true);
expect(includesOne(res, ["发射","在轨","测试"])).toBe(true);
expect(res.endsWith(CN_PERIOD)).toBe(true);
});
test("TC02 目标字数下限钳制_50→80", async () => {
const target = 50;
const clamped = clampTarget(target);
const res = await generate_summary_cn(text_800, target, "资讯", [], "zh-CN");
expect(inRange(res.length, clamped, 20)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
expect(res.endsWith(CN_PERIOD)).toBe(true);
});
test("TC03 目标字数上限钳制_200→180", async () => {
const target = 200;
const clamped = clampTarget(target);
const res = await generate_summary_cn(text_1200, target, "资讯", [], "zh-CN");
expect(inRange(res.length, clamped, 20)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
expect(res.endsWith(CN_PERIOD)).toBe(true);
});
test("TC04 关键词去重与上限截断", async () => {
const kw = ["气象","卫星","轨道","卫星","在轨","发射","卫星"];
const res = await generate_summary_cn(text_1200, 120, "资讯", kw, "zh-CN");
expect(typeof res).toBe("string");
expect(includesOne(res, ["气象","卫星","轨道","在轨","发射"])).toBe(true);
expect(inRange(res.length, 120, 20)).toBe(true);
});
test("TC05 文本清洗_去重与去广告", async () => {
const res = await generate_summary_cn(text_1200, 120, "资讯", ["气象","卫星"], "zh-CN");
expect(res.includes("点击阅读原文")).toBe(false);
expect(res.includes("扫描二维码")).toBe(false);
expect(isSingleParagraph(res)).toBe(true);
expect(inRange(res.length, 120, 20)).toBe(true);
});
test("TC06 英文缩写与百分比保留", async () => {
const res = await generate_summary_cn(compact_core_text, 120, "资讯", ["卫星","LEO"], "zh-CN");
expect(res.includes("LEO")).toBe(true);
expect(res.includes("25%")).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
expect(inRange(res.length, 120, 20)).toBe(true);
});
test("TC07 结尾不完整_合理收束并以句号结束", async () => {
const truncated_text = text_800.slice(0, 600); // 人为截断
const res = await generate_summary_cn(truncated_text, 120, "资讯", ["卫星"], "zh-CN");
expect(res.endsWith(CN_PERIOD)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
});
test("TC08 返回值格式_单段无首尾空格无换行_UTF-8可编码", async () => {
const res = await generate_summary_cn(text_800, 120, "资讯", [], "zh-CN");
expect(typeof res).toBe("string");
expect(res.trim()).toBe(res);
expect(isSingleParagraph(res)).toBe(true);
// UTF-8 可编码
const buf = Buffer.from(res, "utf8");
expect(buf.length).toBeGreaterThan(0);
});
test("TC09 性能_1200字_300ms_内存<20MB", async () => {
jest.setTimeout(1000);
const before = process.memoryUsage().heapUsed;
const t0 = Date.now();
const res = await generate_summary_cn(text_1200, 120, "资讯", ["气象","卫星","轨道"], "zh-CN");
const t1 = Date.now();
const after = process.memoryUsage().heapUsed;
const delta = Math.max(0, after - before);
expect(typeof res).toBe("string");
expect(t1 - t0).toBeLessThan(300);
expect(delta).toBeLessThan(20 * 1024 * 1024);
});
test("TC10 风格变体_简洁", async () => {
const res = await generate_summary_cn(text_800, 120, "简洁", ["卫星"], "zh-CN");
expect(isSingleParagraph(res)).toBe(true);
expect(inRange(res.length, 120, 20)).toBe(true);
});
test("TC11 风格变体_科普", async () => {
const res = await generate_summary_cn(text_800, 120, "科普", ["卫星"], "zh-CN");
expect(isSingleParagraph(res)).toBe(true);
expect(inRange(res.length, 120, 20)).toBe(true);
});
test("TC12 语言参数固定_zh-CN", async () => {
const res = await generate_summary_cn(text_800, 120, "资讯", ["卫星"], "zh-CN");
expect(hasChinese(res)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
});
test("TC13 语言参数非法值_仍返回中文摘要", async () => {
const res = await generate_summary_cn(text_800, 120, "资讯", ["卫星"], "en-US" as any);
expect(hasChinese(res)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
});
test("TC14 文本长度下界_50字", async () => {
const res = await generate_summary_cn(text_50, 80, "资讯", ["卫星"], "zh-CN");
expect(inRange(res.length, 80, 20)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
});
test("TC15 文本长度上界_5000字", async () => {
const res = await generate_summary_cn(text_5000, 180, "资讯", ["气象","卫星","轨道"], "zh-CN");
expect(inRange(res.length, 180, 20)).toBe(true);
expect(isSingleParagraph(res)).toBe(true);
});
});
4) 测试覆盖分析
- 关键路径覆盖
- 正常摘要生成：TC01
- 目标长度钳制上下界：TC02、TC03
- 关键词处理与优先覆盖：TC04、TC01
- 文本清洗（去重/去广告）：TC05
- 事实保留（英文缩写/百分比）：TC06
- 不完整文本收束：TC07
- 返回值约束（单段/无空白/UTF-8）：TC08
- 性能与内存：TC09
- 风格参数三种取值：TC01/TC10/TC11
- 语言固定与容错：TC12/TC13
- 输入文本长度边界：TC14/TC15
- 风险点说明
- 摘要长度容差实现易波动：通过区间断言（±20）降低偶发失败风险
- 文本清洗去广告规则差异：断言常见广告词不出现
- 性能/内存环境敏感：以增量近似评估，防止受进程基线影响
- 专有名词与数字保留：通过最小信息载体文本（compact_core_text）强制其成为核心
5) 执行建议
- 测试执行顺序（推荐）
- 基础正确性：TC01 → TC08
- 性能与资源：TC09
- 风格与语言：TC10 → TC13
- 边界长度：TC14 → TC15
- 环境要求
- Node.js >= 18，TypeScript >= 4.9（若使用 TS）
- 测试框架：Jest >= 29
- 代码结构：src/generate_summary_cn.ts 实现；测试文件放置于 tests/ 目录
- 建议本地独立进程运行，避免与其他内存密集任务并发，确保性能数据稳定
