@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/plugins/decision-making/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 决策判断插件（DecisionMakingPlugin）类型定义 —— 两栏沉浸式重写
+ *
+ * 交互形态：左栏材料常驻 + 右栏三步工作区
+ *   ① 标注决策点 → ② 做出决策 → ③ 阐述理由
+ *
+ * 对应「运行时配置契约表 §6（重写版）」。旧 decisionCard / conclusionFields
+ * 模型整体废弃（项目未上线，无需向后兼容）。
+ */
+import type { EvidenceSummary } from '@shared/types/index.js';
+/**
+ * 标注类别：定义学员可在材料上标注的决策点类型。
+ * 医疗领域如 症状体征 / 检查指标 / 风险因素 / 生活习惯；
+ * 通用领域由落地智能体按业务产出（如 财务风险 / 健康状况 / 家庭结构 / 法律风险）。
+ */
+export interface MarkerCategory {
+    /** 类别标识，如 'symptom' / 'risk' / 'finance' */
+    key: string;
+    /** 显示名，如 '症状体征' / '财务风险' */
+    label: string;
+    /** 主题色（hex），用于段内 inline-tag、标注列表圆点 */
+    color: string;
+}
+/** 富文本段落：可标注的材料块之一（对应原型可点击「+」的段落） */
+export interface RichTextBlock {
+    kind: 'richText';
+    /** 段落唯一 id —— 标注锚点（对应原型 data-pid） */
+    id: string;
+    /** 可选小节标题，如「一、现病史」 */
+    title?: string;
+    /** 段落正文，支持 {路径} 变量引用 */
+    text: string;
+    /** 是否允许标注，默认 true */
+    markable?: boolean;
+}
+/** 数据表格：异常值可标色 */
+export interface TableBlock {
+    kind: 'table';
+    id: string;
+    title?: string;
+    headers: string[];
+    rows: {
+        cells: {
+            value: string;
+            status?: 'normal' | 'warning' | 'danger';
+        }[];
+    }[];
+    /** 是否允许标注，默认 true */
+    markable?: boolean;
+}
+/** 信息卡：键值对摘要（原型「患者信息卡」的通用化） */
+export interface InfoCardBlock {
+    kind: 'infoCard';
+    id: string;
+    title: string;
+    /** 顶部风险/状态徽标 */
+    badge?: {
+        text: string;
+        level: 'high' | 'medium' | 'low';
+    };
+    items: {
+        label: string;
+        value: string;
+    }[];
+    /** 是否允许标注，默认 true */
+    markable?: boolean;
+}
+/** 时间线：按时间/关系排列的条目（原型「家族病史」的通用化） */
+export interface TimelineBlock {
+    kind: 'timeline';
+    id: string;
+    title?: string;
+    items: {
+        label: string;
+        detail: string;
+        level?: 'high' | 'medium' | 'low';
+    }[];
+    /** 是否允许标注，默认 true */
+    markable?: boolean;
+}
+export type MaterialBlock = RichTextBlock | TableBlock | InfoCardBlock | TimelineBlock;
+/** 一个材料选项卡 */
+export interface MaterialTab {
+    id: string;
+    /** 选项卡标签，如「病历摘要」「检验报告」 */
+    title: string;
+    blocks: MaterialBlock[];
+}
+/** 自由填写字段（freeform 题组内使用） */
+export interface DecisionField {
+    name: string;
+    label: string;
+    type: 'text' | 'textarea' | 'number' | 'select';
+    /** 字段用途说明，指导学员填写并供评估参考 */
+    purpose: string;
+    required: boolean;
+    maxLength?: number;
+    /** type='select' 时必填 */
+    options?: string[];
+    placeholder?: string;
+}
+/** 选项（single / multi 题组内使用） */
+export interface DecisionOption {
+    value: string;
+    label: string;
+}
+/**
+ * 决策题组：取代旧的 decisionCard + conclusionFields。
+ * - single：单选（如「初步诊断判断」）
+ * - multi：多选（如「治疗方案优先级」）
+ * - freeform：自由填写若干字段（如「综合健康管理方案」）
+ */
+export interface DecisionGroup {
+    id: string;
+    title: string;
+    kind: 'single' | 'multi' | 'freeform';
+    required?: boolean;
+    /** 额外说明（题型标签「单选 · 必答」由 kind+required 推导，此处仅补充说明） */
+    hint?: string;
+    /** kind='single' | 'multi' 时必填 */
+    options?: DecisionOption[];
+    /** kind='freeform' 时必填 */
+    fields?: DecisionField[];
+}
+export interface ReasonConfig {
+    placeholder?: string;
+    /** 编辑器下方的提示要点 */
+    hints?: string[];
+    /** 是否启用「按类别引用已标注点」工具栏，默认 true */
+    enableMarkerRefs?: boolean;
+}
+export interface DecisionMakingInitData {
+    /** 决策场景说明（顶部展示） */
+    decisionScenario: string;
+    /** 左栏材料，选项卡式展示 */
+    materials: MaterialTab[];
+    /** 标注类别 */
+    markerCategories: MarkerCategory[];
+    /** 决策题组（右栏 Step2） */
+    decisionGroups: DecisionGroup[];
+    /** 理由步骤配置（右栏 Step3） */
+    reasonConfig?: ReasonConfig;
+    /** 前序步骤产物，渲染为左栏「引用」轨 */
+    previousEvidence?: EvidenceSummary[];
+}
+export interface DecisionMakingRuntimeRules {
+    /** 最少标注数，未达不允许提交 */
+    minMarkers?: number;
+    /** 是否必须填写理由 */
+    requireReason?: boolean;
+    /** 理由最小字数（按去空白字符计） */
+    minReasonLength?: number;
+}
+/** 一条标注 */
+export interface DecisionMarker {
+    id: string;
+    /** 所属材料 Tab id */
+    materialId: string;
+    /** 锚定的材料块 id */
+    blockId: string;
+    /** 标注类别 key */
+    categoryKey: string;
+    /** 学员填写的描述 */
+    desc: string;
+}
+export interface DecisionFormState {
+    currentStep: 1 | 2 | 3;
+    /** 左栏当前激活的 Tab id */
+    activeTab: string;
+    /** Step1：标注列表 */
+    markers: DecisionMarker[];
+    /** Step2：题组选择，groupId → 选中的 option value（single 长度恒为 1） */
+    groupSelections: Record<string, string[]>;
+    /** Step2：freeform 题组字段值，groupId → { fieldName: value } */
+    freeformFields: Record<string, Record<string, any>>;
+    /** Step3：理由正文 */
+    reason: string;
+    lastModified: number;
+}

