@sim-design/training 1.0.0 → 1.1.0

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

@@ -0,0 +1,16 @@
+import type { FormField, FieldGroup } from './types';
+import type { ReactNode } from 'react';
+export interface ResolvedGroup {
+    group: FieldGroup | null;
+    fields: FormField[];
+}
+/**
+ * 按 groups 配置将字段分组，未分组字段兜底放末尾
+ */
+export declare function resolveFieldsByGroups(fields: FormField[], groups: FieldGroup[]): ResolvedGroup[];
+export declare function isLongTextField(field: FormField): boolean;
+export declare function resolveFieldSpan(field: FormField, columns: number): number;
+/**
+ * 渲染字段网格（Row/Col/Form.Item）
+ */
+export declare function renderFieldGrid(fields: FormField[], columns: number, validationErrors: Record<string, string>, renderFormField: (field: FormField) => ReactNode): ReactNode;

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

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { BlockStyle, ReportBlock, ChartInputData } from './types';
+import type { ChartConfig } from '../../components/VisualizationRenderer/types';
+/** 学生录入的图表数据 → ChartRenderer 的 ChartConfig */
+export declare function chartInputToConfig(chartType: 'bar' | 'line' | 'pie' | 'radar', data: ChartInputData): ChartConfig;
+/**
+ * 块排版分两处落地，确保用户值真正"可见即可得"：
+ *  - 外层包裹（applyBlockOuterStyle）：水平对齐 + 上下间距，兜底覆盖图表/分割线等无文本元素的块；
+ *  - 内层文本（applyTextStyle）：fontSize / color / 对齐 直接落到各文本元素，覆盖其 inline 默认值。
+ * 只套外层 div 会被内层元素的 inline 默认值覆盖；且表单控件(input/textarea)不可靠继承父级 textAlign，
+ * 故 fontSize/color/对齐 必须下沉到文本元素本身。
+ */
+export declare function applyBlockOuterStyle(style?: BlockStyle): React.CSSProperties;
+/** 用户 fontSize/color/对齐 覆盖某文本元素的默认值（未设则保留该元素默认）。 */
+export declare function applyTextStyle(style: BlockStyle | undefined, defaultFontSize: number, defaultColor: string): React.CSSProperties;
+export interface ReportBlockViewProps {
+    block: ReportBlock;
+    editable?: boolean;
+    onChange?: (next: ReportBlock) => void;
+}
+/**
+ * 单个报告块的自渲染（discriminated union + switch，对齐 decision-making 的 MaterialsPanel 范式）。
+ * editable=false 时纯展示；editable=true 时文本类块可内联编辑（结构编辑/拖拽在 ReportWorkbench）。
+ * 排版：对齐/间距由外层包裹承载，字号/颜色下沉到各文本元素（applyTextStyle），确保用户值生效。
+ */
+export declare const ReportBlockView: React.FC<ReportBlockViewProps>;
+/** 整份报告（只读/可编辑）的纵向渲染。 */
+export declare const ReportCanvas: React.FC<{
+    blocks: ReportBlock[];
+    editable?: boolean;
+    onChangeBlock?: (id: string, next: ReportBlock) => void;
+}>;
+export default ReportCanvas;

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

@@ -0,0 +1,30 @@
+import type { ReportBlock, RecommendedOutline, EvaluationResult } from './types';
+import type { EvaluationRules } from '@shared/types/index.js';
+/** 报告 blocks 序列化为 Markdown，作为评估智能体的"学生报告"输入 */
+export declare function serializeBlocksToMarkdown(blocks: ReportBlock[]): string;
+export interface CompletenessResult {
+    totalRequired: number;
+    filledRequired: number;
+    wordCount: number;
+    emptyBlocks: number;
+    score: number;
+    issues: string[];
+}
+/**
+ * 确定性完整性兜底（不靠 AI，本地算）：必填章节是否填写、空块、字数。
+ * 对应"排版三层评分"的第①层（完整性/态度分）。
+ */
+export declare function checkCompleteness(blocks: ReportBlock[], outline?: RecommendedOutline, runtimeRules?: {
+    minWordCount?: number;
+    minBlocks?: number;
+}): CompletenessResult;
+/** 合并：AI 内容维度（85%）+ 本地完整性维度（15%），构造最终 EvaluationResult */
+export declare function mergeEvaluation(aiEval: EvaluationResult, completeness: CompletenessResult): EvaluationResult;
+/** 报告级评估 prompt（整篇文档 + 报告级维度，取代旧的逐工具维度 prompt） */
+export declare function buildReportEvaluationPrompt(params: {
+    scenario: string;
+    reportMarkdown: string;
+    referenceAnswer?: string;
+    evaluationRules?: EvaluationRules;
+    completeness: CompletenessResult;
+}): string;

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

