277 lines
8.7 KiB
TypeScript
277 lines
8.7 KiB
TypeScript
|
import type {
|
|||
|
|
Persona,
|
|||
|
|
PersonaDraftFields,
|
|||
|
|
PersonaGuard,
|
|||
|
|
PersonaStyle,
|
|||
|
|
StyleDimKey,
|
|||
|
|
StyleDimension,
|
|||
|
|
} from "../domain/types";
|
|||
|
|
import { nowUnixNano } from "./time";
|
|||
|
|
|
|||
|
|
export const DIM_ORDER: StyleDimKey[] = [
|
|||
|
|
"d1Tone",
|
|||
|
|
"d2Structure",
|
|||
|
|
"d3Interaction",
|
|||
|
|
"d4Topics",
|
|||
|
|
"d5Rhythm",
|
|||
|
|
"d6Visual",
|
|||
|
|
"d7Conversion",
|
|||
|
|
"d8Risk",
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
export const DIM_LABELS: Record<StyleDimKey, string> = {
|
|||
|
|
d1Tone: "D1 語氣人格",
|
|||
|
|
d2Structure: "D2 結構模板",
|
|||
|
|
d3Interaction: "D3 互動方式",
|
|||
|
|
d4Topics: "D4 主題分布",
|
|||
|
|
d5Rhythm: "D5 發文節奏",
|
|||
|
|
d6Visual: "D6 視覺語法",
|
|||
|
|
d7Conversion: "D7 轉換方式",
|
|||
|
|
d8Risk: "D8 風險紅線",
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
export type PersonaPromptMode = "post" | "reply" | "outreach" | "inspire";
|
|||
|
|
|
|||
|
|
export function emptyDraftFields(): PersonaDraftFields {
|
|||
|
|
return {
|
|||
|
|
identity: "",
|
|||
|
|
tone: "",
|
|||
|
|
audience: "",
|
|||
|
|
hooks: "",
|
|||
|
|
languageFingerprint: "",
|
|||
|
|
rhythm: "",
|
|||
|
|
punctuation: "",
|
|||
|
|
contentPatterns: "",
|
|||
|
|
knowledgeTranslation: "",
|
|||
|
|
ctaStyle: "",
|
|||
|
|
examples: "",
|
|||
|
|
avoid: "",
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function emptyGuard(): PersonaGuard {
|
|||
|
|
return {
|
|||
|
|
avoid: ["硬廣", "客服腔", "條列說教"],
|
|||
|
|
maxChars: 280,
|
|||
|
|
banAiTone: true,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function emptyStyle(): PersonaStyle {
|
|||
|
|
return {
|
|||
|
|
dimensions: {},
|
|||
|
|
draft: emptyDraftFields(),
|
|||
|
|
draftText: "",
|
|||
|
|
source: "manual",
|
|||
|
|
sampleCount: 0,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function createEmptyPersona(partial?: Partial<Persona> & { id: string; name: string }): Persona {
|
|||
|
|
return {
|
|||
|
|
id: partial?.id || "",
|
|||
|
|
name: partial?.name || "",
|
|||
|
|
brief: partial?.brief || "",
|
|||
|
|
status: partial?.status || "empty",
|
|||
|
|
style: partial?.style || emptyStyle(),
|
|||
|
|
guard: partial?.guard || emptyGuard(),
|
|||
|
|
voice: partial?.voice,
|
|||
|
|
notes: partial?.notes,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 把舊 name/voice/notes 人設升級成三層結構 */
|
|||
|
|
export function normalizePersona(raw: Persona | Record<string, unknown>): Persona {
|
|||
|
|
const r = raw as Partial<Persona> & { voice?: string; notes?: string };
|
|||
|
|
const draft = {
|
|||
|
|
...emptyDraftFields(),
|
|||
|
|
...(r.style?.draft || {}),
|
|||
|
|
};
|
|||
|
|
if (!draft.tone && r.voice) draft.tone = r.voice;
|
|||
|
|
if (!draft.identity && r.name) draft.identity = r.name;
|
|||
|
|
if (!draft.avoid && r.notes) draft.avoid = r.notes;
|
|||
|
|
|
|||
|
|
const style: PersonaStyle = {
|
|||
|
|
dimensions: r.style?.dimensions || {},
|
|||
|
|
draft,
|
|||
|
|
draftText: r.style?.draftText || (r.style ? serializeDraftText(draft) : ""),
|
|||
|
|
source: r.style?.source || "manual",
|
|||
|
|
sampleCount: r.style?.sampleCount || 0,
|
|||
|
|
analyzedAt: r.style?.analyzedAt,
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
if (!style.draftText && (draft.tone || draft.identity)) {
|
|||
|
|
style.draftText = serializeDraftText(draft);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
const hasFingerprint = Boolean(style.draftText.trim()) || Object.keys(style.dimensions).length > 0;
|
|||
|
|
const status = r.status || (hasFingerprint ? "ready" : "empty");
|
|||
|
|
|
|||
|
|
return {
|
|||
|
|
id: String(r.id || ""),
|
|||
|
|
name: String(r.name || "未命名人設"),
|
|||
|
|
brief: String(r.brief || r.notes || ""),
|
|||
|
|
status,
|
|||
|
|
style,
|
|||
|
|
guard: {
|
|||
|
|
...emptyGuard(),
|
|||
|
|
...(r.guard || {}),
|
|||
|
|
avoid: r.guard?.avoid?.length
|
|||
|
|
? r.guard.avoid
|
|||
|
|
: emptyGuard().avoid,
|
|||
|
|
},
|
|||
|
|
voice: r.voice || draft.tone,
|
|||
|
|
notes: r.notes || r.brief,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function serializeDraftText(d: PersonaDraftFields): string {
|
|||
|
|
const lines: string[] = [];
|
|||
|
|
const push = (label: string, value: string) => {
|
|||
|
|
const v = value.trim();
|
|||
|
|
if (v) lines.push(`【${label}】\n${v}`);
|
|||
|
|
};
|
|||
|
|
push("我是誰", d.identity);
|
|||
|
|
push("語氣", d.tone);
|
|||
|
|
push("對誰說", d.audience);
|
|||
|
|
push("開場鉤子", d.hooks);
|
|||
|
|
push("語言指紋", d.languageFingerprint);
|
|||
|
|
push("節奏", d.rhythm);
|
|||
|
|
push("標點", d.punctuation);
|
|||
|
|
push("內容套路", d.contentPatterns);
|
|||
|
|
push("知識轉譯", d.knowledgeTranslation);
|
|||
|
|
push("CTA", d.ctaStyle);
|
|||
|
|
push("像他會說的話", d.examples);
|
|||
|
|
push("絕不怎麼說", d.avoid);
|
|||
|
|
return lines.join("\n\n");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function toneOf(persona?: Persona | null): string {
|
|||
|
|
if (!persona) return "自然口語";
|
|||
|
|
return persona.style?.draft?.tone || persona.voice || "自然口語";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function isPersonaReady(persona?: Persona | null): boolean {
|
|||
|
|
return persona?.status === "ready" && Boolean(persona.style?.draftText?.trim() || persona.style?.draft?.tone);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function personaOptionLabel(persona: Persona): string {
|
|||
|
|
const tone = toneOf(persona);
|
|||
|
|
const badge = persona.status === "ready" ? "ready" : persona.status === "analyzing" ? "分析中" : "待分析";
|
|||
|
|
return `${persona.name} · ${tone}（${badge}）`;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 依任務切片組裝人設 block。
|
|||
|
|
* mock / live 產文都應只吃這個字串。
|
|||
|
|
*/
|
|||
|
|
export function buildPersonaPromptBlock(persona: Persona | null | undefined, mode: PersonaPromptMode): string {
|
|||
|
|
if (!persona) {
|
|||
|
|
return "【人設】尚未選擇。請用台灣繁體、口語、像真人在 Threads 打字。";
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
const p = normalizePersona(persona);
|
|||
|
|
const parts: string[] = [];
|
|||
|
|
|
|||
|
|
// Layer A — who
|
|||
|
|
if (mode === "post" || mode === "inspire" || mode === "outreach") {
|
|||
|
|
const who = [p.name && `名稱：${p.name}`, p.brief && `定位：${p.brief}`, p.style.draft.identity && `角色：${p.style.draft.identity}`]
|
|||
|
|
.filter(Boolean)
|
|||
|
|
.join("\n");
|
|||
|
|
if (who) parts.push(`【人設定位】\n${who}`);
|
|||
|
|
} else {
|
|||
|
|
// reply: light identity
|
|||
|
|
const light = p.style.draft.identity || p.name;
|
|||
|
|
if (light) parts.push(`【人設】你是「${light}」，用自己的語氣回覆。`);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Layer B — how
|
|||
|
|
const draftText = p.style.draftText.trim() || serializeDraftText(p.style.draft);
|
|||
|
|
if (mode === "post") {
|
|||
|
|
if (draftText) parts.push(`【語言指紋與寫作規則】\n${draftText}`);
|
|||
|
|
const d2 = p.style.dimensions.d2Structure?.summary;
|
|||
|
|
const d4 = p.style.dimensions.d4Topics?.summary;
|
|||
|
|
if (d2 || d4) {
|
|||
|
|
parts.push(
|
|||
|
|
`【結構與主題重點】\n${[d2 && `結構：${d2}`, d4 && `主題：${d4}`].filter(Boolean).join("\n")}`,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
} else if (mode === "reply") {
|
|||
|
|
if (draftText) parts.push(`【語言指紋】\n${draftText}`);
|
|||
|
|
const d3 = p.style.dimensions.d3Interaction?.summary;
|
|||
|
|
if (d3) parts.push(`【互動方式】\n${d3}`);
|
|||
|
|
} else if (mode === "outreach") {
|
|||
|
|
const slim = [
|
|||
|
|
p.style.draft.tone && `語氣：${p.style.draft.tone}`,
|
|||
|
|
p.style.draft.avoid && `避免：${p.style.draft.avoid}`,
|
|||
|
|
p.style.draft.languageFingerprint && `用字：${p.style.draft.languageFingerprint}`,
|
|||
|
|
p.style.draft.ctaStyle && `收尾：${p.style.draft.ctaStyle}`,
|
|||
|
|
]
|
|||
|
|
.filter(Boolean)
|
|||
|
|
.join("\n");
|
|||
|
|
if (slim) parts.push(`【外展語氣】\n${slim}`);
|
|||
|
|
else if (draftText) parts.push(`【語言指紋】\n${draftText}`);
|
|||
|
|
} else {
|
|||
|
|
// inspire
|
|||
|
|
const d4 = p.style.dimensions.d4Topics?.summary;
|
|||
|
|
const hooks = p.style.draft.hooks;
|
|||
|
|
const audience = p.style.draft.audience;
|
|||
|
|
parts.push(
|
|||
|
|
`【靈感方向】\n${[
|
|||
|
|
audience && `對誰：${audience}`,
|
|||
|
|
hooks && `鉤子：${hooks}`,
|
|||
|
|
d4 && `主題：${d4}`,
|
|||
|
|
p.style.draft.tone && `語氣：${p.style.draft.tone}`,
|
|||
|
|
]
|
|||
|
|
.filter(Boolean)
|
|||
|
|
.join("\n") || draftText || p.brief}`,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Layer C — guard
|
|||
|
|
const avoid = [
|
|||
|
|
...p.guard.avoid,
|
|||
|
|
...(p.style.draft.avoid ? p.style.draft.avoid.split(/[、,，]/).map((s) => s.trim()).filter(Boolean) : []),
|
|||
|
|
];
|
|||
|
|
const uniqAvoid = [...new Set(avoid)];
|
|||
|
|
const guardLines = [
|
|||
|
|
uniqAvoid.length ? `禁止：${uniqAvoid.join("、")}` : "",
|
|||
|
|
p.guard.banAiTone ? "禁止 AI 腔／客服腔／「總而言之」「希望這對您有幫助」" : "",
|
|||
|
|
p.guard.maxChars ? `長度約不超過 ${p.guard.maxChars} 字` : "",
|
|||
|
|
mode === "reply" ? "你是貼文作者本人在回，不要裝粉絲或官方帳號。" : "",
|
|||
|
|
mode === "outreach" ? "不硬廣；像過來人分享經驗，可輕輕帶觀點。" : "",
|
|||
|
|
].filter(Boolean);
|
|||
|
|
if (guardLines.length) parts.push(`【護欄】\n${guardLines.join("\n")}`);
|
|||
|
|
|
|||
|
|
// Light D1 + D8 always when available for post/reply
|
|||
|
|
if (mode === "post" || mode === "reply") {
|
|||
|
|
const d1 = p.style.dimensions.d1Tone?.summary;
|
|||
|
|
const d8 = p.style.dimensions.d8Risk?.summary;
|
|||
|
|
if (d1 || d8) {
|
|||
|
|
parts.push(
|
|||
|
|
`【語氣與禁忌參考】\n${[d1 && `語氣：${d1}`, d8 && `紅線：${d8}`].filter(Boolean).join("\n")}`,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return parts.join("\n\n") || `【人設】${p.name}：${toneOf(p)}`;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function markReady(persona: Persona): Persona {
|
|||
|
|
const draftText = persona.style.draftText.trim() || serializeDraftText(persona.style.draft);
|
|||
|
|
return {
|
|||
|
|
...persona,
|
|||
|
|
status: draftText ? "ready" : "empty",
|
|||
|
|
style: {
|
|||
|
|
...persona.style,
|
|||
|
|
draftText,
|
|||
|
|
analyzedAt: persona.style.analyzedAt || nowUnixNano(),
|
|||
|
|
},
|
|||
|
|
voice: persona.style.draft.tone || persona.voice,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export function dimSummary(persona: Persona, key: StyleDimKey): StyleDimension | undefined {
|
|||
|
|
return persona.style.dimensions[key];
|
|||
|
|
}
|