package/dist-types/client/src/plugins/form-filling/DocumentFormLayout.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { FormField, FormTemplateConfig } from '../shared/types';
+import type { FieldValidationState } from './useFormFilling';
+export interface DocumentFormLayoutProps {
+    forms: FormTemplateConfig[];
+    formData: Record<string, any>;
+    validationErrors: Record<string, string>;
+    fieldValidation: Record<string, FieldValidationState>;
+    columns: number;
+    activeFormName: string;
+    onActiveFormChange: (formName: string) => void;
+    onFieldChange: (name: string, value: any) => void;
+    onFieldFocus?: (field: FormField | null) => void;
+    /** 解析 {路径}/[表达式]（用于 title/subtitle/docNo/hint/label） */
+    resolveText: (t?: string) => string;
+}
+/**
+ * 高保真多单证布局：Tab 切单证 + 单证抬头（中英双语 + 编号）+ section 分区 + 可编辑字段网格。
+ * 结构与样式镜像 DocumentReview/DocumentCard，但字段为可编辑控件。
+ */
+declare const DocumentFormLayout: React.FC<DocumentFormLayoutProps>;
+export default DocumentFormLayout;

package/dist-types/client/src/plugins/form-filling/FormAssistPanel.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { FormField } from '../shared/types';
+import type { FieldValidationState } from './useFormFilling';
+export interface FormAssistPanelProps {
+    allFields: FormField[];
+    formData: Record<string, any>;
+    validationErrors: Record<string, string>;
+    fieldValidation: Record<string, FieldValidationState>;
+    /** 真正被实时校验覆盖的字段名（仅这些字段填好才显示"校验通过"绿标） */
+    validatedFieldNames: Set<string>;
+    focusedField: FormField | null;
+    resolveText: (t?: string) => string;
+}
+/**
+ * 右栏 AI 实时辅助面板：
+ *  - 当前字段引导：聚焦字段时展示该字段 hint（静态，非 AI；AI 定时指导走全局浮窗）
+ *  - 实时校验动态：按 通过/错误/警告/提示 实时反馈各已填字段
+ */
+declare const FormAssistPanel: React.FC<FormAssistPanelProps>;
+export default FormAssistPanel;