@@ -0,0 +1,12 @@
+import type { ReportBlock } from './types';
+/** 报告 blocks → 打印用 HTML（图表降级为数据表，无需 echarts 运行时；套用 block.style） */
+export declare function blocksToHtml(blocks: ReportBlock[]): string;
+/**
+ * 导出报告为 PDF（v1：新窗口写入打印友好 HTML + window.print()，零依赖，用户「打印为 PDF」）。
+ * 图表在打印件中以数据表呈现，避免依赖 echarts 运行时。
+ */
+export declare function exportReportToPDF(blocks: ReportBlock[], reportTitle?: string): void;
+/**
+ * 导出报告为 Word（v1：HTML-as-.doc，输出 application/msword，Word 可直接打开，零依赖；真 docx 留后续）。
+ */
+export declare function exportReportToWord(blocks: ReportBlock[], reportTitle?: string): void;

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ReportBlock } from '../types';
+export interface BlockPropertiesPanelProps {
+    block: ReportBlock | null;
+    onChange: (next: ReportBlock) => void;
+}
+/** 选中块的属性编辑：结构编辑（按 kind）+ 通用排版（写 block.style，不进评分） */
+export declare const BlockPropertiesPanel: React.FC<BlockPropertiesPanelProps>;
+export default BlockPropertiesPanel;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ReportBlockKind } from '../types';
+import type { CreateBlockOpts } from './factory';
+export interface BlockToolboxProps {
+    availableComponents?: ReportBlockKind[];
+    availableFrameworks?: string[];
+    onAdd: (kind: ReportBlockKind, opts?: CreateBlockOpts) => void;
+}
+/** 右栏组件工具箱：手风琴 6 分组 + 2 列卡片网格（受白名单收窄） */
+export declare const BlockToolbox: React.FC<BlockToolboxProps>;
+export default BlockToolbox;

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { ReferenceDoc, ReportBlock, ReportBlockKind } from '../types';
+export interface ReportWorkbenchProps {
+    blocks: ReportBlock[];
+    onChange: (blocks: ReportBlock[]) => void;
+    scenario?: string;
+    background?: string;
+    referenceDocs?: ReferenceDoc[];
+    availableComponents?: ReportBlockKind[];
+    availableFrameworks?: string[];
+    reportTitle?: string;
+    /** 中间顶栏静态标签（报告类型：X） */
+    reportTypeLabel?: string;
+    /** 「推荐示例」=套用推荐大纲骨架；未提供则隐藏该入口 */
+    onApplyRecommended?: () => void;
+    readOnly?: boolean;
+    onAskAI?: (question: string) => void;
+}
+export declare const ReportWorkbench: React.FC<ReportWorkbenchProps>;
+export default ReportWorkbench;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+export interface SortableBlockProps {
+    id: string;
+    selected: boolean;
+    readOnly?: boolean;
+    onSelect: () => void;
+    onDelete: () => void;
+    children: React.ReactNode;
+}
+/**
+ * 画布中的单块：dnd-kit 可排序包裹 + 选中高亮 + 拖拽手柄 + 删除按钮。
+ * 排序/选中/删除都在自管 React 树内（非 react-live），保证焦点稳定。
+ */
+export declare const SortableBlock: React.FC<SortableBlockProps>;
+export default SortableBlock;

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

@@ -0,0 +1,14 @@
+import type { ListVariant, ReportBlock, ReportBlockKind, TableVariant } from '../types';
+/** 运行时块 id（自增 + 时间戳，避免随机以便排查） */
+export declare function newBlockId(): string;
+/** 工具箱卡片可携带的预设（让"折线图""步骤列表""对比表"等变体一键产生） */
+export interface CreateBlockOpts {
+    toolKey?: string;
+    sectionId?: string;
+    hint?: string;
+    chartType?: 'bar' | 'line' | 'pie' | 'radar';
+    listVariant?: ListVariant;
+    tableVariant?: TableVariant;
+}
+/** 按 kind（+ 可选预设）生成带默认值的新块 */
+export declare function createBlock(kind: ReportBlockKind, opts?: CreateBlockOpts): ReportBlock;

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

@@ -0,0 +1,7 @@
+import type { ReportBlock, RecommendedOutline } from '../types';
+/**
+ * 硬骨架预置：把推荐大纲转成一份带「章节标题 + 建议组件空块 + 引导提示」的报告草稿。
+ * 学生进画布即见结构化草稿（治"单薄"的头号杠杆），可继续填充/增删/调整。
+ * 章节引导挂到该章首个建议块（suggestedBlocks[].note 优先，否则用 section.hint）。
+ */
+export declare function buildOutlineDraft(outline: RecommendedOutline | undefined): ReportBlock[];

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

