@tomako/tools-runtime 0.1.0

package/src/lib/tools/user-interview.generation.ts

@@ -0,0 +1,670 @@
+import type {
+  InterviewGuide,
+  InterviewRecord,
+  InsightReport,
+  ResearchBrief,
+  UserInterviewGoal,
+} from "./user-interview.schema";
+
+export type InterviewGuideTemplate = {
+  interviewTypes: Record<UserInterviewGoal, string>;
+  objectives: Record<UserInterviewGoal, string[]>;
+  participantCriteria: string[];
+  exclusionCriteria: string[];
+  sessionFlow: Record<ResearchBrief["sessionLength"], InterviewGuide["sessionFlow"]>;
+  questions: Record<UserInterviewGoal, InterviewGuide["questions"]>;
+  defaultQuestions: InterviewGuide["questions"];
+  followUpTrees: InterviewGuide["followUpTrees"];
+  strongSignals: string[];
+  weakSignals: string[];
+  riskSignals: string[];
+  postInterviewHandoff: string[];
+};
+
+type OutputLanguage = "zh" | "en";
+
+export function resolveInterviewType(goal: UserInterviewGoal): string {
+  const fallback: Record<UserInterviewGoal, string> = {
+    churn: "Churn interview",
+    discovery: "Exploratory discovery interview",
+    positioning: "Messaging and positioning interview",
+    pricing: "Pricing interview",
+    problemValidation: "Problem validation interview",
+    solutionValidation: "Solution validation interview",
+    usability: "Usability interview",
+  };
+
+  return fallback[goal];
+}
+
+function compactText(text?: string): string {
+  return (text ?? "").replace(/\s+/g, " ").trim();
+}
+
+function hasCjk(text: string): boolean {
+  return /[\u3400-\u9fff]/.test(text);
+}
+
+function inferLanguage(text: string, fallback: OutputLanguage = "en"): OutputLanguage {
+  return hasCjk(text) ? "zh" : fallback;
+}
+
+function languageFromBrief(brief: Pick<ResearchBrief, "language">): OutputLanguage {
+  return brief.language === "zh" ? "zh" : "en";
+}
+
+function label(language: OutputLanguage, zh: string, en: string): string {
+  return language === "zh" ? zh : en;
+}
+
+function takeUnique(items: readonly string[], max: number): string[] {
+  const seen = new Set<string>();
+  const result: string[] = [];
+
+  for (const item of items) {
+    const normalized = compactText(item);
+    const key = normalized.toLowerCase();
+    if (!normalized || seen.has(key)) continue;
+    seen.add(key);
+    result.push(normalized);
+    if (result.length >= max) break;
+  }
+
+  return result;
+}
+
+function compactLines(text: string): string[] {
+  return text
+    .split(/\r?\n+/)
+    .flatMap((line) => line.split(/(?<=[。！？.!?])\s+/))
+    .map((line) => line.trim())
+    .filter((line) => line.length >= 8);
+}
+
+function includesAny(text: string, terms: readonly string[]): boolean {
+  const lower = text.toLowerCase();
+  return terms.some((term) => lower.includes(term.toLowerCase()));
+}
+
+function pickEvidenceLines(
+  lines: readonly string[],
+  terms: readonly string[],
+  fallbackCount = 2,
+): string[] {
+  const matches = lines.filter((line) => includesAny(line, terms));
+  return takeUnique(matches.length ? matches : lines, fallbackCount);
+}
+
+function contextualizeList(
+  items: readonly string[],
+  context: string,
+  language: OutputLanguage,
+  max = 4,
+): string[] {
+  const suffix = context
+    ? label(language, `结合：${context}`, `Context: ${context}`)
+    : "";
+
+  return takeUnique(
+    items.map((item, index) =>
+      index < 2 && suffix ? `${item} ${suffix}` : item,
+    ),
+    max,
+  );
+}
+
+export function createInterviewGuideFromTemplate(
+  brief: ResearchBrief,
+  template: InterviewGuideTemplate,
+): InterviewGuide {
+  const language = languageFromBrief(brief);
+  const productName = compactText(brief.productName);
+  const targetParticipants = compactText(brief.targetParticipants);
+  const decision = compactText(brief.decisionToMake);
+  const hypotheses = compactText(brief.knownHypotheses);
+  const context = [
+    productName,
+    decision
+      ? label(language, `本轮要支持的决策：${decision}`, `decision to support: ${decision}`)
+      : "",
+    hypotheses
+      ? label(language, `待验证假设：${hypotheses}`, `hypothesis to test: ${hypotheses}`)
+      : "",
+  ]
+    .filter(Boolean)
+    .join("；");
+  const goalQuestions =
+    template.questions[brief.interviewGoal] ?? template.defaultQuestions;
+  const productStageLine = label(
+    language,
+    `当前阶段是「${brief.productStage}」，问题需要贴近这一步的真实风险。`,
+    `Current stage is "${brief.productStage}", so questions should focus on the risks of this stage.`,
+  );
+
+  return {
+    recommendedInterviewType:
+      template.interviewTypes[brief.interviewGoal] ??
+      resolveInterviewType(brief.interviewGoal),
+    researchObjectives: takeUnique(
+      [
+        ...contextualizeList(template.objectives[brief.interviewGoal] ?? template.objectives.discovery, context, language, 3),
+        decision
+          ? label(language, `把访谈证据映射到决策：${decision}`, `Map interview evidence back to the decision: ${decision}`)
+          : productStageLine,
+        hypotheses
+          ? label(language, `验证或推翻假设：${hypotheses}`, `Confirm or reject this hypothesis: ${hypotheses}`)
+          : "",
+      ],
+      5,
+    ),
+    participantCriteria: takeUnique(
+      [
+        targetParticipants
+          ? label(language, `优先招募：${targetParticipants}`, `Prioritize participants: ${targetParticipants}`)
+          : "",
+        label(
+          language,
+          `能讲出和「${productName}」相关的最近一次真实经历。`,
+          `Can describe a recent real situation related to "${productName}".`,
+        ),
+        ...template.participantCriteria,
+      ],
+      5,
+    ),
+    exclusionCriteria: takeUnique(
+      [
+        label(
+          language,
+          "只有抽象兴趣、不能回忆具体案例的人。",
+          "People with abstract interest but no concrete recent example.",
+        ),
+        ...template.exclusionCriteria,
+      ],
+      5,
+    ),
+    sessionFlow: template.sessionFlow[brief.sessionLength],
+    questions: goalQuestions.map((item) => ({
+      ...item,
+      purpose: context
+        ? `${item.purpose} ${label(language, `关联到 ${productName} 的当前决策。`, `Tie it back to the current decision for ${productName}.`)}`
+        : item.purpose,
+      followUps: takeUnique(
+        [
+          ...item.followUps,
+          decision
+            ? label(language, `这个回答会如何改变「${decision}」？`, `How would this answer change "${decision}"?`)
+            : "",
+          targetParticipants
+            ? label(language, `这在「${targetParticipants}」中是否常见？`, `Is this common among "${targetParticipants}"?`)
+            : "",
+        ],
+        5,
+      ),
+    })),
+    followUpTrees: template.followUpTrees.map((tree) => ({
+      ...tree,
+      probes: takeUnique(
+        [
+          ...tree.probes,
+          label(language, "请给出最近一次具体例子。", "Ask for the most recent concrete example."),
+        ],
+        4,
+      ),
+    })),
+    strongSignals: takeUnique(
+      [
+        ...template.strongSignals,
+        decision
+          ? label(language, `回答能直接影响「${decision}」。`, `The answer directly changes "${decision}".`)
+          : "",
+      ],
+      6,
+    ),
+    weakSignals: template.weakSignals,
+    riskSignals: takeUnique(
+      [
+        ...template.riskSignals,
+        label(
+          language,
+          "受访者描述的真实任务和当前产品假设不匹配。",
+          "The participant's real task does not match the current product assumption.",
+        ),
+      ],
+      6,
+    ),
+    postInterviewHandoff: template.postInterviewHandoff,
+  };
+}
+
+export function stringifyInterviewGuide(guide: InterviewGuide): string {
+  const lines = [
+    `# ${guide.recommendedInterviewType}`,
+    "",
+    "## Research objectives",
+    ...guide.researchObjectives.map((item) => `- ${item}`),
+    "",
+    "## Participant criteria",
+    ...guide.participantCriteria.map((item) => `- ${item}`),
+    "",
+    "## Interview questions",
+    ...guide.questions.flatMap((item, index) => [
+      `${index + 1}. ${item.question}`,
+      `   - Purpose: ${item.purpose}`,
+      `   - Listen for: ${item.listenFor.join("; ")}`,
+      `   - Follow-ups: ${item.followUps.join("; ")}`,
+      `   - Avoid: ${item.avoid}`,
+    ]),
+    "",
+    "## Strong signals",
+    ...guide.strongSignals.map((item) => `- ${item}`),
+    "",
+    "## Weak signals",
+    ...guide.weakSignals.map((item) => `- ${item}`),
+    "",
+    "## Risk signals",
+    ...guide.riskSignals.map((item) => `- ${item}`),
+  ];
+
+  return lines.join("\n");
+}
+
+export type InterviewRecordInput = {
+  transcript: string;
+  productContext?: string;
+  researchGoal?: string;
+  participantContext?: string;
+  language?: OutputLanguage;
+};
+
+function extractQuotedEvidence(lines: readonly string[]): string[] {
+  return takeUnique(
+    lines
+      .filter((line) => !/^interviewer\s*:/i.test(line))
+      .filter((line) => !/^主持人\s*[:：]/.test(line))
+      .filter((line) => line.length > 24)
+      .map((line) => line.replace(/^(participant|user|受访者|用户)\s*[:：]\s*/i, "")),
+    5,
+  );
+}
+
+function painLabel(evidence: string, language: OutputLanguage): string {
+  if (includesAny(evidence, ["hour", "hours", "day", "spent", "花", "耗时", "天"])) {
+    return label(language, "时间成本或返工", "Time cost or rework");
+  }
+  if (includesAny(evidence, ["$", "pay", "paid", "budget", "cost", "付费", "预算", "成本"])) {
+    return label(language, "金钱或预算压力", "Money or budget pressure");
+  }
+  if (includesAny(evidence, ["delay", "blocked", "stuck", "延期", "卡住", "阻塞"])) {
+    return label(language, "延期或流程阻塞", "Delay or workflow blocker");
+  }
+
+  return label(language, "转写中提到的痛点或阻力", "Pain or friction mentioned in the transcript");
+}
+
+function emptyEvidence(language: OutputLanguage, topic: string): string[] {
+  return [label(language, `转写中没有明确找到「${topic}」，下一场需要追问。`, `No clear "${topic}" evidence found; ask a follow-up next time.`)];
+}
+
+export function createInterviewRecordFromTranscript(
+  input: InterviewRecordInput,
+): InterviewRecord {
+  const language = input.language ?? inferLanguage(input.transcript, "en");
+  const lines = compactLines(input.transcript);
+  const painEvidence = pickEvidenceLines(lines, [
+    "annoying",
+    "hard",
+    "difficult",
+    "delay",
+    "delayed",
+    "stuck",
+    "spent",
+    "hours",
+    "cost",
+    "麻烦",
+    "卡",
+    "延期",
+    "花了",
+    "耗时",
+    "成本",
+  ], 4);
+  const workflowEvidence = pickEvidenceLines(lines, [
+    "first",
+    "then",
+    "used",
+    "tool",
+    "manual",
+    "workflow",
+    "process",
+    "先",
+    "然后",
+    "工具",
+    "手动",
+    "流程",
+  ], 4);
+  const buyingEvidence = pickEvidenceLines(lines, [
+    "pay",
+    "paid",
+    "dollars",
+    "$",
+    "subscribe",
+    "budget",
+    "付费",
+    "多少钱",
+    "预算",
+    "订阅",
+  ], 4);
+  const alternativeEvidence = pickEvidenceLines(lines, [
+    "alternative",
+    "instead",
+    "tool",
+    "template",
+    "agency",
+    "manual",
+    "spreadsheet",
+    "替代",
+    "工具",
+    "模板",
+    "自己",
+    "表格",
+  ], 4);
+  const recentBehavior = pickEvidenceLines(lines, [
+    "last time",
+    "recent",
+    "yesterday",
+    "last week",
+    "two months",
+    "上一次",
+    "最近",
+    "昨天",
+    "上周",
+  ], 4);
+
+  return {
+    participantProfile:
+      compactText(input.participantContext) ||
+      label(language, "未提供受访者背景；仅根据转写谨慎整理。", "Participant profile was not provided; infer cautiously from transcript only."),
+    interviewContext:
+      compactText(input.researchGoal) ||
+      compactText(input.productContext) ||
+      label(language, "未提供访谈背景；建议补充研究目标后重新整理。", "Interview context was not provided; add the research goal before relying on this record."),
+    recentBehavior: recentBehavior.length ? recentBehavior : emptyEvidence(language, label(language, "近期真实行为", "recent behavior")),
+    workflow: workflowEvidence.length ? workflowEvidence : emptyEvidence(language, label(language, "工具和流程", "workflow")),
+    painPoints: (painEvidence.length ? painEvidence : lines.slice(0, 2)).map((evidence) => ({
+      pain: painLabel(evidence, language),
+      evidence,
+      cost: includesAny(evidence, ["hour", "hours", "day", "花", "天", "$", "dollar", "cost", "预算"])
+        ? label(language, "转写中包含明确或部分成本线索。", "Transcript contains explicit or partial cost evidence.")
+        : label(language, "成本仍需下一场追问确认。", "Cost needs a follow-up question."),
+      confidence: includesAny(evidence, ["hour", "hours", "delay", "延期", "花了", "$", "budget"])
+        ? "medium"
+        : "low",
+    })),
+    alternatives: alternativeEvidence.length ? alternativeEvidence : emptyEvidence(language, label(language, "替代方案", "alternatives")),
+    buyingSignals: buyingEvidence.length ? buyingEvidence : emptyEvidence(language, label(language, "付费或采用信号", "buying or adoption signals")),
+    quotes: extractQuotedEvidence(lines),
+    strongSignals: takeUnique(
+      [
+        label(
+          language,
+          "强信号优先看：近期真实行为、具名工具、明确时间/金钱成本、已付费或强替代证据。",
+          "Strong signals: recent behavior, named tools, explicit time/money cost, paid workaround or strong alternative evidence.",
+        ),
+        ...buyingEvidence.slice(0, 2),
+      ],
+      4,
+    ),
+    weakSignals: [
+      label(
+        language,
+        "礼貌性认可、未来可能会用、只愿意免费试试，都应视为弱信号。",
+        "Compliments, future-tense interest, and free-only interest should be treated as weak evidence.",
+      ),
+    ],
+    missedFollowUps: [
+      label(language, "追问最耗时或最不确定的一步。", "Ask for the exact step that consumed the most time or created most uncertainty."),
+      label(language, "追问是否造成延期、额外支出、质量下降或机会损失。", "Ask whether this caused delay, extra spend, quality loss, or missed opportunity."),
+      label(language, "追问当前替代工具为什么还不够好。", "Ask why the current alternative is still not good enough."),
+      label(language, "要求对方提供下一步可测试的真实材料或场景。", "Ask for a concrete next-step test using real materials or a real scenario."),
+    ],
+    openQuestions: [
+      label(language, "这个场景多久重复一次？", "How often does this scenario repeat?"),
+      label(language, "谁拥有预算或最终决策权？", "Who owns the budget or final decision?"),
+      label(language, "结果达到什么标准才足够可用？", "What result quality would be good enough to use?"),
+    ],
+  };
+}
+
+export function stringifyInterviewRecord(record: InterviewRecord): string {
+  const lines = [
+    "# Interview Record",
+    "",
+    "## Participant snapshot",
+    record.participantProfile,
+    "",
+    "## Interview context",
+    record.interviewContext,
+    "",
+    "## Recent behavior",
+    ...record.recentBehavior.map((item) => `- ${item}`),
+    "",
+    "## Workflow",
+    ...record.workflow.map((item) => `- ${item}`),
+    "",
+    "## Pain points",
+    ...record.painPoints.map(
+      (item) =>
+        `- ${item.pain}: ${item.evidence} (cost: ${item.cost}; confidence: ${item.confidence})`,
+    ),
+    "",
+    "## Alternatives",
+    ...record.alternatives.map((item) => `- ${item}`),
+    "",
+    "## Buying signals",
+    ...record.buyingSignals.map((item) => `- ${item}`),
+    "",
+    "## Quotes",
+    ...record.quotes.map((item) => `- "${item}"`),
+    "",
+    "## Missed follow-ups",
+    ...record.missedFollowUps.map((item) => `- ${item}`),
+  ];
+
+  return lines.join("\n");
+}
+
+export type InsightReportInput = {
+  recordsText: string;
+  researchGoal?: string;
+  decisionToMake?: string;
+  language?: OutputLanguage;
+};
+
+function splitRecordBlocks(text: string): string[] {
+  const blocks = text
+    .split(/\n\s*(?:---|##\s+Record\s+\d+|#\s+Record\s+\d+|记录\s*\d+|访谈\s*\d+)\s*\n/i)
+    .map((block) => block.trim())
+    .filter((block) => block.length > 40);
+
+  if (blocks.length > 1) return blocks;
+
+  return text
+    .split(/\n\s*\n(?=(?:Participant|受访者|Record|记录)\s*[:：])/i)
+    .map((block) => block.trim())
+    .filter((block) => block.length > 40);
+}
+
+function countMatches(text: string, terms: readonly string[]): number {
+  const lower = text.toLowerCase();
+  return terms.reduce(
+    (count, term) => count + (lower.includes(term.toLowerCase()) ? 1 : 0),
+    0,
+  );
+}
+
+function confidenceFrom(count: number, recordCount: number): "high" | "medium" | "low" {
+  if (recordCount >= 6 && count >= 4) return "high";
+  if (recordCount >= 3 && count >= 2) return "medium";
+  return "low";
+}
+
+function buildTheme(
+  language: OutputLanguage,
+  sourceLines: readonly string[],
+  sourceText: string,
+  recordCount: number,
+  theme: { zh: string; en: string; terms: string[] },
+): InsightReport["themeClusters"][number] | null {
+  const evidence = pickEvidenceLines(sourceLines, theme.terms, 4);
+  const count = countMatches(sourceText, theme.terms);
+  if (!count && evidence.length === 0) return null;
+
+  return {
+    theme: label(language, theme.zh, theme.en),
+    evidence,
+    confidence: confidenceFrom(count, recordCount),
+  };
+}
+
+export function createInsightReportFromRecords(
+  input: InsightReportInput,
+): InsightReport {
+  const language = input.language ?? inferLanguage(input.recordsText, "en");
+  const records = splitRecordBlocks(input.recordsText);
+  const sourceText = input.recordsText;
+  const sourceLines = compactLines(sourceText);
+  const recordCount = Math.max(records.length, 1);
+  const globalConfidence = recordCount >= 6 ? "high" : recordCount >= 3 ? "medium" : "low";
+  const researchGoal = compactText(input.researchGoal);
+  const decision = compactText(input.decisionToMake);
+  const themes = [
+    buildTheme(language, sourceLines, sourceText, recordCount, {
+      zh: "用户反复提到同一类流程阻力",
+      en: "Participants repeatedly mention workflow friction",
+      terms: ["workflow", "process", "manual", "stuck", "delay", "流程", "手动", "卡", "延期"],
+    }),
+    buildTheme(language, sourceLines, sourceText, recordCount, {
+      zh: "当前替代方案存在明显缺口",
+      en: "Current alternatives leave clear gaps",
+      terms: ["alternative", "tool", "template", "spreadsheet", "instead", "替代", "工具", "模板", "表格", "自己"],
+    }),
+    buildTheme(language, sourceLines, sourceText, recordCount, {
+      zh: "时间、金钱或质量成本正在累积",
+      en: "Time, money, or quality cost is accumulating",
+      terms: ["hour", "hours", "cost", "pay", "budget", "quality", "花", "耗时", "成本", "付费", "预算", "质量"],
+    }),
+    buildTheme(language, sourceLines, sourceText, recordCount, {
+      zh: "使用门槛和信任边界仍需验证",
+      en: "Adoption threshold and trust boundary still need validation",
+      terms: ["trust", "risk", "accurate", "edit", "review", "privacy", "信任", "风险", "准确", "编辑", "隐私", "复核"],
+    }),
+  ].filter((theme): theme is InsightReport["themeClusters"][number] => Boolean(theme));
+
+  const fallbackThemes = themes.length
+    ? themes
+    : [
+        {
+          theme: label(language, "访谈材料需要进一步结构化后再综合", "Interview material needs more structure before synthesis"),
+          evidence: takeUnique(sourceLines, 4),
+          confidence: "low" as const,
+        },
+      ];
+
+  return {
+    executiveSummary: [
+      label(
+        language,
+        `已识别 ${recordCount} 份记录；整体置信度为 ${globalConfidence}。`,
+        `${recordCount} record(s) identified; overall confidence is ${globalConfidence}.`,
+      ),
+      researchGoal
+        ? label(language, `本轮研究目标：${researchGoal}`, `Research goal: ${researchGoal}`)
+        : label(language, "未提供研究目标，报告只按文本证据做方向性整理。", "No research goal was provided, so the report remains directional."),
+      decision
+        ? label(language, `建议只把高证据发现用于支持决策：${decision}`, `Use only well-evidenced findings to support this decision: ${decision}`)
+        : label(language, "重复行为和明确代价应优先于口头兴趣。", "Repeated behavior and explicit cost should outweigh stated interest."),
+    ],
+    participantSegments: [
+      label(language, "高证据用户：能描述近期真实行为、具名工具和明确代价。", "High-evidence users: describe recent behavior, named tools, and clear cost."),
+      label(language, "待验证用户：表达兴趣但缺少具体场景、预算或频率。", "Needs-validation users: express interest but lack concrete scenario, budget, or frequency."),
+      label(language, "不匹配用户：问题由其他角色负责，或现有方案已经足够。", "Poor-fit users: the problem is owned by another role or current solutions are good enough."),
+    ],
+    themeClusters: fallbackThemes,
+    painPointRanking: fallbackThemes.map((theme, index) =>
+      label(
+        language,
+        `${index + 1}. ${theme.theme}：置信度 ${theme.confidence}，优先复核证据是否来自多份记录。`,
+        `${index + 1}. ${theme.theme}: confidence ${theme.confidence}; verify whether evidence appears across multiple records.`,
+      ),
+    ),
+    alternativeMap: [
+      label(language, "当前工具或手工流程：从记录里提取具名工具、模板、表格、人工服务或 workaround。", "Current tools/manual flow: extract named tools, templates, spreadsheets, services, or workarounds from records."),
+      label(language, "继续不用的原因：若用户能忍受现状，说明痛点强度可能不够。", "Reason to keep doing nothing: if users tolerate the status quo, pain intensity may be weak."),
+      label(language, "替代成本：关注学习成本、迁移成本、质量风险和协作阻力。", "Switching cost: watch learning cost, migration cost, quality risk, and collaboration friction."),
+    ],
+    evidenceStrength: [
+      label(language, `样本量：${recordCount}；整体置信度：${globalConfidence}。`, `Sample size: ${recordCount}; overall confidence: ${globalConfidence}.`),
+      label(language, "强证据：近期行为、具名替代方案、明确时间/金钱/风险代价。", "Strong evidence: recent behavior, named alternatives, explicit time/money/risk cost."),
+      label(language, "弱证据：礼貌性认可、未来可能会用、没有具体案例的主观判断。", "Weak evidence: compliments, future-tense interest, and subjective judgment without examples."),
+    ],
+    opportunityMap: fallbackThemes.slice(0, 3).map((theme) =>
+      decision
+        ? label(language, `围绕「${theme.theme}」设计一个能验证「${decision}」的小实验。`, `Design a small experiment around "${theme.theme}" to validate "${decision}".`)
+        : label(language, `围绕「${theme.theme}」设计一个低成本原型或访谈追问。`, `Design a low-cost prototype or follow-up question around "${theme.theme}".`),
+    ),
+    mvpRecommendation: [
+      label(language, "先选择证据最集中、使用场景最窄的一步作为 MVP。", "Start with the narrowest workflow step with the densest evidence."),
+      label(language, "MVP 输出必须能直接替代或改善现有 workaround 的关键部分。", "The MVP output must replace or improve a key part of the existing workaround."),
+      label(language, "低置信主题进入下一轮访谈，不直接进入开发排期。", "Low-confidence themes should go into the next interview round, not directly into the roadmap."),
+    ],
+    pricingSignals: [
+      label(language, "优先寻找过去付费、预算归属、替代成本和时间节省证据。", "Look first for past payment, budget owner, switching cost, and time-saved evidence."),
+      label(language, "口头愿付价格只作为假设，需要通过预售、试点或人工服务验证。", "Stated willingness to pay is only a hypothesis; validate with pre-sale, pilot, or concierge test."),
+      label(language, "若记录中没有成本证据，先不要把定价作为结论。", "If records contain no cost evidence, do not treat pricing as a conclusion."),
+    ],
+    messagingSignals: [
+      label(language, "直接保留用户描述问题和替代方案的原话。", "Preserve the user's own language for the problem and alternatives."),
+      label(language, "把高频词用于 landing page 和下一轮访谈筛选问题。", "Use repeated terms in landing page copy and next-round screening questions."),
+      label(language, "避免把团队内部术语当成用户自然语言。", "Avoid treating internal terminology as natural customer language."),
+    ],
+    nextExperiments: [
+      label(language, "用最高置信主题设计 3-5 个可观察任务或原型测试。", "Turn the highest-confidence theme into 3-5 observable task or prototype tests."),
+      label(language, "邀请提到强痛点的用户参与下一步真实材料测试。", "Invite users who described strong pain to test with real materials."),
+      label(language, "为低置信或矛盾主题补访谈，而不是用平均结论抹平。", "Run more interviews for low-confidence or contradictory themes instead of averaging them away."),
+    ],
+    risksAndUnknowns: [
+      label(language, "访谈样本不能单独推断市场规模或比例。", "Interviews alone cannot estimate market size or prevalence."),
+      label(language, "若记录格式混乱，主题聚类可能遗漏上下文，需要人工复核原文。", "If records are messy, theme clustering may miss context; review the source text."),
+      label(language, "建议和 MVP 方向都应再用行为数据、支付或原型实验验证。", "Recommendations and MVP direction should be validated with behavior data, payment, or prototype tests."),
+    ],
+  };
+}
+
+export function stringifyInsightReport(report: InsightReport): string {
+  const lines = [
+    "# User Interview Insight Report",
+    "",
+    "## Executive summary",
+    ...report.executiveSummary.map((item) => `- ${item}`),
+    "",
+    "## Theme clusters",
+    ...report.themeClusters.flatMap((theme) => [
+      `### ${theme.theme}`,
+      `Confidence: ${theme.confidence}`,
+      ...theme.evidence.map((item) => `- ${item}`),
+      "",
+    ]),
+    "## Evidence strength",
+    ...report.evidenceStrength.map((item) => `- ${item}`),
+    "",
+    "## Pain point ranking",
+    ...report.painPointRanking.map((item) => `- ${item}`),
+    "",
+    "## MVP recommendation",
+    ...report.mvpRecommendation.map((item) => `- ${item}`),
+    "",
+    "## Next experiments",
+    ...report.nextExperiments.map((item) => `- ${item}`),
+  ];
+
+  return lines.join("\n");
+}