dsh-data-domain-knowledge 0.1.0-alpha.9 → 0.1.1-alpha.2

package/src/types.ts

@@ -7,10 +7,8 @@ export type KnowledgeStatus = CardStatus
 /**
  * 知识卡片的 entity_type 白名单。
  *
- * **智能归因的五类也在这里**，这不是放宽而是纠错：排查思路本来就应该是一张 wiki 卡片
- * （0021 §6.4 定了五类实体与三段式卡片），但白名单里没有它们的时候，`writeCard` 会直接
- * 返回 `SCHEMA_TYPE_INVALID`，`readCards` 也会跳过 —— 于是排查思路**永远进不了 wikiNotes，
- * 也就永远召不回来**。列表本身在 `diagnosis/schema.ts` 里定义一次，这里只做联合。
+ * 诊断卡片类型留在联合里供历史数据兼容。当前排查记录落 SourceRaw，Case 是只读投影；
+ * 新运行不会创建 `diagnosis/case` WikiCard。列表本身在 `diagnosis/schema.ts` 里定义一次。
  */
 export type SchemaType =
   | 'concept' | 'metric' | 'table' | 'event' | 'playbook' | 'case'
@@ -19,8 +17,24 @@ export type SchemaType =
 export type EmbeddingProvider = 'wemm-python' | 'ollama' | 'none'
 export type EmbeddingDevice = 'auto' | 'mps' | 'cpu'
 export type RerankProvider = 'bert-python' | 'none'
+
+/**
+ * 知识库编译使用的模型路由。
+ *
+ * 这是知识库的部署配置，不是 Knowledge / WikiCard 的事实数据：`default` 只引用
+ * DSH 当前默认模型，`fixed` 才在本库注册表里保存一条明确的 provider + model。
+ */
+export type CompileModelMode = 'default' | 'fixed'
+export interface CompileModelSelection {
+  reasoningEffort?: string
+  mode: CompileModelMode
+  provider?: string
+  model?: string
+}
+export const DEFAULT_COMPILE_MODEL: CompileModelSelection = { mode: 'default' }
+
 /** 召回与结果诊断中的路线名。`graph` 仅用于后置 boost / 扩展，不是 RecallMode。 */
-export type RecallRoute = 'fts' | 'vector' | 'coordinate' | 'graph'
+export type RecallRoute = 'fts' | 'vector' | 'coordinate' | 'relation' | 'graph'
 /**
  * 召回路线选择（0031 起语义有变）。
  *
@@ -28,11 +42,8 @@ export type RecallRoute = 'fts' | 'vector' | 'coordinate' | 'graph'
  * 不参与候选路线选择。
  */
 export type RecallMode = 'fts' | 'vector' | 'hybrid'
