feat: 导图生成支持携带同源报告作为参考

This commit is contained in:
2026-10-22 21:55:36 +08:00
parent 4aff5c03fe
commit 0c0c5be299
3 changed files with 118 additions and 31 deletions
+30
View File
@@ -43,6 +43,36 @@ describe("generateMindMapPrompt", () => {
expect(messages[1].content).toContain("corePoolSize");
expect(messages[1].content).not.toContain("学习报告");
});
it("没有报告时不带报告块与报告规则", () => {
const messages = generateMindMapPrompt("t", "", ["x"]);
expect(messages[0].content).not.toContain("参考报告规则");
expect(messages[1].content).not.toContain("参考报告");
});
it("携带报告时:碎片标注同源报告,报告三段进入上下文,并给出相关性约束", () => {
const messages = generateMindMapPrompt(
"Java 并发",
"",
[{ content: "corePoolSize 是核心线程数", reportRef: "S1" }],
[
{
ref: "S1",
taskName: "Java 并发",
sessionSummary: "线程池参数总结",
freeSummary: "还需补队列的取舍",
},
],
);
// 系统规则里说明「实质讨论/领域一致才用,否则完全不用」
expect(messages[0].content).toContain("域一致");
expect(messages[0].content).toContain("完全不要使用该报告");
// 用户上下文里碎片标注来源报告,并带上报告三段
expect(messages[1].content).toContain("来源报告:S1");
expect(messages[1].content).toContain("报告 S1");
expect(messages[1].content).toContain("会话摘要:线程池参数总结");
expect(messages[1].content).toContain("自由总结:还需补队列的取舍");
});
});
describe("guidancePrompt", () => {
+75 -27
View File
@@ -10,6 +10,23 @@ export interface FragmentInput {
createdTime?: string;
}
/** 导图生成的一条碎片素材:正文 + 可空的同源报告标识(报告-02) */
export interface MindMapFragmentInput {
content: string;
/** 同源报告标识(会话编号):该碎片与这份报告来自同一次学习会话 */
reportRef?: string;
}
/** 导图生成的一份报告参考上下文(报告-02):同源会话的总结三段 */
export interface MindMapReportInput {
ref: string;
/** 产生该报告的会话所属任务名,用于判断领域是否一致 */
taskName?: string;
sessionSummary?: string;
expectationVerdict?: string;
freeSummary?: string;
}
/**
* 残片聚合为结构化的学习报告草稿。
*
@@ -58,44 +75,75 @@ export function aggregateReportPrompt(
}
/**
* 从知识碎片生成标准思维导图(预留,用于替代 Java 端 BuiltinMindMapGenerator)。
* 从知识碎片生成标准思维导图(报告-02 起可携带报告作为参考上下文;预留,用于替代 Java 端 BuiltinMindMapGenerator)。
*
* <p>素材按**内容归属**给(一个任务名下的碎片),而不是按产生它的会话给:
* 学 A 时顺手记下的旁支知识若归属到 B,就应该出现在 B 的导图里。</p>
*
* <p>报告是同源会话的总结:一次总结可能把若干碎片拼接出新的定义与观点,
* 这些内容只存在于报告里。因此把与碎片同源的报告作为参考带上,但**是否采用由模型按相关性判断**:
* 报告必须实质讨论相关碎片的同一主题、且与本批碎片领域一致,才可提取;只是顺带提及或没提及则完全不用。</p>
*
* 输出为缩进大纲文本,与后端 MindMapTreeTool.parseOutline 格式一致。
*/
export function generateMindMapPrompt(
taskName: string,
taskDescription: string,
fragments: string[],
fragments: Array<string | MindMapFragmentInput>,
reports: MindMapReportInput[] = [],
): ChatMessage[] {
const fragmentItems: MindMapFragmentInput[] = fragments.map((f) =>
typeof f === "string" ? { content: f } : f,
);
const hasReports = reports.length > 0;
const systemRules = [
"你是一名知识结构整理助手。请阅读某个学习任务名下的全部知识碎片,",
"将这些碎片整理成一份思维导图大纲。要求:",
"1. 第一行是导图根标题(任务主题);",
"2. 之后每行一个节点,用两个空格的缩进表示层级;",
"3. 按知识的内在结构组织(概念→细分→要点),不按时间顺序;",
"4. 合并重复的知识点;",
"5. 只基于给定内容,不补充外部知识;",
"6. 直接输出大纲,不要任何解释。",
];
if (hasReports) {
systemRules.push(
"参考报告规则(这些报告是同源学习会话的总结,仅作参考):",
"7. 只有当某份报告实质地讨论了相关碎片的同一主题、且与本批碎片的领域一致时,",
" 才可提取报告中由碎片拼接出的新定义、新观点进入导图;",
"8. 报告只是顺带提及、或者根本没有提到该主题时,完全不要使用该报告的内容;",
"9. 报告与该批碎片的主干强相关时,可以参考它的组织结构,但不要照搬无关内容;",
"10. 不要引入碎片与报告都未涉及的知识。",
);
}
const fragmentLines = fragmentItems.map((fragment, i) => {
const source = fragment.reportRef ? `(来源报告:${fragment.reportRef})` : "";
return `${i + 1}. ${fragment.content}${source}`;
});
const userLines = [
`学习任务:${taskName}`,
taskDescription ? `任务描述:${taskDescription}` : "",
"",
"知识碎片:",
...fragmentLines,
];
if (hasReports) {
userLines.push("", "参考报告(是否采用见规则 7~10):");
for (const report of reports) {
userLines.push(`[报告 ${report.ref}]${report.taskName ? `(来自学习任务「${report.taskName}」)` : ""}`);
if (report.sessionSummary) userLines.push(`会话摘要:${report.sessionSummary}`);
if (report.expectationVerdict) userLines.push(`预期达成判断:${report.expectationVerdict}`);
if (report.freeSummary) userLines.push(`自由总结:${report.freeSummary}`);
}
}
return [
{
role: "system",
content: [
"你是一名知识结构整理助手。请阅读某个学习任务名下的全部知识碎片,",
"将这些碎片整理成一份思维导图大纲。要求:",
"1. 第一行是导图根标题(任务主题);",
"2. 之后每行一个节点,用两个空格的缩进表示层级;",
"3. 按知识的内在结构组织(概念→细分→要点),不按时间顺序;",
"4. 合并重复的知识点;",
"5. 只基于给定内容,不补充外部知识;",
"6. 直接输出大纲,不要任何解释。",
].join(""),
},
{
role: "user",
content: [
`学习任务:${taskName}`,
taskDescription ? `任务描述:${taskDescription}` : "",
"",
"知识碎片:",
...fragments.map((r, i) => `${i + 1}. ${r}`),
]
.filter(Boolean)
.join("\n"),
},
{ role: "system", content: systemRules.join("") },
{ role: "user", content: userLines.filter(Boolean).join("\n") },
];
}
+13 -4
View File
@@ -15,7 +15,14 @@ import { randomUUID, createHash } from "node:crypto";
import { chat, isAvailable, loadConfig, LlmError, type ChatMessage, type ChatOptions } from "./llm/client.js";
import { accumulateUsage, combineSource, emptyUsage, type TokenUsage, type UsageSource } from "./llm/usage.js";
import { withRetry, isRetryableLlmError, type RetryOptions } from "./llm/retry.js";
import { aggregateReportPrompt, compareRecallPrompt, generateMindMapPrompt, guidancePrompt } from "./llm/prompts.js";
import {
aggregateReportPrompt,
compareRecallPrompt,
generateMindMapPrompt,
guidancePrompt,
type MindMapFragmentInput,
type MindMapReportInput,
} from "./llm/prompts.js";
import { loadThinkingConfig, promptLength, reasoningEffortFor, type ThinkingConfig } from "./llm/thinking.js";
import { logStore } from "./admin/store.js";
import { loadPricingConfig, priceUsage, type PricingSnapshot } from "./admin/pricing.js";
@@ -565,12 +572,14 @@ export function buildMessages(task: TaskRecord): ChatMessage[] {
);
}
case "generate-mind-map": {
// 素材为「该任务名下的知识碎片」(按内容归属取),不再用按会话产生的报告
const fragments = p.fragments as string[] | undefined;
// 素材为「该任务名下的知识碎片」(按内容归属取),并携带同源会话的报告作为参考(报告-02)
const fragments = (p.fragments as Array<string | MindMapFragmentInput> | undefined) ?? [];
const reports = (p.reports as MindMapReportInput[] | undefined) ?? [];
return generateMindMapPrompt(
p.taskName as string,
(p.taskDescription as string) ?? "",
fragments ?? [],
fragments,
reports,
);
}
case "guidance": {