package/dist-types/client/src/plugins/form-filling/FormFillingPlugin.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PluginProps } from '@shared/types/index.js';
+/**
+ * 表单填写插件（重写版）
+ *
+ * 能力：
+ *  - 一个插件内 Tab 切换填写多张单证（initData.forms[]，兼容旧单 formTemplate）
+ *  - 高保真保单文档布局（中英双语标签 / section 抬头 / 单证编号 / 只读预填）
+ *  - 前端声明式实时校验（跨字段/跨表单一致、条件必填、比较、范围、正则）
+ *  - 定时实时指导（阶段3接入，复用 COACH_AGENT + 全局浮窗）
+ *
+ * 不支持高代码自定义布局（customLayoutCode）与对话式表单（已隐藏）。
+ */
+declare const FormFillingPlugin: React.FC<PluginProps>;
+export default FormFillingPlugin;

package/dist-types/client/src/plugins/form-filling/forms.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 表单填写——多表单归一与聚合工具
+ *
+ * 一个 form-filling 步骤可含多张单证（initData.forms[]），也兼容旧单表单（initData.formTemplate）。
+ * 本模块是"单/多表单"的唯一收口点：渲染、评估、答案键抽取、落地校验都先经 resolveForms() 归一，
+ * 单表单 = 长度 1 的退化，避免散落 if 判断。对齐 strategy-lab 的 resolveNodes、document-review 的 documents[]。
+ *
+ * 字段命名空间约定：同一步骤内所有表单的 field.name 全局唯一（评估/答案键/确定性评分均按 name 扁平索引）。
+ */
+import type { FormTemplateConfig, FormField } from '../shared/types';
+/**
+ * 把 initData 归一为 FormTemplateConfig[]：
+ *  - 有 forms[] → 直接用（过滤 formName 为空的项）
+ *  - 无 forms[] 有 formTemplate → 包成长度 1 的数组，title=formName，
+ *    groups 取 uiConfig.groups，customerData 取 initData.customerData，columns 取 uiConfig.columns
+ *  - 都没有 → 返回空数组
+ */
+export declare function resolveForms(initData: any): FormTemplateConfig[];
+/**
+ * 聚合所有表单的字段为一张扁平表（全局唯一 name 保证无键冲突）。
+ * 检测到重名时保留首个并 console.warn（防御性，正常数据不应发生）。
+ */
+export declare function collectAllFields(forms: FormTemplateConfig[]): FormField[];
+/**
+ * 派生 fieldName → formName 映射，用于把扁平 formData 的每次变更写回对应表单的 filledData。
+ * 重名时首个表单胜出（与 collectAllFields 一致）。
+ */
+export declare function buildFieldFormMap(forms: FormTemplateConfig[]): Record<string, string>;

