c6651b74b9
P1-6 useStyleLearn/useKimiOauth 修 stale-closure 依赖。 P1-7 CommandPalette/Drawer 加 focus trap（新 lib/a11y/focusTrap）。 P1-8 SSE 解析与 server.ts 去 as 强转改类型守卫/运行时校验。 P2 删冗余强转、开 noUncheckedIndexedAccess、Toast 清理+稳定 key、列表 key 稳定化、 rel=noopener、useMemo 大文本、ConflictCard role=group、useInjection 加锁、 client.test 真断言。 codegen 重生成 schema.d.ts + 消费 DimensionEntry/ReviewConflictView 强类型。
118 lines
4.5 KiB
TypeScript
118 lines
4.5 KiB
TypeScript
// 文风纯逻辑：指纹归一（dims+evidence）、漂移归一（从 chapter_reviews.style）、
|
||
// 学文风/回炉请求体组装。纯逻辑，便于 node 环境单测（C3 扩 T4.3 / C4 扩 T4.2）。
|
||
|
||
import type {
|
||
ReviewHistoryItem,
|
||
StyleFingerprintResponse,
|
||
StyleLearnRequest,
|
||
RefineRequest,
|
||
} from "@/lib/api/types";
|
||
import type { StyleDriftReport, StyleDriftSegment } from "@/lib/review/sse";
|
||
|
||
export type { StyleDriftReport, StyleDriftSegment } from "@/lib/review/sse";
|
||
|
||
// ── 指纹（16 维 + 证据，UX §6.9）─────────────────────────────────
|
||
// 后端 dimensions: DimensionEntry[]（每条 {name,value,evidence}，强类型，替代弱类型 dict）。
|
||
export interface FingerprintDimension {
|
||
name: string;
|
||
value: string;
|
||
evidence: string[];
|
||
}
|
||
|
||
export interface Fingerprint {
|
||
dimensions: FingerprintDimension[];
|
||
version: number;
|
||
}
|
||
|
||
// 把 GET /style 响应映射成 Fingerprint。
|
||
// dimensions 数组顺序即维度顺序（身份）；每条已携带 name/value/evidence。
|
||
export function normalizeFingerprint(
|
||
resp: StyleFingerprintResponse | undefined,
|
||
): Fingerprint | null {
|
||
if (!resp) return null;
|
||
const dimensions: FingerprintDimension[] = (resp.dimensions ?? []).map(
|
||
(d) => ({
|
||
name: d.name,
|
||
value: d.value,
|
||
evidence: d.evidence ?? [],
|
||
}),
|
||
);
|
||
return { dimensions, version: resp.version };
|
||
}
|
||
|
||
// ── 漂移（第四审，C4 扩 T4.2）────────────────────────────────────
|
||
// chapter_reviews.style = {score:int, segments:[{idx,score,label?}]}。
|
||
// 类型 StyleDriftReport/StyleDriftSegment 在 lib/review/sse.ts（reduce 复用），上面已 re-export。
|
||
|
||
function asInt(v: unknown, fallback = 0): number {
|
||
return typeof v === "number" && Number.isFinite(v) ? Math.round(v) : fallback;
|
||
}
|
||
|
||
function asOptionalString(v: unknown): string | null {
|
||
return typeof v === "string" ? v : null;
|
||
}
|
||
|
||
// 把松散 style dict 收窄成漂移报告；缺失/非 dict → null（不渲染）。
|
||
export function normalizeStyleDrift(
|
||
item: ReviewHistoryItem | undefined,
|
||
): StyleDriftReport | null {
|
||
const raw = item?.style;
|
||
if (typeof raw !== "object" || raw === null) return null;
|
||
const dict = raw as Record<string, unknown>;
|
||
const segRaw = Array.isArray(dict["segments"]) ? dict["segments"] : [];
|
||
const segments: StyleDriftSegment[] = segRaw
|
||
.filter((s): s is Record<string, unknown> => typeof s === "object" && s !== null)
|
||
.map((s) => ({
|
||
idx: asInt(s["idx"]),
|
||
score: asInt(s["score"], 100),
|
||
label: asOptionalString(s["label"]),
|
||
}));
|
||
// score 缺省 100（无指纹降级态，对齐后端默认）。
|
||
return { score: asInt(dict["score"], 100), segments };
|
||
}
|
||
|
||
// 同 style SSE 事件 data 也用此收窄（reduceReview case "style" 复用）。
|
||
export function narrowStyleEvent(data: unknown): StyleDriftReport {
|
||
if (typeof data !== "object" || data === null) {
|
||
return { score: 100, segments: [] };
|
||
}
|
||
const dict = data as Record<string, unknown>;
|
||
const segRaw = Array.isArray(dict["segments"]) ? dict["segments"] : [];
|
||
const segments: StyleDriftSegment[] = segRaw
|
||
.filter((s): s is Record<string, unknown> => typeof s === "object" && s !== null)
|
||
.map((s) => ({
|
||
idx: asInt(s["idx"]),
|
||
score: asInt(s["score"], 100),
|
||
label: asOptionalString(s["label"]),
|
||
}));
|
||
return { score: asInt(dict["score"], 100), segments };
|
||
}
|
||
|
||
// ── 请求体组装 ──────────────────────────────────────────────────
|
||
export type StyleLearnMode = "create" | "update";
|
||
|
||
// 组装学文风请求体：去掉空白样本；mode 透传（首学/更新仅前端语义）。
|
||
export function buildLearnRequest(
|
||
samples: readonly string[],
|
||
mode: StyleLearnMode,
|
||
): StyleLearnRequest {
|
||
const cleaned = samples.map((s) => s.trim()).filter((s) => s.length > 0);
|
||
return { samples: cleaned, mode };
|
||
}
|
||
|
||
// 至少一条非空样本才可提交（对齐后端 min_length=1）。
|
||
export function hasUsableSamples(samples: readonly string[]): boolean {
|
||
return samples.some((s) => s.trim().length > 0);
|
||
}
|
||
|
||
// 组装回炉请求体（段去空白；空指令省略）。
|
||
export function buildRefineRequest(
|
||
segment: string,
|
||
instruction?: string | null,
|
||
): RefineRequest {
|
||
const body: RefineRequest = { segment: segment.trim() };
|
||
const trimmed = instruction?.trim();
|
||
if (trimmed) body.instruction = trimmed;
|
||
return body;
|
||
}
|