@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/admin/hooks/useStep5Validation.d.ts

@@ -0,0 +1,16 @@
+import type { CaseSchema, Case } from "@shared/types/index.js";
+import type { TrainingBlueprint, StageContract, StepTaskPackage, CaseVariantPackage, ValidationReport, AssemblyDryRunResult } from "../types/creatorArtifacts";
+interface Params {
+    trainingBlueprint?: TrainingBlueprint;
+    stageContracts?: StageContract[];
+    stepTaskPackages?: StepTaskPackage[];
+    caseSchema?: CaseSchema | null;
+    caseVariantPackages?: CaseVariantPackage[];
+    assemblyDryRunResult?: AssemblyDryRunResult;
+    generatedCases?: Case[];
+}
+export declare function useStep5Validation(params: Params): {
+    validationReport: ValidationReport;
+    releaseDecision: "pass" | "block";
+};
+export {};

package/dist-types/client/src/admin/landingValidation.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 环节二 · 落地产物结构完整性校验（单一数据源）
+ *
+ * 设计目标（P2）：把原先分散在 services.ts 的三处校验逻辑
+ *   ① PLUGIN_REQUIRED_FIELDS 手抄必填清单
+ *   ② dialogue-form 嵌套路径硬编码 if
+ *   ③ document-review 的 evaluationRules 跳过特判
+ * 统一收敛到下面这张声明式规格表 PLUGIN_VALIDATION_SPECS，并由一个通用解释器消费。
+ * 改运行时契约时只需改这一处，规格与「docs/2026年5月17日/运行时配置契约表.md」1:1 对齐。
+ *
+ * 校验能力：
+ *   - required        必填字段（支持 a.b 嵌套路径）
+ *   - conditional     条件必填（当某字段取某值时，另一字段必填）
+ *   - listItems       数组项条件必填（数组内每项按其 kind 校验子字段）
+ *   - referential     引用完整性（A 集合的引用键必须落在 B 集合的标识集内）
+ *   - evaluationRules 评估规则策略 + dimensions 权重和校验
+ *
+ * 注意：本校验只「记录 issues」（passed-with-issues），不强制重试，沿用既有语义。
+ */
+/**
+ * 落地产物是否应产出 evaluationRules 容器。
+ * 单一数据源：读 PLUGIN_VALIDATION_SPECS[pluginType].evaluationRules 策略。
+ * 'none'（如 document-review，插件内规则自带判分）→ 不产，落地前置结构校验不得强求该容器。
+ * 供 services.ts 落地前置校验复用，避免在 services 侧重复硬编码插件名单（违反单一数据源）。
+ */
+export declare const landingProducesEvaluationRules: (pluginType: string) => boolean;
+/**
+ * 环节二 · 结构完整性校验：检查落地产物是否满足插件运行时契约（必填/条件/引用完整性）。
+ */
+export declare const validateLandingCoverage: (pluginType: string, runtimeConfig: {
+    initData: any;
+    runtimeRules: any;
+    evaluationRules?: any;
+    stepBriefing?: any;
+    fieldSuggestions?: any[];
+}) => {
+    passed: boolean;
+    coverageIssues: string[];
+    coverageWarnings: string[];
+};
+/**
+ * 逐案例 × 逐判分步骤校验答案键完整性（四类判分插件）。
+ *
+ * 答案来源 = Case.stepAnswers[stepId].<键>（优先）或 Step 基线：
+ *   - decision-making → Step.evaluationRules.decisionReferences
+ *   - form-filling    → Step.evaluationRules.fieldReferences（按需，可省）
+ *   - case-analysis   → Step.evaluationRules.referenceAnswer（按需，可省）
+ *   - document-review → Step.runtimeRules.referenceAnswers（自带判分，必需）
+ * 强制项（decision/document）缺来源报缺；按需项（form/case-analysis）仅在存在时做结构校验。
+ *
+ * 沿用 validateLandingCoverage 的「passed-with-issues」语义：只记录 issues，不强制阻断。
+ */
+/**
+ * 「被消费字段非空」校验：各步 stepBriefing.caseFacts 引用的案例字段，在每个案例数据里必须有非空值。
+ *
+ * 背景：案例实例由 AI 生成，array/列表类字段在缺素材、缺约束时极易产出空数组 []（形式合法但无内容）。
+ * 而 caseFacts 引用的字段会在运行时实训资料区按 path 取值展示给学员，取到空就是空白面板。
+ * 此处把「消费侧引用了、供给侧却为空」这一确定有害的情况收口为非阻断告警（与 validateCaseAnswerKeys 同语义）。
+ *
+ * 注意：只遍历结构化的 caseFacts[].path（含顶层单段路径，如 "历史记录"）。
+ * 不复用 services.ts 的 extractFieldReferences——它用 includes('.') 过滤掉单段路径、且反向 import 会致循环依赖。
+ */
+export declare const validateCaseFieldCoverage: (model: {
+    stages?: any[];
+} | null | undefined, cases: any[] | null | undefined) => {
+    passed: boolean;
+    coverageIssues: string[];
+};
+export declare const validateCaseAnswerKeys: (model: {
+    stages?: any[];
+} | null | undefined, cases: any[] | null | undefined) => {
+    passed: boolean;
+    coverageIssues: string[];
+};