package/dist-types/client/src/plugins/form-filling/scoring.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 表单填写——确定性兜底评分
+ *
+ * 目的：评估智能体（LLM）对表单的打分天然偏宽松，"乱填 / 空填 / 格式错"也容易拿高分。
+ * 本模块只判机器能 100% 确定的事实（来自 FormField 的 required / validation / min/max / options），
+ * 产出「硬上限 + 强制扣分 + 问题清单」，由评估管线对 LLM 的 totalScore 做最终封顶与扣减，
+ * 并把问题清单注入评估 prompt，让 LLM 的叙述与维度判定与之对齐、避免重复扣分。
+ *
+ * 不做的事（避免误伤）：
+ *  - 不判 businessRules 文字规则（如"与系统留存一致"），那需要案例基准数据，机器没有，留给 LLM。
+ *  - 不判"填的值对不对"（值正确性需案例标准答案），属于后续"注入参考答案"的范畴。
+ */
+import type { FormField, DeclarativeValidationRule } from '../shared/types';
+import type { FieldReference } from '@shared/types/index.js';
+/** 默认阈值（写死，日后如需可配置再外提） */
+export declare const FORM_SCORING_THRESHOLDS: {
+    readonly fillRateGarbage: 0.3;
+    readonly capGarbage: 20;
+    readonly requiredMissingRateForCap: 0.5;
+    readonly capHalfRequiredMissing: 35;
+    readonly formatErrorRateForCap: 0.5;
+    readonly capManyFormatErrors: 40;
+    readonly deductPerRequiredMissing: 8;
+    readonly deductPerFormatError: 12;
+    readonly deductPerRangeViolation: 10;
+    readonly deductPerEnumViolation: 10;
+    readonly deductPerRuleViolation: 10;
+};
+export interface FormDeduction {
+    reason: string;
+    points: number;
+}
+export interface FormDeterministicScore {
+    /** 分数硬上限，100 表示未触发任何封顶 */
+    hardCap: number;
+    /** 逐项强制扣分 */
+    deductions: FormDeduction[];
+    /** 扣分总额 */
+    totalDeduction: number;
+    /** 给评估 prompt / improvements 用的可读问题清单 */
+    findings: string[];
+    /** 整体填充率 0..1 */
+    fillRate: number;
+    /** 未填写的必填项 label 列表 */
+    requiredMissing: string[];
+    /** 是否存在任何客观问题（决定是否介入分数） */
+    hasObjectiveIssues: boolean;
+}
+/** 解析后的逐字段参考值（correctValue 中的 {路径} 已按案例数据展开） */
+export interface ResolvedFieldReference {
+    fieldName: string;
+    label: string;
+    correctValue: string;
+    explanation?: string;
+}
+/**
+ * 把 evaluationRules.fieldReferences 的 correctValue 中的 {路径} 引用按案例/前序表单数据解析为实际值，
+ * 供注入评估 prompt 做"值准确性"逐字段比对。无法解析或无引用的值原样保留（判断式口径）。
+ * @param fields          解析后的表单字段（用于补 label）
+ * @param fieldReferences evaluationRules.fieldReferences
+ * @param caseData        当前案例数据（currentCase）
+ * @param filledData      FormRegistry 已填数据（支持 {表单名.字段} 跨表单引用）
+ */
+export declare function resolveFieldReferences(fields: FormField[], fieldReferences: FieldReference[] | undefined, caseData: any, filledData: Record<string, Record<string, any>>): ResolvedFieldReference[];
+/**
+ * 解析步骤的表单字段：归一为多表单后聚合所有证字段（全局唯一 name），
+ * 每证字段为空或 edit 模式时按 formName 回退 FormRegistry（模板可能在前序步骤定义）。
+ * 单表单 = 长度 1 的退化，行为与旧版一致。
+ */
+export declare function resolveFormFields(step: any): FormField[];
+/** scoreFormDeterministically 的可选项：注入声明式校验规则做确定性兜底（与前端实时校验同源） */
+export interface ScoreOptions {
+    /** runtimeRules.validationRules */
+    rules?: DeclarativeValidationRule[];
+    /** FormRegistry 已填数据（解析 {表单名.字段} 跨表单引用） */
+    filledData?: Record<string, Record<string, any>>;
+    /** 当前案例数据（解析 {案例路径} 引用） */
+    caseData?: any;
+}
+/**
+ * 对表单填写结果做确定性评分。纯函数，无副作用，可单测。
+ * @param fields    解析后的表单字段定义
+ * @param formData  学员提交的字段值（key 为 field.name）
+ * @param options   可选：声明式校验规则（error 级违规并入扣分，与前端实时校验同源）
+ */
+export declare function scoreFormDeterministically(fields: FormField[], formData: Record<string, any>, options?: ScoreOptions): FormDeterministicScore;

