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": {