package/dist-types/client/src/admin/schemaFieldUtils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CaseSchema 字段树展开工具（单一数据源）
+ *
+ * 背景：CaseSchema 字段在嵌套形态下，每个 field.path 只存「相对父级的一段」，
+ * 完整路径需递归 children 拼接。此前「遍历字段树」散落多处各写一份，口径不一：
+ *  - 生成端喂落地/详情智能体的字段清单（services.ts）只 map 顶层、不展开 children
+ *    → bot 看不到深层叶子路径，只能脑补 → caseFacts/scenario 引用漂移、落地校验失败重试；
+ *  - 校验端（landingValidation.ts）却用「完整叶子路径」比对 → 生成端看到的 ≠ 校验端要求的。
+ * 本模块把「遍历 CaseSchema 树」收敛为单一核心，供生成端渲染、校验端展平共用，口径根上一致。
+ *
+ * 放在中立模块：landingValidation.ts 不能 import services.ts（services 依赖它，会形成循环），
+ * 故二者共用的展开逻辑下沉到此，两边都可安全 import。
+ */
+/** 可展开字段（CaseSchemaField 的结构子集；用宽松类型以兼容校验端传入的精简对象） */
+export interface SchemaFieldLike {
+    path?: string;
+    type?: string;
+    label?: string;
+    maxLength?: number;
+    children?: SchemaFieldLike[];
+}
+/**
+ * 展平为完整路径字符串集合（含容器与叶子，去重）。
+ * 校验端的「可引用集」、生成端的覆盖判断共用此口径。
+ */
+export declare const flattenSchemaFieldPaths: (fields: SchemaFieldLike[] | undefined, parentPath?: string) => string[];
+/** UI 下拉候选项：完整路径 + label + type。供编辑器字段路径选择器复用（单一数据源，免 UI 重写递归）。 */
+export interface SchemaFieldOption {
+    path: string;
+    label: string;
+    type?: string;
+}
+/**
+ * 展平为「可在 caseFacts/scenario 中按 path 精确取值」的候选字段项（含容器与叶子，去重）。
+ * - 复用 walk：完整路径、label、type 一次到位；
+ * - 过滤含 [] 的数组元素路径：运行时 getValueByPath / {} 引用都不认 []，选了必取空
+ *   （与 renderFieldsAsFullPaths 同口径；校验端 flatten 保留 [] 认下标，两端有意不同）；
+ * - 保留 object/array 容器路径：caseFacts 可整体引用容器，前端 FactNode 递归渲染；
+ * - label 缺省回退为 path，保证下拉项始终有可读主体。
+ */
+export declare const flattenSchemaFieldOptions: (fields: SchemaFieldLike[] | undefined) => SchemaFieldOption[];
+/**
+ * 渲染为「完整路径平铺清单」，供喂给生成/落地智能体。
+ * 每行：`- 完整路径 (type[, maxLength:N]) — label`。
+ * 关键：展开到完整叶子路径，bot 直接复制即可，不必从缩进/相对段自行拼接（拼接易漏中间层）。
+ */
+export declare const renderFieldsAsFullPaths: (fields: SchemaFieldLike[] | undefined) => string;
+/**
+ * CaseSchema 保留字（信封键）：落地智能体输出 JSON 的顶层键，绝非案例字段路径前缀。
+ * 任何 path 以这些词作为「第一段」的字段，都是落地 bot 把信封键误当字段前缀产出的污染，
+ * 不得进入最终 CaseSchema。业务字段第一段为中文领域键（客户信息/业务数据/角色池…），不冲突。
+ */
+export declare const RESERVED_SCHEMA_ROOT_KEYS: readonly ["fieldSuggestions", "initData", "runtimeRules", "evaluationRules", "stepBriefing"];
+/** 该 path 是否以保留字（信封键）为第一段——应被兜底剔除的污染路径。 */
+export declare const isReservedRootPath: (path: string | undefined | null) => boolean;