package/dist-types/client/src/plugins/form-filling/useFormFilling.d.ts

@@ -0,0 +1,42 @@
+import type { FormField, FormTemplateConfig, FieldValidationLevel } from '../shared/types';
+export interface FieldValidationState {
+    level: FieldValidationLevel;
+    message: string;
+}
+export interface UseFormFillingOptions {
+    onRealtimeData?: (data: any) => void;
+    /** 字段变更通知（插件用于定时实时指导的积压收集） */
+    onFieldChanged?: (field: string, value: any) => void;
+}
+export interface UseFormFillingResult {
+    forms: FormTemplateConfig[];
+    allFields: FormField[];
+    formData: Record<string, any>;
+    /** error 级校验（阻断提交），key=field.name → message */
+    validationErrors: Record<string, string>;
+    /** warning/info 级校验（不阻断），key=field.name */
+    fieldValidation: Record<string, FieldValidationState>;
+    caseData: any;
+    /**
+     * 真正进入实时校验覆盖的字段名集合（有格式校验 / 数值范围 / 被任一声明式规则以其为 field）。
+     * 仅这些字段的"校验通过"才有意义；无规则字段不应冒充"通过"。
+     * required 只是提交门禁、select 选项天然合法，均不计入。
+     */
+    validatedFieldNames: Set<string>;
+    handleFieldChange: (fieldName: string, value: any) => void;
+    /** 提交门禁：必填齐全且无 error 级问题 */
+    checkSubmit: () => {
+        ok: boolean;
+        reason?: string;
+        firstErrorFormName?: string;
+    };
+}
+/**
+ * 表单填写逻辑 Hook（新插件专用，独立于旧 useFormFillingLogic）
+ *
+ * 支持单/多表单（统一经 resolveForms 归一，单表单=长度1退化）。
+ * - 维护一个扁平 formData（field.name 全局唯一），每次变更按 fieldName→formName 写回对应 FormRegistry.filledData[formName]
+ * - 校验分级：error 进 validationErrors（阻断提交 + 就地红字），warning/info 进 fieldValidation（橙/蓝提示）
+ * - 单字段格式/范围来自 FormField + rule-engine；跨字段/跨表单/条件必填来自 runtimeRules.validationRules（与提交端确定性评分共用执行器）
+ */
+export declare function useFormFilling(initData: any, runtimeRules: any, options?: UseFormFillingOptions): UseFormFillingResult;

