From 0c0c5be299b2bad2be91f7b1e87e0df5e1d39c1f Mon Sep 17 00:00:00 2001
From: cat-shark <1716967236@qq.com>
Date: Thu, 22 Oct 2026 21:55:36 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AF=BC=E5=9B=BE=E7=94=9F=E6=88=90?=
=?UTF-8?q?=E6=94=AF=E6=8C=81=E6=90=BA=E5=B8=A6=E5=90=8C=E6=BA=90=E6=8A=A5?=
=?UTF-8?q?=E5=91=8A=E4=BD=9C=E4=B8=BA=E5=8F=82=E8=80=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
src/llm/prompts.test.ts | 30 ++++++++++++
src/llm/prompts.ts | 102 +++++++++++++++++++++++++++++-----------
src/task-queue.ts | 17 +++++--
3 files changed, 118 insertions(+), 31 deletions(-)
diff --git a/src/llm/prompts.test.ts b/src/llm/prompts.test.ts
index 0532de0..f79cb16 100644
--- a/src/llm/prompts.test.ts
+++ b/src/llm/prompts.test.ts
@@ -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", () => {
diff --git a/src/llm/prompts.ts b/src/llm/prompts.ts
index 135ac00..e2f8844 100644
--- a/src/llm/prompts.ts
+++ b/src/llm/prompts.ts
@@ -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)。
*
*
素材按**内容归属**给(一个任务名下的碎片),而不是按产生它的会话给:
* 学 A 时顺手记下的旁支知识若归属到 B,就应该出现在 B 的导图里。
*
+ * 报告是同源会话的总结:一次总结可能把若干碎片拼接出新的定义与观点,
+ * 这些内容只存在于报告里。因此把与碎片同源的报告作为参考带上,但**是否采用由模型按相关性判断**:
+ * 报告必须实质讨论相关碎片的同一主题、且与本批碎片领域一致,才可提取;只是顺带提及或没提及则完全不用。
+ *
* 输出为缩进大纲文本,与后端 MindMapTreeTool.parseOutline 格式一致。
*/
export function generateMindMapPrompt(
taskName: string,
taskDescription: string,
- fragments: string[],
+ fragments: Array,
+ 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") },
];
}
diff --git a/src/task-queue.ts b/src/task-queue.ts
index 5555d85..0741ecc 100644
--- a/src/task-queue.ts
+++ b/src/task-queue.ts
@@ -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 | undefined) ?? [];
+ const reports = (p.reports as MindMapReportInput[] | undefined) ?? [];
return generateMindMapPrompt(
p.taskName as string,
(p.taskDescription as string) ?? "",
- fragments ?? [],
+ fragments,
+ reports,
);
}
case "guidance": {