package/dist-types/client/src/admin/services.d.ts

@@ -0,0 +1,461 @@
+/**
+ * 管理后台服务层
+ * AI 模型生成相关服务 - 简化版（AI 自动判断是否追问）
+ * 以及分步创建器所需的选项生成服务
+ */
+import type { TrainingModel, CaseSchema, CaseSchemaField, CaseSchemaConstraint, Stage, EvaluationRules, AbilityMap, FieldUsage } from "@shared/types/index.js";
+import type { CreatorContext } from "../lib/types";
+export type { CreatorContext } from "../lib/types";
+import type { StepTaskPackage, StageContract } from './types/creatorArtifacts';
+/**
+ * 选项类型（不包含 caseScenario，案例场景使用独立的 generateCaseVariantPackages 函数）
+ */
+export type OptionType = "businessType" | "targetPosition" | "learningObjectives" | "trainingType" | "ideologicalElements";
+/**
+ * 选项生成上下文（用于基础信息推荐）
+ */
+export interface OptionContext {
+    domain?: string;
+    businessType?: string;
+    targetPosition?: string;
+    trainingType?: string;
+}
+/**
+ * AI 推荐选项
+ */
+export interface AIOption {
+    value: string;
+    label: string;
+    description?: string;
+    difficulty?: "easy" | "medium" | "hard";
+}
+/**
+ * 场景维度
+ */
+export interface ScenarioDimension {
+    key: string;
+    dimensionLabel: string;
+    value: string;
+    fieldHint?: string;
+}
+/**
+ * 带维度的场景选项（旧格式兼容）
+ */
+export interface AIScenarioOption extends AIOption {
+    dimensions?: ScenarioDimension[];
+}
+export interface CaseVariantPackageOption {
+    variantId: string;
+    label: string;
+    difficulty: "easy" | "medium" | "hard";
+    objectProfile: Record<string, any>;
+    keyFacts: string[];
+    constraints: string[];
+    hiddenRisks: string[];
+    disturbanceEvents: string[];
+    communicationResistance: string[];
+    standardPath: string[];
+    commonErrors: string[];
+}
+/**
+ * 生成选项结果（基础信息推荐）
+ */
+export interface GenerateOptionsResult {
+    options: AIOption[];
+}
+/**
+ * 用户需求（用户实际填写的内容）
+ */
+export interface UserRequirements {
+    domain: string;
+    businessType: string;
+    targetPosition: string;
+    learningObjectives?: string;
+    trainingLevel?: 'undergraduate' | 'vocational' | 'technical';
+    trainingType?: string;
+    ideologicalElements?: string;
+    ideologicalRatio?: number;
+    cases?: string;
+    description?: string;
+}
+/**
+ * 模板定义
+ */
+export interface ModelTemplate {
+    id: string;
+    name: string;
+    description: string;
+    domain: string;
+    businessType: string;
+    targetPosition: string;
+    difficulty: "easy" | "medium" | "hard";
+    stageCount: number;
+    caseCount: number;
+}
+export declare const modelTemplates: ModelTemplate[];
+/** 流程大纲 - 步骤骨架 */
+export interface OutlineStep {
+    stepId: string;
+    stepName: string;
+    purpose: string;
+    pluginType?: string;
+}
+/** 流程大纲 - 阶段骨架 */
+export interface OutlineStage {
+    stageId: string;
+    stageName: string;
+    stageGoal: string;
+    entryCriteria: string[];
+    deliverables: string[];
+    keyDecisions: string[];
+    completionCriteria: string[];
+    commonMistakes: string[];
+    steps: OutlineStep[];
+}
+/** 流程大纲 */
+export interface ProcessOutline {
+    summary: string;
+    stages: OutlineStage[];
+}
+/**
+ * 从 AI 响应中提取并解析 JSON（多重容错）
+ */
+export declare const parseAIResponse: (response: string) => any;
+export declare const getDefaultEvaluationRules: () => EvaluationRules;
+export declare const normalizeEvaluationRules: (input: any, fallback?: EvaluationRules) => EvaluationRules;
+export declare const resolveStepEvaluationRules: (stepRules: any, stageRules: any) => EvaluationRules;
+/**
+ * 从模板转换为需求
+ */
+export declare const templateToRequirements: (template: ModelTemplate) => UserRequirements;
+export declare const saveCreatorContext: (context: CreatorContext) => void;
+export declare const loadCreatorContext: () => CreatorContext | null;
+export declare const clearCreatorContext: () => void;
+/**
+ * 生成流程大纲（Stage 2 → 3）
+ * 基于 basicInfo + caseScenario 调用 AI 生成流程大纲
+ */
+export declare const generateProcessOutline: (context: {
+    domain: string;
+    businessType: string;
+    targetPosition: string;
+    trainingGoal?: string;
+    jobTasks?: string[];
+    competencyGoals?: string[];
+    objectTypes?: string[];
+    riskScenarios?: string[];
+    acceptanceCriteria?: string[];
+    trainingLevel?: "undergraduate" | "vocational" | "technical";
+    cases?: string;
+    scenarioSeeds?: AIScenarioOption[];
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    outline: ProcessOutline;
+    message?: string;
+    conversationId?: string;
+    abilityMap?: AbilityMap;
+}>;
+/**
+ * 修改流程大纲（Stage 3 内对话式修改）
+ * 复用 Stage 3 的会话
+ */
+export declare const refineProcessOutline: (userMessage: string, cozeToken: string, conversationId: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    outline: ProcessOutline;
+    message?: string;
+    conversationId?: string;
+    abilityMap?: AbilityMap;
+}>;
+/**
+ * 基于确认的大纲生成完整模型 JSON（Stage 4b） */
+export declare const generateStepDetails: (context: {
+    conversationId?: string;
+    outline: ProcessOutline;
+    outlineText?: string;
+    abilityMapText?: string;
+    retryFeedback?: string;
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    model: TrainingModel;
+    declaredFields: CaseSchemaField[];
+    declaredConstraints: CaseSchemaConstraint[];
+    conversationId: string;
+}>;
+/**
+ * 按阶段生成步骤细节（当 totalSteps >= 6 时使用）
+ * 复用共享会话，逐阶段调用 AI 生成
+ */
+export declare const generateStageDetails: (context: {
+    conversationId?: string;
+    stageIndex: number;
+    totalStages: number;
+    stageName: string;
+    stageGoal: string;
+    steps: Array<{
+        stepId: string;
+        stepName: string;
+        purpose: string;
+        pluginType?: string;
+    }>;
+    trainingBlueprint?: Record<string, any>;
+    accumulatedFields: CaseSchemaField[];
+    abilityMapText?: string;
+    retryFeedback?: string;
+    outlineText?: string;
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    stageContract: any;
+    stepTaskPackages: any[];
+    stageAssessment: any;
+    declaredFields: CaseSchemaField[];
+    declaredConstraints: CaseSchemaConstraint[];
+    conversationId: string;
+}>;
+/**
+ * 步骤级 revision service
+ */
+export declare const reviseStepDetailsByPrompt: (context: {
+    conversationId?: string;
+    outline: any;
+    model: TrainingModel;
+    declaredFields: CaseSchemaField[];
+    declaredConstraints?: CaseSchemaConstraint[];
+    stageIndex: number;
+    stepIndex: number;
+    step: Stage["steps"][number];
+    userInstruction: string;
+    abilityMapText?: string;
+    retryFeedback?: string;
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    step: Stage["steps"][number];
+    declaredFields: CaseSchemaField[];
+    declaredConstraints: CaseSchemaConstraint[];
+    conversationId?: string;
+}>;
+/**
+ * 阶段级 revision service
+ */
+export declare const reviseStageDetailsByPrompt: (context: {
+    conversationId?: string;
+    outline: any;
+    model: TrainingModel;
+    declaredFields: CaseSchemaField[];
+    declaredConstraints?: CaseSchemaConstraint[];
+    stageIndex: number;
+    stage: Stage;
+    userInstruction: string;
+    abilityMapText?: string;
+    retryFeedback?: string;
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    stage: Stage;
+    declaredFields: CaseSchemaField[];
+    declaredConstraints: CaseSchemaConstraint[];
+    conversationId?: string;
+}>;
+export declare const landStepRuntimeConfig: (context: {
+    stepId: string;
+    stepName: string;
+    pluginType: string;
+    pluginConfigDraft: any;
+    common: any;
+    declaredFields: CaseSchemaField[];
+    stageContract: any;
+    /** 上次落地校验未通过的问题（结构缺失/非法表达式），重试时回传给智能体定向修正 */
+    retryFeedback?: string;
+}, cozeToken: string) => Promise<{
+    initData: Record<string, any>;
+    runtimeRules: Record<string, any>;
+    evaluationRules: {
+        dimensions: any[];
+        businessRules: string[];
+        fieldReferences?: any[];
+    };
+    stepBriefing?: any;
+    fieldSuggestions: CaseSchemaField[];
+}>;
+/**
+ * 环节二 · 结构完整性校验
+ * 校验规格（单一数据源）与实现已迁出至 ./landingValidation，
+ * 此处再导出以保持既有引用路径（useStep3Details 等从 "../services" 引入）。
+ */
+export { validateLandingCoverage, validateCaseAnswerKeys, validateCaseFieldCoverage } from './landingValidation';
+/**
+ * 独立生成案例数据（Case[]）
+ * @deprecated Step4 已拆分，逐案例改用 generateCaseInstance（独立会话 + 产答案键）。保留以兼容旧合约测试。
+ */
+export declare const generateCases: (context: {
+    conversationId?: string;
+    caseVariantPackages?: CaseVariantPackageOption[];
+    caseSchema?: CaseSchema;
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    cases: any[];
+    conversationId: string;
+}>;
+/**
+ * 判分步骤题面（供 4b 按本案例数据产出答案键）。覆盖四类判分插件，按 pluginType 取对应字段：
+ *  - decision-making → groups（题组/选项），答案键 = decisionReferences
+ *  - form-filling    → formFields（表单字段），答案键 = fieldReferences
+ *  - case-analysis   → scenario + requiredPointsHint，答案键 = referenceAnswer + requiredPoints
+ *  - document-review → documentFields + errorTypes，答案键 = documentReferenceAnswers
+ */
+export interface AnswerKeyStepQuestion {
+    stepId: string;
+    stepName: string;
+    pluginType: 'decision-making' | 'form-filling' | 'case-analysis' | 'document-review';
+    decisionScenario?: string;
+    groups?: Array<{
+        id: string;
+        title: string;
+        kind: 'single' | 'multi' | 'freeform';
+        options?: {
+            value: string;
+            label: string;
+        }[];
+        fields?: {
+            name: string;
+            label: string;
+        }[];
+    }>;
+    formFields?: Array<{
+        name: string;
+        label: string;
+        required?: boolean;
+        type?: string;
+        formName?: string;
+        formTitle?: string;
+    }>;
+    scenario?: string;
+    requiredPointsHint?: string[];
+    documentFields?: Array<{
+        name: string;
+        label?: string;
+        docName?: string;
+    }>;
+    errorTypes?: Array<{
+        id: string;
+        label?: string;
+    }>;
+}
+/**
+ * 从已生成模型中抽取各判分步骤的题面（案例无关的"考卷"），供 step4b 逐案例产出答案键。
+ * 答案键由 4b 按各案例数据填（评估专用、学员不可见）。
+ */
+export declare const buildAnswerKeyQuestions: (model: {
+    stages?: any[];
+} | null | undefined) => AnswerKeyStepQuestion[];
+/**
+ * 生成单个案例实例 + 答案键（Step 4b）。
+ * 每次调用都新建会话（不传 conversationId），逐案例隔离、互不串味。
+ * answerKeySteps 提供各判分步骤题面（decision/form/case-analysis/document-review），
+ * 4b 据此为"本案例"产出 stepAnswers（评估专用、学员不可见）。
+ */
+export declare const generateCaseInstance: (context: {
+    caseVariantPackage: CaseVariantPackageOption;
+    caseSchema: CaseSchema;
+    answerKeySteps?: AnswerKeyStepQuestion[];
+    domainContext?: {
+        domain?: string;
+        businessType?: string;
+        targetPosition?: string;
+        trainingGoal?: string;
+        trainingLevel?: string;
+    };
+}, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void) => Promise<{
+    case: any;
+    conversationId: string;
+}>;
+/**
+ * 生成自定义布局代码（调用 Coze 智能体）
+ *
+ * @param fields 字段列表（文本描述，供 AI 参考）
+ * @param layoutDescription 管理员对布局的自然语言描述
+ * @param cozeToken Coze API Token
+ * @param botId Bot ID
+ * @param onStreamUpdate 流式更新回调
+ */
+export declare const generateCustomLayoutCode: (fields: Array<{
+    name: string;
+    label: string;
+    type: string;
+    required?: boolean;
+    validation?: string;
+    options?: string[];
+}>, layoutDescription: string, cozeToken: string, onStreamUpdate?: (content: string, isComplete: boolean) => void, conversationId?: string) => Promise<{
+    code: string;
+    conversationId: string;
+}>;
+/**
+ * 验证模型 JSON 是否有效
+ */
+export declare const validateTrainingModel: (data: any) => {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 保存模型到 localStorage
+ */
+export declare const saveModelToStorage: (model: TrainingModel) => void;
+/**
+ * 从 localStorage 加载模型列表
+ */
+export declare const loadModelsFromStorage: () => TrainingModel[];
+/**
+ * 从 localStorage 删除模型
+ */
+export declare const deleteModelFromStorage: (modelId: string) => void;
+/**
+ * 导出模型为 JSON 文件
+ */
+export declare const exportModelToJson: (model: TrainingModel) => void;
+/**
+ * 从 JSON 文件导入模型
+ */
+export declare const importModelFromJson: (file: File) => Promise<TrainingModel>;
+export declare function inferFieldUsages(stepTaskPackages: StepTaskPackage[], stageContracts?: StageContract[]): Map<string, FieldUsage[]>;
+export declare function flattenDeclaredFieldPaths(fields: CaseSchemaField[], parentPath?: string): string[];
+/**
+ * CaseSchema 字段归一化（落地前规范化 + 去重）。
+ *
+ * 生成端会从三处写入 declaredFields（环节一/三的 AI、环节二 fieldSuggestions、autoRepair 回填），
+ * 且提示词历史上允许「平铺叶子」与「object+children」两种等价写法、数组又被拍成 .0./.1. 下标，
+ * 导致存储态自相矛盾（同路径重复声明、混用约定）。本函数把所有形态统一规整为唯一的「嵌套树」：
+ *  - object 用 children，子字段 path 只写叶子段；
+ *  - array 用 children 描述「元素结构」（不枚举下标，元素边界 [] 由完整路径表达）；
+ *  - 同一逻辑路径只保留一条，元数据（label/purpose/maxLength/enumValues/usage/rule）合并。
+ */
+export declare function canonicalizeSchemaFields(fields: CaseSchemaField[]): CaseSchemaField[];
+export declare function formatMissingFieldReferencesMessage(missingRefs: string[]): string;
+export declare function formatUnsupportedTemplateExpressionsMessage(expressions: string[]): string;
+export declare function validateFieldReferencesAgainstSchema(stages: Stage[], declaredFields: CaseSchemaField[]): {
+    missingRefs: string[];
+    unsupportedExpressions: string[];
+};
+/**
+ * 自动修复缺失的字段声明：扫描 initData 中的 {字段路径} 引用，
+ * 将未在 declaredFields 中声明的叶子路径自动补齐为扁平条目。
+ * 避免因 AI 遗漏声明或 children 路径格式错误而触发不必要的重试。
+ */
+export declare function autoRepairMissingFieldDeclarations(stages: Stage[], declaredFields: CaseSchemaField[]): {
+    repairedFields: CaseSchemaField[];
+    autoAdded: string[];
+};
+export interface GenerateCaseVariantPackagesParams {
+    domain: string;
+    businessType: string;
+    targetPosition: string;
+    stages: Stage[];
+    caseSchema: CaseSchema;
+    learningObjectives?: string;
+    trainingLevel?: string;
+    conversationId?: string;
+    cozeToken: string;
+}
+export declare const generateCaseVariantPackages: (params: GenerateCaseVariantPackagesParams) => Promise<{
+    caseVariantPackages: CaseVariantPackageOption[];
+    conversationId?: string;
+}>;
+/**
+ * 生成 AI 推荐选项
+ * 用于分步创建器的基础信息推荐（业务类型/目标岗位/学习目标/实训类型/思政元素）
+ *
+ * @param type - 选项类型
+ * @param context - 上下文数据
+ * @param cozeToken - Coze API Token
+ * @param onStreamUpdate - 流式更新回调
+ */

package/dist-types/client/src/admin/shared-editors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 共享子组件：StringListEditor、KeyValueEditor
+ * 从 InitDataEditors.tsx 提取，供多个编辑器复用
+ */
+import React from "react";
+import type { CaseSchema } from "@shared/types/index.js";
+/**
+ * 字符串列表编辑器（Select mode="tags"）
+ */
+export declare const StringListEditor: React.FC<{
+    value: string[];
+    onChange: (val: string[]) => void;
+    placeholder?: string;
+}>;
+/**
+ * 键值对编辑器
+ */
+export declare const KeyValueEditor: React.FC<{
+    value: Record<string, any>;
+    onChange: (val: Record<string, any>) => void;
+}>;
+/**
+ * 案例字段结构编辑器
+ */
+interface CaseSchemaEditorProps {
+    value: CaseSchema;
+    onChange: (value: CaseSchema) => void;
+    showConstraints?: boolean;
+}
+export declare const CaseSchemaEditor: React.FC<CaseSchemaEditorProps>;
+export {};