第15章 - 思维日志-轨迹与家长报告

export interface JournalEntry {
  id: string;
  at: number;
  levelId: LevelId;
  variantId: string;
  stamps: StampId[];
  toolIds: ToolId[];
  failureClasses: string[];
  revisionCount: number;
  /** 玩家可选的一句话，≤ 80 字；不进任何统计 */
  note?: string;
}

// packages/progress/src/manager.ts（节选）
const entry: JournalEntry = {
  id: this.nextJournalId(at),
  at,
  levelId,
  variantId,
  stamps,
  toolIds,
  failureClasses: failureClassesSeen,
  revisionCount,
};
const journal = [...this.current.journal, entry].slice(-MAX_JOURNAL_ENTRIES);

// packages/evidence/src/trail.ts（节选）
/**
 * 思维轨迹：把证据事件按时间排成一条可回看的中文时间线。
 * 纯函数：不读时钟、不碰 DOM；limit 默认 80 条（docs/07 §1.2）。
 * save 仅用于签名对齐：轨迹的唯一事实来源是证据事件。
 */
export function buildTrail(
  _save: SaveData,
  events: EvidenceEvent[],
  summaries: readonly LevelSummary[],
  limit = DEFAULT_LIMIT,
): TrailItem[] {
  const max = normalizeLimit(limit);
  if (max === 0) return [];

  const titles = new Map<string, string>();
  for (const summary of summaries) titles.set(summary.id, summary.title);

  const decorated: { event: EvidenceEvent; at: number; index: number }[] = [];
  events.forEach((event, index) => {
    if (event === null || typeof event !== 'object') return;
    decorated.push({ event, at: normalizeAt(event.at), index });
  });
  decorated.sort((a, b) => a.at - b.at || a.index - b.index);

  const visible = decorated.slice(-max);
  // ……逐条拼成 TrailItem
}

// packages/evidence/src/types.ts（节选）
export interface TrailItem {
  id: string;
  at: number;
  levelId: LevelId;
  title: string;
  phase: EvidencePhase;
  phaseLabel: string;
  tool?: ToolId;
  toolLabel?: string;
  action: string;
  outcome: 'info' | 'pass' | 'fail';
  failureClass?: string;
  label: string;
}

const PHASE_LABELS: Record<EvidencePhase, string> = {
  observe: '观察', hypothesize: '猜想', construct: '搭建', run: '运行',
  result: '结果', revise: '修订', generalize: '推广', argue: '论证',
};

// apps/site/src/views/JournalView.vue（节选）
/**
 * 失败类在运行时是英文 id（pattern-cycle-wrong）。直接显示会让孩子读到一串英文，
 * 这里按前缀归到 failcat.* 的中文分类，原始 id 只留在 title 里给大人排查。
 */
const FAIL_CATEGORY_PREFIXES: readonly (readonly [string, string])[] = [
  ['pattern', 'failcat.pattern'],
  ['construct', 'failcat.construct'],
  ['rule', 'failcat.rule'],
  ['counter', 'failcat.counter'],
  ['probe', 'failcat.probe'],
  ['exp', 'failcat.exp'],
  ['sim', 'failcat.sim'],
  ['queue', 'failcat.queue'],
  ['network', 'failcat.network'],
  ['schedule', 'failcat.schedule'],
  ['sampling', 'failcat.sampling'],
  ['inference', 'failcat.inference'],
  ['distribution', 'failcat.distribution'],
  ['frontier', 'failcat.frontier'],
  ['argue', 'failcat.argue'],
];

function failCategoryKey(failureClass: string): string {
  const prefix = failureClass.split('-')[0] ?? '';
  for (const [match, key] of FAIL_CATEGORY_PREFIXES) {
    if (prefix === match) return key;
  }
  return 'failcat.other';
}

'failcat.pattern': '规律的规律',
'failcat.construct': '摆放与构造',
'failcat.rule': '程序与路线',
'failcat.queue': '排队指标',
'failcat.other': '结构反馈',

// apps/site/src/views/JournalView.vue（节选）
/** 同一分类只显示一次，原始 id 们合进 title，悬停能看到全部。 */
function failureCategories(ids: readonly string[]): { key: string; raw: string[] }[] {
  const grouped = new Map<string, string[]>();
  for (const id of ids) {
    const key = failCategoryKey(id);
    const list = grouped.get(key);
    if (list) list.push(id);
    else grouped.set(key, [id]);
  }
  return [...grouped.entries()].map(([key, raw]) => ({ key, raw }));
}

// apps/site/src/components/TrailList.vue（节选）
function displayLabel(item: TrailItem): string {
  if (!item.failureClass) return item.label;
  return item.label
    .replace('（未通过：' + item.failureClass + '）', '（未通过：' + failureLabel(item.failureClass) + '）')
    .replace(' (failed: ' + item.failureClass + ')', ' (failed: ' + failureLabel(item.failureClass) + ')');
}

// apps/site/src/views/JournalView.vue（节选）
/** 最近 120 条回放（docs/02 §10.1）；再往前的记录留在证据库里，不被日志页淹没。 */
const entries = computed(() => [...(progress.save?.journal ?? [])].reverse().slice(0, 120));
const trail = computed(() => localizeTrail(
  buildTrail(progress.save ?? emptySave(0), progress.evidence, LEVEL_SUMMARIES, 80),
  LEVEL_SUMMARIES,
  locale.value,
));

onMounted(async () => {
  await progress.init();
  await progress.loadEvidence(300);
});

// packages/evidence/src/report.ts（节选）
export function buildReport(
  save: SaveData,
  events: EvidenceEvent[],
  summaries: readonly LevelSummary[],
  now: number,
): ReportModel {
  const generatedAt = normalizeTime(now);
  const safeEvents = validEvents(events);
  const profile = buildEvidenceProfile(save, safeEvents, summaries, generatedAt);
  // ……工具次数、关卡表、周期、隐私声明
}

// packages/evidence/src/types.ts（节选）
export interface ReportModel {
  generatedAt: number;
  nickname: string;
  periodDays: number;
  tools: { tool: ToolId; label: string; uses: number }[];
  levels: ReportLevelRow[];
  dimensions: DimensionView[];
  recommendations: Recommendation[];
  totalJournal: number;
  totalEvents: number;
  privacyNote: string;
}

// apps/site/src/views/ReportView.vue（节选）
function printReport(): void {
  window.print();
}

// apps/site/src/components/AdultGate.vue（节选）
const holding = ref(false);
let timer: number | null = null;

function start(): void {
  if (holding.value) return;
  holding.value = true;
  clearTimer();
  timer = window.setTimeout(() => {
    timer = null;
    holding.value = false;
    emit('unlock');
  }, 3000);
}

function cancel(): void {
  clearTimer();
  holding.value = false;
}

onBeforeUnmount(clearTimer);

// apps/site/src/views/ReportView.vue（节选）
async function unlock(): Promise<void> {
  await progress.init();
  await progress.loadEvidence(500);
  await progress.refreshBadges();
  if (!progress.save) return;
  report.value = localizeReport(
    buildReport(progress.save, progress.evidence, LEVEL_SUMMARIES, platform.now()),
    LEVEL_SUMMARIES,
    locale.value,
  );
  unlocked.value = true;
}