feat: 报告结构支持检索方向/来源与智能新增,并修复协助卡停轮与宿主跳转

为深度研究报告结构增加检索方向与技能来源、对话式智能新增页与详情排版;澄清中间件在 after_model 可靠结束本轮,避免弱模型出卡后继续生成;任务按钮补充 host 跳转与相关深链能力。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
董宏凯andCursor committed 2026-08-22 17:46:06 +08:00
1 parent a5a9c952e8
commit 51afebb394
67 files changed
+4511 -699

No files matched your search

@@ -646,7 +646,7 @@ export async function listReportVariants(parentSessionId: string): Promise<DeepR
*/
export async function createResearchReportVariant(
sessionId: string,
input: { reportOutline?: string },
input: { reportOutline?: string; structureMode?: "fixed" | "adaptive" },
): Promise<DeepResearchSession> {
const response = await apiFetch(
`${BASE()}/sessions/${encodeURIComponent(sessionId)}/report-variants`,
@@ -860,6 +860,7 @@ export async function* streamFullResearchReportRewrite(
style: DocumentRewriteStyle;
modelName?: string;
reportOutline?: string;
structureMode?: "fixed" | "adaptive";
},
signal?: AbortSignal,
onJobStarted?: (jobId: string) => void,
@@ -16,6 +16,128 @@ import {
import { apiFetch } from "@/core/api/fetch-client";
import { getBackendBaseURL } from "@/core/config";
export type ReportStructureMode = "fixed" | "adaptive";
export const DEFAULT_REPORT_STRUCTURE_MODE: ReportStructureMode = "adaptive";
export const REPORT_STRUCTURE_MODE_OPTIONS: {
value: ReportStructureMode;
label: string;
description: string;
}[] = [
{
value: "fixed",
label: "固定大纲",
description: "按结构内容的章节标题与层级逐一成文,不得改写、合并或省略。",
},
{
value: "adaptive",
label: "弹性大纲",
description: "保留现有成文策略,可按材料对无依据小节做合并或省略。",
},
];
export function normalizeReportStructureMode(value: unknown): ReportStructureMode {
return value === "fixed" ? "fixed" : "adaptive";
}
export function reportStructureModeLabel(mode: ReportStructureMode): string {
return mode === "fixed" ? "固定大纲" : "弹性大纲";
}
export const MAX_RETRIEVAL_DIRECTIONS = 12;
export const MAX_RETRIEVAL_DIRECTION_CHARS = 200;
export const MAX_RETRIEVAL_SKILLS = 8;
export const MAX_RETRIEVAL_SKILL_CHARS = 64;
const EMPTY_LIST_TOKENS = new Set(["", "[]", "{}", "null", "none", "undefined"]);
function coerceListish(value: unknown): unknown[] {
if (value == null || typeof value === "boolean") return [];
if (Array.isArray(value)) return value;
if (typeof value === "string") {
const text = value.trim();
if (!text || EMPTY_LIST_TOKENS.has(text.toLowerCase())) return [];
if (text.startsWith("[") || text.startsWith("{")) {
try {
const parsed = JSON.parse(text) as unknown;
if (parsed == null) return [];
if (Array.isArray(parsed)) return parsed;
return [];
} catch {
return [value];
}
}
return [value];
}
return [];
}
export function normalizeRetrievalDirections(value: unknown): string[] {
const parts = coerceListish(value);
const seen = new Set<string>();
const out: string[] = [];
for (const item of parts) {
const text = String(item ?? "")
.replace(/\s+/g, " ")
.trim()
.slice(0, MAX_RETRIEVAL_DIRECTION_CHARS);
if (!text || EMPTY_LIST_TOKENS.has(text.toLowerCase())) continue;
const key = text.toLowerCase();
if (seen.has(key)) continue;
seen.add(key);
out.push(text);
if (out.length >= MAX_RETRIEVAL_DIRECTIONS) break;
}
return out;
}
export function normalizeRetrievalSkills(value: unknown): string[] {
const parts = coerceListish(value);
const seen = new Set<string>();
const out: string[] = [];
for (const item of parts) {
const text = String(item ?? "")
.replace(/[\x00\r\n]/g, "")
.trim()
.slice(0, MAX_RETRIEVAL_SKILL_CHARS);
if (!text || EMPTY_LIST_TOKENS.has(text.toLowerCase()) || /\s/.test(text)) continue;
const key = text.toLowerCase();
if (seen.has(key)) continue;
seen.add(key);
out.push(text);
if (out.length >= MAX_RETRIEVAL_SKILLS) break;
}
return out;
}
const COLLECTOR_DIRECTION_INTRO =
"请按以下检索方向拆分检索词(这是拆词约束,不是检索词本身):每个方向拆成若干具体、可检索的检索词(含课题中的专名、时间、地点、同义/中英对照等),不要直接把方向名称拿去搜索——方向标签往往搜不到结果。覆盖列出的每一个方向;未列出的方面不必主动扩展。某个检索词没有结果时,换更具体或更短的词再试,仍不要改用未列出的方向。";
const COLLECTOR_SKILL_INTRO =
"请严格按照以下技能收集素材:先用 read_file 读取每个技能的 SKILL.md,再按其说明调用工具检索。不要改用未列出的技能,也不要自行改成纯 web_search(除非技能说明要求联网)。每个技能至少使用一轮。";
/** First collector turn: append direction / skill blocks only when they exist. */
export function composeCollectorQueryWithDirections(
query: string,
directions: unknown,
skills?: unknown,
): string {
let topic = query.trim();
if (!topic) return topic;
const cleanedDirections = normalizeRetrievalDirections(directions);
if (cleanedDirections.length > 0 && !topic.includes("<retrieval-directions>")) {
const lines = cleanedDirections.map((item, index) => `${index + 1}. ${item}`).join("\n");
topic = `${topic}\n\n<retrieval-directions>\n${COLLECTOR_DIRECTION_INTRO}\n${lines}\n</retrieval-directions>`;
}
const cleanedSkills = normalizeRetrievalSkills(skills);
if (cleanedSkills.length > 0 && !topic.includes("<retrieval-skills>")) {
const lines = cleanedSkills.map((item, index) => `${index + 1}. ${item}`).join("\n");
topic = `${topic}\n\n<retrieval-skills>\n${COLLECTOR_SKILL_INTRO}\n${lines}\n</retrieval-skills>`;
}
return topic;
}
export interface ReportStructure {
id: string;
/** 标题:卡片主标签,也是列表「标题筛选」的目标。 */
@@ -24,6 +146,12 @@ export interface ReportStructure {
name: string;
/** 接口内容:选中卡片后应用到报告结构(custom_outline)的 Markdown 文本。 */
content: string;
/** 结构约束:固定大纲逐章对照;弹性大纲沿用现有材料驱动写法。 */
structureMode: ReportStructureMode;
/** 检索方向:选中后收集员按这些方向拆分具体检索词;空则沿用收集员自行拆词。 */
retrievalDirections: string[];
/** 检索来源:选中后收集素材调用这些技能;空则沿用收集员默认工具。 */
retrievalSkills: string[];
enabled: boolean;
/** 创建用户名(本部署为邮箱;系统内置种子为“系统内置”)。 */
createdBy: string | null;
@@ -36,6 +164,9 @@ export type ReportStructureInput = {
title: string;
name: string;
content: string;
structureMode: ReportStructureMode;
retrievalDirections: string[];
retrievalSkills: string[];
};
export type ReportStructurePatch = Partial<ReportStructureInput>;
@@ -49,6 +180,9 @@ interface ServerStructure {
title: string;
name: string;
content: string;
structure_mode?: string | null;
retrieval_directions?: string[] | null;
retrieval_skills?: string[] | null;
enabled: boolean;
created_by: string | null;
created_at: string | null;
@@ -61,6 +195,9 @@ function toStructure(s: ServerStructure): ReportStructure {
title: s.title,
name: s.name ?? "",
content: s.content,
structureMode: normalizeReportStructureMode(s.structure_mode),
retrievalDirections: normalizeRetrievalDirections(s.retrieval_directions),
retrievalSkills: normalizeRetrievalSkills(s.retrieval_skills),
enabled: s.enabled ?? true,
createdBy: s.created_by ?? null,
createdAt: s.created_at ?? null,
@@ -99,7 +236,14 @@ export async function createReportStructure(input: ReportStructureInput): Promis
const res = await apiFetch(BASE(), {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ title: input.title, name: input.name, content: input.content }),
body: JSON.stringify({
title: input.title,
name: input.name,
content: input.content,
structure_mode: normalizeReportStructureMode(input.structureMode),
retrieval_directions: normalizeRetrievalDirections(input.retrievalDirections),
retrieval_skills: normalizeRetrievalSkills(input.retrievalSkills),
}),
});
return toStructure(await readJson<ServerStructure>(res, "create report structure"));
}
@@ -112,6 +256,13 @@ export async function updateReportStructure(
if (patch.title !== undefined) body.title = patch.title;
if (patch.name !== undefined) body.name = patch.name;
if (patch.content !== undefined) body.content = patch.content;
if (patch.structureMode !== undefined) body.structure_mode = normalizeReportStructureMode(patch.structureMode);
if (patch.retrievalDirections !== undefined) {
body.retrieval_directions = normalizeRetrievalDirections(patch.retrievalDirections);
}
if (patch.retrievalSkills !== undefined) {
body.retrieval_skills = normalizeRetrievalSkills(patch.retrievalSkills);
}
const res = await apiFetch(`${BASE()}/${encodeURIComponent(id)}`, {
method: "PUT",
headers: { "Content-Type": "application/json" },
@@ -10,6 +10,7 @@
import { useEffect, useMemo, useState } from "react";
import { useNavigate } from "react-router-dom";
import {
AppWindow,
ArrowLeft,
ArrowRight,
ExternalLink,
@@ -257,6 +258,7 @@ function TaskSideJumpMenu({
function renderTaskJumpIcon(btn: TaskButton, className: string) {
if (btn.linkType === "url") return <ExternalLink className={className} />;
if (btn.linkType === "host") return <AppWindow className={className} />;
if (btn.linkType === "purpose") return <Maximize2 className={className} />;
return <ArrowRight className={className} />;
}
@@ -264,6 +266,7 @@ function renderTaskJumpIcon(btn: TaskButton, className: string) {
function renderRoundtableMenuIcon(btn: TaskButton) {
const className = "h-4 w-4";
if (btn.linkType === "purpose") return <Maximize2 className={className} />;
if (btn.linkType === "host") return <AppWindow className={className} />;
if (btn.linkType === "url") return <FileSearch className={className} />;
if (btn.target === "3qfx") return <Network className={className} />;
if (btn.target === "xdfx") return <Workflow className={className} />;
@@ -272,6 +275,12 @@ function renderRoundtableMenuIcon(btn: TaskButton) {
}
function getRoundtableMenuTone(btn: TaskButton) {
if (btn.linkType === "host") {
return {
item: "hover:text-indigo-700 dark:hover:text-indigo-100",
icon: "bg-indigo-50 text-indigo-600 dark:bg-indigo-400/10 dark:text-indigo-200",
};
}
if (btn.linkType === "url") {
return {
item: "hover:text-rose-700 dark:hover:text-rose-100",