-import { existsSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join, resolve } from 'node:path'
-import type { DataError, Envelope as WireEnvelope } from 'dsh-data-contracts/envelope'
-import type { LineageContext, LineageRef } from 'dsh-data-contracts/refs'
+import type { DataError, Envelope as WireEnvelope } from '#contracts'
+import type { LineageContext, LineageRef } from '#contracts'
 
 export interface KnowledgeError extends DataError {
   code: string
@@ -46,26 +57,24 @@ export interface KnowledgeError extends DataError {
  * (`spec/contracts/envelope.json`) with the error narrowed to `KnowledgeError`,
  * so `retryable` / `suggestion` stay visible to callers and the panel.
  *
- * The shape itself lives in `dsh-data-contracts` — the status rule
+ * The shape itself lives in the shared contract source — the status rule
  * "warnings make it partial" is defined once there, not re-spelled here.
  */
 export type Envelope<T> = WireEnvelope<T, KnowledgeError>
 
 export interface KnowledgeConfig {
   /**
-   * **Tita Agent 根路径** —— 用户唯一要设的那个路径（0029）。
+   * **Tita Agent 根路径** —— 固定为 DSH 下的 `tita-agent` 专属目录。
    *
    * 根路径下固定四段：`domain_knowledge/`（知识树，按知识库 id 分叉）、
    * `output/`（交付物，二级按日期）、`tmp/`（运行期临时文件，二级按日期）、
    * `resource/`（模型、Python 环境、注册表）。
-   * 四段为什么这么分，见 `layout.ts` 顶部的四条原理。
+   * 用户可在设置里查看并打开它，但不能从设置里切换；见 `layout.ts`。
    */
   agentRoot: string
   /**
-   * @deprecated 0029：这是**旧布局**的知识树根（`01_source_raw` 直接躺在它
-   * 下面）。它不再可设置，也不再决定任何路径 —— 只作为一次性的迁移来源存在：
-   * 值非空且新位置还是空的时，把旧树搬进 `<agentRoot>/domain_knowledge/default`。
-   * 搬完（或本来就没有）它就不再有意义。
+   * @deprecated 0029：旧布局的知识树根。字段仅为兼容旧配置保留；它不再可设置，
+   * 不再决定路径，也不会触发旧树读取或迁移。
    */
   rootDir: string
   schemaTypes: SchemaType[]
@@ -120,11 +129,11 @@ export interface KnowledgeConfig {
    * 组织（表达层）。两步都开着才是完整的「Knowledge Compiler + Wiki Materializer」。
    */
   cardOrganize: boolean
-  /** Python 解释器。空串 = 自动（`<agentRoot>/resource/python/bin/python`，退回旧家当目录，再退回 `python3`）。 */
+  /** Python 解释器。空串 = 自动（隔离依赖环境，再退回 `DSH_PYTHON` / `python3`）。 */
   python: string
   embeddingProvider: EmbeddingProvider
   embeddingBaseUrl: string
-  /** 嵌入模型：一个本地目录或一个 HF 模型名。空串 = 自动（根路径下的本地模型，退回旧家当目录，再退回 HF 名）。 */
+  /** 嵌入模型：一个本地目录或一个 HF 模型名。空串 = 自动（根路径下的本地模型，再退回 HF 名）。 */
   embeddingModel: string
   embeddingDimension: number
   embeddingBatchSize: number
@@ -174,14 +183,6 @@ export interface KnowledgeConfig {
   rerankTimeoutMs: number
 }
 
-/**
- * 旧的「家当」目录（0029 之前模型与虚拟环境住在这里）。
- *
- * 现在它们是**兜底**：路径解析优先看 `<agentRoot>/resource/`，找不到再回这里，
- * 最后才退回裸的模型名（从 HuggingFace 拉）。这样搬完家当、或还没搬完家当，
- * 行为都对；而 `TITA_DATA_AGENT_HOME` 仍然是覆盖它的入口。
- */
-export const legacyResourceHome = (): string => resolve(process.env.TITA_DATA_AGENT_HOME || join(homedir(), '.tita-data-agent'))
 /** 本地模型目录名。与 `layout.ts` 的 `resourceModels()` 拼在一起就是主位置。 */
 export const LOCAL_EMBEDDING_MODEL_DIR = 'WeMM-Embedding-2B-Quantized'
 /**
@@ -229,10 +230,9 @@ export const DEFAULT_KNOWLEDGE_CONFIG: RuntimeKnowledgeConfig = {
   // 卡片组织（模型）默认**开**：Knowledge 只是事实层，Wiki 卡片正文必须经过这一步
   // 物化成可读的表达。只有显式写 `false` / `0` 才关闭兼容路径。
   cardOrganize: !['false', '0'].includes((process.env.DSH_KNOWLEDGE_CARD_ORGANIZE ?? '').trim().toLowerCase()),
-  // 0029：三个「家当」路径的默认值是**空串 = 自动**。它们跟着 `<agentRoot>/resource/`
-  // 走，而 agentRoot 由设置决定、模块加载时还不知道 —— 所以在运行时解析
-  // （`runtime.ts` 的 `resolveResources`）。环境变量仍然优先。
-  python: process.env.DSH_PYTHON || '',
+  // 0029：空串 = 自动。优先用 `<agentRoot>/resource/python/` 的隔离依赖环境；
+  // DSH_PYTHON 只作为创建该环境的基础解释器和未准备时的运行时回退。
+  python: '',
   embeddingProvider: 'wemm-python',
   embeddingBaseUrl: process.env.DSH_EMBEDDING_BASE_URL || 'http://127.0.0.1:11434',
   embeddingModel: process.env.DSH_EMBEDDING_MODEL || process.env.DSH_EMBEDDING_MODEL_PATH || '',
@@ -243,7 +243,8 @@ export const DEFAULT_KNOWLEDGE_CONFIG: RuntimeKnowledgeConfig = {
   embeddingDevice: (process.env.DSH_EMBEDDING_DEVICE as 'auto' | 'mps' | 'cpu' | undefined) || 'auto',
   recallTopK: Number(process.env.DSH_KNOWLEDGE_RECALL_TOP_K || 10),
   recallCandidatePool: Number(process.env.DSH_KNOWLEDGE_CANDIDATE_POOL || 50),
-  recallMode: (process.env.DSH_KNOWLEDGE_RECALL_MODE as RecallMode | undefined) || 'hybrid',
+  // 默认与设置侧栏的产品行为一致：召回固定为多路径融合。
+  recallMode: 'hybrid',
   // 阈值初值：关键词与重排沿用 WeKnora 的出厂值（0.3 / 0.2），**向量阈值必须改** ——
   // 见下。
   keywordThreshold: Number(process.env.DSH_KNOWLEDGE_KEYWORD_THRESHOLD || 0.3),
@@ -505,12 +506,12 @@ export interface WikiCardVersion {
 export interface SearchHit extends WikiNote {
   score: number
   /** 坐标路由也是一条正式召回路由，不能在融合后写进类型之外。 */
-  match: 'fts' | 'vector' | 'coordinate' | 'graph' | 'hybrid'
+  match: 'fts' | 'vector' | 'coordinate' | 'relation' | 'graph' | 'hybrid'
   /**
    * 这个命中在每一路里的**名次**（1 起，0031）。
    *
    * 融合改用 RRF 之后，名次是唯一进入融合的量 —— 所以它必须留痕：界面上的
-   * 「三路状态」、`match` 的推导、以及「为什么这条排第一」都读它。
+   * 各路状态、`match` 的推导、以及「为什么这条排第一」都读它。
    * 缺失 = 那一路没有召回它。
    */
   ranks?: Partial<Record<RecallRoute, number>>
@@ -558,6 +559,12 @@ export interface RecallHit extends SearchHit {
 export interface RecallKnowledge {
   id: string
   text: string
+  /** Citation anchors are checked; semantic entailment is not established. */
+  claimVerification?: 'unverified'
+  requiresReview?: boolean
+  evidenceStatus?: 'current' | 'historical' | 'unversioned' | 'missing' | 'human'
+  sourceVersion?: number
+  currentSourceVersion?: number
   /**
    * Knowledge 的真值状态。**如实带出来，不许静默过滤**：Card review 不是 Knowledge 验证，
    * 因此 candidate / disputed / deprecated 都必须让上层看到。
@@ -700,6 +707,8 @@ export interface RecallTimings {
   ftsMs: number
   /** Coordinate 路：注册表 OAS 解析 + 卡片坐标命中 + Section 展开。 */
   coordinateMs: number
+  /** 对象关系路：沿显式 related_to 关系展开候选。 */
+  relationMs?: number
   /** 向量路整体（= `embedMs` + `scanMs` + 阈值与排序）。 */
   vectorMs: number
   /** 其中：查询编码。**首次含模型加载**，所以它可能是 8000ms 而不是 270ms。 */
@@ -741,6 +750,8 @@ export interface RecallLedgerRow {
 export interface RecallLedger {
   /** Coordinate 路：坐标命中后展开的 Section 候选。 */
   coordinate: RecallLedgerRow[]
+  /** 关系路：查询命中对象的一跳 related_to 候选。 */
+  relation: RecallLedgerRow[]
   /** 关键词路：`rows` 含没过阈值的那些。 */
   fts: RecallLedgerRow[]
   /** 向量路：同上。 */
@@ -797,7 +808,7 @@ export interface RecallResult {
   /** 融合之前每一路的超采深度（0031）。 */
   candidatePool: number
   /**
-   * 两路融合**去重之后**的候选条数。
+   * 多路融合**去重之后**的候选条数。
    *
    * 它和相邻那两个数都不是一回事，混用就是「召回了 17 + 2 条，融合后怎么变成 0」的来源：
    * `candidatePool` 是融合前每一路各自的超采深度（50），`fusedCount` 才是融合后的池子
@@ -858,6 +869,8 @@ export interface KnowledgeBase {
    * 空串 = 没有备注（此时提示词里那一段整个不出现）。
    */
   extractionNote: string
+  /** 编译模型路由：默认跟随 DSH，或固定到模型目录中的一项。 */
+  compileModel: CompileModelSelection
   createdAt: string
   updatedAt: string
   sourceCount: number
@@ -984,6 +997,15 @@ export interface DocumentDeleteImpact {
     shared: number
     items: Array<{ entityId: string; entityType: string; title: string; exclusive: boolean }>
   }
+  events: {
+    /** 提到这份文档的独立 Event 条数。 */
+    total: number
+    /** 只由这份文档支撑 —— 删除文档后 Event 一并删除。 */
+    exclusive: number
+    /** 还有其他来源 —— Event 保留，只移除这份来源记录。 */
+    shared: number
+    items: Array<{ id: string; title: string; occurredAt: string | null; exclusive: boolean }>
+  }
   /** 这份文档的抽取轨迹条数，一起删。 */
   extractionRuns: number
 }
@@ -1186,6 +1208,10 @@ export interface OperationDetail {
   phases?: {
     /** Extract：这一轮抽出的 Knowledge 条数。 */
     knowledge: number
+    /** Extract：这一轮抽出的 Event 条数。 */
+    events?: number
+    /** Resolve：按稳定 Event 身份并入已有事件的条数。 */
+    eventsMerged?: number
     /** Resolve：命中已有轴实体 / 新建候选 / 作用域不确定。 */
     axesMatched: number
     axesCreated: number

package/src/wiki-finalize.ts

@@ -167,6 +167,34 @@ export function cardKey(card: { entityType: string; entityId: string }): string
  * 弱的那一类是有用的：知识库刚建起来时，关系一条都没有，而「这几张卡来自同一篇文章」
  * 恰好是人最需要的导航。
  */
+/**
+ * 把「按**卡片身份**」的相关推荐计划，映射到「按**分组键**」（0070）。
+ *
+ * 两个键空间不同：`planRelated` 的键是 `type:entityId`，而物化阶段的分组键是坐标
+ * （`objectId\u0001actionId\u0001sceneId`）。不映射会出现一个**静默的**退化：
+ * `organizeCard` 拿不到「可引用的邻居」，而模型一旦照样写出 `[[名字]]`，校验会判
+ * `ORGANIZE_UNKNOWN_REFERENCE`，整组物化失败、卡片永远写不出来。
+ *
+ * 只映射**已经有卡片**的分组：新建的卡片在相关计划里本来就不存在（与旧的
+ * `relatedForCard(existing)` 行为一致）。键用卡片自己的类型，也与旧路径一致。
+ */
+/** `T` 是相关推荐条目的形状：调用方按自己的投影传进来，这里只管键的映射。 */
+export function relatedByGroupKey<T>(
+  groups: ReadonlyArray<{ key: string; cardId?: string }>,
+  cardKeyOf: (groupKey: string) => string | undefined,
+  plan: ReadonlyMap<string, T[]>,
+): Map<string, T[]> {
+  const mapped = new Map<string, T[]>()
+  for (const group of groups) {
+    if (group.cardId === undefined) continue
+    const key = cardKeyOf(group.key)
+    if (key === undefined) continue
+    const entries = plan.get(key)
+    if (entries !== undefined) mapped.set(group.key, entries)
+  }
+  return mapped
+}
+
 export function planRelated(
   cards: Array<Pick<KnowledgeCard, 'entityType' | 'entityId' | 'title' | 'sourceRefs'>>,
   relations: Array<{ fromKey: string; toKey: string }>,

package/src/wiki-materialize.ts

@@ -84,7 +84,11 @@ export function coordinateIdsOf(
   scene: string | null,
 ): CardCoordinate {
   const idOf = (list: TrialAxis[], name: string | null): string =>
-    name === null ? '' : list.find(axis => axis.name === name)?.id ?? ''
+    name === null ? '' : (() => {
+      const axis = list.find(item => item.name === name)
+      // ambiguous 仍保留 mention 供 review，但不能写入一个看似有效的猜测 id。
+      return axis?.outcome === 'ambiguous' ? '' : axis?.id ?? ''
+    })()
   return {
     objectId: idOf(axes.objects, object),
     actionId: idOf(axes.actions, action),
@@ -107,6 +111,10 @@ export function candidatesFromReport(input: {
   report: TrialReport
   profileId: SchemaType
   sourceId: string
+  /** 坐标 ID → 该坐标下全部独立 Event ID。 */
+  eventIdsByCoordinate?: Record<string, string[]>
+  /** 本次试跑的临时 Event id → 已落库的 Event id。 */
+  eventIds?: Record<string, string>
 }): MaterializeResult {
   const { report, profileId, sourceId } = input
   const byId = new Map(report.knowledge.map(item => [item.id, item]))
@@ -116,12 +124,9 @@ export function candidatesFromReport(input: {
   let unresolvedCoordinates = 0
 
   for (const card of report.wikiCards) {
-    // 一条 Knowledge 都没引用到的卡不建 —— 空壳卡没有任何东西可召回，
-    // 而它占的 id 会让下一份真正说了点什么的文档并进这张空卡里。
     const items = card.placements
       .map(placement => byId.get(placement.item))
       .filter((item): item is TrialKnowledge => item !== undefined)
-    if (items.length === 0) continue
 
     /**
      * 撞名检测。键是**坐标**而不是卡名 —— 要抓的正是「两个不同坐标、同一个名字」。
@@ -140,6 +145,19 @@ export function candidatesFromReport(input: {
     const usable = coordinateIsEmpty(ids) ? undefined : ids
     if (usable === undefined) unresolvedCoordinates += 1
 
+    // Event 只有三轴都明确归一后才能挂到坐标 WikiCard。部分坐标仍保留在 Event
+    // 元数据和原文里，但不能让它被误聚合进某个更宽泛的坐标卡。
+    const completeCoordinate = Boolean(ids.objectId && ids.actionId && ids.sceneId)
+    const coordinateKey = `${ids.objectId}\u0001${ids.actionId}\u0001${ids.sceneId}`
+    const eventIds = completeCoordinate
+      ? input.eventIdsByCoordinate?.[coordinateKey]
+        ?? card.events.map(id => input.eventIds?.[id]).filter((id): id is string => Boolean(id))
+      : []
+    if (items.length === 0) continue
+    const knowledgeBody = renderFallbackBody(card.placements, byId)
+    const body = knowledgeBody
+    const evidence = evidenceOf(items, sourceId)
+
     cards.push({
       candidate: {
         kind: 'entity',
@@ -148,7 +166,7 @@ export function candidatesFromReport(input: {
         // 旧的无分隔拼接标题继续参与召回与判重，但不再占据展示标题。
         aliases: [...new Set([legacyCardNameFor(card.object, card.action, card.scene)])]
           .filter(alias => alias !== card.name),
-        body: renderFallbackBody(card.placements, byId),
+        body,
         ...(items[0] ? { summary: items[0].text } : {}),
         /**
          * 证据取这条卡里**第一条核对得上的引文**。
@@ -157,7 +175,8 @@ export function candidatesFromReport(input: {
          * 逐条知识各自的出处留在 Knowledge 上（那是真源）。所以这里挑一条就够，
          * 不把每条知识的引文都堆到卡片上：那会让同一句话在库里存很多份。
          */
-        evidence: evidenceOf(items, sourceId),
+        evidence,
+        fields: { event_refs: JSON.stringify([...new Set(eventIds)]) },
         confidence: 0.7,
       },
       ...(usable === undefined ? {} : { coordinate: usable }),

package/src/wiki-trial-types.ts

@@ -1,3 +1,4 @@
+import type { KnowledgeContent, KnowledgeKind } from './knowledge-contract.js'
 /**
  * Wiki 抽取试跑（0063）的**类型真源**。
  *
@@ -48,6 +49,9 @@ export interface TrialSource {
  * **只有 `text` 是内容**，其余全是索引与出处。
  */
 export interface TrialKnowledge {
+  scopeIdentity?: boolean
+  kind?: KnowledgeKind
+  data?: KnowledgeContent
   id: string
   text: string
   /** 三个轴实体的**名字**，不是 id —— 换成 id 是第 4 步的事。 */
@@ -75,6 +79,38 @@ export interface TrialKnowledge {
   noCoordinate: boolean
 }
 
+export type TrialEventStepKind = 'observation' | 'check' | 'action' | 'result' | 'conclusion'
+
+/**
+ * 一次具体发生。Event 与 Knowledge 并列抽取：Event 记录本次经过，Knowledge 记录可复用内容。
+ * 坐标名已由同一套轴注册表归一；来源引文由本地按原文核验。
+ */
+export interface TrialEvent {
+  id: string
+  externalId: string | null
+  title: string
+  summary: string
+  object: string | null
+  action: string | null
+  scene: string | null
+  occurredAt: string | null
+  symptom: string | null
+  timeline: Array<{
+    id: string
+    type: TrialEventStepKind
+    description: string
+    result: string | null
+    at: string | null
+    sources: TrialSource[]
+  }>
+  rootCause: string | null
+  rootCauseStatus: 'confirmed' | 'suspected' | null
+  outcome: string | null
+  missing: string[]
+  sources: TrialSource[]
+  noCoordinate: boolean
+}
+
 /**
  * 一个轴实体。
  *
@@ -142,6 +178,8 @@ export interface TrialWikiCard {
   /** 系统按坐标推导的自然语言展示标题。 */
   name: string
   placements: TrialPlacement[]
+  /** 同一坐标下的 Event 引用；Event 自身仍保留独立身份与来源。 */
+  events: string[]
 }
 
 /**
@@ -155,10 +193,13 @@ export interface TrialMatrixGroup {
   scene: string
   /** 落在这一组的知识条数。 */
   knowledge: number
+  /** 落在这一组的事件数。 */
+  events: number
   /** 这一组的 Wiki Card 名。没有成卡时是空串。 */
   card: string
   /** 这一组里的知识 id，按它们在报告里的顺序。 */
   items: string[]
+  eventItems: string[]
 }
 
 /** 矩阵的一格。**场景落在格子内部**，不进坐标轴。 */
@@ -169,6 +210,7 @@ export interface TrialMatrixCell {
   groups: TrialMatrixGroup[]
   /** 这一格的合计条数。 */
   knowledge: number
+  events: number
 }
 
 /**
@@ -184,6 +226,7 @@ export interface TrialMatrixLoose {
   name: string
   groups: TrialMatrixGroup[]
   knowledge: number
+  events: number
 }
 
 export interface TrialMatrix {
@@ -198,6 +241,8 @@ export interface TrialMatrix {
   noObject: TrialMatrixLoose[]
   /** 三个分量都空的知识条数。它不进矩阵、不成卡，只被全库命中。 */
   noCoordinate: number
+  /** 有坐标但未能归入格子的事件数。 */
+  noCoordinateEvents: number
   /** 有知识的格子数。 */
   withKnowledge: number
   /** 有内容的格子数（有知识或有卡）。 */
@@ -253,6 +298,26 @@ export interface TrialAudit {
   dropped: Array<{ quote: string; why: string }>
 }
 
+/** 模型端返回的本次调用用量；缓存字段与普通输入 token 分开计数。 */
+export interface TrialTokenUsage {
+  inputTokens?: number
+  outputTokens?: number
+  totalTokens?: number
+  cacheReadTokens?: number
+  cacheWriteTokens?: number
+  reasoningTokens?: number
+}
+
+/** 坐标补判的模型调用轨迹，和主抽取请求分开保存。 */
+export interface TrialModelCallTrace {
+  ok: boolean
+  why?: string
+  request?: { provider?: string; model?: string; reasoningEffort?: string; sessionId?: string }
+  prompt: { system: string; user: string }
+  response?: string
+  usage?: TrialTokenUsage
+}
+
 export interface TrialReport {
   title: string
   subject: string
@@ -263,6 +328,7 @@ export interface TrialReport {
   actions: TrialAxis[]
   scenes: TrialAxis[]
   knowledge: TrialKnowledge[]
+  events: TrialEvent[]
   wikiCards: TrialWikiCard[]
   matrix: TrialMatrix
   checks: TrialCheck[]
@@ -274,7 +340,23 @@ export interface TrialReport {
    * `raw` 是模型实际回了什么的一小段。**没有它，降级告警没有下一步** ——
    * 「模型的回答里没有 JSON」这句话本身不告诉人该去改什么。
    */
-  model: { ok: boolean; why?: string; raw?: string }
+  model: {
+    ok: boolean
+    /** Structural decoding succeeded, including a valid empty extraction. */
+    parsed?: boolean
+    outputFormat?: 'json' | 'table'
+    why?: string
+    /** 解析失败时的短摘录，保留旧界面的错误提示。 */
+    raw?: string
+    /** 本次实际送出的模型路由与会话信息。 */
+    request?: { provider?: string; model?: string; reasoningEffort?: string; sessionId?: string }
+    /** 模型返回的完整原文，供抽取轨迹复核。 */
+    response?: string
+    /** 模型端返回的本次调用用量。 */
+    usage?: TrialTokenUsage
+    /** 有坐标无法直接解析时，额外调用一次模型作候选判定。 */
+    axisResolution?: TrialModelCallTrace
+  }
   /**
    * 原样发出去的提示词。
    *