package/dist-types/client/src/plugins/form-filling/validationRules.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 表单填写——声明式校验规则执行器（纯函数，无副作用，可单测）
+ *
+ * 只补 FormField 自身属性（required/validation/min/max/options）表达不了的校验：
+ * 跨字段/跨表单一致、条件必填、阈值比较、正则、范围。
+ *
+ * 关键约束：**实时校验（前端逐次输入）与提交时确定性评分共用本执行器**，
+ * 规则只有一份（runtimeRules.validationRules），杜绝两套规则漂移。
+ *
+ * 每条规则描述"何时触发一条提示/错误"（firing condition），命中即产生一条 RuleViolation。
+ */
+import type { DeclarativeValidationRule, FieldValidationLevel } from '../shared/types';
+export interface RuleViolation {
+    ruleId: string;
+    field: string;
+    level: FieldValidationLevel;
+    message: string;
+}
+/**
+ * 执行声明式规则，返回所有命中的违规项。
+ * @param rules     runtimeRules.validationRules
+ * @param formData  当前扁平表单数据（key=field.name，多表单聚合后全局唯一）
+ * @param filledData FormRegistry 已填数据（支持 {表单名.字段} 跨表单引用）
+ * @param caseData  当前案例数据（{案例路径} 引用解析；可缺省）
+ */
+export declare function evaluateDeclarativeRules(rules: DeclarativeValidationRule[] | undefined, formData: Record<string, any>, filledData?: Record<string, Record<string, any>>, caseData?: any): RuleViolation[];

package/dist-types/client/src/plugins/shared/DecisionShared.d.ts

@@ -0,0 +1,54 @@
+import React from 'react';
+import type { EvidenceSummary } from '@shared/types/index.js';
+import type { ThemeTokens } from '../shared';
+export declare function alpha(hex: string, a: number): string;
+export declare function buildDecisionTokens(theme?: string | ThemeTokens): {
+    primary: string;
+    primaryLight: string;
+    primaryBorder: string;
+    success: string;
+    successLight: string;
+    successBorder: string;
+    warning: string;
+    warningLight: string;
+    warningBorder: string;
+    danger: string;
+    dangerLight: string;
+    dangerBorder: string;
+    text: string;
+    textMuted: string;
+    textLight: string;
+    border: string;
+    bg: string;
+    white: string;
+    radius: {
+        sm: number;
+        md: number;
+        lg: number;
+    };
+    shadow: {
+        sm: string;
+        md: string;
+    };
+};
+export declare function getLevelColor(level: string, theme?: string | ThemeTokens): string;
+export declare function getLevelStyle(level: string, theme?: string | ThemeTokens): {
+    color: string;
+    bg: string;
+    border: string;
+    ant: string;
+};
+export declare const EvidencePanel: React.FC<{
+    previousEvidence: EvidenceSummary[];
+    title?: string;
+    theme?: string | ThemeTokens;
+}>;
+export declare const ResultPreview: React.FC<{
+    items: Array<{
+        label: string;
+        value: string;
+        color?: string;
+    }>;
+    title?: string;
+    theme?: string | ThemeTokens;
+}>;

package/dist-types/client/src/plugins/shared/FrameworkWidget.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { AnalysisTool } from './analysisTools';
+/**
+ * 分析框架 widget（方案设计报告搭建器）。
+ * 复用 analysisTools 的 dimensions 作命名格子，按 tool.layout 渲染：
+ * quadrant=2×2 象限 | columns=N 列并排 | sections=纵向命名分区（默认）。
+ * 五力/鱼骨 v1 降级 sections。
+ */
+export interface FrameworkWidgetProps {
+    tool: AnalysisTool;
+    /** 各维度当前值，key = dimension.key */
+    values: Record<string, string>;
+    editable?: boolean;
+    onChange?: (key: string, value: string) => void;
+    /** 覆盖默认标题 */
+    title?: string;
+}
+export declare const FrameworkWidget: React.FC<FrameworkWidgetProps>;
+export default FrameworkWidget;

package/dist-types/client/src/plugins/shared/PluginFooter.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { PluginFooterProps } from './types';
+declare const PluginFooter: React.FC<PluginFooterProps>;
+export default PluginFooter;

package/dist-types/client/src/plugins/shared/PluginHeader.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { PluginHeaderProps } from './types';
+declare const PluginHeader: React.FC<PluginHeaderProps>;
+export default PluginHeader;

