接通主角绑定、开场封印与游玩辅助，让世界模拟器从创作连续落到本局。

直聘插入按模块回馈，并记录请求骨架便于排查。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-22 07:40:08 +08:00
parent 9306c8e659
commit dd0a9e87d8
88 changed files with 6869 additions and 786 deletions
@@ -0,0 +1,238 @@
+/**
+ * 开场白 meta 里的用户角色（名字+简介）是本条开场的初始设定。
+ * 用户选用后只覆盖本局 @玩家 / @人设，不写进全局角色列表。
+ */
+import type { Blackboard } from "../blackboard/blackboard.js";
+import {
+  CREATION_PLACEHOLDER_NAME,
+  personaForLifecycle,
+  type PersonaDirective,
+} from "./store.js";
+import {
+  OPENING_PERSONA_CHOICE_TAG,
+  OPENING_PERSONA_TAG,
+  parseOpeningSealPayload,
+  readSealedOpeningPersona,
+  splitOpeningDocument,
+} from "../skills/opening-seal.js";
+
+export const PROTAGONIST_TAG = "设计.主角设定";
+
+const RESERVED_NAMES = new Set(["@玩家", "用户", "主角", CREATION_PLACEHOLDER_NAME]);
+
+export type ProtagonistSpec = {
+  name: string;
+  background: string;
+  identity: string;
+  cheat: string;
+  extra: string;
+};
+
+export type SessionProtagonist = {
+  name: string;
+  description: string;
+  summary: string;
+};
+
+export function parseProtagonistSpec(
+  raw: string | null | undefined,
+): ProtagonistSpec | null {
+  const text = raw?.trim() ?? "";
+  if (!text) return null;
+  const fromJson = parseFromJson(text);
+  if (fromJson) return fromJson;
+  return parseFromProse(text);
+}
+
+export function readSessionProtagonist(
+  board: Blackboard,
+): SessionProtagonist | null {
+  const sealed = readSealedOpeningPersona(
+    board.getContentByTag(OPENING_PERSONA_TAG),
+  );
+  const fromOpening =
+    sealed ??
+    parseOpeningSealPayload(board.getContentByTag("设计.开场白与开场变量"))
+      ?.persona ??
+    splitOpeningDocument(board.getContentByTag("设计.开场白")).persona;
+  if (fromOpening) {
+    return {
+      name: fromOpening.name,
+      description: fromOpening.description,
+      summary: firstSentence(fromOpening.description),
+    };
+  }
+  const spec = parseProtagonistSpec(board.getContentByTag(PROTAGONIST_TAG));
+  if (!spec) return null;
+  return {
+    name: spec.name,
+    description: formatPersonaDescription(spec),
+    summary: formatProtagonistSummary(spec),
+  };
+}
+
+export function formatPersonaDescription(spec: ProtagonistSpec): string {
+  const special: string[] = [];
+  if (spec.identity && spec.identity !== "无") special.push(`身份：${spec.identity}`);
+  if (spec.cheat && spec.cheat !== "无") special.push(`金手指：${spec.cheat}`);
+  if (spec.extra && spec.extra !== "无") special.push(spec.extra);
+  const parts: string[] = [];
+  if (spec.background && spec.background !== "未定") {
+    parts.push(`背景：${spec.background}`);
+  }
+  if (special.length) parts.push(`特殊设定：${special.join("；")}`);
+  return parts.join("\n").trim();
+}
+
+export function formatProtagonistSummary(spec: ProtagonistSpec): string {
+  const bits = [spec.identity, spec.cheat, spec.background]
+    .map((s) => firstSentence(s))
+    .filter((s) => s && s !== "无" && s !== "未定");
+  return bits.slice(0, 2).join(" · ");
+}
+
+/** 用户选用开场预设后，用开场里的名字+简介替换 @玩家 / @人设。 */
+export function overlayPlayPersona(
+  stage: "design" | "play",
+  board: Blackboard | null | undefined,
+): PersonaDirective | null {
+  const base = personaForLifecycle(stage);
+  if (stage !== "play" || !board || !base) return base;
+  const choice = board.getContentByTag(OPENING_PERSONA_CHOICE_TAG)?.trim();
+  if (choice === "global") return base;
+  const preset = readSessionProtagonist(board);
+  if (!preset) return base;
+  if (choice === "opening") {
+    return {
+      name: preset.name,
+      description: preset.description || base.description,
+    };
+  }
+  return base;
+}
+
+function parseFromJson(text: string): ProtagonistSpec | null {
+  const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+  const candidates = fenced ? [fenced[1].trim(), text] : [text];
+  for (const candidate of candidates) {
+    let doc: unknown;
+    try {
+      doc = JSON.parse(candidate);
+    } catch {
+      continue;
+    }
+    const spec = specFromUnknown(doc);
+    if (spec) return spec;
+  }
+  return null;
+}
+
+function specFromUnknown(doc: unknown): ProtagonistSpec | null {
+  if (!doc || typeof doc !== "object" || Array.isArray(doc)) return null;
+  const row = doc as Record<string, unknown>;
+  const body =
+    row.正文 && typeof row.正文 === "object" && !Array.isArray(row.正文)
+      ? (row.正文 as Record<string, unknown>)
+      : row;
+  const name = readName(body.名字 ?? body.name);
+  if (!name) return null;
+  const special = body.特殊设定;
+  const specialObj =
+    special && typeof special === "object" && !Array.isArray(special)
+      ? (special as Record<string, unknown>)
+      : null;
+  const specialText = typeof special === "string" ? special.trim() : "";
+  return {
+    name,
+    background: readText(body.背景 ?? body.background) || "未定",
+    identity:
+      readText(specialObj?.身份 ?? specialObj?.identity ?? body.身份) ||
+      (specialText && !specialObj ? specialText : "") ||
+      "无",
+    cheat: readText(specialObj?.金手指 ?? specialObj?.cheat ?? body.金手指) || "无",
+    extra: readText(specialObj?.其它 ?? specialObj?.extra ?? body.其它) || "无",
+  };
+}
+
+function parseFromProse(text: string): ProtagonistSpec | null {
+  const name = extractName(
+    matchField(text, "名字") ||
+      matchField(text, "姓名") ||
+      matchField(text, "name"),
+  );
+  if (!name) return null;
+  const cheat =
+    matchField(text, "金手指") || matchField(text, "能做什么") || "无";
+  const background =
+    matchField(text, "背景") || matchField(text, "关键背景") || "未定";
+  return {
+    name,
+    background,
+    identity: matchField(text, "身份") || "无",
+    cheat,
+    extra: matchField(text, "其它") || matchField(text, "特殊设定") || "无",
+  };
+}
+
+function readName(raw: unknown): string | null {
+  return extractName(readText(raw));
+}
+
+function extractName(raw: string): string | null {
+  const stripped = stripMd(raw).trim();
+  if (!stripped) return null;
+  const firstLine = stripped.split(/\n/)[0]?.trim() ?? "";
+  const clause = firstLine.split(/[。！？；.!?;]/)[0]?.trim() ?? "";
+  const noQuote = clause.replace(/^[「『“"']|[」』”"']$/g, "").trim();
+  const noParen = noQuote.replace(/[（(].*$/, "").trim();
+  const candidate = noParen || noQuote;
+  if (!usableName(candidate)) return null;
+  if (candidate.length > 16) return null;
+  return candidate;
+}
+
+function usableName(name: string): boolean {
+  const n = name.trim();
+  if (!n) return false;
+  if (RESERVED_NAMES.has(n)) return false;
+  if (n.includes("@玩家")) return false;
+  if (/^（?待/.test(n)) return false;
+  return true;
+}
+
+function readText(raw: unknown): string {
+  if (typeof raw !== "string") return "";
+  return raw.trim();
+}
+
+function stripMd(text: string): string {
+  return text.replace(/\*\*/g, "").replace(/^#+\s*/, "").trim();
+}
+
+function firstSentence(text: string): string {
+  const flat = stripMd(text).replace(/\s+/g, " ").trim();
+  if (!flat) return "";
+  const clause = flat.split(/[。！？\n]/)[0]?.trim() ?? "";
+  if (clause.length <= 36) return clause;
+  return `${clause.slice(0, 36)}…`;
+}
+
+function matchField(text: string, label: string): string {
+  const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const sameLine = text.match(new RegExp(`${escaped}[：:]\\s*([^\\n]+)`));
+  if (sameLine?.[1]?.trim()) return sameLine[1].trim();
+  return markdownSection(text, escaped);
+}
+
+function markdownSection(text: string, escapedTitle: string): string {
+  const re = new RegExp(
+    `^#{1,3}\\s*${escapedTitle}(?=\\s|[（(:：]|$)[^\\n]*$`,
+    "im",
+  );
+  const m = re.exec(text);
+  if (!m) return "";
+  const rest = text.slice(m.index + m[0].length);
+  const next = rest.search(/^#{1,3}\s+/m);
+  const body = (next >= 0 ? rest.slice(0, next) : rest).trim();
+  return body.split(/\n---\s*\n/)[0]?.trim() ?? "";
+}