feat: 导图改用知识碎片素材并输出结构化报告草稿

This commit is contained in:
2026-10-09 19:12:04 +08:00
parent 1c3168277d
commit e359e58ff2
4 changed files with 113 additions and 30 deletions
+5 -4
View File
@@ -32,14 +32,15 @@ describe("aggregateReportPrompt", () => {
});
describe("generateMindMapPrompt", () => {
it("要求输出缩进大纲且只包含学习报告", () => {
it("要求输出缩进大纲,素材是该任务名下的知识碎片", () => {
const messages = generateMindMapPrompt(
"Java 并发",
"并发编程学习",
["报告一"],
["corePoolSize 是核心线程数"],
);
expect(messages[0].content).toContain("缩进");
expect(messages[1].content).toContain("报告一");
expect(messages[1].content).not.toContain("学习残片");
expect(messages[0].content).toContain("知识碎片");
expect(messages[1].content).toContain("corePoolSize");
expect(messages[1].content).not.toContain("学习报告");
});
});
+30 -22
View File
@@ -11,9 +11,15 @@ export interface FragmentInput {
}
/**
* 残片聚合为学习报告。
* 原则:报告是写给"未来复习的自己"的,保留具体知识点,剔除口语碎屑;
* 不虚构残片中不存在的内容;对抽象概念补充正反例子以明确边界。
* 残片聚合为结构化的学习报告草稿。
*
* 报告形态是结构化的,AI 负责能由碎片推出的三段:
* 会话摘要(这次实际学了什么)、预期达成判断、自由总结草稿。
* 第四段「按归属分组的碎片」由后端按内容归属实时聚合,不需要 AI 输出。
*
* 输出要求:严格 JSON,不要 markdown 代码块,格式如下:
* {"sessionSummary":"...","expectationVerdict":"...","freeSummary":"..."}
* 没有依据的字段输出空字符串,不要编造。
*/
export function aggregateReportPrompt(
taskName: string,
@@ -32,42 +38,44 @@ export function aggregateReportPrompt(
{
role: "system",
content: [
"你是一名学习记录整理助手。用户在一次学习会话中随手记录了若干学习残片,",
"请将它们整理为一份简洁的学习报告。要求:",
"1. 只基于残片内容,不虚构残片中不存在的知识;",
"2. 保留具体的知识点、概念、结论,去掉口语化的碎屑;",
"3. 对残片中的抽象概念或知识,除定义/要点外,再补充一组正反例子,",
" 用「是X:…;不是X:…」的形式列出具体具象,帮助明确概念边界;",
" 例如:奇数(也叫单数)是不能被 2 整除的整数;是奇数:1、3、5、7;不是奇数:2、4、6、8;",
" 例子只用于解释残片已有的抽象内容,不引入新的知识点;",
"4. 按逻辑而非时间组织内容,相关的点合并;",
"5. 报告以要点形式呈现,因包含示例,目标 600 字左右,不超过 1000 字;",
"6. 如果提供了学习预期,在报告末尾用一句话说明本次学习与预期的差距(完成/部分完成/未涉及);",
"7. 直接输出报告正文,不要输出「报告如下」之类的引导语。",
"你是一名学习记录整理助手。用户在一次学习会话中随手记录了若干知识碎片,",
"请据此生成一份结构化学习报告草稿,只输出严格 JSON,不要 markdown 代码块、不要解释。",
"JSON 字段:",
'1. "sessionSummary":会话摘要,说明这次实际学了什么。按逻辑组织、合并相关要点,保留具体知识点,',
" 去掉口语化碎屑;对抽象概念可用「是X:…;不是X:…」补一组具体例子帮自己以后看懂边界。",
'2. "expectationVerdict":预期达成判断,对照给定的学习预期用一两句话判断完成情况',
" (完全达成/部分达成/未涉及)。没有提供学习预期时输出空字符串。",
'3. "freeSummary":自由总结草稿。只写能从碎片推断出的疑问、卡点与可能的下一步;',
" 没有依据就输出空字符串,不要编造。用户会在此基础上修改。",
"硬性要求:只基于给定碎片,不虚构不存在的知识;所有字段都必须是字符串。",
].join(""),
},
{
role: "user",
content: `学习任务:${taskName}\n${expectationBlock}\n本次学习的残片记录:\n${fragmentLines}`,
content: `学习任务:${taskName}\n${expectationBlock}\n本次学习记录的知识碎片:\n${fragmentLines}`,
},
];
}
/**
* 从学习报告生成标准思维导图(预留,用于替代 Java 端 BuiltinMindMapGenerator)。
* 从知识碎片生成标准思维导图(预留,用于替代 Java 端 BuiltinMindMapGenerator)。
*
* <p>素材按**内容归属**给(一个任务名下的碎片),而不是按产生它的会话给:
* 学 A 时顺手记下的旁支知识若归属到 B,就应该出现在 B 的导图里。</p>
*
* 输出为缩进大纲文本,与后端 MindMapTreeTool.parseOutline 格式一致。
*/
export function generateMindMapPrompt(
taskName: string,
taskDescription: string,
reports: string[],
fragments: string[],
): ChatMessage[] {
return [
{
role: "system",
content: [
"你是一名知识结构整理助手。请阅读某个学习任务的全部学习报告,",
"将其中的知识点整理成一份思维导图大纲。要求:",
"你是一名知识结构整理助手。请阅读某个学习任务名下的全部知识碎片,",
"将这些碎片整理成一份思维导图大纲。要求:",
"1. 第一行是导图根标题(任务主题);",
"2. 之后每行一个节点,用两个空格的缩进表示层级;",
"3. 按知识的内在结构组织(概念→细分→要点),不按时间顺序;",
@@ -82,8 +90,8 @@ export function generateMindMapPrompt(
`学习任务:${taskName}`,
taskDescription ? `任务描述:${taskDescription}` : "",
"",
"学习报告:",
...reports.map((r, i) => `${i + 1}. ${r}`),
"知识碎片:",
...fragments.map((r, i) => `${i + 1}. ${r}`),
]
.filter(Boolean)
.join("\n"),