@@ -0,0 +1,112 @@
+import type { DecisionData, SimulationResult, VisualizationData, StrategyEvaluationResult, ReferenceData, SimulationConstraint, StrategyEvaluationDimension, SimulationMode, DecisionField, NodeOutcome } from './types';
+/**
+ * 推演引擎
+ * 负责调用 AI 进行决策推演、可视化生成和评估
+ */
+export declare class SimulationEngine {
+    private botId;
+    private currentUser;
+    private token;
+    constructor(token: string, currentUser?: {
+        userId: string;
+        name: string;
+    });
+    /**
+     * 执行推演
+     */
+    simulate(params: {
+        decision: DecisionData;
+        scenario: string;
+        background: string;
+        mode: SimulationMode;
+        referenceData?: ReferenceData[];
+        constraints?: SimulationConstraint[];
+        dimensions?: Array<{
+            name: string;
+            initialValue?: number;
+            icon?: string;
+            color?: string;
+        }>;
+        previousResult?: SimulationResult;
+        decisionGoal?: string;
+        previousOutcome?: NodeOutcome;
+        conversationId?: string;
+        characterConfig?: any;
+        onStreamUpdate?: (content: string, isComplete: boolean, event: string) => void;
+        onFirstChunk?: () => void;
+    }): Promise<{
+        result: SimulationResult;
+        conversationId: string;
+    }>;
+    /**
+     * 生成可视化数据
+     */
+    generateVisualization(result: SimulationResult): VisualizationData;
+    /**
+     * 执行评估
+     */
+    evaluate(params: {
+        decision: DecisionData;
+        simulationResult: SimulationResult;
+        scenario: string;
+        dimensions: StrategyEvaluationDimension[];
+        conversationId?: string;
+    }): Promise<{
+        result: StrategyEvaluationResult;
+        conversationId: string;
+    }>;
+    /**
+     * 轻量判定：学员本节点拍定的决策是否达成该节点的决策目标。
+     * 复用本节点会话；返回二值 + 理由 + 改进建议。独立于 evaluate()（后者是步骤完成后的正式打分）。
+     */
+    judgeNodeGoal(params: {
+        decisionGoal: string;
+        goalCompletionCriteria?: string;
+        decision: DecisionData;
+        result: SimulationResult;
+        conversationId?: string;
+    }): Promise<{
+        achieved: boolean;
+        reasoning: string[];
+        suggestions?: string[];
+    }>;
+    /**
+     * 构建推演 prompt（首轮）
+     */
+    private buildSimulationPrompt;
+    /**
+     * 构建迭代 prompt（后续轮次）
+     *
+     * 关键：迭代是策略实验室的核心环节，prompt 必须与首轮同样结构化——
+     * 带上约束、推演维度及上一轮的当前值作为基线，并要求按相同 JSON 契约
+     * 返回全部维度的更新值，否则 AI 会回退到与上一轮几乎相同的数字。
+     */
+    private buildIterationPrompt;
+    /**
+     * 构建评估 prompt
+     */
+    private buildEvaluationPrompt;
+    /**
+     * 从 AI 响应文本中提取 JSON 对象。
+     * 直接 parse 失败后会对常见的 LLM JSON 格式错误（缺引号、未转义引号、
+     * 尾逗号、截断等）做容错修复重试，见 jsonRepair.ts。
+     */
+    private tryParseJSON;
+    /**
+     * 解析推演结果
+     */
+    private parseSimulationResult;
+    /**
+     * 解析评估结果
+     */
+    private parseEvaluationResult;
+}
+/**
+ * 将可视化输入的 JSON 数据转换为自然语言描述
+ * 利用 VisualField 配置中的 label 信息，将 key/id 映射为可读文本
+ */
+/**
+ * 把统一决策字段（DecisionField[]）提交值 humanize 为自然语言，供推演/评估提示词消费。
+ * 简单控件直出「标签: 值」，可视化控件按 control 专门格式化；未覆盖的 key 用 JSON 兜底。
+ */
+export declare function formatDecision(data: Record<string, any>, fields: DecisionField[]): string;

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

@@ -0,0 +1,21 @@
+import type { SimulationMode, SimulationModeType } from './types';
+/**
+ * 预定义的模拟模式配置
+ */
+export declare const SIMULATION_MODES: Record<SimulationModeType, SimulationMode>;
+/**
+ * 获取模式配置
+ */
+export declare const getSimulationMode: (type: SimulationModeType) => SimulationMode;
+/**
+ * 获取所有模式列表
+ */
+export declare const getAllSimulationModes: () => SimulationMode[];
+/**
+ * 默认评估维度
+ */
+export declare const DEFAULT_EVALUATION_DIMENSIONS: {
+    dimension: string;
+    weight: number;
+    criteria: string;
+}[];

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

@@ -0,0 +1,5 @@
+import type { ThemeTokens } from './types';
+/**
+ * 解析主题配置：支持预设名称字符串或自定义 ThemeTokens 对象
+ */
+export declare function resolveTheme(theme?: string | ThemeTokens): ThemeTokens;