@waterwx/dsh-novel-forge 1.7.0 → 1.7.2

package/lib/index.js

@@ -950,6 +950,7 @@ function mergeVolatileFromDisk(outputDir, project) {
 		if (disk === void 0) return;
 		project.bible = disk.bible;
 		project.roles = disk.roles;
+		project.mangaRoles = disk.mangaRoles;
 		project.plotlines = disk.plotlines;
 		project.roleStatus = disk.roleStatus;
 		project.blurb = disk.blurb;
@@ -2023,8 +2024,9 @@ async function refreshPlotlineProgress(ctx, config, project, line) {
 async function extractRoles(ctx, config, project) {
 	const system = [
 		"你是一位网文角色库管理员。请根据本书的大纲、设定、编年录与章节摘要，提炼完整的角色库。",
-		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注。",
-		"数量控制：最多输出 10 个角色，宁缺毋滥；路人级一次带过的不要收录。",
+		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注；反复出现且有剧情作用的身份型角色（站长、律师、警察、法官、店主等）必须收录。",
+		"数量控制：最多输出 10 个角色；覆盖优先——主角、主要反派、重要配角（女主/关键配角）必须全收，所有有名有姓者必收；只有真正一次性路人（无名字、无剧情作用）才可省略。",
+		"重要：正常一部完整故事应提炼 6-10 个角色；若少于 4 个通常说明漏提炼，必须重新核对正文摘录。",
 		"重要：正文中若有明确的主角与主要反派，必须分别以 protagonist / antagonist 收录，禁止遗漏；反派确实未出场时才可省略。",
 		"输出优先级：主角（protagonist）与主要反派（antagonist）必须优先输出并完整刻画，其次女主/重要配角；判断不出名字时用正文中的身份称呼。",
 		"每个角色输出：",
@@ -2078,9 +2080,10 @@ async function extractRoles(ctx, config, project) {
 	});
 	let raw = parseJsonArray(text);
 	const hasProtagonist = raw.some((e) => typeof e === "object" && e !== null && e.roleLabel === "protagonist");
-	if (raw.length === 0 || !hasProtagonist) {
+	const tooFew = raw.length > 0 && raw.length < 4;
+	if (raw.length === 0 || !hasProtagonist || tooFew) {
 		text = await complete(ctx, config, {
-			system: system + (raw.length === 0 ? "\n上一次输出为空或格式不正确。请直接输出 JSON 数组（即使只有一个角色也要输出），不要输出其他文字。" : "\n上一次输出中缺少主角（roleLabel 为 protagonist 的角色）。请重新输出完整 JSON 数组，务必包含正文中的主角。"),
+			system: system + (raw.length === 0 ? "\n上一次输出为空或格式不正确。请直接输出 JSON 数组（即使只有一个角色也要输出），不要输出其他文字。" : tooFew ? "\n上一次输出角色过少（不足 4 个）。这是一部完整故事，请重新核对正文摘录：主角、主要反派、重要配角与所有有名有姓的角色都要收录（宁多勿漏），输出 6-10 个。" : "\n上一次输出中缺少主角（roleLabel 为 protagonist 的角色）。请重新输出完整 JSON 数组，务必包含正文中的主角。"),
 			user,
 			temperature: .3,
 			maxTokens: Math.max(config.maxTokens, 24e3),
@@ -2097,12 +2100,11 @@ async function extractRoles(ctx, config, project) {
 		"extra"
 	]);
 	const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : [];
-	const roles = [];
-	for (const entry of raw) {
-		if (typeof entry !== "object" || entry === null) continue;
+	const toRole = (entry) => {
+		if (typeof entry !== "object" || entry === null) return void 0;
 		const name = typeof entry.name === "string" ? entry.name.trim().slice(0, 30) : "";
-		if (name === "") continue;
-		roles.push({
+		if (name === "") return void 0;
+		return {
 			name,
 			roleLabel: labels.has(entry.roleLabel) ? entry.roleLabel : "support",
 			identity: typeof entry.identity === "string" ? entry.identity.slice(0, 100) : "",
@@ -2111,7 +2113,92 @@ async function extractRoles(ctx, config, project) {
 			relations: strArr(entry.relations).map((r) => r.slice(0, 60)).slice(0, 10),
 			arc: strArr(entry.arc).map((a) => a.slice(0, 120)).slice(0, 10),
 			knowledge: strArr(entry.knowledge).map((k) => k.slice(0, 120)).slice(0, 12)
-		});
+		};
+	};
+	const roles = [];
+	for (const entry of raw) {
+		const role = toRole(entry);
+		if (role !== void 0) roles.push(role);
+	}
+	if (roles.length > 0) {
+		const names = roles.map((r) => r.name).join("、");
+		const patchSystem = system + "\n上一次已提炼角色：" + names + "。\n现在只输出「遗漏的角色」JSON 数组：检查正文摘录中反复出现、有固定身份称呼（如站长、律师、警察、法官、店主、老师）且对剧情有作用的角色；一次性路人不要输出。没有遗漏就输出 []。字段与上面相同。";
+		try {
+			const patchRaw = parseJsonArray(await complete(ctx, config, {
+				system: patchSystem,
+				user,
+				temperature: .3,
+				maxTokens: Math.max(config.maxTokens, 12e3),
+				reasoning: config.analysisReasoning ?? "low"
+			}));
+			const existing = new Set(roles.map((r) => r.name));
+			for (const entry of patchRaw) {
+				const role = toRole(entry);
+				if (role === void 0 || existing.has(role.name)) continue;
+				existing.add(role.name);
+				roles.push(role);
+				if (roles.length >= 10) break;
+			}
+		} catch {}
+	}
+	const ROLE_TITLE_HINTS = [
+		"站长",
+		"律师",
+		"检察官",
+		"法官",
+		"警察",
+		"店主",
+		"老板",
+		"经理",
+		"局长",
+		"医生",
+		"老师",
+		"护士",
+		"房东",
+		"司机",
+		"保安",
+		"主管",
+		"队长",
+		"厂长",
+		"董事长",
+		"总裁",
+		"市长",
+		"道长",
+		"掌门",
+		"师父",
+		"师傅",
+		"管家"
+	];
+	const existingNames = new Set(roles.map((r) => r.name));
+	const titleCount = /* @__PURE__ */ new Map();
+	for (const chapter of written) {
+		const body = readChapterFile(config.outputDir, chapter);
+		if (body === void 0) continue;
+		for (const t of ROLE_TITLE_HINTS) {
+			let idx = 0;
+			let n = 0;
+			while ((idx = body.indexOf(t, idx)) !== -1) {
+				n++;
+				idx += t.length;
+			}
+			titleCount.set(t, (titleCount.get(t) ?? 0) + n);
+		}
+	}
+	for (const t of ROLE_TITLE_HINTS) {
+		if (roles.length >= 10) break;
+		if (!(existingNames.has(t) || [...existingNames].some((n) => n.includes(t))) && (titleCount.get(t) ?? 0) >= 3) {
+			existingNames.add(t);
+			roles.push({
+				name: t,
+				roleLabel: "support",
+				identity: "身份型角色（正文反复出现）",
+				traits: [],
+				goals: "",
+				relations: [],
+				arc: [],
+				knowledge: []
+			});
+		}
 	}
 	return roles;
 }
@@ -2457,13 +2544,11 @@ function withStyle(pair, styleWords) {
 	};
 }
 /**
-* 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
-* 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
+* 底层实现：为任意角色源提炼「动漫形象描述词」（不写库，写库由上层调用方负责）。
+* 扫描该角色出场的已写章节正文，截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
 */
-async function extractRoleVisual(ctx, config, project, outputDir, roleName, styleId, filterId) {
-	const role = (project.roles ?? []).find((r) => r.name === roleName);
-	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
-	role.promptStyleId = styleId;
+async function extractRoleVisualFrom(ctx, config, project, outputDir, role, styleId, filterId, shortDrama = false) {
+	const roleName = role.name;
 	const appearanceHints = /(发|眉|眼|眸|脸|肤|唇|身材|身高|衣|袍|裙|衫|靴|腰带|气质|模样|长相|容貌|披|束|扎|戴|佩|挂|绣|青|白|黑|红|蓝|紫|灰|银|金|少年|青年|少女|汉子|老者|中年|纤细|挺拔|瘦削|壮实|清秀|俊朗|英气|阴鸷|慈眉)/;
 	const roleText = `${role.name} ${role.identity ?? ""}`;
 	const colorWords = [
@@ -2577,6 +2662,8 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName, styl
 			"2. 正文未明确写到的项目（如瞳色没写、身高没写），用「未定」标注或直接不写，不要编造数值。",
 			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合；服装按分件组织（上身/下身/鞋/配饰）。",
 			"4. 标志物（标签/印记/饰品）必须出现在每段提示词中——它们是一致性的命根子。",
+			"5. 立绘/四视图/细节是「角色设定稿」：禁止写瞬间动作与道具使用状态（握手机、看屏幕、未接来电、走路、回头等），禁止写剧情状态与场景背景；只保留可长期存在的外貌、服装与常驻标志物（工牌、饰品等）。",
+			...shortDrama ? ["6. 短剧精简模式·人设极致化：性格标签必须极致化（如「极端偏执」「绝对冷血」，单一维度拉到最满）；外貌只保留 1-2 个最强辨识度点，弱化平凡细节；服装/标志物更夸张醒目。"] : [],
 			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
 			...rules.map((r) => "- " + r),
 			"输出六部分：",
@@ -2598,7 +2685,7 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName, styl
 		user: [
 			`书名：《${project.bookName}》`,
 			`目标角色：${role.name}（${role.identity}）`,
-			role.traits.length > 0 ? `性格标签：${role.traits.join("、")}` : "",
+			(role.traits ?? []).length > 0 ? `性格标签：${role.traits.join("、")}` : "",
 			`正文出场描写（含外貌线索的段落）：`,
 			...excerpts.map((e) => `[第${e.no}章] ${e.text}`),
 			"只输出 JSON 对象。"
@@ -2658,15 +2745,35 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName, styl
 		promptKit
 	};
 }
-/**
-* 角色四类生图提示词精修包（promptKit）：以锚点 + 表情清单 + 视觉规则为输入，
-* LLM 产出 立绘/四视图/表情×N/细节 四套 zh+en 提示词（比前端拼装更精炼）。
-*/
-async function generateRolePromptKit(ctx, config, project, roleName, styleId, filterId) {
+/** 小说角色库：提炼单个角色的形象锚点并写回角色卡。 */
+async function extractRoleVisual(ctx, config, project, outputDir, roleName, styleId, filterId) {
 	const role = (project.roles ?? []).find((r) => r.name === roleName);
 	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
-	if (role.imagePrompt === void 0) throw new Error(`角色「${roleName}」还没有形象锚点，请先生成锚点`);
 	role.promptStyleId = styleId;
+	return extractRoleVisualFrom(ctx, config, project, outputDir, role, styleId, filterId);
+}
+/** 漫剧角色卡：提炼形象锚点并写回漫剧卡（status → anchored）。 */
+async function extractMangaRoleVisual(ctx, config, project, outputDir, cardId, styleId, filterId) {
+	const card = (project.mangaRoles ?? []).find((c) => c.id === cardId);
+	if (card === void 0) throw new Error(`漫剧角色卡 ${cardId} 不存在`);
+	const visual = await extractRoleVisualFrom(ctx, config, project, outputDir, {
+		name: card.name,
+		identity: card.identity,
+		traits: card.traits
+	}, styleId, filterId, project.shortDramaMode === true);
+	card.promptStyleId = styleId;
+	card.imagePrompt = visual;
+	if ((visual.expressions ?? []).length > 0) card.expressions = visual.expressions;
+	if (visual.promptKit !== void 0) card.promptKit = visual.promptKit;
+	if (card.status === "imported" || card.status === "pending_confirm") card.status = "anchored";
+	card.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	return visual;
+}
+/**
+* 底层实现：基于角色源的形象锚点 + 表情清单 + 视觉规则产出四类生图提示词（不写库）。
+*/
+async function generateRolePromptKitFrom(ctx, config, project, role, styleId, filterId, shortDrama = false) {
+	role.name;
 	const rules = project.visualRules ?? [];
 	const styleWords = styleKeywords(styleId, filterId);
 	const raw = parseJsonObject(await complete(ctx, config, {
@@ -2679,6 +2786,8 @@ async function generateRolePromptKit(ctx, config, project, roleName, styleId, fi
 			"2. sheet 四视图：同一角色的 正面/左侧面/右侧面/背面 四视图设定表（character sheet），纯白背景，四个视角分别描述。",
 			"3. expressions 表情：每个表情一段，脸部特写（头部到锁骨），纯白背景，五官与角色定稿完全一致，只换情绪表达（眼神/嘴角/眉），皮肤纹理细节完整，无多余杂物。",
 			"4. details 细节：多组局部细节集合参考图（一张图多个局部框），纯白背景；把该角色全部标志物逐项列出，每项一句特写描述；细节清晰锐利，角色细节参考稿，无多余杂物。",
+			"5. 立绘/四视图/细节为「角色设定稿」：禁止瞬间动作、道具使用状态与剧情状态（握手机、看屏幕、未接来电等），只保留可长期存在的外貌、服装与常驻标志物（工牌、饰品等）。",
+			...shortDrama ? ["6. 短剧精简模式·人设极致化：性格标签必须极致化（单一维度拉到最满）；外貌只保留 1-2 个最强辨识度点；服装/标志物更夸张醒目，一眼可认。"] : [],
 			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
 			...rules.map((r) => "- " + r),
 			"zh 要求：连贯中文，写实电影感，60-150 字/段；en 要求：booru 风格逗号分隔标签，30-50 个/段。",
@@ -2721,6 +2830,198 @@ async function generateRolePromptKit(ctx, config, project, roleName, styleId, fi
 	if (kit.portrait.zh === "" || kit.portrait.en === "") throw new Error("提示词精修失败：LLM 未返回有效 JSON");
 	return kit;
 }
+/** 小说角色库：角色四类生图提示词精修包（写回角色卡）。 */
+async function generateRolePromptKit(ctx, config, project, roleName, styleId, filterId) {
+	const role = (project.roles ?? []).find((r) => r.name === roleName);
+	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
+	if (role.imagePrompt === void 0) throw new Error(`角色「${roleName}」还没有形象锚点，请先生成锚点`);
+	role.promptStyleId = styleId;
+	return generateRolePromptKitFrom(ctx, config, project, {
+		name: role.name,
+		identity: role.identity,
+		imagePrompt: role.imagePrompt,
+		expressions: role.expressions
+	}, styleId, filterId);
+}
+/** 漫剧角色卡：四类生图提示词精修包（写回漫剧卡，status → anchored）。 */
+async function generateMangaRolePromptKit(ctx, config, project, cardId, styleId, filterId) {
+	const card = (project.mangaRoles ?? []).find((c) => c.id === cardId);
+	if (card === void 0) throw new Error(`漫剧角色卡 ${cardId} 不存在`);
+	if (card.imagePrompt === void 0) throw new Error(`「${card.name}」还没有形象锚点，请先生成锚点`);
+	const kit = await generateRolePromptKitFrom(ctx, config, project, {
+		name: card.name,
+		identity: card.identity,
+		imagePrompt: card.imagePrompt,
+		expressions: card.expressions
+	}, styleId, filterId, project.shortDramaMode === true);
+	card.promptStyleId = styleId;
+	card.promptKit = kit;
+	if (card.status === "imported" || card.status === "pending_confirm") card.status = "anchored";
+	card.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	return kit;
+}
+/**
+* 漫剧角色库·提名（两段式）：从某章分镜的 characters 提名候选角色名 →
+* 规则过滤（精确名 + 身份/简称匹配，短名单 ≤5）→ LLM 确认（是/否 + 选哪个，不做开放检索）→
+* 返回带漫剧卡建议的候选（未匹配时给出「回小说库补提炼 / 漫剧直接创建」判定）。
+*/
+async function nominateMangaRoles(ctx, config, project, outputDir, chapterNo) {
+	const entry = (project.storyboards ?? []).find((e) => e.chapterNo === chapterNo);
+	if (entry === void 0) throw new Error(`第 ${chapterNo} 章还没有分镜产出，请先在「分镜」页生成剧情骨架/分镜表`);
+	const names = [];
+	const pushNames = (list) => {
+		for (const n of list ?? []) {
+			const t = n.trim().slice(0, 20);
+			if (t !== "" && !names.includes(t)) names.push(t);
+		}
+	};
+	pushNames(entry.skeleton?.characters);
+	pushNames(entry.table?.characters);
+	for (const s of entry.table?.shots ?? []) pushNames(s.characters);
+	if (names.length === 0) throw new Error(`第 ${chapterNo} 章的分镜还没有结构化角色（characters 为空），请重新生成剧情骨架/分镜表`);
+	const imported = /* @__PURE__ */ new Set();
+	for (const c of project.mangaRoles ?? []) {
+		imported.add(c.name);
+		if (c.sourceRoleName !== void 0 && c.sourceRoleName !== "") imported.add(c.sourceRoleName);
+	}
+	const already = names.filter((n) => imported.has(n)).map((n) => ({
+		rawName: n,
+		verdict: "already_imported",
+		matches: [],
+		suggested: emptyCandidateSuggestion(n)
+	}));
+	const fresh = names.filter((n) => !imported.has(n));
+	if (fresh.length === 0) return already;
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	const body = chapter !== void 0 ? readChapterFile(outputDir, chapter) : void 0;
+	const roles = project.roles ?? [];
+	const shortlists = fresh.map((rawName) => {
+		const shortlist = [];
+		const push = (n) => {
+			if (!shortlist.includes(n)) shortlist.push(n);
+		};
+		for (const r of roles) {
+			if (shortlist.length >= 5) break;
+			const n = r.name;
+			if (n === rawName) {
+				push(n);
+				continue;
+			}
+			if (n.includes(rawName) || rawName.includes(n)) {
+				push(n);
+				continue;
+			}
+			const ident = r.identity ?? "";
+			if (ident !== "" && (ident === rawName || ident.includes(rawName) || rawName.includes(ident))) push(n);
+		}
+		return {
+			rawName,
+			roleNames: shortlist
+		};
+	});
+	const beats = (entry.skeleton?.beats ?? []).map((b) => `[${b.id}] ${b.event}`).join("\n");
+	const raw = parseJsonArray(await complete(ctx, config, {
+		system: [
+			"你是一位漫剧选角导演。下面给出「分镜角色提名」与「小说角色库候选名单」。",
+			"任务：为每个提名判定它对应小说角色库中的哪一个候选（或判定小说库没有对应角色），并预填一张「漫剧角色卡」的建议信息。",
+			"规则：",
+			"1. roleName 只能从该提名的候选名单中选，禁止输出名单之外的名字（不做开放检索）。",
+			"2. verdict：matched=候选名单里确实有对应角色（选最像的那个）；ambiguous=名单里有多个候选且无法确定（此时 roleName 可留空或选最可能的一个）；not_in_library=候选名单为空或都不对应。",
+			"3. matched/ambiguous 时给出漫剧卡建议：name（漫剧用名，默认与角色名一致）、identity（身份一句话，30 字内）、coreFunction（protagonist=主角/mentor=导师/love_interest=感情线/antagonist=反派/sidekick=搭档/informant=线人/functional=功能性）、protagonistRelation（enemy/friend/mentor/lover/exploit=利用/neutral）、speechStyle（口头禅或说话方式）、traits（不超过 3 个极致性格标签）、appearance（1-2 个辨识度外貌点）、keyScenes（本章该角色 1-2 个关键剧情节点，格式「第N章 xxx」）。",
+			"4. 身份型提名（如「持枪者」「围观群众」）：候选名单有则匹配；名单没有且正文确有该称谓 → not_in_library；正文也没有 → not_in_library。",
+			...project.shortDramaMode === true ? ["5. 短剧精简模式（本书已开启）：只保留 5-8 个上镜角色——主角/反派/感情线/关键配角；功能性路人不上卡（此类提名直接 not_in_library）。每个角色必须给出明确的 coreFunction 与 protagonistRelation；性格标签极致化；候选超过 8 个时按戏份重要性裁剪到最核心 8 个。"] : [],
+			"输出必须是合法 JSON 数组：[{\"rawName\": \"...\", \"verdict\": \"...\", \"roleName\": \"...或省略\", \"suggested\": {...}}]，每个提名都要有，数组长度必须等于提名数。",
+			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+		].join("\n"),
+		user: [
+			`章节：第 ${chapterNo} 章《${chapter?.title ?? ""}》`,
+			"==== 剧情骨架（节拍） ====",
+			beats !== "" ? beats : "（无骨架节拍）",
+			"==== 角色提名与候选名单 ====",
+			shortlists.map((s) => s.roleNames.length > 0 ? `[提名] ${s.rawName} → 候选：${s.roleNames.join("、")}` : `[提名] ${s.rawName} → 候选：（无）`).join("\n"),
+			body !== void 0 ? "==== 章节正文（前 2500 字，判断称谓归属用） ====\n" + body.replace(/^#.*$/gm, "").trim().slice(0, 2500) : "",
+			"只输出 JSON 数组。"
+		].filter((x) => x !== "").join("\n\n"),
+		temperature: .2,
+		maxTokens: Math.max(config.maxTokens, 8e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	const verdicts = /* @__PURE__ */ new Set([
+		"matched",
+		"ambiguous",
+		"not_in_library"
+	]);
+	const fnMap = {
+		protagonist: "protagonist",
+		mentor: "mentor",
+		love_interest: "love_interest",
+		antagonist: "antagonist",
+		sidekick: "sidekick",
+		informant: "informant",
+		functional: "functional"
+	};
+	const relMap = {
+		enemy: "enemy",
+		friend: "friend",
+		mentor: "mentor",
+		lover: "lover",
+		exploit: "exploit",
+		neutral: "neutral"
+	};
+	const byName = /* @__PURE__ */ new Map();
+	for (const e of raw) if (typeof e === "object" && e !== null && typeof e.rawName === "string") byName.set(e.rawName.trim(), e);
+	const str = (v) => typeof v === "string" ? v.trim().slice(0, 100) : "";
+	const strArr = (v, n) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "").map((x) => x.trim().slice(0, 20)).slice(0, n) : [];
+	const out = [];
+	for (const item of shortlists) {
+		const judge = byName.get(item.rawName);
+		const judgeVerdict = judge !== void 0 ? str(judge.verdict) : "";
+		const verdict = verdicts.has(judgeVerdict) ? judgeVerdict : item.roleNames.length > 0 ? "ambiguous" : "not_in_library";
+		let roleName;
+		if (judge !== void 0) {
+			const chosen = str(judge.roleName);
+			if (chosen !== "" && item.roleNames.includes(chosen)) roleName = chosen;
+		}
+		if (verdict === "matched" && roleName === void 0 && item.roleNames.length === 1) roleName = item.roleNames[0];
+		const sug = typeof judge?.suggested === "object" && judge?.suggested !== null ? judge.suggested : {};
+		const novelHint = verdict === "not_in_library" && body !== void 0 ? body.includes(item.rawName) ? "backfill" : "manga_new" : void 0;
+		const suggested = {
+			name: (str(sug.name) !== "" ? str(sug.name) : roleName ?? item.rawName).slice(0, 30),
+			identity: str(sug.identity).slice(0, 60),
+			coreFunction: fnMap[str(sug.coreFunction)] ?? "functional",
+			protagonistRelation: relMap[str(sug.protagonistRelation)] ?? "neutral",
+			speechStyle: str(sug.speechStyle).slice(0, 60),
+			traits: strArr(sug.traits, 3),
+			appearance: str(sug.appearance).slice(0, 100),
+			keyScenes: strArr(sug.keyScenes, 3)
+		};
+		out.push({
+			rawName: item.rawName,
+			verdict,
+			matches: item.roleNames.map((n) => ({
+				roleName: n,
+				reason: roleName === n ? "LLM 确认" : "规则候选"
+			})),
+			matchedRoleName: roleName,
+			novelHint,
+			suggested
+		});
+	}
+	return [...already, ...out];
+}
+/** 空建议（already_imported 等无需 LLM 的候选用）。 */
+function emptyCandidateSuggestion(name) {
+	return {
+		name,
+		identity: "",
+		coreFunction: "functional",
+		protagonistRelation: "neutral",
+		speechStyle: "",
+		traits: [],
+		appearance: "",
+		keyScenes: []
+	};
+}
 /** ✨ 从道藏/红线提炼「视觉世界观规则」：生图/生视频必须遵守的设定纠偏（如"商品=人，禁止常规超市商品"）。 */
 async function extractVisualRules(ctx, config, project) {
 	const system = [
@@ -2997,10 +3298,8 @@ async function testImageEndpoint(baseURL, apiKey, model) {
 		};
 	}
 }
-async function generateRoleReferenceImage(ctx, config, project, outputDir, name, style = "", modelId) {
-	const role = project.roles?.find((r) => r.name === name);
-	if (role === void 0) throw new Error(`角色 ${name} 不存在`);
-	if (role.imagePrompt === void 0) throw new Error(`角色 ${name} 还没有形象锚点，请先生成锚点`);
+/** 底层：按形象锚点调用生图接口生成定妆图（不写库；写库由上层调用方负责）。 */
+async function generateReferenceImageFrom(config, anchor, style = "", modelId) {
 	if (config.imageApiEnabled !== true) throw new Error("生图未启用，请在设置中启用一个生图模型");
 	const activeImage = (modelId !== void 0 && modelId !== "" ? (config.imageModels ?? []).find((m) => m.id === modelId) : void 0) ?? (config.imageModels ?? []).find((m) => m.enabled) ?? (config.imageModels ?? [])[0];
 	const apiKey = activeImage?.apiKey ?? config.imageApiKey;
@@ -3010,9 +3309,9 @@ async function generateRoleReferenceImage(ctx, config, project, outputDir, name,
 	if (apiKey === void 0 || apiKey === "" || model === void 0 || model === "") throw new Error("请先在设置中配置生图模型的 API Key 和模型 id");
 	const stylePrompt = getComicStylePrompt(style);
 	const prompt = [
-		role.imagePrompt.zh,
-		role.imagePrompt.en,
-		role.imagePrompt.tags.join(", "),
+		anchor.zh,
+		anchor.en,
+		anchor.tags.join(", "),
 		stylePrompt,
 		"character reference sheet, front view, clean background, consistent design"
 	].filter(Boolean).join(", ");
@@ -3040,10 +3339,27 @@ async function generateRoleReferenceImage(ctx, config, project, outputDir, name,
 	const imgRes = await fetch(url);
 	if (!imgRes.ok) throw new Error("下载生图结果失败");
 	const buf = Buffer.from(await imgRes.arrayBuffer());
-	const dataUrl = `data:${imgRes.headers.get("content-type") || "image/jpeg"};base64,${buf.toString("base64")}`;
+	return `data:${imgRes.headers.get("content-type") || "image/jpeg"};base64,${buf.toString("base64")}`;
+}
+/** 小说角色库：生成角色定妆图并写回角色卡（imageUrl）。 */
+async function generateRoleReferenceImage(ctx, config, project, outputDir, name, style = "", modelId) {
+	const role = project.roles?.find((r) => r.name === name);
+	if (role === void 0) throw new Error(`角色 ${name} 不存在`);
+	if (role.imagePrompt === void 0) throw new Error(`角色 ${name} 还没有形象锚点，请先生成锚点`);
+	const dataUrl = await generateReferenceImageFrom(config, role.imagePrompt, style, modelId);
 	role.imageUrl = dataUrl;
 	return dataUrl;
 }
+/** 漫剧角色卡：生成定妆图并写回漫剧卡（imageUrl）。 */
+async function generateMangaRoleReferenceImage(ctx, config, project, outputDir, cardId, style = "", modelId) {
+	const card = (project.mangaRoles ?? []).find((c) => c.id === cardId);
+	if (card === void 0) throw new Error(`漫剧角色卡 ${cardId} 不存在`);
+	if (card.imagePrompt === void 0) throw new Error(`「${card.name}」还没有形象锚点，请先生成锚点`);
+	const dataUrl = await generateReferenceImageFrom(config, card.imagePrompt, style, modelId);
+	card.imageUrl = dataUrl;
+	card.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	return dataUrl;
+}
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 async function analyzePlotlineHealth(ctx, config, project) {
 	const system = [
@@ -3448,6 +3764,47 @@ function saveChapterStoryboard(project, outputDir, entry) {
 	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 	saveProject(outputDir, project);
 }
+/** 确定性兜底：正文中出现的角色库角色名（LLM 漏填 characters 时使用）。 */
+function guessCharactersFromRoles(project, body, limit = 12) {
+	const out = [];
+	for (const r of project.roles ?? []) {
+		if (out.length >= limit) break;
+		if (r.name !== "" && !out.includes(r.name) && body.includes(r.name)) out.push(r.name);
+	}
+	return out;
+}
+/** 清洗 LLM 输出的角色名数组：去空 / 去重 / 限长 / 限字数。 */
+function sanitizeCharacters(raw, limit) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const v of raw) {
+		if (typeof v !== "string") continue;
+		const name = v.trim().slice(0, 20);
+		if (name === "" || out.includes(name)) continue;
+		out.push(name);
+		if (out.length >= limit) break;
+	}
+	return out;
+}
+function buildMangaRoleBindings(project) {
+	const cards = project.mangaRoles ?? [];
+	const byName = /* @__PURE__ */ new Map();
+	for (const c of cards) {
+		if (c.name !== "") byName.set(c.name, c);
+		if (c.sourceRoleName !== void 0 && c.sourceRoleName !== "") byName.set(c.sourceRoleName, c);
+	}
+	return {
+		byId: new Map(cards.map((c) => [c.id, c])),
+		resolve: (name) => {
+			const exact = byName.get(name);
+			if (exact !== void 0) return exact;
+			for (const c of cards) {
+				if (c.name !== "" && (c.name.includes(name) || name.includes(c.name))) return c;
+				if (c.sourceRoleName !== void 0 && c.sourceRoleName !== "" && (c.sourceRoleName.includes(name) || name.includes(c.sourceRoleName))) return c;
+			}
+		}
+	};
+}
 /**
 * 分镜·导演级：剧情骨架 → 分镜表（镜头级）。
 * 只做画面层：景别/机位运镜/时长/画面/台词/音效/光效 + 状态连续；禁止改剧情（骨架只读）。
@@ -3461,6 +3818,12 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 	const roles = (project.roles ?? []).filter((r) => body.includes(r.name)).slice(0, 8).map((r) => `${r.name}（${r.roleLabel === "protagonist" ? "主角" : r.roleLabel === "antagonist" ? "反派" : r.roleLabel === "female_lead" ? "女主" : "配角"}）：${r.identity ?? ""}`);
 	const usedScenes = (project.scenes ?? []).filter((s) => body.includes(s.name)).slice(0, 6);
 	const scenes = usedScenes.map((s) => `${s.name}：${s.summary ?? ""}`);
+	const bindings = buildMangaRoleBindings(project);
+	const mangaLines = (bindings.byId.size > 0 ? [...bindings.byId.values()].filter((c) => body.includes(c.name) || c.sourceRoleName !== void 0 && body.includes(c.sourceRoleName)).slice(0, 8) : []).map((c) => {
+		const anchor = c.imagePrompt !== void 0 ? c.imagePrompt.zh.slice(0, 90) : c.appearance !== "" ? c.appearance : "";
+		const ref = c.imageUrl !== void 0 ? "；参考图：有" : (c.gallery ?? []).some((g) => g.label.includes("立绘")) ? "；参考图：有（立绘）" : "";
+		return `${c.name}（${c.identity ?? ""}）：定妆${anchor !== "" ? "「" + anchor + "」" : "（锚点未生成）"}${ref}`;
+	});
 	const rules = (project.visualRules ?? []).map((r) => "- " + r);
 	const baseStyle = styleId !== void 0 ? findStyle(styleId) : void 0;
 	const filterStyle = filterId !== void 0 ? findStyle(filterId) : void 0;
@@ -3472,7 +3835,7 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 		system: [
 			"你是一位从业 10 年的电影导演兼分镜师，专长网文改编影视化。",
 			"任务：把「剧情骨架」的每一个节拍展开为 1-3 个电影镜头，输出分镜表——只做画面层，禁止新增或改变剧情（骨架是只读输入）。",
-			"输出合法 JSON 对象：{\"shots\": [{\"beatId\": \"骨架节拍id\", \"shot\": \"景别\", \"camera\": \"机位与运镜\", \"duration\": 秒数, \"visual\": \"画面内容\", \"line\": \"台词/旁白\", \"sound\": \"音效\", \"light\": \"光效\", \"prevState\": \"承接上一镜头结尾状态\", \"nextState\": \"本镜头结束状态\"}]}",
+			"输出合法 JSON 对象：{\"shots\": [{\"beatId\": \"骨架节拍id\", \"shot\": \"景别\", \"camera\": \"机位与运镜\", \"duration\": 秒数, \"visual\": \"画面内容\", \"line\": \"台词/旁白\", \"sound\": \"音效\", \"light\": \"光效\", \"prevState\": \"承接上一镜头结尾状态\", \"nextState\": \"本镜头结束状态\", \"characters\": [\"出镜角色名\"]}]}",
 			"景别取值：远景/全景/中景/近景/特写。",
 			"硬性要求：",
 			"【视觉风格】（必须内嵌进 visual/light 的画面措辞与光效描述）：",
@@ -3482,7 +3845,9 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 			"3. visual 必须写明：角色动作 + 表情 + 服装/标志物（标志物来自下方视觉规则与角色锚点，逐镜头保持）。",
 			"4. 台词/音效/光效无则空字符串，不要编造。",
 			"5. duration 1-12 秒。",
-			"6. 所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束，不要输出其他文字。"
+			"6. 所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束，不要输出其他文字。",
+			"7. 每个镜头必须输出 characters：本镜头出镜角色名数组（1-4 个），从「出场角色锚点」或正文中选取，使用正文里的确切称谓（如「周野」「周野的律师」），禁止自造名/缩写；路人或群像可用身份词（如「围观群众」）。",
+			"8. 人物外观/服装/标志物必须遵守「漫剧定妆卡」与「出场角色锚点」：同一角色逐镜头保持完全一致（服装、发色、标志物禁止更换）；定妆卡未覆盖的路人可用通用描述。"
 		].join("\n"),
 		user: [
 			`章节《${chapter.title}》（第 ${chapter.no} 章）`,
@@ -3490,6 +3855,7 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 			`弧线：${skeleton.arc}`,
 			skeleton.beats.map((b) => `[${b.id}] [${b.function}] ${b.event}（情绪：${b.emotion}${b.cause !== void 0 ? "；承接：" + b.cause : ""}）`).join("\n"),
 			roles.length > 0 ? "==== 出场角色锚点 ====\n" + roles.join("\n") : "",
+			mangaLines.length > 0 ? "==== 漫剧定妆卡（角色外观以此为准，禁止改换服装/发色/标志物） ====\n" + mangaLines.join("\n") : "",
 			scenes.length > 0 ? "==== 相关场景 ====\n" + scenes.join("\n") : "",
 			rules.length > 0 ? "==== 本书视觉规则（必须内嵌进 visual） ====\n" + rules.join("\n") : "",
 			"==== 章节正文（画面细节以此为准） ====",
@@ -3518,16 +3884,35 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 		sound: typeof entry.sound === "string" ? entry.sound.trim().slice(0, 80) : "",
 		light: typeof entry.light === "string" ? entry.light.trim().slice(0, 80) : "",
 		prevState: typeof entry.prevState === "string" ? entry.prevState.trim().slice(0, 150) : "",
-		nextState: typeof entry.nextState === "string" ? entry.nextState.trim().slice(0, 150) : ""
+		nextState: typeof entry.nextState === "string" ? entry.nextState.trim().slice(0, 150) : "",
+		characters: sanitizeCharacters(entry.characters, 4)
 	})).filter((s) => s.visual !== "") : [];
 	if (shots.length === 0) throw new Error("模型未输出有效镜头，请重试");
 	const covered = new Set(shots.map((s) => s.beatId));
 	const missing = skeleton.beats.filter((b) => !covered.has(b.id)).map((b) => b.id);
 	if (missing.length > 0) console.warn(`[dsh-novel-forge] storyboard: beat ${missing.join(",")} 无镜头覆盖`);
+	const tableChars = [];
+	const tableRoleIds = [];
+	for (const s of shots) {
+		const ids = [];
+		for (const n of s.characters ?? []) {
+			const card = bindings.resolve(n);
+			if (card !== void 0 && !ids.includes(card.id)) ids.push(card.id);
+		}
+		s.mangaRoleIds = ids.length > 0 ? ids : void 0;
+		for (const c of s.characters ?? []) {
+			if (!tableChars.includes(c)) tableChars.push(c);
+			if (tableChars.length >= 12) break;
+		}
+		for (const id of ids) if (!tableRoleIds.includes(id)) tableRoleIds.push(id);
+	}
+	const fallbackChars = (skeleton.characters ?? guessCharactersFromRoles(project, body, 12)).slice(0, 12);
 	const table = {
 		chapterNo,
 		shots,
-		usedScenes: usedScenes.map((s) => s.name)
+		usedScenes: usedScenes.map((s) => s.name),
+		characters: tableChars.length > 0 ? tableChars : fallbackChars,
+		mangaRoleIds: tableRoleIds.length > 0 ? tableRoleIds : void 0
 	};
 	saveChapterStoryboard(project, outputDir, {
 		chapterNo,
@@ -3548,11 +3933,21 @@ async function generateStoryboardPrompts(ctx, config, project, outputDir, chapte
 	const filterStyle = filterId !== void 0 ? findStyle(filterId) : void 0;
 	const stylePrefix = [baseStyle?.keywords, filterStyle?.keywords].filter((v) => v !== void 0 && v !== "").join("，") || "3D动漫，超精细建模，电影光影";
 	const rules = (project.visualRules ?? []).map((r) => "- " + r);
-	const shotLines = table.shots.map((s) => `[${s.id}] 节拍${s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s
+	const bindings = buildMangaRoleBindings(project);
+	const shotLines = table.shots.map((s) => {
+		const makeUp = (s.characters ?? []).map((n) => bindings.resolve(n)).filter((c) => c !== void 0).map((c) => {
+			const anchor = c.imagePrompt !== void 0 ? c.imagePrompt.zh.slice(0, 60) : c.appearance !== "" ? c.appearance : "";
+			const ref = c.imageUrl !== void 0 ? "（参考图）" : "";
+			return c.name + "：" + anchor + ref;
+		}).join("；");
+		return `[${s.id}] 节拍${s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s
+出场：${s.characters !== void 0 && s.characters.length > 0 ? s.characters.join("、") : "（未标注）"}
+定妆：${makeUp !== "" ? makeUp : "（未绑定漫剧卡）"}
 画面：${s.visual}
 台词：${s.line !== "" ? s.line : "（无）"}
 光效：${s.light !== "" ? s.light : "（无）"}
-承接：${s.prevState} → ${s.nextState}`).join("\n\n");
+承接：${s.prevState} → ${s.nextState}`;
+	}).join("\n\n");
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
 			"你是一位资深影视分镜提示词工程师，熟悉即梦 AI / Seedance 等视频生成模型的中文提示词写法。",
@@ -3562,7 +3957,7 @@ async function generateStoryboardPrompts(ctx, config, project, outputDir, chapte
 			"重要：每段提示词开头必须原样嵌入风格词块原文，不得省略、不得改写。",
 			"硬性要求：",
 			"1. 只写画面与镜头，禁止写音频/台词配音说明（视频模型无音频）。",
-			"2. 服装/发色/标志物必须沿用镜头表与视觉规则，禁止自行更换。",
+			"2. 服装/发色/标志物必须沿用镜头表、定妆卡与视觉规则，禁止自行更换（同一角色跨镜头保持一致）。",
 			"3. 运镜用通俗电影词（推近/拉远/跟随/低机位仰拍/过肩/手持晃动/固定机位），不要用分镜术语缩写。",
 			"4. 输出合法 JSON 对象：{\"prompts\": [{\"shotId\": \"s1\", \"text\": \"...\"}]}，所有镜头都要有，顺序一致。",
 			"5. 字符串内不得包含换行符，JSON 必须在一段内完整结束。"
@@ -3579,10 +3974,16 @@ async function generateStoryboardPrompts(ctx, config, project, outputDir, chapte
 		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const shotIds = new Set(table.shots.map((s) => s.id));
-	const prompts = Array.isArray(raw.prompts) ? raw.prompts.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
-		shotId: shotIds.has(entry.shotId) ? entry.shotId : "",
-		text: ensureStyleEmbedded(typeof entry.text === "string" ? entry.text.trim().slice(0, 400) : "", stylePrefix, "zh")
-	})).filter((x) => x.shotId !== "" && x.text !== "") : [];
+	const shotBinding = new Map(table.shots.map((s) => [s.id, s.mangaRoleIds ?? []]));
+	const prompts = Array.isArray(raw.prompts) ? raw.prompts.filter((v) => typeof v === "object" && v !== null).map((entry) => {
+		const shotId = shotIds.has(entry.shotId) ? entry.shotId : "";
+		const ids = shotBinding.get(shotId) ?? [];
+		return {
+			shotId,
+			text: ensureStyleEmbedded(typeof entry.text === "string" ? entry.text.trim().slice(0, 400) : "", stylePrefix, "zh"),
+			mangaRoleIds: ids.length > 0 ? ids : void 0
+		};
+	}).filter((x) => x.shotId !== "" && x.text !== "") : [];
 	if (prompts.length === 0) throw new Error("模型未输出有效提示词，请重试");
 	saveChapterStoryboard(project, outputDir, {
 		chapterNo,
@@ -3604,13 +4005,14 @@ async function generateStoryboardSkeleton(ctx, config, project, outputDir, chapt
 		system: [
 			"你是一位从业 15 年的电影编剧，专长网文改编影视化，深谙三幕结构与节拍（beat）写作。",
 			"任务：把这一章改编成影视化「剧情骨架」——只做故事层，不做画面。",
-			"输出合法 JSON 对象：{\"arc\": \"本章弧线一句话（起承转合，20-60字）\", \"beats\": [{\"event\": \"事件一句话（发生了什么）\", \"emotion\": \"人物情绪走向（如 压抑→隐忍→惊惧）\", \"function\": \"铺垫|冲突|转折|高潮|收束|伏笔|人物塑造\", \"cause\": \"承接上一节拍的原因（可省略）\"}]}",
+			"输出合法 JSON 对象：{\"arc\": \"本章弧线一句话（起承转合，20-60字）\", \"beats\": [{\"event\": \"事件一句话（发生了什么）\", \"emotion\": \"人物情绪走向（如 压抑→隐忍→惊惧）\", \"function\": \"铺垫|冲突|转折|高潮|收束|伏笔|人物塑造\", \"cause\": \"承接上一节拍的原因（可省略）\"}], \"characters\": [\"出镜角色名1\", \"出镜角色名2\"]}",
 			"硬性要求：",
 			"1. beats 数量 4-9 个，严格按时间顺序，因果链完整：前一个 beat 的结果是后一个 beat 的原因。",
 			"2. 必须覆盖本章全部剧情要点与正文关键事件，遗漏关键事件视为失败。",
 			"3. 只输出剧情骨架，禁止写画面描写、机位运镜、台词细节、音效（那是导演阶段的事）。",
 			"4. 所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
-			"5. 直接输出 JSON 本身，不要输出思考过程或其他文字。"
+			"5. 直接输出 JSON 本身，不要输出思考过程或其他文字。",
+			"6. 额外输出 characters：本章真正出镜（说话/行动/被正面描写）的角色名数组，全部使用正文中的确切称谓（如「周野」「周野的律师」，不要改名或拼接），去重，3-10 个；路人或群像可用身份词（如「围观群众」）。"
 		].join("\n"),
 		user: [
 			`章节《${chapter.title}》（第 ${chapter.no} 章）`,
@@ -3640,10 +4042,13 @@ async function generateStoryboardSkeleton(ctx, config, project, outputDir, chapt
 		cause: typeof entry.cause === "string" && entry.cause.trim() !== "" ? entry.cause.trim().slice(0, 150) : void 0
 	})).filter((b) => b.event !== "") : [];
 	if (beats.length === 0) throw new Error("模型未输出有效节拍链，请重试");
+	const skeletonChars = sanitizeCharacters(raw.characters, 12);
+	const chars = skeletonChars.length > 0 ? skeletonChars : guessCharactersFromRoles(project, body, 12);
 	const skeleton = {
 		chapterNo,
 		arc: arc !== "" ? arc : "（本章弧线未生成）",
-		beats
+		beats,
+		characters: chars.length > 0 ? chars : void 0
 	};
 	saveChapterStoryboard(project, outputDir, {
 		chapterNo,
@@ -4775,6 +5180,8 @@ const NOVEL_API = {
 	bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview",
 	/** 漫剧方案管理：create/remove/activate。 */
 	manhuaPlans: "/api/dsh-novel-forge/manhua/plans",
+	/** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+	mangaRoles: "/api/dsh-novel-forge/manga/roles",
 	/** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
 	storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton",
 	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
@@ -7307,6 +7714,210 @@ function makeRoutes(deps) {
 			writeJson(res, 200, { roles: project.roles });
 		}
 	};
+	/** 漫剧角色库：从分镜提名（规则+LLM 两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+	const mangaRolesRoute = {
+		kind: "exact",
+		path: NOVEL_API.mangaRoles,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const body = await readJsonBody(req);
+			if (project.mangaRoles === void 0) project.mangaRoles = [];
+			const op = body?.op;
+			if (op === "nominate") {
+				const chapterNo = body?.chapterNo;
+				if (typeof chapterNo !== "number" || chapterNo <= 0) {
+					writeJson(res, 400, { error: "chapterNo（章号）必填" });
+					return;
+				}
+				try {
+					const candidates = await nominateMangaRoles(ctx, config, project, config.outputDir, chapterNo);
+					writeJson(res, 200, {
+						cards: project.mangaRoles,
+						candidates
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `提名失败：${error.message}` });
+					return;
+				}
+			} else if (op === "adopt" || op === "update") {
+				const card = body?.card;
+				if (card === void 0 || typeof card !== "object") {
+					writeJson(res, 400, { error: "card（漫剧角色卡）必填" });
+					return;
+				}
+				const name = (card.name ?? "").trim();
+				if (name === "") {
+					writeJson(res, 400, { error: "漫剧角色名不能为空" });
+					return;
+				}
+				const now = (/* @__PURE__ */ new Date()).toISOString();
+				const existing = card.id !== "" ? project.mangaRoles.find((c) => c.id === card.id) : void 0;
+				const next = {
+					id: card.id !== "" ? card.id : "mr-" + Date.now().toString(36) + "-" + Math.random().toString(36).slice(2, 6),
+					sourceRoleName: card.sourceRoleName !== void 0 && card.sourceRoleName !== "" ? card.sourceRoleName : void 0,
+					name,
+					identity: card.identity ?? "",
+					coreFunction: card.coreFunction ?? "functional",
+					protagonistRelation: card.protagonistRelation ?? "neutral",
+					speechStyle: card.speechStyle ?? "",
+					traits: Array.isArray(card.traits) ? card.traits.map((t) => String(t).slice(0, 20)).filter((t) => t !== "").slice(0, 3) : [],
+					appearance: card.appearance ?? "",
+					keyScenes: Array.isArray(card.keyScenes) ? card.keyScenes.map((k) => String(k).slice(0, 120)).filter((k) => k !== "").slice(0, 6) : [],
+					appearsInEpisodes: Array.isArray(card.appearsInEpisodes) ? [...new Set(card.appearsInEpisodes.map((n) => Number(n)).filter((n) => Number.isFinite(n) && n > 0))].sort((a, b) => a - b).slice(0, 200) : [],
+					status: card.status ?? "imported",
+					imagePrompt: card.imagePrompt,
+					expressions: card.expressions,
+					promptKit: card.promptKit,
+					imageUrl: card.imageUrl,
+					gallery: card.gallery,
+					promptStyleId: card.promptStyleId,
+					createdAt: existing?.createdAt ?? now,
+					updatedAt: now
+				};
+				if (existing !== void 0) {
+					const idx = project.mangaRoles.findIndex((c) => c.id === card.id);
+					project.mangaRoles[idx] = next;
+				} else project.mangaRoles.push(next);
+				project.updatedAt = now;
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { cards: project.mangaRoles });
+				return;
+			} else if (op === "remove") {
+				const id = body?.id;
+				if (typeof id !== "string" || id === "") {
+					writeJson(res, 400, { error: "id（漫剧卡 id）必填" });
+					return;
+				}
+				project.mangaRoles = project.mangaRoles.filter((c) => c.id !== id);
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { cards: project.mangaRoles });
+				return;
+			} else if (op === "visual") {
+				const id = body?.id?.trim();
+				if (id === void 0 || id === "") {
+					writeJson(res, 400, { error: "id（漫剧卡 id）必填" });
+					return;
+				}
+				try {
+					const visual = await extractMangaRoleVisual(ctx, config, project, config.outputDir, id, body?.styleId, body?.filterId);
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						cards: project.mangaRoles,
+						visual
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `形象锚点生成失败：${error.message}` });
+					return;
+				}
+			} else if (op === "promptKit") {
+				const id = body?.id?.trim();
+				if (id === void 0 || id === "") {
+					writeJson(res, 400, { error: "id（漫剧卡 id）必填" });
+					return;
+				}
+				try {
+					const kit = await generateMangaRolePromptKit(ctx, config, project, id, body?.styleId, body?.filterId);
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						cards: project.mangaRoles,
+						promptKit: kit
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `提示词精修失败：${error.message}` });
+					return;
+				}
+			} else if (op === "image") {
+				const id = body?.id?.trim();
+				const dataUrl = body?.dataUrl?.trim();
+				if (id === void 0 || id === "") {
+					writeJson(res, 400, { error: "id（漫剧卡 id）必填" });
+					return;
+				}
+				if (dataUrl === void 0 || dataUrl === "") {
+					writeJson(res, 400, { error: "dataUrl（定妆图）必填" });
+					return;
+				}
+				const card = project.mangaRoles.find((c) => c.id === id);
+				if (card === void 0) {
+					writeJson(res, 404, { error: "漫剧角色卡不存在" });
+					return;
+				}
+				const label = body?.label?.trim() ?? "";
+				if (label !== "") {
+					card.gallery ??= [];
+					card.gallery = card.gallery.filter((g) => g.label !== label);
+					card.gallery.push({
+						label,
+						dataUrl
+					});
+					if (label.includes("立绘")) card.imageUrl = dataUrl;
+				} else card.imageUrl = dataUrl;
+				card.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, {
+					cards: project.mangaRoles,
+					imageUrl: card.imageUrl
+				});
+				return;
+			} else if (op === "removeImage") {
+				const id = body?.id?.trim();
+				const label = body?.label?.trim() ?? "";
+				const card = project.mangaRoles.find((c) => c.id === id);
+				if (card !== void 0) {
+					if (label !== "") {
+						card.gallery = (card.gallery ?? []).filter((g) => g.label !== label);
+						if (label.includes("立绘")) card.imageUrl = void 0;
+					} else card.imageUrl = void 0;
+					card.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				}
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { cards: project.mangaRoles });
+				return;
+			} else if (op === "imageGenerate") {
+				const id = body?.id?.trim();
+				if (id === void 0 || id === "") {
+					writeJson(res, 400, { error: "id（漫剧卡 id）必填" });
+					return;
+				}
+				try {
+					const imageUrl = await generateMangaRoleReferenceImage(ctx, config, project, config.outputDir, id, body?.style ?? "", body?.modelId);
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						cards: project.mangaRoles,
+						imageUrl
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `定妆图生成失败：${error.message}` });
+					return;
+				}
+			} else if (op === "mode") {
+				project.shortDramaMode = body?.shortDramaMode === true;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, {
+					cards: project.mangaRoles,
+					shortDramaMode: project.shortDramaMode
+				});
+				return;
+			} else {
+				writeJson(res, 400, { error: "未知的 manga/roles op" });
+				return;
+			}
+		}
+	};
 	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
 	const chapterResetRoute = {
 		kind: "exact",
@@ -7884,6 +8495,7 @@ function makeRoutes(deps) {
 		renameRoute,
 		plotlinesRoute,
 		rolesRoute,
+		mangaRolesRoute,
 		scenesRoute,
 		visualRulesRoute,
 		sensitiveRoute,