oh-my-knowledge 0.52.1 → 0.52.2

package/dist/observability/codex-conversation-index.d.ts

@@ -51,6 +51,10 @@ export interface CodexJsonlLine {
     startOffset: number;
     endOffset: number;
 }
+export interface CodexTaskRecordReadOptions {
+    /** Include only the next task prefix through its first human user message. */
+    includeNextHumanMessage?: boolean;
+}
 /**
  * Build a compact byte-range index without retaining the rollout. Only records
  * needed for turn boundaries and list metrics are parsed.
@@ -80,7 +84,7 @@ export declare function isCurrentCodexRolloutIndex(value: unknown, sourcePath: s
  * index remains internally consistent even after newer records are appended.
  */
 export declare function isReusableCodexRolloutIndex(value: unknown, sourcePath: string): value is CodexRolloutIndex;
-export declare function readCodexTaskRecords(index: CodexRolloutIndex, task: CodexIndexedTask): {
+export declare function readCodexTaskRecords(index: CodexRolloutIndex, task: CodexIndexedTask, options?: CodexTaskRecordReadOptions): {
     records: Array<unknown | undefined>;
     lines: CodexJsonlLine[];
     malformedRecordCount: number;

package/dist/observability/codex-conversation-index.js

@@ -327,7 +327,7 @@ export function isReusableCodexRolloutIndex(value, sourcePath) {
         return false;
     }
 }
-export function readCodexTaskRecords(index, task) {
+export function readCodexTaskRecords(index, task, options = {}) {
     const records = [];
     if (index.sessionMeta !== undefined && index.sessionMetaLine !== undefined) {
         records[index.sessionMetaLine] = index.sessionMeta;
@@ -345,8 +345,40 @@ export function readCodexTaskRecords(index, task) {
             malformedRecordCount += 1;
         }
     }, task.startOffset, task.endOffset, task.startLine);
+    if (options.includeNextHumanMessage) {
+        const taskIndex = index.tasks.findIndex((candidate) => candidate.turnId === task.turnId);
+        const nextTask = taskIndex >= 0 ? index.tasks[taskIndex + 1] : undefined;
+        if (nextTask) {
+            forEachJsonlLine(index.sourcePath, (record) => {
+                lines.push(record);
+                try {
+                    const parsed = JSON.parse(record.text);
+                    records[record.line] = parsed;
+                    return isHumanUserPrompt(parsed) ? false : undefined;
+                }
+                catch {
+                    malformedRecordCount += 1;
+                    return undefined;
+                }
+            }, nextTask.startOffset, nextTask.endOffset, nextTask.startLine);
+        }
+    }
     return { records, lines, malformedRecordCount };
 }
+function isHumanUserPrompt(value) {
+    const raw = objectValue(value);
+    if (!raw)
+        return false;
+    const recordType = stringValue(raw.type);
+    const payload = objectValue(raw.payload) ?? {};
+    const payloadType = stringValue(payload.type);
+    if (!isUserPromptRecord(recordType, payloadType, payload))
+        return false;
+    const message = userPromptText(payload)?.trim();
+    return Boolean(message
+        && codexUserMessageOrigin(message) === 'human'
+        && codexUserDisplayText(message)?.trim());
+}
 function finalizeSupersededTask(task, endOffset, endLine, endTimestamp) {
     return stripMutable({
         ...task,
@@ -501,7 +533,7 @@ function forEachJsonlLine(filePath, visit, startOffset = 0, endOffset = Number.P
     let indexedEndsWithNewline = true;
     let fragments = [];
     try {
-        while (absoluteOffset < endOffset) {
+        readLoop: while (absoluteOffset < endOffset) {
             const requestBytes = Math.min(buffer.length, endOffset - absoluteOffset);
             const bytesRead = readSync(fd, buffer, 0, requestBytes, absoluteOffset);
             if (bytesRead === 0)
@@ -515,7 +547,7 @@ function forEachJsonlLine(filePath, visit, startOffset = 0, endOffset = Number.P
                     ? Buffer.concat([...fragments, tail])
                     : tail;
                 const nextOffset = absoluteOffset + index + 1;
-                emitLine(lineBuffer, lineNumber, lineStartOffset, nextOffset, visit);
+                const shouldContinue = emitLine(lineBuffer, lineNumber, lineStartOffset, nextOffset, visit);
                 indexedSize = nextOffset;
                 indexedLineCount = lineNumber + 1;
                 indexedEndsWithNewline = true;
@@ -523,6 +555,8 @@ function forEachJsonlLine(filePath, visit, startOffset = 0, endOffset = Number.P
                 cursor = index + 1;
                 lineStartOffset = nextOffset;
                 lineNumber += 1;
+                if (!shouldContinue)
+                    break readLoop;
             }
             if (cursor < bytesRead)
                 fragments.push(Buffer.from(buffer.subarray(cursor, bytesRead)));
@@ -561,6 +595,6 @@ function isCompleteJsonRecord(buffer) {
 function emitLine(buffer, line, startOffset, endOffset, visit) {
     const text = buffer.toString('utf8').trim();
     if (!text)
-        return;
-    visit({ text, line, startOffset, endOffset });
+        return true;
+    return visit({ text, line, startOffset, endOffset }) !== false;
 }

package/dist/observability/conversation-catalog.js

@@ -106,7 +106,9 @@ class CodexConversationCatalog {
     trajectoryFromIndex(row, index, indexedTask) {
         const threadId = row.id;
         const turnId = indexedTask.turnId;
-        const selected = readCodexTaskRecords(index, indexedTask);
+        const selected = readCodexTaskRecords(index, indexedTask, {
+            includeNextHumanMessage: true,
+        });
         const traceSession = parseCodexSessionFile(row.rolloutPath, selected.records);
         const fullSessionTimeline = projectTraceSessionTimeline(traceSession);
         const turns = reconstructExperienceTurns(fullSessionTimeline);

package/dist/observability/feedback-matchers.d.ts

@@ -28,6 +28,11 @@ export interface TextMatchRange {
 }
 export declare function findUserCorrectionMatches(value: string): TextMatchRange[];
 export declare function hasUserCorrectionSignal(value: string): boolean;
+/**
+ * 用严格纠正信号把下一轮用户消息关联回上一任务。统计反馈匹配仍保持更宽，
+ * 因为「改成」等表达可用于指标统计，但不足以单独证明任务连续性。
+ */
+export declare function hasExplicitFollowUpCorrectionSignal(value: string): boolean;
 export declare function findUserGoalShiftMatches(value: string): TextMatchRange[];
 export declare function hasUserGoalShiftSignal(value: string): boolean;
 export declare function findNegativeFeedbackMatches(value: string): TextMatchRange[];

package/dist/observability/feedback-matchers.js

@@ -40,6 +40,14 @@ const PHRASE_USER_CORRECTION_TERMS = [
     '改成',
     '重来',
 ];
+const EXPLICIT_FOLLOW_UP_CORRECTION_PATTERNS = [
+    /(?:^|[\s,，;；.。!！?？:：])(?:不对|错了)(?:啊|呀|吧|呢)?(?=$|[\s,，;；.。!！?？:：])/iu,
+    /(?:这|这个|这样|你的|你.{0,8})(?:不对|错了)/iu,
+    /不是这个|不是我要的|不要这样|理解错|看错|你没懂|重来|重新来|重做|重新做/iu,
+    /\b(?:that(?:'s| is)|this is|you(?:'re| are)) wrong\b/iu,
+    /\b(?:this|that) is (?:incorrect|not right)\b/iu,
+    /\byou (?:misunderstood|misread)\b|\b(?:start|do)(?: it)? over\b/iu,
+];
 const USER_GOAL_SHIFT_TERMS = [
     '换个方向',
     '重新来',
@@ -165,6 +173,13 @@ export function findUserCorrectionMatches(value) {
 export function hasUserCorrectionSignal(value) {
     return findUserCorrectionMatches(value).length > 0;
 }
+/**
+ * 用严格纠正信号把下一轮用户消息关联回上一任务。统计反馈匹配仍保持更宽，
+ * 因为「改成」等表达可用于指标统计，但不足以单独证明任务连续性。
+ */
+export function hasExplicitFollowUpCorrectionSignal(value) {
+    return EXPLICIT_FOLLOW_UP_CORRECTION_PATTERNS.some((pattern) => pattern.test(value));
+}
 export function findUserGoalShiftMatches(value) {
     const ranges = [];
     for (const term of USER_GOAL_SHIFT_TERMS) {

package/dist/observability/knowledge-debugger.js

@@ -1,4 +1,5 @@
 import { createHash } from 'node:crypto';
+import { hasUserCorrectionSignal } from './feedback-matchers.js';
 import { resolveTaskWindow } from './task-window.js';
 const AGENTS_CONTEXT_RE = /^# AGENTS\.md instructions for ([^\n]+)\n/gim;
 const SKILL_PATH_RE = /((?:~|\.{0,2}|\/)?[^\s"'`]*\/skills\/(?:\.system\/)?([^/\s"'`]+)\/SKILL\.md)\b/i;
@@ -16,13 +17,16 @@ export function buildKnowledgeDebuggerViewModel(session, targetTurnId, ingestion
 }) {
     const taskWindow = resolveTaskWindow(session, targetTurnId);
     const normalizedEvents = taskWindow.events;
+    const normalizedTimeline = normalizedEvents.filter((event) => event.runtimeKind !== 'usage');
     const timeline = taskWindow.semanticEvents.filter((event) => event.runtimeKind !== 'usage');
+    const replayTimeline = [...timeline, ...taskWindow.relatedEvents]
+        .sort((left, right) => left.order - right.order);
     const knowledgeEvidence = projectKnowledgeEvidence(timeline);
-    const steps = buildTaskReplaySteps(session, timeline, knowledgeEvidence);
-    const notices = buildIntegrityNotices(taskWindow.scope, timeline, steps, ingestion);
-    const userEvents = timeline.filter((event) => event.kind === 'user_message');
-    const assistantEvents = timeline.filter((event) => event.kind === 'assistant_message');
-    const observedModels = timeline.reduce((models, event) => {
+    const steps = buildTaskReplaySteps(session, replayTimeline, knowledgeEvidence);
+    const notices = buildIntegrityNotices(taskWindow.scope, normalizedEvents, ingestion);
+    const userEvents = normalizedTimeline.filter((event) => event.kind === 'user_message');
+    const assistantEvents = normalizedTimeline.filter((event) => event.kind === 'assistant_message');
+    const observedModels = normalizedTimeline.reduce((models, event) => {
         const eventModel = event.model?.trim();
         if (eventModel && !models.includes(eventModel))
             models.push(eventModel);
@@ -34,11 +38,11 @@ export function buildKnowledgeDebuggerViewModel(session, targetTurnId, ingestion
         summary: {
             userGoal: eventText(userEvents[0]),
             finalResponse: eventText(assistantEvents.at(-1)),
-            observedStartTimestamp: timeline.find((event) => (event.timestamp && event.runtimeKind !== 'session_context'))?.timestamp
-                ?? timeline.find((event) => event.timestamp)?.timestamp,
-            observedEndTimestamp: [...timeline].reverse().find((event) => event.timestamp)?.timestamp,
-            toolCallCount: steps.filter((step) => step.stepKind === 'tool_exchange').length,
-            toolFailureCount: steps.filter((step) => step.stepKind === 'tool_exchange' && step.toolStatus === 'failure').length,
+            observedStartTimestamp: normalizedTimeline.find((event) => (event.timestamp && event.runtimeKind !== 'session_context'))?.timestamp
+                ?? normalizedTimeline.find((event) => event.timestamp)?.timestamp,
+            observedEndTimestamp: [...normalizedTimeline].reverse().find((event) => event.timestamp)?.timestamp,
+            toolCallCount: normalizedEvents.filter((event) => event.kind === 'tool_use').length,
+            toolFailureCount: normalizedEvents.filter((event) => (event.kind === 'tool_result' && (event.toolStatus === 'failure' || event.isError))).length,
             hasUserCorrection: steps.some((step) => step.stepKind === 'user_correction'),
             observedModels,
         },
@@ -199,7 +203,7 @@ function isKnowledgeReturningCall(toolName, callText) {
     const command = sourceLocator(callText);
     return command ? READ_ONLY_SHELL_RE.test(command) : false;
 }
-function buildIntegrityNotices(taskScope, timeline, steps, ingestion) {
+function buildIntegrityNotices(taskScope, normalizedEvents, ingestion) {
     const notices = [];
     if (taskScope.basis === 'unresolved') {
         notices.push({ code: 'task_boundary_unavailable', count: 1 });
@@ -214,17 +218,40 @@ function buildIntegrityNotices(taskScope, timeline, steps, ingestion) {
         notices.push({ code: 'ignored_values', count: ingestion.ignoredValueCount });
     if (ingestion?.unknownEventCount)
         notices.push({ code: 'unknown_events', count: ingestion.unknownEventCount });
-    const unmatchedCalls = steps.filter((step) => step.stepKind === 'tool_exchange' && step.events.length === 1).length;
-    if (unmatchedCalls > 0)
-        notices.push({ code: 'unmatched_tool_calls', count: unmatchedCalls });
-    const unmatchedResults = steps.filter((step) => step.stepKind === 'unmatched_tool_result').length;
-    if (unmatchedResults > 0)
-        notices.push({ code: 'unmatched_tool_results', count: unmatchedResults });
-    const missingTimestamps = timeline.filter((event) => !event.timestamp).length;
+    const unmatched = unmatchedToolEventCounts(normalizedEvents);
+    if (unmatched.calls > 0)
+        notices.push({ code: 'unmatched_tool_calls', count: unmatched.calls });
+    if (unmatched.results > 0)
+        notices.push({ code: 'unmatched_tool_results', count: unmatched.results });
+    const missingTimestamps = normalizedEvents.filter((event) => !event.timestamp).length;
     if (missingTimestamps > 0)
         notices.push({ code: 'missing_timestamps', count: missingTimestamps });
     return notices;
 }
+function unmatchedToolEventCounts(events) {
+    const availableResults = new Map();
+    for (const event of events) {
+        if (event.kind !== 'tool_result')
+            continue;
+        const key = toolCorrelationKey(event);
+        availableResults.set(key, (availableResults.get(key) ?? 0) + 1);
+    }
+    let unmatchedCalls = 0;
+    for (const event of events) {
+        if (event.kind !== 'tool_use')
+            continue;
+        const key = toolCorrelationKey(event);
+        const remaining = availableResults.get(key) ?? 0;
+        if (remaining === 0) {
+            unmatchedCalls += 1;
+        }
+        else {
+            availableResults.set(key, remaining - 1);
+        }
+    }
+    const unmatchedResults = [...availableResults.values()].reduce((sum, count) => sum + count, 0);
+    return { calls: unmatchedCalls, results: unmatchedResults };
+}
 function correctionEventIds(session, timeline) {
     const ids = new Set();
     for (const episode of session.sessionStory?.episodes ?? []) {
@@ -235,9 +262,15 @@ function correctionEventIds(session, timeline) {
         }
     }
     const userCorrectionCount = session.indicators?.userCorrectionCount ?? 0;
+    const lastAssistantOrder = Math.max(-1, ...timeline.filter((event) => event.kind === 'assistant_message').map((event) => event.order));
+    const explicitCandidates = timeline
+        .filter((event) => (event.kind === 'user_message'
+        && event.order > lastAssistantOrder
+        && hasUserCorrectionSignal(event.fullText ?? event.snippet ?? '')));
+    for (const event of explicitCandidates)
+        ids.add(event.id);
     if (ids.size > 0 || userCorrectionCount === 0)
         return ids;
-    const lastAssistantOrder = Math.max(-1, ...timeline.filter((event) => event.kind === 'assistant_message').map((event) => event.order));
     const correctionCandidates = timeline
         .filter((event) => event.kind === 'user_message' && event.order > lastAssistantOrder)
         .slice(-userCorrectionCount);

package/dist/observability/task-semantic-projection.d.ts

@@ -0,0 +1,11 @@
+import type { ExperienceTimelineEvent } from '../types/index.js';
+export interface TaskSemanticProjectionOptions {
+    preservePendingToolCalls?: boolean;
+}
+/**
+ * Bound one task's semantic projection without separating tool exchanges or
+ * blindly discarding the middle of a long task. Failures, task boundaries and
+ * the user/assistant endpoints are retained first; remaining capacity is
+ * distributed across the task so the preview still explains its progression.
+ */
+export declare function projectTaskSemanticEvents(events: ExperienceTimelineEvent[], limit: number, options?: TaskSemanticProjectionOptions): ExperienceTimelineEvent[];

package/dist/observability/task-semantic-projection.js

@@ -0,0 +1,172 @@
+const PRIORITY_BANDS = [100, 90, 80, 70, 60, 40, 20, 0];
+/**
+ * Bound one task's semantic projection without separating tool exchanges or
+ * blindly discarding the middle of a long task. Failures, task boundaries and
+ * the user/assistant endpoints are retained first; remaining capacity is
+ * distributed across the task so the preview still explains its progression.
+ */
+export function projectTaskSemanticEvents(events, limit, options = {}) {
+    if (limit <= 0 || events.length === 0)
+        return [];
+    if (events.length <= limit)
+        return events;
+    const units = semanticUnits(events, options);
+    const selected = new Map();
+    let remaining = limit;
+    const required = units
+        .filter((unit) => unit.required)
+        .sort((left, right) => right.priority - left.priority || left.retentionOrder - right.retentionOrder);
+    for (const unit of required) {
+        if (unit.events.length > remaining)
+            continue;
+        selected.set(unit.id, unit);
+        remaining -= unit.events.length;
+    }
+    for (const priority of PRIORITY_BANDS) {
+        if (remaining <= 0)
+            break;
+        const candidates = units.filter((unit) => (!selected.has(unit.id) && unit.priority === priority));
+        if (candidates.length === 0)
+            continue;
+        const totalSize = candidates.reduce((sum, unit) => sum + unit.events.length, 0);
+        if (totalSize <= remaining) {
+            for (const unit of candidates)
+                selected.set(unit.id, unit);
+            remaining -= totalSize;
+            continue;
+        }
+        remaining = selectSpreadCandidates(candidates, selected, units, remaining);
+    }
+    return [...selected.values()]
+        .flatMap((unit) => unit.events)
+        .sort((left, right) => left.order - right.order);
+}
+function semanticUnits(events, options) {
+    const resultByCall = new Map();
+    for (const event of events) {
+        if (event.kind !== 'tool_result')
+            continue;
+        const key = toolCorrelationKey(event);
+        resultByCall.set(key, [...(resultByCall.get(key) ?? []), event]);
+    }
+    const firstUserId = events.find((event) => event.kind === 'user_message')?.id;
+    const finalAssistantId = [...events].reverse()
+        .find((event) => event.kind === 'assistant_message')?.id;
+    const consumedResults = new Set();
+    const units = [];
+    for (const event of events) {
+        if (event.kind === 'tool_result' && consumedResults.has(event.id))
+            continue;
+        if (event.kind === 'tool_use') {
+            const result = resultByCall.get(toolCorrelationKey(event))
+                ?.find((candidate) => !consumedResults.has(candidate.id));
+            if (result)
+                consumedResults.add(result.id);
+            const exchange = result ? [event, result] : [event];
+            const failed = exchange.some((candidate) => candidate.isError || candidate.toolStatus === 'failure');
+            const pending = !result && options.preservePendingToolCalls === true;
+            units.push({
+                id: `tool:${event.id}`,
+                events: exchange,
+                order: event.order,
+                priority: failed ? 135 : pending ? 140 : 70,
+                required: failed || pending,
+                retentionOrder: pending ? -event.order : event.order,
+            });
+            continue;
+        }
+        const isFirstUser = event.id === firstUserId;
+        const isFinalAssistant = event.id === finalAssistantId;
+        const isBoundary = event.kind === 'lifecycle' && isBoundaryLifecycle(event);
+        const isFailedResult = event.kind === 'tool_result'
+            && (event.isError || event.toolStatus === 'failure');
+        const required = isFirstUser
+            || event.id === finalAssistantId
+            || isFailedResult
+            || isBoundary;
+        units.push({
+            id: `event:${event.id}`,
+            events: [event],
+            order: event.order,
+            priority: requiredPriority(event, {
+                isFirstUser,
+                isFinalAssistant,
+                isBoundary,
+                isFailedResult,
+            }),
+            required,
+            retentionOrder: event.order,
+        });
+    }
+    return units;
+}
+function requiredPriority(event, flags) {
+    if (flags.isFirstUser)
+        return 160;
+    if (flags.isFinalAssistant)
+        return 150;
+    if (flags.isBoundary && event.label === 'turn_started')
+        return 145;
+    if (flags.isFailedResult)
+        return 135;
+    if (flags.isBoundary)
+        return 130;
+    return semanticPriority(event);
+}
+function semanticPriority(event) {
+    if (event.kind === 'user_message' || event.kind === 'assistant_message')
+        return 90;
+    if (event.kind === 'skill_context')
+        return 80;
+    if (event.kind === 'runtime_context')
+        return event.runtimeKind === 'usage' ? 0 : 80;
+    if (event.kind === 'lifecycle')
+        return 70;
+    if (event.kind === 'tool_result')
+        return event.isError || event.toolStatus === 'failure' ? 100 : 70;
+    if (event.kind === 'observation' || event.kind === 'agent_activity')
+        return 60;
+    if (event.kind === 'model_activity')
+        return event.contentVisibility === 'plaintext' ? 40 : 20;
+    return 0;
+}
+function isBoundaryLifecycle(event) {
+    const label = `${event.label ?? ''} ${event.sourceType ?? ''}`.toLowerCase();
+    return /(?:turn|task)[_-]?(?:start|complete|abort|interrupt|end)/.test(label);
+}
+function selectSpreadCandidates(candidates, selected, allUnits, capacity) {
+    const selectedOrders = [...selected.values()].map((unit) => unit.order);
+    const firstOrder = allUnits[0]?.order ?? 0;
+    const lastOrder = allUnits.at(-1)?.order ?? firstOrder;
+    const distances = new Map(candidates.map((candidate) => [
+        candidate.id,
+        selectedOrders.length > 0
+            ? Math.min(...selectedOrders.map((order) => Math.abs(candidate.order - order)))
+            : Math.min(Math.abs(candidate.order - firstOrder), Math.abs(lastOrder - candidate.order)),
+    ]));
+    let remaining = capacity;
+    while (remaining > 0) {
+        const fitting = candidates.filter((unit) => (!selected.has(unit.id) && unit.events.length <= remaining));
+        if (fitting.length === 0)
+            break;
+        const next = fitting.reduce((best, candidate) => {
+            const candidateDistance = distances.get(candidate.id) ?? 0;
+            const bestDistance = distances.get(best.id) ?? 0;
+            return candidateDistance > bestDistance
+                || (candidateDistance === bestDistance && candidate.order < best.order)
+                ? candidate
+                : best;
+        });
+        selected.set(next.id, next);
+        remaining -= next.events.length;
+        for (const candidate of candidates) {
+            if (selected.has(candidate.id))
+                continue;
+            distances.set(candidate.id, Math.min(distances.get(candidate.id) ?? Number.POSITIVE_INFINITY, Math.abs(candidate.order - next.order)));
+        }
+    }
+    return remaining;
+}
+function toolCorrelationKey(event) {
+    return event.callInstanceId ?? event.toolUseId ?? event.id;
+}

package/dist/observability/task-window.d.ts

@@ -3,6 +3,7 @@ export declare const TASK_SEMANTIC_EVENT_LIMIT = 240;
 export interface ResolvedTaskWindow {
     events: ExperienceTimelineEvent[];
     semanticEvents: ExperienceTimelineEvent[];
+    relatedEvents: ExperienceTimelineEvent[];
     scope: TaskWindowScope;
 }
 export declare function resolveTaskWindow(session: TaskTrajectorySession, targetTurnId: string, semanticLimit?: number): ResolvedTaskWindow;

package/dist/observability/task-window.js

@@ -1,3 +1,5 @@
+import { hasExplicitFollowUpCorrectionSignal } from './feedback-matchers.js';
+import { projectTaskSemanticEvents } from './task-semantic-projection.js';
 export const TASK_SEMANTIC_EVENT_LIMIT = 240;
 export function resolveTaskWindow(session, targetTurnId, semanticLimit = TASK_SEMANTIC_EVENT_LIMIT) {
     const events = session.fullSessionTimeline;
@@ -11,11 +13,17 @@ export function resolveTaskWindow(session, targetTurnId, semanticLimit = TASK_SE
             return event ? [event] : [];
         })
         : [];
-    const semanticEvents = semanticPreview(taskEvents, semanticLimit);
+    const semanticEvents = projectTaskSemanticEvents(taskEvents, semanticLimit, {
+        preservePendingToolCalls: selected?.status === 'open',
+    });
+    const relatedEvents = selected
+        ? relatedCorrectionEvents(session, selected.turnId, eventById)
+        : [];
     const matchedAttributedEventCount = taskEvents.filter((event) => attributedIds.has(event.id)).length;
     return {
         events: taskEvents,
         semanticEvents,
+        relatedEvents,
         scope: {
             basis: selected?.boundaryBasis ?? 'unresolved',
             turnId: selected?.turnId,
@@ -27,10 +35,23 @@ export function resolveTaskWindow(session, targetTurnId, semanticLimit = TASK_SE
         },
     };
 }
-function semanticPreview(events, limit) {
-    if (events.length <= limit)
-        return events;
-    const headCount = Math.ceil(limit * 0.6);
-    const tailCount = limit - headCount;
-    return [...events.slice(0, headCount), ...events.slice(-tailCount)];
+function relatedCorrectionEvents(session, selectedTurnId, eventById) {
+    const selectedIndex = session.turns.findIndex((turn) => turn.turnId === selectedTurnId);
+    const selectedTurn = selectedIndex >= 0 ? session.turns[selectedIndex] : undefined;
+    if (!selectedTurn)
+        return [];
+    const selectedTraceKey = turnTraceKey(selectedTurn);
+    const nextTurn = session.turns.slice(selectedIndex + 1).find((turn) => (turnTraceKey(turn) === selectedTraceKey));
+    if (!nextTurn)
+        return [];
+    const firstHumanMessage = nextTurn.eventIds
+        .map((id) => eventById.get(id))
+        .find((event) => event?.kind === 'user_message' && event.role === 'user');
+    if (!firstHumanMessage)
+        return [];
+    const text = firstHumanMessage.fullText ?? firstHumanMessage.snippet ?? '';
+    return hasExplicitFollowUpCorrectionSignal(text) ? [firstHumanMessage] : [];
+}
+function turnTraceKey(turn) {
+    return turn.traceId?.trim() || turn.sourceTrace;
 }

package/dist/renderer/knowledge-debugger-renderer.js

@@ -1,6 +1,7 @@
 import { inlineMarkdownText, renderSafeInlineMarkdown } from './inline-markdown.js';
 import { icon } from './icons.js';
 import { DEFAULT_LANG, e, layout } from './layout.js';
+import { primaryTrajectoryEvidenceRef, trajectoryEvidenceRef, } from './trajectory-evidence.js';
 import { renderTrajectoryLiveClientSource } from './trajectory-live.js';
 import { renderTrajectoryRoutingClientSource } from './trajectory-routing.js';
 const ACCESS_LABELS = {
@@ -97,8 +98,8 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
       .app-main{width:100%;height:100%;min-height:0;max-width:none;margin:0;padding:10px 18px 14px;overflow:hidden}
       .footer{display:none!important}
       .trajectory-shell{height:100%;min-height:0;display:flex;flex-direction:column;margin:0;padding:0;letter-spacing:0}
-      .trajectory-mode{display:inline-flex;padding:2px;border:1px solid var(--border);border-radius:7px;background:var(--bg-elevated)}
-      .trajectory-mode button{height:28px;padding:3px 11px;border:0;border-radius:5px;background:transparent;color:var(--text-secondary);font:500 12px/1.4 inherit;letter-spacing:0;cursor:pointer}
+      .trajectory-mode{display:inline-flex;flex:none;padding:2px;border:1px solid var(--border);border-radius:7px;background:var(--bg-elevated)}
+      .trajectory-mode button{height:28px;padding:3px 11px;border:0;border-radius:5px;background:transparent;color:var(--text-secondary);font:500 12px/1.4 inherit;letter-spacing:0;white-space:nowrap;cursor:pointer}
       .trajectory-mode button[aria-pressed="true"]{background:var(--text-primary);color:var(--bg-surface);box-shadow:0 1px 2px rgba(24,32,51,.14)}
       .trajectory-mode button:focus-visible,.trajectory-event:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
       .trajectory-heading{flex:none;display:grid;grid-template-columns:minmax(0,1fr) auto;gap:24px;align-items:center;min-height:32px;margin:0 0 8px}
@@ -113,7 +114,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
       .trajectory-warning strong{color:var(--text-primary)}
       .trajectory-frame{flex:1;min-height:0;overflow:hidden;display:grid;grid-template-rows:40px minmax(0,1fr);border:1px solid var(--border);border-radius:8px;background:var(--bg-surface);box-shadow:var(--shadow-sm)}
       .trajectory-frame-head{display:flex;align-items:center;min-height:0;padding:0 10px 0 14px;border-bottom:1px solid var(--border)}
-      .trajectory-frame-head h2{margin:0;font-size:13px;font-weight:600;letter-spacing:0}
+      .trajectory-frame-head h2{flex:none;margin:0;font-size:13px;font-weight:600;letter-spacing:0;white-space:nowrap}
       .trajectory-live-controls{display:inline-flex;align-items:center;gap:3px;margin-left:8px}
       .trajectory-live-state{display:inline-flex;align-items:center;gap:5px;color:var(--text-muted);font-size:9px;white-space:nowrap}
       .trajectory-live-state:before{content:"";width:5px;height:5px;border-radius:50%;background:var(--green);box-shadow:0 0 0 3px rgba(31,157,99,.1)}
@@ -249,6 +250,11 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
       .trajectory-operation-copy p{display:-webkit-box;margin:0;overflow:hidden;color:var(--text-secondary);font-size:11px;line-height:1.45;-webkit-box-orient:vertical;-webkit-line-clamp:2}
       .trajectory-operation-actions{display:flex;align-items:center;gap:6px;padding-top:0}
       .trajectory-evidence-count{color:var(--text-secondary);font-size:10px;white-space:nowrap}
+      .trajectory-evidence-jump,.trajectory-field-evidence{border:0;border-radius:4px;background:transparent;color:var(--accent);font-size:9px;font-weight:600;white-space:nowrap;cursor:pointer}
+      .trajectory-evidence-jump{padding:4px 6px}
+      .trajectory-field-evidence{padding:3px 5px}
+      .trajectory-evidence-jump:hover,.trajectory-field-evidence:hover{background:var(--bg-elevated);color:var(--text-primary)}
+      .trajectory-evidence-jump:focus-visible,.trajectory-field-evidence:focus-visible{outline:2px solid var(--accent);outline-offset:1px}
       .trajectory-inspector-close{display:grid;width:24px;height:24px;place-items:center;border:0;border-radius:4px;background:transparent;color:var(--text-muted);cursor:pointer}
       .trajectory-inspector-close:hover{background:var(--bg-elevated);color:var(--text-primary)}
       .trajectory-inspector-close:focus-visible{outline:2px solid var(--accent);outline-offset:1px}
@@ -284,6 +290,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
       .trajectory-raw-head,.trajectory-raw-row summary{display:grid;grid-template-columns:76px 126px minmax(240px,1fr) 138px;gap:12px;align-items:center}
       .trajectory-raw-head{position:sticky;top:0;z-index:3;min-height:32px;padding:0 14px;border-bottom:1px solid var(--border);background:var(--bg-elevated);color:var(--text-muted);font-size:9px;font-weight:600}
       .trajectory-raw-row{border-bottom:1px solid var(--border)}
+      .trajectory-raw-row.is-evidence-target{background:rgba(79,70,229,.07);box-shadow:inset 3px 0 0 var(--accent)}
       .trajectory-raw-row[hidden]{display:none}
       .trajectory-raw-row summary{min-height:46px;padding:7px 14px;color:var(--text-primary);cursor:pointer;list-style:none}
       .trajectory-raw-row summary::-webkit-details-marker{display:none}
@@ -301,7 +308,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
       @media(max-width:1100px){.trajectory-shell[data-inspector-open="true"] .trajectory-body{grid-template-columns:minmax(0,1fr) 320px}.trajectory-canvas{--lane-label-width:96px;--event-width:148px}.trajectory-lane-name{padding-inline:10px}.trajectory-lane-name span{font-size:9px}}
       @media(max-width:1080px){.trajectory-meta-time{display:none!important}}
       @media(max-width:860px){.app-main{padding-inline:10px}.trajectory-heading{grid-template-columns:1fr;gap:0}.trajectory-meta{display:none}.trajectory-shell[data-inspector-open="true"] .trajectory-body{grid-template-columns:1fr;grid-template-rows:minmax(0,3fr) minmax(160px,2fr)}.trajectory-inspector{border-top:1px solid var(--border);border-left:0}.trajectory-operation-head{padding-block:9px}}
-      @media(max-width:600px){.app-bar{padding-inline:10px}.app-brand-tag{display:none}.trajectory-heading h1{font-size:17px}.trajectory-range{display:none}.trajectory-frame-head .trajectory-mode{margin-left:auto}.trajectory-canvas{--lane-label-width:76px;--event-width:126px}.trajectory-lane-name{padding-inline:8px}.trajectory-lane-name span{display:none}.trajectory-event-time{display:none}.trajectory-raw-head,.trajectory-raw-row summary{grid-template-columns:66px 94px minmax(160px,1fr)}.trajectory-raw-id{display:none}.trajectory-raw-row pre{padding-left:14px}}
+      @media(max-width:600px){.app-bar{padding-inline:10px}.app-brand-tag{display:none}.trajectory-heading h1{font-size:17px}.trajectory-frame-head{gap:2px;padding-inline:8px}.trajectory-frame-space{min-width:0}.trajectory-range{display:none}.trajectory-live-controls{margin-left:3px}.trajectory-live-state{gap:0;font-size:0}.trajectory-live-follow{width:22px;padding:0;justify-content:center}.trajectory-live-follow span{display:none}.trajectory-boundary-info{margin-left:1px}.trajectory-focus{margin-left:2px}.trajectory-frame-head .trajectory-mode{margin-left:2px}.trajectory-mode button{min-width:37px;padding-inline:6px;font-size:0}.trajectory-mode button:after{content:attr(data-short-label);font-size:10px}.trajectory-canvas{--lane-label-width:76px;--event-width:126px}.trajectory-lane-name{padding-inline:8px}.trajectory-lane-name span{display:none}.trajectory-event-time{display:none}.trajectory-raw-head,.trajectory-raw-row summary{grid-template-columns:66px 94px minmax(160px,1fr)}.trajectory-raw-id{display:none}.trajectory-raw-row pre{padding-left:14px}}
       @media(prefers-reduced-motion:reduce){.trajectory-body{transition:none}}
     </style>
     <main class="trajectory-shell" data-mode="semantic"${options.live ? ` data-live-endpoint="${e(options.live.endpoint)}" data-live-revision="${e(options.live.revision)}"` : ''}>
@@ -333,9 +340,9 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
           <span class="trajectory-range">${e(formatRelativeTime(0))} — ${e(formatRelativeTime(projection.durationMs))}</span>
           ${projection.facets.length > 0 ? renderFacetFocus(projection.facets, lang) : ''}
           <div class="trajectory-mode" aria-label="${zh ? '查看模式' : 'View mode'}">
-            <button type="button" data-trajectory-mode="semantic" aria-pressed="true">${zh ? '语义轨迹' : 'Semantic trajectory'}</button>
-            <button type="button" data-trajectory-mode="normalized" aria-pressed="false">${zh ? '规范化事件' : 'Normalized events'}</button>
-            <button type="button" data-trajectory-mode="source" aria-pressed="false">${zh ? '原始日志' : 'Raw logs'}</button>
+            <button type="button" data-trajectory-mode="semantic" data-short-label="${zh ? '轨迹' : 'Track'}" aria-pressed="true">${zh ? '语义轨迹' : 'Semantic trajectory'}</button>
+            <button type="button" data-trajectory-mode="normalized" data-short-label="${zh ? '事件' : 'Events'}" aria-pressed="false">${zh ? '规范化事件' : 'Normalized events'}</button>
+            <button type="button" data-trajectory-mode="source" data-short-label="${zh ? '日志' : 'Logs'}" aria-pressed="false">${zh ? '原始日志' : 'Raw logs'}</button>
           </div>
         </header>
 
@@ -358,7 +365,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
             <header class="trajectory-operation-head">
               <div class="trajectory-operation-type" id="trajectory-operation-type"></div>
               <div class="trajectory-operation-copy"><h3 id="trajectory-operation-title"></h3><p id="trajectory-operation-summary"></p></div>
-              <div class="trajectory-operation-actions"><div class="trajectory-evidence-count" id="trajectory-evidence-count"></div><button class="trajectory-inspector-close" type="button" data-inspector-close aria-label="${zh ? '关闭详情' : 'Close details'}" title="${zh ? '关闭详情' : 'Close details'}"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M6 6l12 12"></path><path d="M18 6L6 18"></path></svg></button></div>
+              <div class="trajectory-operation-actions"><div class="trajectory-evidence-count" id="trajectory-evidence-count"></div><button class="trajectory-evidence-jump" type="button" data-operation-evidence hidden></button><button class="trajectory-inspector-close" type="button" data-inspector-close aria-label="${zh ? '关闭详情' : 'Close details'}" title="${zh ? '关闭详情' : 'Close details'}"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M6 6l12 12"></path><path d="M18 6L6 18"></path></svg></button></div>
             </header>
             <div class="trajectory-semantic-panels">${projection.operations.map((operation) => renderSemanticPanel(operation, false, lang)).join('')}</div>
           </aside>
@@ -377,7 +384,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
         const cards = Array.from(document.querySelectorAll('[data-trajectory-operation]'));
         const normalizedRows = Array.from(document.querySelectorAll('[data-trajectory-normalized-event]'));
         const normalizedEmpty = document.querySelector('[data-trajectory-normalized-empty]');
-        const sourceRecordList = document.querySelector('[data-source-records-endpoint]');
+        const sourceRecordList = document.querySelector('[data-event-view="source"]');
         const semanticPanels = Array.from(document.querySelectorAll('[data-trajectory-semantic-panel]'));
         const semanticPanelContainer = document.querySelector('.trajectory-semantic-panels');
         const detailBlocks = Array.from(document.querySelectorAll('[data-field-detail-block]'));
@@ -385,6 +392,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
         const operationTitle = document.querySelector('#trajectory-operation-title');
         const operationSummary = document.querySelector('#trajectory-operation-summary');
         const evidenceCount = document.querySelector('#trajectory-evidence-count');
+        const operationEvidence = document.querySelector('[data-operation-evidence]');
         const lanes = document.querySelector('.trajectory-lanes');
         const operationLinks = document.querySelector('.trajectory-links');
         const facetFocus = document.querySelector('.trajectory-focus');
@@ -410,6 +418,8 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
         loadFailed: zh ? '原始日志读取失败。可以切换视图后重试。' : 'Raw logs could not be loaded. Switch views and retry.',
         partialRecords: SOURCE_RECORD_PARTIAL_LABELS[lang].records,
         partialContent: SOURCE_RECORD_PARTIAL_LABELS[lang].content,
+        viewSource: zh ? '查看原始日志' : 'View raw log',
+        viewNormalized: zh ? '查看规范化事件' : 'View normalized event',
     })};
         const cardLane = (card) => card.closest('.trajectory-lane')?.dataset.lane || '';
         const operationIds = semanticPanels.map((panel) => panel.dataset.trajectorySemanticPanel).filter(Boolean);
@@ -815,6 +825,16 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
           if (operationTitle) operationTitle.textContent = panel.dataset.title || '—';
           if (operationSummary) operationSummary.textContent = panel.dataset.summary || '';
           if (evidenceCount) evidenceCount.textContent = panel.dataset.evidenceLabel || '';
+          if (operationEvidence) {
+            const sourceEventId = panel.dataset.evidenceSourceEventId || '';
+            operationEvidence.hidden = !sourceEventId;
+            operationEvidence.dataset.evidenceSourceEventId = sourceEventId;
+            operationEvidence.dataset.evidenceSourceLineIndex = panel.dataset.evidenceSourceLineIndex || '';
+            operationEvidence.dataset.evidenceTraceId = panel.dataset.evidenceTraceId || '';
+            operationEvidence.textContent = panel.dataset.evidenceSourceLineIndex
+              ? sourceRecordLabels.viewSource
+              : sourceRecordLabels.viewNormalized;
+          }
           currentOperationId = id;
           if (animateLayout && shell.dataset.inspectorOpen !== 'true') beginLayoutTransition();
           shell.dataset.inspectorOpen = 'true';
@@ -831,6 +851,7 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
           });
           semanticPanels.forEach((item) => { item.hidden = true; });
           currentOperationId = '';
+          if (operationEvidence) operationEvidence.hidden = true;
           if (inspectorWasOpen) beginLayoutTransition();
           delete shell.dataset.inspectorOpen;
           if (inspector) inspector.hidden = true;
@@ -896,6 +917,8 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
           if (!sourceRecordList) return;
           const details = document.createElement('details');
           details.className = 'trajectory-raw-row';
+          details.dataset.sourceLineIndex = String(record.sourceIndex ?? '');
+          details.dataset.sourceTraceId = String(record.traceId || '');
           const summary = document.createElement('summary');
           const time = document.createElement('time');
           time.textContent = relativeSourceTime(record.timestamp);
@@ -955,6 +978,40 @@ export function renderKnowledgeDebuggerPage(model, lang = DEFAULT_LANG, options
           if (mode === 'source') void loadSourceRecords();
           document.querySelectorAll('[data-trajectory-mode]').forEach((item) => item.setAttribute('aria-pressed', String(item.dataset.trajectoryMode === mode)));
         };
+        const clearEvidenceTarget = () => {
+          document.querySelectorAll('.trajectory-raw-row.is-evidence-target').forEach((row) => row.classList.remove('is-evidence-target'));
+        };
+        const revealEvidenceRow = (row) => {
+          if (!row) return false;
+          clearEvidenceTarget();
+          row.open = true;
+          row.classList.add('is-evidence-target');
+          requestAnimationFrame(() => row.scrollIntoView({
+            behavior: window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth',
+            block: 'center',
+          }));
+          return true;
+        };
+        const matchingSourceRow = (lineIndex, traceId) => Array.from(sourceRecordList?.querySelectorAll('[data-source-line-index]') || [])
+          .find((row) => row.dataset.sourceLineIndex === lineIndex
+            && (!traceId || row.dataset.sourceTraceId === traceId));
+        const revealEvidence = async (target) => {
+          const sourceEventId = target.dataset.evidenceSourceEventId || target.dataset.detailSourceEventId || '';
+          const sourceLineIndex = target.dataset.evidenceSourceLineIndex || target.dataset.detailSourceLineIndex || '';
+          const traceId = target.dataset.evidenceTraceId || target.dataset.detailTraceId || '';
+          if (sourceLineIndex && sourceRecordList) {
+            setTrajectoryMode('source');
+            await loadSourceRecords();
+            if (revealEvidenceRow(matchingSourceRow(sourceLineIndex, traceId))) return;
+          }
+          if (!sourceEventId) return;
+          setTrajectoryMode('normalized');
+          revealEvidenceRow(normalizedRows.find((row) => row.dataset.trajectoryNormalizedEvent === sourceEventId));
+        };
+        operationEvidence?.addEventListener('click', () => void revealEvidence(operationEvidence), { signal: pageLifecycle.signal });
+        document.querySelectorAll('[data-view-evidence]').forEach((button) => {
+          button.addEventListener('click', () => void revealEvidence(button.closest('[data-field-detail-block]') || button), { signal: pageLifecycle.signal });
+        });
         document.querySelectorAll('[data-trajectory-mode]').forEach((button) => {
           button.addEventListener('click', () => {
             const mode = button.dataset.trajectoryMode || 'semantic';
@@ -1208,8 +1265,8 @@ function projectReplay(model, lang, options) {
                         : (zh ? '已观测到工具调用，但当前 trace 中没有匹配到返回结果。' : 'A tool call was observed, but no matching result appears in the trace.'),
                 evidenceLabel: zh ? `${step.events.length + evidence.length} 条关联证据` : `${step.events.length + evidence.length} related records`,
                 fields: [
-                    { label: zh ? '执行' : 'Action', value: `${call?.toolName ?? step.title} · ${inferToolActionLabel(evidence, lang)}`, detail: compactText(input || (zh ? '未记录输入' : 'Input not recorded'), 520), detailKind: 'content' },
-                    { label: zh ? '结果' : 'Result', value: `${toolStatusLabel(resultState, lang)}${duration ? ` · ${duration}` : ''}`, detail: result ? eventPreview(result, zh ? '工具没有返回内容。' : 'The tool returned no content.') : resultState === 'pending' ? (zh ? '正在等待工具结果写入 trace。' : 'Waiting for the tool result to appear in the trace.') : (zh ? '当前 trace 中没有匹配到工具结果。' : 'No matching tool result in this trace.'), detailSourceEventId: result?.id, detailKind: 'result' },
+                    { label: zh ? '执行' : 'Action', value: `${call?.toolName ?? step.title} · ${inferToolActionLabel(evidence, lang)}`, detail: compactText(input || (zh ? '未记录输入' : 'Input not recorded'), 520), evidence: trajectoryEvidenceRef(call), detailKind: 'content' },
+                    { label: zh ? '结果' : 'Result', value: `${toolStatusLabel(resultState, lang)}${duration ? ` · ${duration}` : ''}`, detail: result ? eventPreview(result, zh ? '工具没有返回内容。' : 'The tool returned no content.') : resultState === 'pending' ? (zh ? '正在等待工具结果写入 trace。' : 'Waiting for the tool result to appear in the trace.') : (zh ? '当前 trace 中没有匹配到工具结果。' : 'No matching tool result in this trace.'), evidence: trajectoryEvidenceRef(result), detailKind: 'result' },
                     { label: 'Knowledge', value: evidence.length > 0 ? evidence.map((item) => `${knowledgeKindLabel(item, lang)} · ${item.label}`).join('、') : (zh ? '未关联' : 'Not associated'), detail: evidence.length > 0 ? evidence.map((item) => `${item.accessKind} · ${shortHash(item.contentHash)}`).join('\n') : (zh ? '未从本次工具交换投影出 Knowledge' : 'No Knowledge projected from this tool exchange') },
                 ],
                 events: step.events,
@@ -1256,7 +1313,7 @@ function projectReplay(model, lang, options) {
                         value: contextContent ? (zh ? '源日志已记录可见内容' : 'Observable content recorded') : (zh ? '源日志未记录上下文内容' : 'Context content not recorded by the source log'),
                         detail: contextContent ?? (zh ? '当前规范化事件只保留了上下文类型与元数据。' : 'The normalized event only retains the context type and metadata.'),
                         copyable: Boolean(contextContent),
-                        detailSourceEventId: contextContent ? contextEvent?.id : undefined,
+                        evidence: trajectoryEvidenceRef(contextEvent),
                         detailKind: 'content',
                     },
                     { label: zh ? '内容身份' : 'Content identity', value: first?.contentHash ? `sha256:${shortHash(first.contentHash)}` : (zh ? '未记录哈希' : 'Hash not recorded'), detail: zh ? '只标识观测到的内容，不推断是否被模型采用' : 'Identifies observed content without inferring model use' },
@@ -1329,6 +1386,7 @@ function projectReplay(model, lang, options) {
                             value: text,
                             detail: reasoningContentSourceLabel(event?.contentSource, lang),
                             presentation: 'content',
+                            evidence: trajectoryEvidenceRef(event),
                         }]),
                 ]
                 : [
@@ -1340,6 +1398,7 @@ function projectReplay(model, lang, options) {
                         value: text,
                         detail: zh ? '未做隐藏意图或原因推断' : 'No hidden-intent or causal inference',
                         presentation: 'content',
+                        evidence: trajectoryEvidenceRef(event),
                     },
                 ],
             events: step.events,
@@ -1602,7 +1661,8 @@ function renderFacetFocus(facets, lang) {
     return `<details class="trajectory-focus"><summary aria-label="${zh ? '类型筛选' : 'Filter by type'}" title="${zh ? '类型筛选' : 'Filter by type'}"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 6h18"></path><path d="M7 12h10"></path><path d="M10 18h4"></path></svg></summary><div class="trajectory-focus-menu" role="group" aria-label="${zh ? '类型筛选' : 'Type filter'}"><span class="trajectory-focus-title">${zh ? '类型筛选' : 'Type filter'}</span><button class="trajectory-focus-option" type="button" data-trajectory-facet="" aria-pressed="true"><span class="trajectory-focus-swatch" aria-hidden="true"></span><span>${zh ? '全部类型' : 'All types'}</span><small>${zh ? '清除' : 'Clear'}</small></button>${options}</div></details>`;
 }
 function renderSemanticPanel(operation, selected, lang) {
-    return `<div class="trajectory-operation-panel trajectory-fields" data-trajectory-semantic-panel="${e(operation.id)}" data-selection-label="${e(operation.selectionLabel)}" data-type-label="${e(operation.typeLabel)}" data-title="${e(operation.title)}" data-summary="${e(operation.summary)}" data-evidence-label="${e(operation.evidenceLabel)}"${selected ? '' : ' hidden'}>${operation.fields.map((field) => {
+    const evidence = primaryTrajectoryEvidenceRef(operation.events);
+    return `<div class="trajectory-operation-panel trajectory-fields" data-trajectory-semantic-panel="${e(operation.id)}" data-selection-label="${e(operation.selectionLabel)}" data-type-label="${e(operation.typeLabel)}" data-title="${e(operation.title)}" data-summary="${e(operation.summary)}" data-evidence-label="${e(operation.evidenceLabel)}"${renderEvidenceDataAttributes(evidence)}${selected ? '' : ' hidden'}>${operation.fields.map((field) => {
         const content = field.presentation === 'content'
             ? `<div class="trajectory-field-content">${renderSafeInlineMarkdown(field.value)}</div>`
             : `<strong class="trajectory-field-value">${e(field.value)}</strong>`;
@@ -1611,7 +1671,7 @@ function renderSemanticPanel(operation, selected, lang) {
 }
 function renderFieldDetail(field, lang) {
     const preview = fieldDetailPreview(field.detail);
-    if ((!preview.truncated || !field.detailSourceEventId) && !field.copyable) {
+    if ((!preview.truncated || !field.evidence?.normalizedEventId) && !field.copyable && !field.evidence) {
         return `<code class="trajectory-field-detail">${e(field.detail)}</code>`;
     }
     const zh = lang === 'zh';
@@ -1624,18 +1684,30 @@ function renderFieldDetail(field, lang) {
     const collapseLabel = zh ? (result ? '收起结果' : '收起内容') : (result ? 'Collapse result' : 'Collapse content');
     const copyLabel = zh ? (result ? '复制结果' : '复制内容') : (result ? 'Copy result' : 'Copy content');
     const copiedLabel = zh ? '已复制' : 'Copied';
-    const canExpand = preview.truncated && Boolean(field.detailSourceEventId);
+    const canExpand = preview.truncated && Boolean(field.evidence?.normalizedEventId);
     const displayedDetail = canExpand ? preview.text : field.detail;
-    const sourceEventAttribute = field.detailSourceEventId
-        ? ` data-detail-source-event-id="${e(field.detailSourceEventId)}"`
-        : '';
+    const evidenceAttributes = renderEvidenceDataAttributes(field.evidence, 'detail');
     const status = canExpand
         ? `<span class="trajectory-field-detail-status" data-field-detail-status>${e(previewStatus)}</span>`
         : '<span></span>';
     const toggle = canExpand
         ? `<button class="trajectory-field-detail-toggle" type="button" data-field-detail-toggle aria-expanded="false">${e(expandLabel)}</button>`
         : '';
-    return `<div class="trajectory-field-detail-block" data-field-detail-block data-expanded="false" data-expandable="${String(canExpand)}"${sourceEventAttribute} data-preview-status="${e(previewStatus)}" data-full-status="${e(fullStatus)}" data-expand-label="${e(expandLabel)}" data-collapse-label="${e(collapseLabel)}" data-copy-label="${e(copyLabel)}" data-copied-label="${e(copiedLabel)}"><code class="trajectory-field-detail" data-field-detail>${e(displayedDetail)}</code><div class="trajectory-field-detail-actions">${status}<span class="trajectory-field-detail-controls">${toggle}<button class="trajectory-field-detail-copy" type="button" data-field-detail-copy aria-label="${e(copyLabel)}" title="${e(copyLabel)}">${icon('copy', { size: 13 })}</button></span></div></div>`;
+    const evidenceButton = field.evidence
+        ? `<button class="trajectory-field-evidence" type="button" data-view-evidence>${lang === 'zh' ? (field.evidence.sourceLineIndex !== undefined ? '查看原始日志' : '查看规范化事件') : (field.evidence.sourceLineIndex !== undefined ? 'View raw log' : 'View normalized event')}</button>`
+        : '';
+    return `<div class="trajectory-field-detail-block" data-field-detail-block data-expanded="false" data-expandable="${String(canExpand)}"${evidenceAttributes} data-preview-status="${e(previewStatus)}" data-full-status="${e(fullStatus)}" data-expand-label="${e(expandLabel)}" data-collapse-label="${e(collapseLabel)}" data-copy-label="${e(copyLabel)}" data-copied-label="${e(copiedLabel)}"><code class="trajectory-field-detail" data-field-detail>${e(displayedDetail)}</code><div class="trajectory-field-detail-actions">${status}<span class="trajectory-field-detail-controls">${evidenceButton}${toggle}<button class="trajectory-field-detail-copy" type="button" data-field-detail-copy aria-label="${e(copyLabel)}" title="${e(copyLabel)}">${icon('copy', { size: 13 })}</button></span></div></div>`;
+}
+function renderEvidenceDataAttributes(evidence, prefix = 'evidence') {
+    if (!evidence)
+        return '';
+    const attributes = [` data-${prefix}-source-event-id="${e(evidence.normalizedEventId)}"`];
+    if (evidence.sourceLineIndex !== undefined) {
+        attributes.push(` data-${prefix}-source-line-index="${evidence.sourceLineIndex}"`);
+    }
+    if (evidence.traceId)
+        attributes.push(` data-${prefix}-trace-id="${e(evidence.traceId)}"`);
+    return attributes.join('');
 }
 function fieldDetailPreview(detail) {
     const lines = detail.replace(/\r\n/g, '\n').split('\n');
@@ -1669,7 +1741,8 @@ function renderNormalizedEventList(events, operations, startTimestamp, lang) {
         const source = `${event.sourceLineIndex !== undefined ? `#${event.sourceLineIndex} · ` : ''}${shortHash(event.traceId ?? event.id)}`;
         const facetIds = [...(facetsByEventId.get(event.id) ?? [])];
         const kind = event.sourceType ? `${event.kind} · ${event.sourceType}` : event.kind;
-        return `<details class="trajectory-raw-row" data-trajectory-normalized-event="${e(event.id)}" data-trajectory-facets="${e(facetIds.join(' '))}"><summary><time>${e(formatRelativeTimestamp(event.timestamp, startTimestamp))}</time><span class="trajectory-raw-kind">${e(kind)}</span><strong>${e(preview)}</strong><code class="trajectory-raw-id">${e(source)}</code></summary><pre>${e(content || event.label || '')}</pre></details>`;
+        const sourceAttributes = `${event.sourceLineIndex !== undefined ? ` data-source-line-index="${event.sourceLineIndex}"` : ''}${event.traceId ? ` data-source-trace-id="${e(event.traceId)}"` : ''}`;
+        return `<details class="trajectory-raw-row" data-trajectory-normalized-event="${e(event.id)}"${sourceAttributes} data-trajectory-facets="${e(facetIds.join(' '))}"><summary><time>${e(formatRelativeTimestamp(event.timestamp, startTimestamp))}</time><span class="trajectory-raw-kind">${e(kind)}</span><strong>${e(preview)}</strong><code class="trajectory-raw-id">${e(source)}</code></summary><pre>${e(content || event.label || '')}</pre></details>`;
     }).join('');
     return `<section class="trajectory-raw-list" data-event-view="normalized" aria-label="${zh ? '按来源顺序排列的规范化事件' : 'Normalized events in source order'}"><header class="trajectory-raw-head"><span>${zh ? '时间' : 'Time'}</span><span>${zh ? '规范化 / 来源类型' : 'Normalized / source type'}</span><span>${zh ? '内容' : 'Content'}</span><span>${zh ? '来源位置' : 'Source position'}</span></header>${rows}<div class="trajectory-raw-empty" data-trajectory-normalized-empty hidden>${zh ? '没有符合当前类型筛选的规范化事件' : 'No normalized events match the current type filter'}</div></section>`;
 }
@@ -1721,7 +1794,7 @@ function renderSourceRecordList(model, startTimestamp, lang, sourceRecordsEndpoi
             record.redacted ? (zh ? '【不透明加密载荷已省略】' : '[Opaque encrypted payload omitted]') : '',
             record.truncated ? (zh ? '【该记录已按归档上限截断】' : '[Record truncated by archive limit]') : '',
         ].filter(Boolean).join('\n');
-        return `<details class="trajectory-raw-row"><summary><time>${e(formatRelativeTimestamp(record.timestamp, startTimestamp))}</time><span class="trajectory-raw-kind">${e(record.sourceType)}</span><strong>${e(preview)}</strong><code class="trajectory-raw-id">${e(locator)}</code></summary><pre>${e(record.raw)}${notices ? `\n\n${e(notices)}` : ''}</pre></details>`;
+        return `<details class="trajectory-raw-row" data-source-line-index="${record.sourceIndex}" data-source-trace-id="${e(record.traceId)}"><summary><time>${e(formatRelativeTimestamp(record.timestamp, startTimestamp))}</time><span class="trajectory-raw-kind">${e(record.sourceType)}</span><strong>${e(preview)}</strong><code class="trajectory-raw-id">${e(locator)}</code></summary><pre>${e(record.raw)}${notices ? `\n\n${e(notices)}` : ''}</pre></details>`;
     }).join('');
     const unavailable = source.status === 'unavailable'
         ? `<div class="trajectory-raw-empty">${e(sourceRecordUnavailableLabel(source.reason, lang))}</div>`

package/dist/renderer/trajectory-evidence.d.ts

@@ -0,0 +1,8 @@
+import type { ExperienceTimelineEvent } from '../types/index.js';
+export interface TrajectoryEvidenceRef {
+    normalizedEventId: string;
+    sourceLineIndex?: number;
+    traceId?: string;
+}
+export declare function trajectoryEvidenceRef(event: ExperienceTimelineEvent | undefined): TrajectoryEvidenceRef | undefined;
+export declare function primaryTrajectoryEvidenceRef(events: ExperienceTimelineEvent[]): TrajectoryEvidenceRef | undefined;

package/dist/renderer/trajectory-evidence.js

@@ -0,0 +1,12 @@
+export function trajectoryEvidenceRef(event) {
+    if (!event)
+        return undefined;
+    return {
+        normalizedEventId: event.id,
+        ...(event.sourceLineIndex !== undefined ? { sourceLineIndex: event.sourceLineIndex } : {}),
+        ...(event.traceId ? { traceId: event.traceId } : {}),
+    };
+}
+export function primaryTrajectoryEvidenceRef(events) {
+    return trajectoryEvidenceRef(events.find((event) => event.sourceLineIndex !== undefined) ?? events[0]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-knowledge",
-  "version": "0.52.1",
+  "version": "0.52.2",
   "packageManager": "yarn@4.16.0",
   "description": "OMK — Observe. Measure. Know. Evidence-backed knowledge changes for AI applications.",
   "type": "module",