@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/lib/types.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { TrainingBlueprint, StageContract, StepTaskPackage, StageAcceptanceRecord, CaseVariantPackage, ValidationReport, AssemblyDryRunResult, GenerationPhase, Phase1Artifacts } from '../admin/types/creatorArtifacts';
 export type Domain = 'banking' | 'insurance' | 'trade';
 export type Difficulty = 'easy' | 'medium' | 'hard';
 export type TrainingLevel = 'undergraduate' | 'vocational' | 'technical';
@@ -29,6 +30,8 @@ export interface GlobalRules {
 export interface EvaluationRules {
     dimensions: EvaluationDimension[];
     businessRules: string[];
+    referenceAnswer?: string;
+    requiredPoints?: string[];
 }
 export interface EntryAnimation {
     type: EntryAnimationType;
@@ -41,25 +44,49 @@ export interface StepTargetAbility {
 }
 export interface Step {
     stepId: string;
-    name: string;
+    stepName: string;
     description?: string;
     learningObjectives?: string[];
     pluginId: string;
     pluginType: PluginType;
     initData: any;
-    checkRules: any;
+    runtimeRules: any;
+    evaluationRules?: EvaluationRules;
     jumpRules?: any;
     entryAnimation?: EntryAnimation;
     order: number;
     targetAbilities?: StepTargetAbility[];
 }
+export interface StageAssessment {
+    consistencyChecks: Array<{
+        name: string;
+        description: string;
+        relatedSteps: string[];
+    }>;
+    deliverableChecks: Array<{
+        deliverable: string;
+        criteria: string[];
+    }>;
+    goalCriteria: string[];
+    passPolicy: {
+        stepWeights: Record<string, number>;
+        passScore?: number;
+    };
+}
 export interface Stage {
     stageId: string;
-    name: string;
+    stageName: string;
     description: string;
     businessType: string;
     learningObjectives?: string[];
-    evaluationRules: EvaluationRules;
+    stageGoal?: string;
+    deliverables?: string[];
+    entryCriteria?: string[];
+    completionCriteria?: string[];
+    commonMistakes?: string[];
+    stageAssessment?: StageAssessment;
+    /** @deprecated 由 step.evaluationRules 替代，环节三完成后删除 */
+    evaluationRules?: EvaluationRules;
     steps: Step[];
     order: number;
 }
@@ -69,11 +96,13 @@ export interface RoleConfig {
     角色类型: string;
     [key: string]: any;
 }
+export type FieldUsage = 'display' | 'evaluation';
 export interface CaseSchemaField {
     path: string;
     type: 'string' | 'number' | 'boolean' | 'enum' | 'date' | 'object' | 'array';
     label: string;
-    purpose?: string;
+    purpose: string;
+    usage: FieldUsage[];
     rule?: string;
     enumValues?: string[];
     maxLength?: number;
@@ -101,9 +130,9 @@ export interface Case {
     scenario: string;
     customerInfo: any;
     businessData: any;
-    standardAnswer: any;
+    stepAnswers?: Record<string, any>;
     riskPoints?: string[];
-    rolePool: Record<string, RoleConfig>;
+    角色池: Record<string, RoleConfig>;
 }
 export interface AbilityNode {
     id: string;
@@ -175,6 +204,7 @@ export interface DimensionResult {
     suggestions?: string[];
 }
 export interface EvaluationReport {
+    stepId?: string;
     totalScore: number;
     dimensions: DimensionResult[];
     highlights: string[];
@@ -182,6 +212,33 @@ export interface EvaluationReport {
     nextStepAdvice: string;
     pass: boolean;
 }
+export interface StageAssessmentReport {
+    stageId: string;
+    totalScore: number;
+    pass: boolean;
+    stepBreakdown: Array<{
+        stepId: string;
+        stepName: string;
+        score: number;
+        weight: number;
+    }>;
+    consistencyIssues: Array<{
+        description: string;
+        relatedSteps: string[];
+        severity: 'info' | 'warning' | 'error';
+    }>;
+    deliverableResults: Array<{
+        deliverable: string;
+        achieved: boolean;
+        comment: string;
+    }>;
+    goalAchievement: {
+        score: number;
+        comment: string;
+    };
+    highlights: string[];
+    improvements: string[];
+}
 export interface ScenarioDimension {
     key: string;
     dimensionLabel: string;
@@ -189,7 +246,20 @@ export interface ScenarioDimension {
     fieldHint?: string;
 }
 export interface CreatorContext {
-    basicInfo: {
+    trainingBlueprint?: TrainingBlueprint;
+    stageContracts?: StageContract[];
+    stepTaskPackages?: StepTaskPackage[];
+    stageAcceptanceRecords?: StageAcceptanceRecord[];
+    /** 两段式生成的阶段状态机，用于中断后恢复到正确的生成环节 */
+    generationPhase?: GenerationPhase;
+    /** 环节一产物，用于中断后恢复并继续环节二落地（无需重生成） */
+    phase1Artifacts?: Phase1Artifacts | null;
+    caseVariantPackages?: CaseVariantPackage[];
+    validationReport?: ValidationReport;
+    assemblyDraft?: TrainingModel;
+    assemblyDryRunResult?: AssemblyDryRunResult;
+    releaseDecision?: 'pass' | 'block';
+    basicInfo?: {
         domain: string;
         businessType: string;
         targetPosition: string;
@@ -202,32 +272,48 @@ export interface CreatorContext {
     };
     intentData?: any;
     caseScenario: {
-        selectedCases: Array<{
-            value: string;
+        caseVariantPackages: Array<{
+            variantId: string;
             label: string;
-            description?: string;
+            difficulty: 'easy' | 'medium' | 'hard';
+            objectProfile: Record<string, any>;
+            keyFacts: string[];
+            constraints: string[];
+            hiddenRisks: string[];
+            disturbanceEvents: string[];
+            communicationResistance: string[];
+            standardPath: string[];
+            commonErrors: string[];
         }>;
-        customCase: string;
-        scenarioSeeds?: Record<string, ScenarioDimension[]>;
+        selectedVariantIds: string[];
     };
     outline: {
+        summary: string;
         stages: Array<{
-            name: string;
-            description: string;
-            businessType: string;
-            learningObjectives?: string[];
+            stageId: string;
+            stageName: string;
+            stageGoal: string;
+            entryCriteria: string[];
+            deliverables: string[];
+            keyDecisions: string[];
+            completionCriteria: string[];
+            commonMistakes: string[];
             steps: Array<{
-                name: string;
-                description: string;
-                learningObjectives?: string[];
+                stepId: string;
+                stepName: string;
+                purpose: string;
+                pluginType?: string;
             }>;
         }>;
-        summary?: string;
     } | null;
+    abilityMap?: import('@shared/types/index.js').AbilityMap | null;
     outlineMessages: Array<{
         role: 'user' | 'ai';
         content: string;
     }>;
+    outlineConversationId?: string | null;
+    detailConversationId?: string | null;
+    /** @deprecated 仅用于恢复旧缓存，不再写入新值 */
     designConversationId?: string | null;
     generatedModel?: TrainingModel;
     caseSchema?: CaseSchema;
@@ -236,7 +322,12 @@ export interface CreatorContext {
     currentStep: number;
     savedAt: number;
 }
-export type TokenProvider = () => string | Promise<string>;
+/**
+ * Token 提供器。
+ * @param forceRefresh 传 true 表示强制刷新（清掉缓存并重新换取），用于 token 失效自愈；
+ *                     不传或 false 走正常的缓存优先逻辑。
+ */
+export type TokenProvider = (forceRefresh?: boolean) => string | Promise<string>;
 export interface CreatorNotifyAdapter {
     success(message: string): void;
     error(message: string): void;

package/dist-types/client/src/plugins/AssessmentPlugin.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 评估问卷插件（通用）- 左右布局版
+ * 适用于：风险评估、适当性评估、合规检查、信用评估等
+ */
+declare const AssessmentPlugin: React.FC<PluginProps>;
+export default AssessmentPlugin;

package/dist-types/client/src/plugins/CaseAnalysisPlugin.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 案例分析（对外 label：方案设计）插件 · 纯逻辑层。
+ * 范式：学生用结构化组件搭建一份报告/方案文档 → AI 按整篇报告评分 + 本地完整性兜底。
+ * 命名保留 CaseAnalysis*（PluginType 值仍 'case-analysis'）。
+ */
+declare const CaseAnalysisPlugin: React.FC<PluginProps>;
+export default CaseAnalysisPlugin;

package/dist-types/client/src/plugins/CaseAnalysisPluginView.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { CaseAnalysisUIConfig, ReportBlock, ReportBlockKind, ReferenceDoc, RecommendedOutline, EvaluationResult } from './shared/types';
+export type { EvaluationResult } from './shared/types';
+export interface CaseAnalysisPluginViewProps {
+    phase: 'editing' | 'evaluating' | 'feedback';
+    scenario: string;
+    background?: string;
+    referenceDocs?: ReferenceDoc[];
+    reportTitle?: string;
+    /** 中间顶栏标签来源 */
+    stepName?: string;
+    /** 「推荐示例」套用的大纲骨架 */
+    recommendedOutline?: RecommendedOutline;
+    blocks: ReportBlock[];
+    onBlocksChange: (blocks: ReportBlock[]) => void;
+    availableComponents?: ReportBlockKind[];
+    availableFrameworks?: string[];
+    evaluation: EvaluationResult | null;
+    loading: boolean;
+    uiConfig: CaseAnalysisUIConfig;
+    onSubmit: () => void;
+    onRetry: () => void;
+    onComplete: () => void;
+}
+declare const CaseAnalysisPluginView: React.FC<CaseAnalysisPluginViewProps>;
+export default CaseAnalysisPluginView;

package/dist-types/client/src/plugins/DecisionSelectPlugin.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 决策选择插件（通用）
+ * 适用于：产品推荐、审批决策、方案选择、异常处置等
+ */
+declare const DecisionSelectPlugin: React.FC<PluginProps>;
+export default DecisionSelectPlugin;

package/dist-types/client/src/plugins/DialogueFormPlugin.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 对话式表单插件
+ * 一边与AI扮演的角色聊天，一边操作表单
+ * 复用 useDialogueLogic + useFormFillingLogic
+ */
+declare const DialogueFormPlugin: React.FC<PluginProps>;
+export default DialogueFormPlugin;

package/dist-types/client/src/plugins/DialogueFormPluginView.d.ts

@@ -0,0 +1,37 @@
+import React from "react";
+import type { DialogueFormUIConfig } from "./shared/types";
+interface Message {
+    role: "customer" | "teller";
+    content: string;
+    timestamp: number;
+    emotion?: "neutral" | "happy" | "confused" | "angry";
+    feedback?: string;
+}
+export interface DialogueFormPluginViewProps {
+    messages: Message[];
+    input: string;
+    aiResponding: boolean;
+    aiError?: string | null;
+    scenario?: string;
+    objectives?: string[];
+    tellerRoleName: string;
+    customerRoleName: string;
+    formTemplate: any;
+    formData: Record<string, any>;
+    validationErrors: Record<string, string>;
+    highlightedFields: Set<string>;
+    formInstance: any;
+    uiConfig: DialogueFormUIConfig;
+    stableFormData: Record<string, any>;
+    stableOnValueChange: (field: string, value: any) => void;
+    forceRenderKey?: number;
+    onInputChange: (value: string) => void;
+    onSend: () => void;
+    onFieldChange: (fieldName: string, value: any) => void;
+    onComplete: () => void;
+}
+/**
+ * 对话式表单插件纯 UI 组件
+ */
+declare const DialogueFormPluginView: React.FC<DialogueFormPluginViewProps>;
+export default DialogueFormPluginView;

package/dist-types/client/src/plugins/DialoguePlugin.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 对话交互插件
+ * 用于客户接待、需求确认等对话场景
+ */
+declare const DialoguePlugin: React.FC<PluginProps>;
+export default DialoguePlugin;

package/dist-types/client/src/plugins/DialoguePluginView.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import type { DialogueUIConfig } from './shared/types';
+import type { DialoguePhase } from '@shared/types/index.js';
+type Emotion = 'neutral' | 'happy' | 'confused' | 'angry';
+type TalkQuality = 'excellent' | 'good' | 'average' | 'poor';
+interface Message {
+    role: 'customer' | 'teller';
+    content: string;
+    timestamp: number;
+    emotion?: Emotion;
+    feedback?: string;
+    talkQuality?: TalkQuality;
+}
+interface RoleProfile {
+    name: string;
+    trait?: string;
+    desc?: string;
+}
+export interface DialoguePluginViewProps {
+    messages: Message[];
+    input: string;
+    aiResponding: boolean;
+    aiError?: string | null;
+    dialogueLogCount: number;
+    scenario?: string;
+    dialogueGoals?: string[];
+    tellerRoleName: string;
+    customerRoleName: string;
+    customerProfile?: RoleProfile;
+    tellerProfile?: RoleProfile;
+    uiConfig: DialogueUIConfig;
+    onInputChange: (value: string) => void;
+    onSend: () => void;
+    onComplete: () => void;
+    phases?: DialoguePhase[];
+    currentPhaseId?: string | null;
+    phaseHistory?: string[];
+}
+/**
+ * 对话插件运行时视图（双栏：左聊天区 65% + 右信息面板 35%）。
+ * 按 yyy_v2 原型 main-content 还原；顶栏与左侧实训资料栏由引擎/公共模块统一渲染，此处不重复。
+ */
+declare const DialoguePluginView: React.FC<DialoguePluginViewProps>;
+export default DialoguePluginView;

package/dist-types/client/src/plugins/DocumentReview/DocumentCard.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+import type { ReviewDocument, ReviewField, ReferenceDiscrepancy } from '../shared/types';
+import type { DocumentReviewScoreResult } from '../shared/judgement';
+/**
+ * 单据审核「找茬式」核心组件
+ *
+ * 像素级复现原型 document-review2.html 的单证区：
+ *   .document-card → .tab-bar/.tab-item/.tab-badge → .tab-panel
+ *   → .doc-header/.doc-title/.doc-subtitle/.doc-no
+ *   → .form-section/.form-section-title → .form-grid(cols-2/3/full)
+ *   → .field-item(marked/marked-error/marked-correct/locate-flash)
+ *
+ * 多份单证用 Tab（每 Tab 一份），点击 field-item 触发 onFieldClick。
+ */
+export interface DocumentCardProps {
+    documents: ReviewDocument[];
+    /** key = field.name（全局唯一） */
+    markedFields: Map<string, {
+        typeId: string;
+        reason?: string;
+    }>;
+    onFieldClick: (docIndex: number, field: ReviewField) => void;
+    /** 当前激活 Tab（单证）变化时回调，索引为 documents 下标。用于驱动外部底栏「当前单证」等联动 */
+    onTabChange?: (index: number) => void;
+    /** 控制 Tab 上的预设错误数 badge */
+    showExpectedCount: boolean;
+    /** 各单证预设错误数（仅 showExpectedCount 为 true 时显示） */
+    expectedCountByDoc?: Record<number, number>;
+    /** 提交后：标注命中/遗漏/误标 */
+    resultMode?: boolean;
+    /** perAnswer / falseMarks */
+    scoreResult?: DocumentReviewScoreResult;
+    /** 提交后取 correctValue 展示 */
+    answers?: ReferenceDiscrepancy[];
+    /** 高亮笔圈划的字段集合（key = field.name），对齐原型 .highlight-pen */
+    highlightedFields?: Set<string>;
+}
+/**
+ * 主插件通过 ref 调用的命令式句柄（定位/闪烁）。
+ * DocumentCard 内部自管 activeIndex（Tab），定位需切 Tab + 滚动 + 闪烁，
+ * 故由内部暴露 locate(fieldName)：找到字段所在单证 → 切 Tab → 下一帧 scrollIntoView + locate-flash。
+ */
+export interface DocumentCardHandle {
+    locate: (fieldName: string) => void;
+}
+export declare const DocumentCard: React.ForwardRefExoticComponent<DocumentCardProps & React.RefAttributes<DocumentCardHandle>>;
+export default DocumentCard;

package/dist-types/client/src/plugins/DocumentReview/LayoutComponents.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+/**
+ * 单据审核「找茬式」三栏布局容器
+ *
+ * 容器内自适应 flex 布局（对齐决策判断插件 styles.root/workspace，不再用 fixed 定位）：
+ *   mainLayout（横向 flex，height:100% 填满父容器，溢出收敛到各栏内部）
+ *     ├─ 左：参考文档侧边栏（ReferenceDocPanel，flex 子项，固定宽 330，可折叠到 0）
+ *     ├─ 中：contentArea（flex:1，自身 overflowY:auto）
+ *     │      工具栏 + 单证卡片 + 结果面板 + 底部统计条（均由 children 注入）
+ *     └─ 右：标记清单面板（MarkListPanel，flex 子项，固定宽 380，可折叠到 0）
+ *
+ * 关键：三栏全部相对本容器排布。因此当外层步骤弹窗缩窄（如打开案例详情侧栏）时，
+ *   中栏 flex:1 自动收缩、左右栏随容器收敛，整组三栏随弹窗自适应；
+ *   不再依赖"头部恰好 64px"的隐式契约，也不会用 fixed 越出弹窗遮挡头部。
+ *   面板折叠/展开由各自组件用 width 过渡 + absolute 浮动按钮实现（相对本容器，position:relative）。
+ */
+export interface DocumentReviewLayoutProps {
+    /** 左栏（可选，已弃用）：参考文档移至引擎「实训资料」资料栏统一渲染，本插件不再传 */
+    left?: React.ReactNode;
+    /** 中栏：工具栏 + 单证 + 结果 + 底栏 */
+    center: React.ReactNode;
+    /** 右栏：标记清单面板（flex 子项，含自身折叠与浮动展开按钮） */
+    right: React.ReactNode;
+}
+export declare const DocumentReviewLayout: React.FC<DocumentReviewLayoutProps>;
+/**
+ * 底部统计条（对齐原型 .bottom-bar）
+ *
+ *   左侧：📄 单证数量 / 📍 当前单证 / ⚠️ 预设错误数（N 受 showExpectedCount 控制）
+ *   右侧：操作提示
+ *
+ * 预设错误数仅在 showExpectedCount 为真且 expectedTotal 有值时展示该项
+ * （T9 会统一复核显隐口径，此处先按入参透传）。
+ */
+export interface BottomBarProps {
+    /** 单证数量 */
+    documentCount: number;
+    /** 当前单证名称 */
+    currentDocName: string;
+    /** 预设错误数（仅 showExpectedCount 时展示） */
+    expectedTotal?: number;
+    showExpectedCount: boolean;
+    /** 右侧提示文案 */
+    hint?: string;
+}
+export declare const BottomBar: React.FC<BottomBarProps>;
+export default DocumentReviewLayout;

package/dist-types/client/src/plugins/DocumentReview/MarkListPanel.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+import type { ErrorTypeOption } from '../shared/types';
+import type { DocumentReviewScoreResult } from '../shared/judgement';
+/**
+ * 右侧「标记清单」单条数据
+ * fieldName 全局唯一，作为定位/编辑/删除的 key。
+ */
+export interface MarkListItem {
+    fieldName: string;
+    fieldLabel: string;
+    docName: string;
+    typeId: string;
+    reason?: string;
+}
+/**
+ * 单据审核「找茬式」右侧标记清单面板
+ *
+ * 像素级复现原型 document-review2.html 的右侧面板：
+ *   .mark-panel(.collapsed / .submitted-mode)
+ *     → .mark-panel-header（紫色渐变 #667eea→#764ba2，含收起按钮）
+ *     → .mark-panel-stats（已标记不符点 X / N 处，count-num 24px 蓝）
+ *     → .mark-panel-body
+ *         → .mark-list-empty（空态）
+ *         → .mark-list-item ×N（.mark-list-index / .mark-list-field-name
+ *            / .mark-list-tab-tag / .mark-list-type-tag / .mark-list-reason
+ *            / .mark-list-actions[定位/编辑/删除]）
+ *   + .mark-panel-fab（收起时浮动展开按钮）
+ *
+ * submitted 只读：隐藏编辑/删除（保留定位）；依据 scoreResult 给序号/类型 tag 上色
+ *   - 命中（fieldName ∈ perAnswer 且 hit）→ index-correct + type-correct（绿）
+ *   - 误标（fieldName ∈ falseMarks）→ index-wrong（红）
+ */
+export interface MarkListPanelProps {
+    marks: MarkListItem[];
+    /** 查 typeId → label */
+    errorTypes: ErrorTypeOption[];
+    collapsed: boolean;
+    onToggleCollapsed: () => void;
+    submitted: boolean;
+    /** 提交后判定每条命中/误标 */
+    scoreResult?: DocumentReviewScoreResult;
+    onLocate: (fieldName: string) => void;
+    onEdit: (fieldName: string) => void;
+    onDelete: (fieldName: string) => void;
+    /** 控制 "/ N" 显隐 */
+    showExpectedCount: boolean;
+    /** N（预设不符点总数） */
+    expectedTotal?: number;
+}
+export declare const MarkListPanel: React.FC<MarkListPanelProps>;
+export default MarkListPanel;

package/dist-types/client/src/plugins/DocumentReview/MarkModal.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import type { ErrorTypeOption } from '../shared/types';
+/**
+ * 单据审核「找茬式」标记弹窗
+ *
+ * 像素级复现原型 document-review2.html 的标记弹窗：
+ *   .mark-modal-overlay(show) → .mark-modal
+ *     → .mark-modal-header
+ *     → .mark-field-preview(.label / .value)
+ *     → .mark-modal-body(label + .mark-error-select[optgroup] + label + .mark-reason-input)
+ *     → .mark-modal-footer(.btn-cancel / .btn-confirm / 红色「取消标记」)
+ *
+ * 错误类型按 errorTypes[].group 分 <optgroup>（原型 confirmMark 行为）；
+ * 未选错误类型不允许确认（原型 alert「请选择错误类型」）。
+ *
+ * existing（编辑既有标记）：回填 typeId/reason，额外显示红色「取消标记」(onRemove)，
+ * 「确认标记」文案改为「更新标记」（原型隐藏确认仅留删除，本实现保留更新能力以便修改类型/说明）。
+ */
+export interface MarkModalProps {
+    open: boolean;
+    /** 字段名预览 */
+    fieldLabel: string;
+    /** 字段值预览 */
+    fieldValue: string;
+    errorTypes: ErrorTypeOption[];
+    /** 编辑既有标记时回填 */
+    existing?: {
+        typeId: string;
+        reason?: string;
+    };
+    onConfirm: (typeId: string, reason: string) => void;
+    /** 仅 existing 时显示「取消标记」 */
+    onRemove?: () => void;
+    onCancel: () => void;
+}
+export declare const MarkModal: React.FC<MarkModalProps>;
+export default MarkModal;

package/dist-types/client/src/plugins/DocumentReview/ResultPanel.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { ReviewDocument, ReferenceDiscrepancy, ErrorTypeOption } from '../shared/types';
+import type { DocumentReviewScoreResult } from '../shared/judgement';
+/**
+ * 单据审核「找茬式」提交后结果面板 —— 不符点清单
+ *
+ * 像素级复现原型 document-review2.html 的 .result-panel：
+ *   .result-panel
+ *     .result-header（黄色渐变）
+ *        h3「📋 审核结果 — 不符点清单」
+ *        .result-stats（.stat-item found/missed/wrong，取自 scoreResult）
+ *     .result-body
+ *        .discrepancy-table（状态 / 字段名称 / 所属单证 / 错误类型 / 原值→正确值）
+ *          - 命中(hit)：✅、原值划线 + 绿色 correctValue、explanation、学员备注(蓝)
+ *          - 遗漏：❌、「【未标记】原值：X → 应为：Y」(红)、explanation
+ *          - 误标(falseMarks)：⚠️、「误标」、该字段无误提示 + 学员备注
+ */
+export interface ResultPanelProps {
+    scoreResult: DocumentReviewScoreResult;
+    answers: ReferenceDiscrepancy[];
+    /** 用于按 fieldName 查 字段label / 原值 / 所属单证名 */
+    documents: ReviewDocument[];
+    /** typeId → label */
+    errorTypes: ErrorTypeOption[];
+    /** 学员备注 reason（fieldName → { typeId, reason }） */
+    marks: Map<string, {
+        typeId: string;
+        reason?: string;
+    }>;
+}
+export declare const ResultPanel: React.FC<ResultPanelProps>;
+export default ResultPanel;

package/dist-types/client/src/plugins/DocumentReview/Toolbar.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+/**
+ * 单据审核「找茬式」顶部工具栏
+ *
+ * 像素级复现原型 document-review2.html 的 .toolbar：
+ *   .toolbar
+ *     .toolbar-left
+ *        .tool-btn（高亮笔，active 态由 highlightActive 控制）
+ *        .tool-btn（审核提示，点击弹出 hintText）
+ *        .tool-btn（清除标注）
+ *     .toolbar-right
+ *        .status-badge(.reviewing / .submitted)（带脉冲圆点）
+ *        已标记 X 处
+ *        .submit-btn（提交审核 / 已提交禁用）
+ *
+ * 注意：高亮笔在字段上的显示，以及「点击字段切高亮 vs 开标记弹窗」的分流由
+ * 主插件 + DocumentCard 接线，本组件只负责按钮与 active 态。已砍掉放大镜。
+ */
+export interface ToolbarProps {
+    markedCount: number;
+    /** 高亮笔是否激活 */
+    highlightActive: boolean;
+    onToggleHighlight: () => void;
+    onClearMarks: () => void;
+    onSubmit: () => void;
+    submitted: boolean;
+    /** 审核提示文案（默认给通用操作指引） */
+    hintText?: string;
+}
+export declare const Toolbar: React.FC<ToolbarProps>;
+export default Toolbar;