package/dist-types/client/src/plugins/shared/analysisTools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 内置分析工具注册表
+ */
+export interface AnalysisToolDimension {
+    key: string;
+    label: string;
+    description: string;
+    placeholder: string;
+}
+export interface AnalysisTool {
+    key: string;
+    name: string;
+    category: '战略/商业分析' | '思维方法' | '问题分析' | '营销/销售' | '案例复盘';
+    description: string;
+    dimensions: AnalysisToolDimension[];
+    /**
+     * 框架 widget 渲染布局（方案设计报告搭建器用）。
+     * quadrant=2×2 象限 | columns=N 列并排 | sections=纵向命名分区（默认）。
+     * 五力/鱼骨 v1 降级 sections。省略按 sections 渲染。
+     */
+    layout?: 'quadrant' | 'columns' | 'sections';
+}
+export declare const builtinAnalysisTools: AnalysisTool[];
+/**
+ * 获取可用的分析工具列表
+ * - availableKeys 为空/undefined → 返回全部内置工具
+ * - availableKeys 有值 → 过滤内置工具
+ * - customTools 有值 → 追加到结果末尾
+ */
+export declare function getAvailableTools(availableKeys?: string[], customTools?: AnalysisTool[]): AnalysisTool[];

package/dist-types/client/src/plugins/shared/disturbanceUtils.d.ts

@@ -0,0 +1,5 @@
+import type { CommunicationResistanceConfig } from '@shared/types/index.js';
+export declare function buildDisturbanceBlock(disturbanceEvent?: string): string;
+export declare function buildResistanceBlock(resistance?: CommunicationResistanceConfig): string;
+export declare function buildFadeBlock(resistanceFaded?: boolean): string;
+export declare function buildBranchBlock(branchDirective?: string): string;

package/dist-types/client/src/plugins/shared/index.d.ts

@@ -0,0 +1,5 @@
+export { default as PluginHeader } from './PluginHeader';
+export { default as PluginFooter } from './PluginFooter';
+export { resolveTheme } from './themes';
+export { resolveFieldsByGroups, renderFieldGrid } from './renderFieldGrid';
+export type { BaseUIConfig, UIConfig, DialogueUIConfig, CaseAnalysisUIConfig, ModelUIConfig, FormField, FormLayoutProps, ThemeTokens, FieldGroup, PluginHeaderProps, PluginFooterProps, } from './types';

package/dist-types/client/src/plugins/shared/jsonRepair.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LLM 生成 JSON 的容错修复与提取
+ *
+ * AI 返回的 JSON 偶发格式错误（实际线上案例：字符串值缺少开头引号），
+ * JSON.parse 直接失败会导致运行时降级为展示原始文本。本模块在 parse
+ * 失败后重写文本，修复常见病种：
+ * - 字符串值/键缺少开头或结尾引号、键值对之间缺逗号/冒号
+ * - 字符串内部未转义的双引号、裸换行、非法转义
+ * - 中文全角引号/冒号被用作 JSON 结构符号、零宽字符/全角空格混入
+ * - 单引号字符串、尾逗号、输出截断导致的未闭合括号
+ *
+ * 修复是 best-effort 且偏保守：宁可让产物 parse 失败走降级，也不返回
+ * 语义损坏的数据——extractLLMJson 对修复产物做键健诊与占比护栏，
+ * 修复失败时返回 null，由调用方决定降级方式。
+ *
+ * 已知限制：字符串内容若恰好包含「"}」「",」等 ASCII 引号紧跟 ASCII
+ * 结构符的组合，无法与真实闭引号区分，可能提前闭合（中文语料中极罕见）。
+ */
+/**
+ * 修复 LLM 生成 JSON 的常见格式错误。修复过程抛错时原样返回输入。
+ */
+export declare function repairLLMJson(input: string): string;
+/**
+ * 从 AI 响应文本中提取并解析 JSON 对象/数组。
+ *
+ * 候选分两组：完整组（整体文本、各代码块内容）与片段组（首{到尾}、
+ * 各顶层平衡 {} 组、顶层 [] 组）。解析顺序：完整组原文 parse → 完整组
+ * 修复重 parse → 片段组原文 parse → 片段组修复重 parse。
+ * 修复轮防护：产物键健诊；消费比例过低（只修出开头一小段前缀垃圾，
+ * 如 "[1] 说明文字…"）拒绝；过短片段（纯文本里的 {x:1} 示意）不修复。
+ * 彻底失败返回 null，任何内部异常也归于 null（决不向调用方抛错）。
+ */
+export declare function extractLLMJson(text: string): any | null;
+/**
+ * 判断一段响应文本"看起来是想返回 JSON"——用于解析彻底失败时
+ * 决定降级展示方式（坏 JSON 不该原文展示给学员，纯文本回复则应保留）。
+ * 兜底分支要求引号键模式出现在 { 之后，避免把含引号术语的普通文本误判。
+ */
+export declare function looksLikeJsonResponse(text: string): boolean;

