152 lines
7.5 KiB
TypeScript
152 lines
7.5 KiB
TypeScript
import { beforeEach, describe, expect, test } from "bun:test";
|
|
|
|
import { recordDirectorDiagnostic, resetDirectorDiagnosticDedupe } from "../src/lib/canvas/director/director-diagnostics-recorder";
|
|
import { getClientDiagnosticEvents } from "../src/services/diagnostics/client-diagnostics";
|
|
|
|
/** 只看导演台自己的稳定码事件，避免与其它测试写入的诊断流互相干扰。 */
|
|
function directorEvents() {
|
|
return getClientDiagnosticEvents().filter((event) => (event.code || "").startsWith("DIRECTOR_"));
|
|
}
|
|
|
|
function newestDirectorEvent() {
|
|
return directorEvents().at(-1);
|
|
}
|
|
|
|
const LEAK_PROBES = [
|
|
"https://cdn.example.com/actor.glb?token=abc123#frag",
|
|
"authorization: Bearer eyJhbGciOiJIUzI1NiJ9.payload.sig",
|
|
"cookie=session=deadbeef; Path=/",
|
|
"api_key=sk-live-0000",
|
|
"Error: boom\n at DirectorModel (director-viewport.tsx:571:29)",
|
|
"演员 1 的镜头意图正文",
|
|
];
|
|
|
|
beforeEach(() => {
|
|
resetDirectorDiagnosticDedupe();
|
|
});
|
|
|
|
describe("记录进统一诊断缓冲区", () => {
|
|
test("写入的事件带稳定码、固定文案与 runtime 分类", () => {
|
|
const before = directorEvents().length;
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_RENDER_FAILED")).toBe(true);
|
|
|
|
expect(directorEvents().length).toBe(before + 1);
|
|
const event = newestDirectorEvent();
|
|
expect(event?.code).toBe("DIRECTOR_VIEWPORT_RENDER_FAILED");
|
|
expect(event?.level).toBe("error");
|
|
expect(event?.category).toBe("runtime");
|
|
expect(event?.message).toBe("导演台 3D 视口渲染失败");
|
|
// 绝不落 stack。
|
|
expect(event?.stack || "").toBe("");
|
|
});
|
|
|
|
test("安全字段以枚举后缀进入 code，便于检索", () => {
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectId: "obj-1", objectKind: "model", attempt: 2 })).toBe(true);
|
|
const event = newestDirectorEvent();
|
|
expect(event?.code).toBe("DIRECTOR_MODEL_LOAD_FAILED object=obj-1 kind=model attempt=2");
|
|
});
|
|
|
|
test("sceneId 只进 code 后缀，不冒充 canvasId", () => {
|
|
expect(recordDirectorDiagnostic("DIRECTOR_SAVE_FLUSH_FAILED", { sceneId: "repro-scene-1", revision: 3 })).toBe(true);
|
|
const event = newestDirectorEvent();
|
|
// DirectorScene.id 不是 canvas id，绝不写入既有后端契约字段。
|
|
expect(event?.canvasId).toBeUndefined();
|
|
expect(event?.code).toBe("DIRECTOR_SAVE_FLUSH_FAILED scene=repro-scene-1 revision=3");
|
|
});
|
|
|
|
test("三个保存相关码都能写入且级别正确", () => {
|
|
recordDirectorDiagnostic("DIRECTOR_SAVE_RETRY_RECOVERED", { revision: 1 });
|
|
expect(newestDirectorEvent()?.level).toBe("info");
|
|
recordDirectorDiagnostic("DIRECTOR_SAVE_DRAFT_UNAVAILABLE", { revision: 1 });
|
|
expect(newestDirectorEvent()?.level).toBe("error");
|
|
recordDirectorDiagnostic("DIRECTOR_CLOSE_BLOCKED", { saveOutcome: "stay" });
|
|
expect(newestDirectorEvent()?.level).toBe("warning");
|
|
});
|
|
});
|
|
|
|
describe("去重与噪声控制", () => {
|
|
test("同一 code+字段在窗口内只记一次", () => {
|
|
const before = directorEvents().length;
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_LOST")).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_LOST")).toBe(false);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_LOST")).toBe(false);
|
|
expect(directorEvents().length).toBe(before + 1);
|
|
});
|
|
|
|
test("字段不同视为不同事件，不会被误去重", () => {
|
|
const before = directorEvents().length;
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectKind: "model", attempt: 1 })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectKind: "model", attempt: 2 })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectKind: "actor", attempt: 1 })).toBe(true);
|
|
expect(directorEvents().length).toBe(before + 3);
|
|
});
|
|
|
|
test("不同 objectId 在窗口内不互相吞掉", () => {
|
|
const before = directorEvents().length;
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectId: "obj-1", objectKind: "model" })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectId: "obj-2", objectKind: "model" })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectId: "obj-3", objectKind: "model" })).toBe(true);
|
|
// 同一 objectId 重复仍要被去重。
|
|
expect(recordDirectorDiagnostic("DIRECTOR_MODEL_LOAD_FAILED", { objectId: "obj-1", objectKind: "model" })).toBe(false);
|
|
expect(directorEvents().length).toBe(before + 3);
|
|
});
|
|
|
|
test("不同 sceneId 在窗口内不互相吞掉", () => {
|
|
const before = directorEvents().length;
|
|
expect(recordDirectorDiagnostic("DIRECTOR_SAVE_FLUSH_FAILED", { sceneId: "scene-1", revision: 1 })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_SAVE_FLUSH_FAILED", { sceneId: "scene-2", revision: 1 })).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_SAVE_FLUSH_FAILED", { sceneId: "scene-1", revision: 1 })).toBe(false);
|
|
expect(directorEvents().length).toBe(before + 2);
|
|
});
|
|
|
|
test("所有写入的 code 都以稳定 DIRECTOR_ 前缀开头", () => {
|
|
resetDirectorDiagnosticDedupe();
|
|
recordDirectorDiagnostic("DIRECTOR_CLOSE_BLOCKED", { sceneId: "scene-1", saveOutcome: "stay" });
|
|
for (const event of directorEvents()) {
|
|
expect((event.code || "").startsWith("DIRECTOR_")).toBe(true);
|
|
}
|
|
});
|
|
|
|
test("重置去重状态后可再次记录同一事件", () => {
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_RESTORED")).toBe(true);
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_RESTORED")).toBe(false);
|
|
resetDirectorDiagnosticDedupe();
|
|
expect(recordDirectorDiagnostic("DIRECTOR_VIEWPORT_CONTEXT_RESTORED")).toBe(true);
|
|
});
|
|
});
|
|
|
|
describe("不泄漏敏感内容", () => {
|
|
test("伪造的敏感字段不会进入缓冲区任何字段", () => {
|
|
for (const probe of LEAK_PROBES) {
|
|
resetDirectorDiagnosticDedupe();
|
|
recordDirectorDiagnostic("DIRECTOR_MODEL_ADOPT_FAILED", {
|
|
objectId: probe,
|
|
sceneId: probe,
|
|
// @ts-expect-error 故意传入非法枚举，验证运行时白名单而非仅靠类型。
|
|
objectKind: probe,
|
|
// @ts-expect-error 故意传入非法数值类型。
|
|
attempt: probe,
|
|
});
|
|
|
|
const event = newestDirectorEvent();
|
|
const serialized = JSON.stringify(event);
|
|
expect(serialized).not.toContain("cdn.example.com");
|
|
expect(serialized).not.toContain("token=abc123");
|
|
expect(serialized).not.toContain("sk-live-0000");
|
|
expect(serialized).not.toContain("deadbeef");
|
|
expect(serialized).not.toContain("Bearer");
|
|
expect(serialized).not.toContain("演员");
|
|
expect(serialized).not.toContain("director-viewport.tsx");
|
|
expect(event?.canvasId).toBeUndefined();
|
|
expect(event?.code).toBe("DIRECTOR_MODEL_ADOPT_FAILED");
|
|
}
|
|
});
|
|
|
|
test("未知 code 既不写入也不抛错", () => {
|
|
const before = directorEvents().length;
|
|
// @ts-expect-error 故意传入白名单外的 code。
|
|
expect(recordDirectorDiagnostic("DIRECTOR_NOT_A_REAL_CODE", { objectId: "obj-1" })).toBe(false);
|
|
expect(directorEvents().length).toBe(before);
|
|
});
|
|
});
|