package/dist-types/client/src/plugins/shared/judgement.d.ts

@@ -0,0 +1,46 @@
+import type { EvidenceSummary } from '@shared/types/index.js';
+import type { DecisionMode, JudgementItem, ReferenceDiscrepancy, ScoringConfig } from './types';
+export declare const normalizeDecisionMode: (mode?: string, initData?: any) => DecisionMode;
+export interface StudentMark {
+    fieldName: string;
+    typeId: string;
+}
+export interface DocumentReviewScoreResult {
+    score: number;
+    found: number;
+    missed: number;
+    wrong: number;
+    perAnswer: Array<{
+        fieldName: string;
+        hit: boolean;
+        typeCorrect: boolean;
+    }>;
+    falseMarks: string[];
+}
+/**
+ * 单据审核"找茬式"判分纯函数
+ * - 命中且类型对：该点满分
+ * - 命中但类型错：该点满分 × baseRatio（默认 0.6）
+ * - 遗漏：不得分
+ * - 误标（标了非参考答案的字段）：每个温和扣分（默认单点平均分的一半）
+ * - 总分 clamp 到 [0, 100]
+ */
+export declare function computeDocumentReviewScore(answers: ReferenceDiscrepancy[], marks: StudentMark[], scoring?: ScoringConfig): DocumentReviewScoreResult;
+export declare const buildEvidenceSummary: (params: {
+    sourceStepId: string;
+    sourceStepName?: string;
+    sourceType: string;
+    title: string;
+    summary: string;
+    keyFacts: Array<{
+        label: string;
+        value: string;
+    }>;
+    riskFlags?: string[];
+    conclusion?: string;
+}) => EvidenceSummary;
+/**
+ * 按 sourceType 查找前序证据（通用）
+ */
+export declare const findEvidenceByType: (previousEvidence: EvidenceSummary[] | undefined, sourceType: string) => EvidenceSummary | undefined;
+export declare const buildEvidenceSourceItems: (previousEvidence?: EvidenceSummary[]) => JudgementItem[];

package/dist-types/client/src/plugins/shared/nodeChain.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 推演节点链工具
+ *
+ * 单一数据源：所有「场景配置」只活在 initData.nodes[]。本工具把节点数组归一化（补全 order /
+ * decisionStyle / nodeId 等缺省），运行时一律操作返回的数组——「单场景」就是 nodes.length === 1
+ * 的退化，避免单节点/多节点两套分支。
+ */
+import type { StrategyLabInitData, SimulationNode } from './types';
+/**
+ * 归一化为节点数组：补全 order（缺省按下标）、decisionStyle（缺省 iterate）、nodeId（缺省 node-{i}）。
+ * nodes 为必填字段；若异常缺失/为空，返回一个最小占位单节点以保证运行时不崩。
+ */
+export declare function resolveNodes(initData: StrategyLabInitData): SimulationNode[];
+/** 是否为真正的多节点链（>1 个节点）。 */
+export declare function isMultiNode(initData: StrategyLabInitData): boolean;