worsoft-frontend-codegen-local-mcp 0.1.9 → 0.1.11

package/mcp_server.js

@@ -1,1818 +1,1816 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
 const SERVER_NAME = 'worsoft-codegen-local';
-const SERVER_VERSION = '0.1.9';
-const PROTOCOL_VERSION = '2024-11-05';
-const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
-const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
-const STYLE_CATALOG_PATH = path.join(__dirname, 'assets', 'style-catalog.json');
-const DEFAULT_DESIGN_FILE = path.resolve(__dirname, '..', 'sql', 'SQL 璁捐璇存槑.md');
-const STYLE_CATALOG = loadStyleCatalog();
-const DEFAULT_DICT_REGISTRY_KEYS = {
-  add_start_stop: 'COMMON_STATUS',
-  trade_standard_type: 'TRADE_STANDARD_TYPE',
-  trade_score_standard: 'TRADE_SCORE_STANDARD',
-};
-const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
-  show: boolean;
-  alwaysHide: boolean;
-  smart: boolean;
-  labelKey: string;
-  label?: string;
-  width: string;
-  dictType?: string;
-}
-
-export interface FieldConfig {
-  key: string;
-  labelKey?: string;
-  label?: string;
-  width?: string;
-  show?: boolean;
-  alwaysHide?: boolean;
-  smart?: boolean;
-  dictType?: string;
-}
-
-export interface CrudSchemaDefinition {
-  master: FieldConfig[];
-  children?: Record<string, FieldConfig[]>;
-}
-
-export interface CrudSchema {
-  master: Record<string, FieldMeta>;
-  children: Record<string, Record<string, FieldMeta>>;
-  filterTypes: Record<string, number>;
-  childFilterTypes: Record<string, Record<string, number>>;
-  allDictTypes: string[];
-}
-
-const DEFAULT_WIDTH = '120';
-
-export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
-  show: true,
-  alwaysHide: false,
-  smart: false,
-  labelKey,
-  width,
-});
-
-export const dictField = (labelKey: string, dictType: string, width = DEFAULT_WIDTH): FieldMeta => ({
-  ...field(labelKey, width),
-  dictType,
-});
-
-export const buildFilterTypes = (fields: Record<string, FieldMeta>) =>
-  Object.fromEntries(Object.entries(fields).filter(([, item]) => item.dictType).map(([key]) => [key, 30]));
-
-export const collectDictTypes = (...groups: Array<Record<string, FieldMeta>>) =>
-  Array.from(
-    new Set(
-      groups.flatMap((group) =>
-        Object.values(group)
-          .map((item) => item.dictType)
-          .filter(Boolean) as string[]
-      )
-    )
-  );
-
-const normalizeField = (item: FieldConfig): FieldMeta => ({
-  show: item.show ?? true,
-  alwaysHide: item.alwaysHide ?? false,
-  smart: item.smart ?? false,
-  labelKey: item.labelKey ?? item.label ?? item.key,
-  ...(item.label ? { label: item.label } : {}),
-  width: item.width ?? DEFAULT_WIDTH,
-  ...(item.dictType ? { dictType: item.dictType } : {}),
-});
-
-const toFieldMap = (fields: FieldConfig[]) =>
-  Object.fromEntries(fields.map((item) => [item.key, normalizeField(item)])) as Record<string, FieldMeta>;
-
-const buildSchema = (
-  master: Record<string, FieldMeta>,
-  children: Record<string, Record<string, FieldMeta>> = {}
-): CrudSchema => ({
-  master,
-  children,
-  filterTypes: buildFilterTypes(master),
-  childFilterTypes: Object.fromEntries(
-    Object.entries(children).map(([key, fields]) => [key, buildFilterTypes(fields)])
-  ),
-  allDictTypes: collectDictTypes(master, ...Object.values(children)),
-});
-
-export function createCrudSchema(master: Record<string, FieldMeta>, children?: Record<string, Record<string, FieldMeta>>): CrudSchema;
-export function createCrudSchema(definition: CrudSchemaDefinition): CrudSchema;
-export function createCrudSchema(
-  masterOrDefinition: Record<string, FieldMeta> | CrudSchemaDefinition,
-  children: Record<string, Record<string, FieldMeta>> = {}
-): CrudSchema {
-  if ('master' in masterOrDefinition && Array.isArray(masterOrDefinition.master)) {
-    const master = toFieldMap(masterOrDefinition.master);
-    const childGroups = Object.fromEntries(
-      Object.entries(masterOrDefinition.children ?? {}).map(([key, fields]) => [key, toFieldMap(fields)])
-    ) as Record<string, Record<string, FieldMeta>>;
-    return buildSchema(master, childGroups);
-  }
-
-  return buildSchema(masterOrDefinition as Record<string, FieldMeta>, children);
-}
-`;
-
-const TOOL_SCHEMA = {
-  type: 'object',
-  properties: {
-    designFile: { type: 'string', description: 'Absolute or relative Markdown design file path. Defaults to ../sql/SQL 璁捐璇存槑.md when omitted.' },
-    tableName: { type: 'string', description: 'Target main table name from the design file.' },
-    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Style id from assets/style-catalog.json.' },
-    children: {
-      type: 'array',
-      description: 'Optional direct child-table relations for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form.',
-      items: {
-        type: 'object',
-        properties: {
-          childTableName: { type: 'string', description: 'Child table name.' },
-          mainField: { type: 'string', description: 'Main table relation field.' },
-          childField: { type: 'string', description: 'Child table relation field.' },
-          relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
-        },
-        required: ['childTableName', 'mainField', 'childField'],
-        additionalProperties: false,
-      },
-    },
-    childTableName: { type: 'string', description: 'Child table name. Required when style=master_child_jump.' },
-    mainField: { type: 'string', description: 'Main table relation field. Required when style=master_child_jump.' },
-    childField: { type: 'string', description: 'Child table relation field. Required when style=master_child_jump.' },
-    relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
-    frontendPath: { type: 'string', description: 'Absolute frontend output root path.' },
-    moduleName: { type: 'string', description: 'Relative frontend module path, for example admin/test.' },
-    writeToDisk: { type: 'boolean', default: true, description: 'Whether to write generated files.' },
-    overwrite: { type: 'boolean', default: true, description: 'Whether to overwrite existing files. If false, existing files are skipped.' },
-  },
-  required: ['tableName', 'style', 'frontendPath'],
-  additionalProperties: false,
-};
-
-function loadStyleCatalog() {
-  return JSON.parse(fs.readFileSync(STYLE_CATALOG_PATH, 'utf8'));
-}
-
-function writeMessage(payload) {
-  process.stdout.write(JSON.stringify(payload) + '\n');
-}
-
-function successResponse(id, result) {
-  return { jsonrpc: '2.0', id, result };
-}
-
-function errorResponse(id, code, message) {
-  return { jsonrpc: '2.0', id, error: { code, message } };
-}
-
-function toolTextResult(text) {
-  return { content: [{ type: 'text', text }], isError: false };
-}
-
-function toCamelCase(value) {
-  return value.replace(/_([a-zA-Z0-9])/g, (_, letter) => letter.toUpperCase());
-}
-
-function toPascalCase(value) {
-  const camel = toCamelCase(value);
-  return camel.charAt(0).toUpperCase() + camel.slice(1);
-}
-
-function normalizeModuleName(moduleName) {
-  if (!moduleName) {
-    return 'admin/test';
-  }
-  return moduleName.replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
-}
-
-function toConstantCase(value) {
-  return String(value || '')
-    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-    .replace(/[^a-zA-Z0-9]+/g, '_')
-    .replace(/^_+|_+$/g, '')
-    .toUpperCase();
-}
-
-function parseDictRegistryEntries(fileContent) {
-  const blockMatch = String(fileContent || '').match(/export const DictRegistry\s*=\s*{([\s\S]*?)}\s*as const;/);
-  if (!blockMatch) return [];
-
-  const entries = [];
-  const entryRegex = /^\s*([A-Z0-9_]+)\s*:\s*['"]([^'"]+)['"]\s*,?\s*$/gm;
-  let match = entryRegex.exec(blockMatch[1]);
-  while (match) {
-    entries.push({ key: match[1], value: match[2] });
-    match = entryRegex.exec(blockMatch[1]);
-  }
-  return entries;
-}
-
-function renderDictRegistryContent(entries) {
-  const lines = entries.map((entry) => `  ${entry.key}: '${entry.value}',`);
-  return [
-    'export const DictRegistry = {',
-    ...lines,
-    '} as const;',
-    '',
-    'export type DictRegistryKey = keyof typeof DictRegistry;',
-    'export type DictType = (typeof DictRegistry)[DictRegistryKey];',
-    '',
-  ].join('\n');
-}
-
-function isPlainObject(value) {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function parseExportDefaultObject(fileContent) {
-  const source = String(fileContent || '').replace(/^\uFEFF/, '').trim();
-  if (!source) return null;
-  try {
-    const executable = source.replace(/^export\s+default/, 'return');
-    return new Function(executable)();
-  } catch (error) {
-    return null;
-  }
-}
-
-function deepMergeMissing(target, source) {
-  if (!isPlainObject(source)) {
-    return target === undefined ? source : target;
-  }
-
-  const result = isPlainObject(target) ? { ...target } : {};
-  for (const [key, value] of Object.entries(source)) {
-    if (result[key] === undefined) {
-      result[key] = value;
-      continue;
-    }
-    if (isPlainObject(result[key]) && isPlainObject(value)) {
-      result[key] = deepMergeMissing(result[key], value);
-    }
-  }
-  return result;
-}
-
-function escapeTsString(value) {
-  return String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'");
-}
-
-function renderTsLiteral(value, indentLevel = 0) {
-  const indent = '  '.repeat(indentLevel);
-  const childIndent = '  '.repeat(indentLevel + 1);
-
-  if (typeof value === 'string') {
-    return `'${escapeTsString(value)}'`;
-  }
-  if (typeof value === 'number' || typeof value === 'boolean') {
-    return String(value);
-  }
-  if (Array.isArray(value)) {
-    if (!value.length) return '[]';
-    return ['[', ...value.map((item) => `${childIndent}${renderTsLiteral(item, indentLevel + 1)},`), `${indent}]`].join('\n');
-  }
-  if (isPlainObject(value)) {
-    const entries = Object.entries(value);
-    if (!entries.length) return '{}';
-    return [
-      '{',
-      ...entries.map(([key, item]) => {
-        const renderedKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : `'${escapeTsString(key)}'`;
-        return `${childIndent}${renderedKey}: ${renderTsLiteral(item, indentLevel + 1)},`;
-      }),
-      `${indent}}`,
-    ].join('\n');
-  }
-  return 'null';
-}
-
-function renderExportDefaultContent(objectValue) {
-  return `export default ${renderTsLiteral(objectValue, 0)};\n`;
-}
-
-function getPreferredDictRegistryKey(dictType) {
-  return DEFAULT_DICT_REGISTRY_KEYS[dictType] || toConstantCase(dictType) || 'DICT_TYPE';
-}
-
-function buildUniqueDictRegistryKey(dictType, usedKeys, existingByKey) {
-  const preferred = getPreferredDictRegistryKey(dictType);
-  let candidate = preferred;
-  let index = 2;
-
-  while (usedKeys.has(candidate) && existingByKey.get(candidate) !== dictType) {
-    candidate = `${preferred}_${index}`;
-    index += 1;
-  }
-
-  return candidate;
-}
-
-function buildI18nNamespaceSegments(model) {
-  return [...model.moduleName.split('/').filter(Boolean), model.functionName];
-}
-
-function buildI18nNamespace(model) {
-  return buildI18nNamespaceSegments(model).join('.');
-}
-
-function removeFeatureCommonLocaleSections(localeObject, model) {
-  if (!isPlainObject(localeObject)) {
-    return localeObject;
-  }
-
-  const segments = buildI18nNamespaceSegments(model);
-  let cursor = localeObject;
-  for (let index = 0; index < segments.length; index += 1) {
-    const segment = segments[index];
-    if (!isPlainObject(cursor[segment])) {
-      return localeObject;
-    }
-    if (index === segments.length - 1) {
-      delete cursor[segment].placeholders;
-      delete cursor[segment].actions;
-      delete cursor[segment].messages;
-      return localeObject;
-    }
-    cursor = cursor[segment];
-  }
-
-  return localeObject;
-}
-
-function buildFieldLabelKey(model, field) {
-  return `${buildI18nNamespace(model)}.fields.${field.attrName}`;
-}
-
-function buildChildFieldLabelKey(model, childModel, field) {
-  return `${buildI18nNamespace(model)}.children.${childModel.listName}.fields.${field.attrName}`;
-}
-
-function buildChildSectionTitleKey(model, childModel) {
-  return `${buildI18nNamespace(model)}.children.${childModel.listName}.title`;
-}
-
-function buildLocaleLeaf(model) {
-  const leaf = {
-    title: model.tableComment,
-    fields: Object.fromEntries(model.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-  };
-
-  if (model.children.length) {
-    leaf.children = Object.fromEntries(
-      model.children.map((childModel) => [
-        childModel.listName,
-        {
-          title: childModel.tableComment,
-          fields: Object.fromEntries(childModel.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-        },
-      ])
-    );
-  }
-
-  return leaf;
-}
-
-function buildZhCnLocaleObject(model) {
-  const root = {};
-  const segments = buildI18nNamespaceSegments(model);
-  let cursor = root;
-
-  for (let index = 0; index < segments.length - 1; index += 1) {
-    const segment = segments[index];
-    cursor[segment] = cursor[segment] || {};
-    cursor = cursor[segment];
-  }
-
-  cursor[segments[segments.length - 1]] = buildLocaleLeaf(model);
-  return root;
-}
-
-function prepareZhCnLocaleFile(model) {
-  const localePath = path.join(model.frontendPath, 'src', 'i18n', 'biz', ...model.moduleName.split('/'), `${model.functionName}.zh-cn.ts`);
-  const exists = fs.existsSync(localePath);
-  const currentContent = exists ? readUtf8File(localePath) : '';
-  const currentObject = exists ? parseExportDefaultObject(currentContent) : null;
-  const generatedObject = buildZhCnLocaleObject(model);
-  const isCompatible = !exists || isPlainObject(currentObject);
-  const sanitizedCurrentObject = isCompatible ? removeFeatureCommonLocaleSections(currentObject || {}, model) : null;
-  const mergedObject = isCompatible ? deepMergeMissing(sanitizedCurrentObject || {}, generatedObject) : null;
-
-  return {
-    path: localePath,
-    frontendPath: model.frontendPath,
-    exists,
-    isCompatible,
-    namespace: buildI18nNamespace(model),
-    content: mergedObject ? renderExportDefaultContent(mergedObject) : '',
-    needsWrite: !exists || (isCompatible && renderExportDefaultContent(currentObject || {}) !== renderExportDefaultContent(mergedObject)),
-  };
-}
-
-function prepareDictRegistry(frontendPath, dictTypes) {
-  const registryPath = path.join(frontendPath, 'src', 'enums', 'dict-registry.ts');
-  const exists = fs.existsSync(registryPath);
-  const existingEntries = exists ? parseDictRegistryEntries(readUtf8File(registryPath)) : [];
-  const entries = existingEntries.map((entry) => ({ ...entry }));
-  const keyByValue = new Map(entries.map((entry) => [entry.value, entry.key]));
-  const existingByKey = new Map(entries.map((entry) => [entry.key, entry.value]));
-  const usedKeys = new Set(entries.map((entry) => entry.key));
-  let changed = !exists;
-
-  for (const dictType of dictTypes) {
-    if (!dictType || keyByValue.has(dictType)) continue;
-    const key = buildUniqueDictRegistryKey(dictType, usedKeys, existingByKey);
-    entries.push({ key, value: dictType });
-    keyByValue.set(dictType, key);
-    existingByKey.set(key, dictType);
-    usedKeys.add(key);
-    changed = true;
-  }
-
-  return {
-    path: registryPath,
-    entries,
-    keyByValue,
-    needsWrite: changed,
-  };
-}
-
-function ensureCrudSchemaSupportFile(frontendPath) {
-  const schemaPath = path.join(frontendPath, 'src', 'utils', 'crudSchema.ts');
-  const exists = fs.existsSync(schemaPath);
-  const currentContent = exists ? readUtf8File(schemaPath) : '';
-  const hasCoreShape =
-    currentContent.includes('export interface CrudSchemaDefinition') &&
-    currentContent.includes('export function createCrudSchema') &&
-    currentContent.includes('export interface FieldConfig');
-  const supportsLabelKey = currentContent.includes('labelKey');
-  const shouldUpgradeLegacy = exists && hasCoreShape && !supportsLabelKey;
-
-  return {
-    path: schemaPath,
-    content: DEFAULT_CRUD_SCHEMA_TEMPLATE,
-    exists,
-    isCompatible: hasCoreShape && supportsLabelKey,
-    needsWrite: !exists || shouldUpgradeLegacy,
-  };
-}
-
-function ensureDirectory(filePath) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-}
-
-function writeSupportFile(filePath, content) {
-  ensureDirectory(filePath);
-  fs.writeFileSync(filePath, content, 'utf8');
-}
-
-function prepareSharedSupport(frontendPath, dictTypes) {
-  const normalizedDictTypes = [...new Set((dictTypes || []).filter(Boolean))];
-  const dictRegistry = prepareDictRegistry(frontendPath, normalizedDictTypes);
-  const crudSchema = ensureCrudSchemaSupportFile(frontendPath);
-  return {
-    dictRegistry,
-    crudSchema,
-  };
-}
-
-function maybeWriteSharedSupport(sharedSupport, writeToDisk) {
-  if (!writeToDisk) return;
-
-  if (sharedSupport.crudSchema.needsWrite) {
-    writeSupportFile(sharedSupport.crudSchema.path, sharedSupport.crudSchema.content);
-  }
-
-  if (sharedSupport.dictRegistry.needsWrite) {
-    writeSupportFile(sharedSupport.dictRegistry.path, renderDictRegistryContent(sharedSupport.dictRegistry.entries));
-  }
-}
-
-function buildSupportNote(sharedSupport, localeZhSupport) {
-  const notes = [];
-
-  if (sharedSupport.crudSchema.exists && !sharedSupport.crudSchema.isCompatible) {
-    notes.push(
-      'Detected an existing src/utils/crudSchema.ts that does not match the expected helper signature. ' +
-        'MCP preserved the existing file and did not overwrite it. Generated pages now depend on that file being manually aligned.'
-    );
-  }
-
-  if (localeZhSupport.exists && !localeZhSupport.isCompatible) {
-    notes.push(
-      `Detected an existing ${path.relative(localeZhSupport.frontendPath, localeZhSupport.path).replace(/\\/g, '/')} that MCP could not parse. ` +
-        'The file was preserved and not updated, so new Chinese i18n keys may need to be merged manually.'
-    );
-  }
-
-  return notes.length ? notes.join(' ') : 'Runtime template rendering completed.';
-}
-
-function getDictRegistryReference(dictType, keyByValue) {
-  if (!dictType) return '';
-  const key = keyByValue.get(dictType) || getPreferredDictRegistryKey(dictType);
-  return `DictRegistry.${key}`;
-}
-
-function isAuditField(fieldName) {
-  return [
-    'id',
-    'tenant_id',
-    'version',
-    'create_time',
-    'update_time',
-    'create_user_id',
-    'update_user_id',
-    'create_user',
-    'update_user',
-    'create_pos_id',
-    'create_pos',
-    'create_dpt_id',
-    'create_dpt',
-    'create_ogn_id',
-    'create_ogn',
-    'create_psm_full_id',
-    'create_psm_full_name',
-    'update_psm_full_id',
-    'update_psm_full_name',
-    'del_flag',
-  ].includes(fieldName);
-}
-
-function findDictType(comment) {
-  return extractDictType(comment);
-  const match = comment.match(/(?:瀛楀吀|dict)[锛?\s]*([a-zA-Z0-9_]+)/i);
-}
-
-function mapFieldType(field) {
-  if (field.dictType) return 'select';
-  if (field.sqlType === 'DATETIME' || field.sqlType === 'TIMESTAMP') return 'datetime';
-  if (field.sqlType === 'DATE') return 'date';
-  if (['INT', 'BIGINT', 'DECIMAL', 'NUMERIC'].includes(field.sqlType)) return 'number';
-  if (field.sqlType === 'TEXT') return 'textarea';
-  if (field.sqlType === 'VARCHAR' && field.length && Number(field.length) > 64) return 'textarea';
-  return 'text';
-}
-
-function escapeForRegex(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function stripBom(text) {
-  return text.replace(/^\uFEFF/, '');
-}
-
-function readUtf8File(filePath) {
-  return stripBom(fs.readFileSync(filePath, 'utf8'));
-}
-
-function normalizeDictType(value) {
-  const normalized = String(value || '').trim();
-  if (!normalized || normalized === '-' || normalized === '/') {
-    return null;
-  }
-  return normalized.replace(/^['"`]+|['"`]+$/g, '');
-}
-
-function stripDictAnnotation(label) {
-  const text = String(label || '').trim();
-  if (!text) {
-    return '';
-  }
-  return text
-    .replace(/\s*[锛?]\s*(?:瀛楀吀|dict)(?:绫诲瀷|type)?\s*[:锛?]?\s*[a-zA-Z0-9_-]+\s*[锛?]\s*/gi, '')
-    .replace(/\s+/g, ' ')
-    .trim();
-}
-
-function extractDictType(text) {
-  const normalized = String(text || '').trim();
-  if (!normalized) {
-    return null;
-  }
-
-  const patterns = [
-    /(?:瀛楀吀|dict)(?:绫诲瀷|type)?\s*[:锛?]\s*([a-zA-Z0-9_-]+)/i,
-    /(?:瀛楀吀|dict)(?:绫诲瀷|type)?\s*[锛?]\s*([a-zA-Z0-9_-]+)\s*[锛?]/i,
-    /[锛?]\s*(?:瀛楀吀|dict)(?:绫诲瀷|type)?\s*[:锛?]?\s*([a-zA-Z0-9_-]+)\s*[锛?]/i,
-  ];
-
-  for (const pattern of patterns) {
-    const match = normalized.match(pattern);
-    if (match && match[1]) {
-      return normalizeDictType(match[1]);
-    }
-  }
-
-  return null;
-}
-
-function resolveDictType(comment, explicitDictType) {
-  return normalizeDictType(explicitDictType) || extractDictType(comment);
-}
-
-function detectDictType(comment) {
-  return extractDictType(comment);
-  return findDictType(comment) || ((comment.match(/(?:瀛楀吀|dict)\s*[:锛歕(锛圿?\s*([a-zA-Z0-9_]+)/i) || [])[1] ?? null);
-}
-
-function splitLength(value) {
-  const normalized = String(value || '').trim();
-  if (!normalized || normalized === '-' || normalized === '/') {
-    return { length: '', scale: '' };
-  }
-  const parts = normalized.split(',').map((item) => item.trim()).filter(Boolean);
-  return { length: parts[0] || '', scale: parts[1] || '' };
-}
-
-function normalizeDefaultValue(value) {
-  const normalized = String(value || '').trim();
-  if (!normalized || normalized === '-' || normalized === '/') {
-    return '';
-  }
-  return normalized;
-}
-
-function parseRequiredFlag(value) {
-  const normalized = String(value || '').trim().toLowerCase();
-  return ['鏄?, 'y', 'yes', '1', 'true', '蹇呭～'].includes(normalized);
-}
-
-function parseMarkdownRow(line) {
-  const trimmed = line.trim();
-  if (!trimmed.startsWith('|')) return [];
-  return trimmed
-    .slice(1, trimmed.endsWith('|') ? -1 : undefined)
-    .split('|')
-    .map((cell) => cell.trim());
-}
-
-function isMarkdownSeparatorRow(cells) {
-  return cells.length > 0 && cells.every((cell) => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, '')));
-}
-
-function findHeaderIndex(headers, patterns) {
-  return headers.findIndex((header) => patterns.some((pattern) => pattern.test(header)));
-}
-
-function findPrimaryKeyFromText(text, fields) {
-  const quotedMatch = text.match(/PRIMARY\s+KEY\s*\(\s*`?([a-zA-Z0-9_]+)`?\s*\)/i);
-  if (quotedMatch) {
-    return quotedMatch[1];
-  }
-
-  const commentPk = fields.find((field) => /涓婚敭/i.test(field.comment));
-  if (commentPk) {
-    return commentPk.fieldName;
-  }
-
-  const idField = fields.find((field) => field.fieldName === 'id');
-  if (idField) {
-    return idField.fieldName;
-  }
-
-  return fields[0] ? fields[0].fieldName : null;
-}
-
-function parseMarkdownTableSection(tableName, tableComment, sectionLines) {
-  const firstTableLineIndex = sectionLines.findIndex((line) => line.trim().startsWith('|'));
-  if (firstTableLineIndex < 0) {
-    throw new Error('Could not find markdown field table for ' + tableName);
-  }
-
-  const tableLines = [];
-  for (let index = firstTableLineIndex; index < sectionLines.length; index += 1) {
-    const line = sectionLines[index].trim();
-    if (!line.startsWith('|')) break;
-    tableLines.push(line);
-  }
-
-  const rows = tableLines.map(parseMarkdownRow).filter((cells) => cells.length > 0);
-  if (rows.length < 3) {
-    throw new Error('Markdown field table is incomplete for ' + tableName);
-  }
-
-  const headers = rows[0];
-  const dataRows = rows.slice(1).filter((cells) => !isMarkdownSeparatorRow(cells));
-  const fieldNameIndex = findHeaderIndex(headers, [/瀛楁鍚?, /鍒楀悕/i, /field/i]);
-  const sqlTypeIndex = findHeaderIndex(headers, [/绫诲瀷/, /鏁版嵁绫诲瀷/, /type/i]);
-  const lengthIndex = findHeaderIndex(headers, [/闀垮害/, /绮惧害/, /length/i]);
-  const requiredIndex = findHeaderIndex(headers, [/蹇呭～/, /蹇呰緭/, /required/i]);
-  const defaultIndex = findHeaderIndex(headers, [/榛樿/, /default/i]);
-  const commentIndex = findHeaderIndex(headers, [/璇存槑/, /澶囨敞/, /comment/i]);
-
-  const dictTypeIndex = findHeaderIndex(headers, [/瀛楀吀/, /dict/i, /dict_?type/i]);
-
-  if (fieldNameIndex < 0 || sqlTypeIndex < 0) {
-    throw new Error('Markdown field table headers are missing required columns for ' + tableName);
-  }
-
-  const fields = [];
-  for (const row of dataRows) {
-    const fieldName = String(row[fieldNameIndex] || '').trim();
-    if (!fieldName || fieldName === '-') continue;
-
-    const sqlType = String(row[sqlTypeIndex] || '').trim().toUpperCase();
-    if (!sqlType) continue;
-
-    const lengthRaw = lengthIndex >= 0 ? row[lengthIndex] : '';
-    const comment = String(commentIndex >= 0 ? row[commentIndex] : '').trim() || fieldName;
-    const explicitDictType = dictTypeIndex >= 0 ? row[dictTypeIndex] : '';
-    const { length, scale } = splitLength(lengthRaw);
-
-    fields.push({
-      fieldName,
-      attrName: toCamelCase(fieldName),
-      sqlType,
-      length,
-      scale,
-      comment,
-      dictType: resolveDictType(comment, explicitDictType),
-      notNull: requiredIndex >= 0 ? parseRequiredFlag(row[requiredIndex]) : false,
-      defaultValue: defaultIndex >= 0 ? normalizeDefaultValue(row[defaultIndex]) : '',
-    });
-  }
-
-  if (!fields.length) {
-    throw new Error('No fields were parsed from markdown table ' + tableName);
-  }
-
-  const sectionText = sectionLines.join('\n');
-  const pkName = findPrimaryKeyFromText(sectionText, fields);
-  const pkField = fields.find((field) => field.fieldName === pkName) || fields[0];
-  return { pkField, fields, tableComment };
-}
-
-function parseMarkdownDesignTables(markdownText) {
-  const lines = stripBom(markdownText).replace(/\r\n?/g, '\n').split('\n');
-  const tables = new Map();
-
-  for (let index = 0; index < lines.length; index += 1) {
-    const heading = lines[index].trim();
-    const headingMatch = heading.match(/^###\s+\S+\s+([a-zA-Z0-9_]+)\s*[\(锛圿([^)\n锛塢+)[\)锛塢/);
-    if (!headingMatch) continue;
-
-    const tableName = headingMatch[1];
-    const tableComment = headingMatch[2].trim();
-    const sectionLines = [];
-    let nextIndex = index + 1;
-    while (nextIndex < lines.length && !/^(##|###)\s+/.test(lines[nextIndex])) {
-      sectionLines.push(lines[nextIndex]);
-      nextIndex += 1;
-    }
-
-    tables.set(tableName, parseMarkdownTableSection(tableName, tableComment, sectionLines));
-    index = nextIndex - 1;
-  }
-
-  return tables;
-}
-
-function extractIdentifiersFromLine(line) {
-  return [...String(line || '').matchAll(/`?([a-zA-Z][a-zA-Z0-9_]*)`?/g)].map((match) => match[1]);
-}
-
-function stripMarkdownSyntax(text) {
-  return String(text || '')
-    .replace(/\*\*/g, '')
-    .replace(/`/g, '')
-    .replace(/\r\n?/g, '\n');
-}
-
-function parseMarkdownRelations(markdownText) {
-  const text = stripMarkdownSyntax(markdownText);
-  const blocks = [];
-  const headingRegex = /^(###|####)\s+(.+)$/gm;
-  let current = null;
-  let match = headingRegex.exec(text);
-
-  while (match) {
-    if (current) {
-      current.body = text.slice(current.start, match.index);
-      blocks.push(current);
-    }
-
-    current = {
-      title: match[2].trim(),
-      start: headingRegex.lastIndex,
-      body: '',
-    };
-    match = headingRegex.exec(text);
-  }
-
-  if (current) {
-    current.body = text.slice(current.start);
-    blocks.push(current);
-  }
-
-  const relations = [];
-  for (const block of blocks) {
-    const lines = block.body.split('\n').map((line) => line.trim()).filter(Boolean);
-    const mainLine = lines.find((line) => /(涓昏〃|鐖惰〃)\s*[:锛歖/.test(line));
-    const childLine = lines.find((line) => /(浠庤〃|瀛愯〃)\s*[:锛歖/.test(line));
-    const fieldLine = lines.find((line) => /鍏宠仈瀛楁\s*[:锛歖/.test(line));
-    if (!mainLine || !childLine || !fieldLine) continue;
-
-    const mainIdentifiers = extractIdentifiersFromLine(mainLine);
-    const childIdentifiers = extractIdentifiersFromLine(childLine);
-    const fieldIdentifiers = extractIdentifiersFromLine(fieldLine);
-    if (!mainIdentifiers.length || !childIdentifiers.length || fieldIdentifiers.length < 2) continue;
-
-    const relationTypeLine = lines.find((line) => /鍏崇郴绫诲瀷\s*[:锛歖/.test(line));
-    relations.push({
-      title: block.title,
-      mainTableName: mainIdentifiers[0],
-      childTableName: childIdentifiers[0],
-      childField: fieldIdentifiers[0],
-      mainField: fieldIdentifiers[1],
-      relationType: relationTypeLine ? relationTypeLine.split(/[:锛歖/).slice(1).join(':').trim() : '',
-    });
-  }
-
-  return relations;
-}
-
-function parseMarkdownDesignFile(markdownText) {
-  return {
-    tables: parseMarkdownDesignTables(markdownText),
-    relations: [],
-  };
-}
-
-function parseTableFromMarkdownDesign(designDoc, tableName) {
-  const parsed = designDoc.tables.get(tableName);
-  if (!parsed) {
-    throw new Error('Could not find table definition for ' + tableName + ' in Markdown design file');
-  }
-  return parsed;
-}
-
-function buildQuestionMarkSegmentRegex(segment) {
-  return new RegExp('^' + escapeForRegex(segment).replace(/\\\?/g, '.') + '$', 'i');
-}
-
-function tryResolveGarbledPath(resolvedPath) {
-  if (!resolvedPath.includes('?')) {
-    return null;
-  }
-
-  const parsed = path.parse(resolvedPath);
-  const segments = resolvedPath.slice(parsed.root.length).split(path.sep).filter(Boolean);
-  let currentPath = parsed.root;
-
-  for (const segment of segments) {
-    const exactPath = path.join(currentPath, segment);
-    if (fs.existsSync(exactPath)) {
-      currentPath = exactPath;
-      continue;
-    }
-
-    if (!segment.includes('?') || !fs.existsSync(currentPath) || !fs.statSync(currentPath).isDirectory()) {
-      return null;
-    }
-
-    const matcher = buildQuestionMarkSegmentRegex(segment);
-    const matches = fs.readdirSync(currentPath).filter((name) => matcher.test(name));
-    if (matches.length !== 1) {
-      throw new Error(
-        'Source file path could not be resolved uniquely from garbled input: ' +
-          resolvedPath +
-          '. Matched entries: ' +
-          (matches.length ? matches.join(', ') : 'none')
-      );
-    }
-
-    currentPath = path.join(currentPath, matches[0]);
-  }
-
-  return fs.existsSync(currentPath) ? currentPath : null;
-}
-
-function resolveSourcePath(inputPath) {
-  const resolvedPath = path.resolve(inputPath);
-  if (fs.existsSync(resolvedPath)) {
-    return resolvedPath;
-  }
-
-  const recoveredPath = tryResolveGarbledPath(resolvedPath);
-  if (recoveredPath) {
-    return recoveredPath;
-  }
-
-  throw new Error('Source file does not exist: ' + resolvedPath);
-}
-
-function formatRelationCandidate(relation) {
-  return {
-    childTableName: relation.childTableName,
-    mainField: relation.mainField,
-    childField: relation.childField,
-    relationType: relation.relationType || '',
-  };
-}
-
-function getRelationCandidates(designDoc, tableName) {
-  return designDoc.relations
-    .filter((relation) => relation.mainTableName === tableName)
-    .map(formatRelationCandidate);
-}
-
-function buildRetryArguments(safeArgs, sourceFile, childTableName) {
-  const retryArguments = {
-    tableName: safeArgs.tableName,
-    style: safeArgs.style,
-    frontendPath: safeArgs.frontendPath,
-    moduleName: safeArgs.moduleName,
-    writeToDisk: safeArgs.writeToDisk,
-    overwrite: safeArgs.overwrite,
-  };
-
-  if (sourceFile) {
-    retryArguments.designFile = sourceFile;
-  }
-
-  if (safeArgs.children && safeArgs.children.length) {
-    retryArguments.children = safeArgs.children.map((relation) => ({
-      childTableName: relation.childTableName,
-      mainField: relation.mainField,
-      childField: relation.childField,
-      relationType: relation.relationType || '',
-    }));
-  }
-
-  if (childTableName) {
-    retryArguments.childTableName = childTableName;
-  }
-
-  if (safeArgs.mainField) {
-    retryArguments.mainField = safeArgs.mainField;
-  }
-
-  if (safeArgs.childField) {
-    retryArguments.childField = safeArgs.childField;
-  }
-
-  if (safeArgs.relationType) {
-    retryArguments.relationType = safeArgs.relationType;
-  }
-
-  return retryArguments;
-}
-
-function buildRelationCorrectionEntry(safeArgs, sourceFile, candidates, selectedChildTableName) {
-  return {
-    field: 'childTableName',
-    title: '涓诲瓙琛ㄥ叧鑱斾慨姝ｅ叆鍙?,
-    tableName: safeArgs.tableName,
-    style: safeArgs.style,
-    designFile: sourceFile,
-    description: candidates.length
-      ? 'If the current child relation is not the one you want, pass childTableName to choose a candidate from the design file.'
-      : 'No child relation was found. Check the 涓讳粠琛ㄥ叧鑱旇鏄?section in the design file.',
-    currentValue: selectedChildTableName || '',
-    options: candidates.map((item) => item.childTableName),
-    candidates,
-    example: candidates.length ? buildRetryArguments(safeArgs, sourceFile, candidates[0].childTableName) : buildRetryArguments(safeArgs, sourceFile, selectedChildTableName),
-    retryArguments: candidates.map((item) => buildRetryArguments(safeArgs, sourceFile, item.childTableName)),
-  };
-}
-
-function createRelationResolutionError(message, safeArgs, sourceFile, candidates, selectedChildTableName, status) {
-  const error = new Error(message);
-  error.details = {
-    type: 'relation_resolution',
-    status,
-    tableName: safeArgs.tableName,
-    designFile: sourceFile,
-    message,
-    candidates,
-    correctionEntry: buildRelationCorrectionEntry(safeArgs, sourceFile, candidates, selectedChildTableName),
-  };
-  return error;
-}
-
-function loadSourceDocument(safeArgs) {
-  const inputPath = safeArgs.designFile || DEFAULT_DESIGN_FILE;
-  const sourcePath = resolveSourcePath(inputPath);
-  const text = readUtf8File(sourcePath);
-  return {
-    path: sourcePath,
-    text,
-    designDoc: parseMarkdownDesignFile(text),
-  };
-}
-
-function normalizeChildrenInput(inputChildren) {
-  if (inputChildren === undefined || inputChildren === null) {
-    return [];
-  }
-  if (!Array.isArray(inputChildren)) {
-    throw new Error('children must be an array');
-  }
-  return inputChildren.map((item, index) => {
-    if (!item || typeof item !== 'object') {
-      throw new Error('children[' + index + '] must be an object');
-    }
-    const childTableName = item.childTableName ? String(item.childTableName) : '';
-    const mainField = item.mainField ? String(item.mainField) : '';
-    const childField = item.childField ? String(item.childField) : '';
-    const relationType = item.relationType ? String(item.relationType) : '';
-    const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !({ childTableName, mainField, childField })[field]);
-    if (missingFields.length) {
-      throw new Error('children[' + index + '] is missing required fields: ' + missingFields.join(', '));
-    }
-    return { childTableName, mainField, childField, relationType };
-  });
-}
-
-function resolveMarkdownChildRelations(sourceDocument, safeArgs) {
-  if (safeArgs.children && safeArgs.children.length) {
-    return safeArgs.children.map((relation) => ({
-      mainTableName: safeArgs.tableName,
-      childTableName: relation.childTableName,
-      mainField: relation.mainField,
-      childField: relation.childField,
-      relationType: relation.relationType || '',
-    }));
-  }
-
-  const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !safeArgs[field]);
-  if (missingFields.length) {
-    const message = 'master_child_jump requires either children[] or legacy relation fields. Missing: ' + missingFields.join(', ') + '.';
-    const error = new Error(message);
-    error.details = {
-      type: 'relation_input_required',
-      status: 'missing_required_relation_input',
-      tableName: safeArgs.tableName,
-      designFile: sourceDocument.path,
-      message,
-      requiredFields: ['children[] or childTableName/mainField/childField'],
-      correctionEntry: {
-        fields: ['children', 'childTableName', 'mainField', 'childField'],
-        example: {
-          ...buildRetryArguments(safeArgs, sourceDocument.path, safeArgs.childTableName || '<child_table_name>'),
-          children: [
-            {
-              childTableName: safeArgs.childTableName || '<child_table_name>',
-              mainField: safeArgs.mainField || '<main_field>',
-              childField: safeArgs.childField || '<child_field>',
-              relationType: safeArgs.relationType || '1:N',
-            },
-          ],
-          mainField: safeArgs.mainField || '<main_field>',
-          childField: safeArgs.childField || '<child_field>',
-        },
-      },
-    };
-    throw error;
-  }
-
-  return [
-    {
-      mainTableName: safeArgs.tableName,
-      childTableName: safeArgs.childTableName,
-      mainField: safeArgs.mainField,
-      childField: safeArgs.childField,
-      relationType: safeArgs.relationType || '',
-    },
-  ];
-}
-
-function getStylePreset(styleId) {
-  const preset = STYLE_CATALOG[styleId];
-  if (!preset) throw new Error('Unsupported style: ' + styleId);
-  return preset;
-}
-
-function resolveSharedTemplates(stylePreset) {
-  const selected = {};
-  for (const [kind, templateName] of Object.entries(stylePreset.templateFiles || {})) {
-    const templatePath = path.join(TEMPLATE_LIBRARY_ROOT, templateName);
-    selected[kind] = { name: templateName, path: templatePath, exists: fs.existsSync(templatePath) };
-  }
-  return selected;
-}
-
-function hasRuntimeSupport(stylePreset) {
-  return Boolean(stylePreset.runtime && stylePreset.runtime.supported && stylePreset.runtime.templateDir);
-}
-
-function normalizeFields(parsed) {
-  return parsed.fields.map((field) => ({ ...field, formType: mapFieldType(field), isAudit: isAuditField(field.fieldName) }));
-}
-
-function ensureFieldExists(fields, fieldName, tableName, role) {
-  const field = fields.find((item) => item.fieldName === fieldName);
-  if (!field) throw new Error(role + ' field "' + fieldName + '" was not found on table ' + tableName);
-  return field;
-}
-
-function buildChildModels(sourceDocument, safeArgs, mainParsed) {
-  if (safeArgs.style !== 'master_child_jump') return [];
-
-  const relations = resolveMarkdownChildRelations(sourceDocument, safeArgs);
-  return relations.map((relation) => {
-    const childParsed = parseTableFromMarkdownDesign(sourceDocument.designDoc, relation.childTableName);
-    const childFields = normalizeFields(childParsed);
-    const mainRelationField = ensureFieldExists(mainParsed.fields, relation.mainField, safeArgs.tableName, 'Main relation');
-    const childRelationField = ensureFieldExists(childParsed.fields, relation.childField, relation.childTableName, 'Child relation');
-    const childVisibleFields = childFields.filter(
-      (field) => field.fieldName !== childParsed.pkField.fieldName && !field.isAudit && field.fieldName !== relation.childField
-    );
-
-    return {
-      tableName: relation.childTableName,
-      tableComment: childParsed.tableComment,
-      className: toPascalCase(relation.childTableName),
-      functionName: toCamelCase(relation.childTableName),
-      listName: toCamelCase(relation.childTableName) + 'List',
-      pk: childParsed.pkField,
-      fields: childFields,
-      visibleFields: childVisibleFields,
-      mainField: mainRelationField,
-      childField: childRelationField,
-      relationType: relation.relationType,
-    };
-  });
-}
-
-function buildModel(safeArgs) {
-  const sourceDocument = loadSourceDocument(safeArgs);
-  const mainParsed = parseTableFromMarkdownDesign(sourceDocument.designDoc, safeArgs.tableName);
-  const fields = normalizeFields(mainParsed);
-  const visibleFields = fields.filter((field) => field.fieldName !== mainParsed.pkField.fieldName && !field.isAudit);
-  const gridFields = visibleFields.slice(0, 8);
-  const children = buildChildModels(sourceDocument, safeArgs, mainParsed);
-  const childDictTypes = children.flatMap((child) => child.visibleFields.map((field) => field.dictType).filter(Boolean));
-  const dictTypes = [...new Set([...visibleFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
-
-  return {
-    sourceFile: sourceDocument.path,
-    designFile: sourceDocument.path,
-    tableName: safeArgs.tableName,
-    tableComment: mainParsed.tableComment,
-    className: toPascalCase(safeArgs.tableName),
-    functionName: toCamelCase(safeArgs.tableName),
-    moduleName: normalizeModuleName(safeArgs.moduleName),
-    pk: mainParsed.pkField,
-    fields,
-    visibleFields,
-    gridFields,
-    dictTypes,
-    frontendPath: path.resolve(safeArgs.frontendPath),
-    style: safeArgs.style,
-    children,
-  };
-}
-
-function renderTemplate(templateText, replacements) {
-  let output = templateText;
-  for (const [key, value] of Object.entries(replacements)) {
-    output = output.split('{{' + key + '}}').join(String(value));
-  }
-  return output;
-}
-
-function renderFormField(field) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  const prop = field.attrName;
-
-  if (field.formType === 'select') {
-    return [
-      '          <el-col :span="12" class="mb20">',
-      `            <el-form-item label="${label}" prop="${prop}">`,
-      `              <el-select v-model="form.${prop}" placeholder="璇烽€夋嫨${label}" style="width: 100%">`,
-      `                <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
-      '              </el-select>',
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'number') {
-    const max = field.comment.includes('%') || field.comment.includes('姣斾緥') ? ' :max="100"' : '';
-    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
-    return [
-      '          <el-col :span="12" class="mb20">',
-      `            <el-form-item label="${label}" prop="${prop}">`,
-      `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} placeholder="璇疯緭鍏?{label}" style="width: 100%" />`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'datetime' || field.formType === 'date') {
-    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
-    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
-    return [
-      '          <el-col :span="12" class="mb20">',
-      `            <el-form-item label="${label}" prop="${prop}">`,
-      `              <el-date-picker type="${pickerType}" placeholder="璇烽€夋嫨${label}" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"></el-date-picker>`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'textarea') {
-    return [
-      '          <el-col :span="24" class="mb20">',
-      `            <el-form-item label="${label}" prop="${prop}">`,
-      `              <el-input type="textarea" v-model="form.${prop}" placeholder="璇疯緭鍏?{label}" />`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  return [
-    '          <el-col :span="12" class="mb20">',
-    `            <el-form-item label="${label}" prop="${prop}">`,
-    `              <el-input v-model="form.${prop}" placeholder="璇疯緭鍏?{label}" />`,
-    '            </el-form-item>',
-    '          </el-col>',
-  ].join('\n');
-}
-
-function renderTableColumn(field) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  if (field.dictType) {
-    return [
-      `        <el-table-column prop="${field.attrName}" label="${label}" show-overflow-tooltip>`,
-      '          <template #default="scope">',
-      `            <dict-tag :options="${field.dictType}" :value="scope.row.${field.attrName}" />`,
-      '          </template>',
-      '        </el-table-column>',
-    ].join('\n');
-  }
-  return `        <el-table-column prop="${field.attrName}" label="${label}" show-overflow-tooltip />`;
-}
-
-function renderChildTableColumn(field, childListName) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  const rules = field.notNull ? ` :rules="[{ required: true, trigger: 'blur' }]"` : '';
-
-  let control = `                  <el-input v-model="row.${field.attrName}" />`;
-  if (field.formType === 'select' && field.dictType) {
-    control = [
-      `                  <el-select v-model="row.${field.attrName}" placeholder="璇烽€夋嫨${label}" style="width: 100%">`,
-      `                    <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
-      '                  </el-select>',
-    ].join('\n');
-  } else if (field.formType === 'number') {
-    const max = field.comment.includes('%') || field.comment.includes('姣斾緥') ? ' :max="100"' : '';
-    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
-    control = `                  <el-input-number v-model="row.${field.attrName}" :min="0"${max}${precision} style="width: 100%" />`;
-  }
-
-  return [
-    `            <el-table-column label="${label}" prop="${field.attrName}">`,
-    '              <template #default="{ row, $index }">',
-    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
-    control,
-    '                </el-form-item>',
-    '              </template>',
-    '            </el-table-column>',
-  ].join('\n');
-}
-
-function renderOptionField(field) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  return `  ${field.attrName}: { show:true, alwaysHide:false, smart:false, label: '${label}', width: '120' },`;
-}
-
-function renderFilterType(field) {
-  if (!field.dictType) return null;
-  return `  ${field.attrName}: 30,`;
-}
-
-function renderDefaultLine(field) {
-  if (field.formType === 'number') return `  ${field.attrName}: 0,`;
-  return `  ${field.attrName}: '',`;
-}
-
-function renderFormDefaults(model) {
-  const lines = [`  ${model.pk.attrName}: '',`];
-  for (const field of model.visibleFields) lines.push(renderDefaultLine(field));
-  return lines.join('\n');
-}
-
-function renderChildTempDefaults(childModel) {
-  if (!childModel) return '';
-  return childModel.fields.map(renderDefaultLine).join('\n');
-}
-
-function renderChildListDefaultLine(childModel) {
-  return `  ${childModel.listName}: [],`;
-}
-
-function renderChildTempDeclaration(childModel) {
-  return [
-    `const childTemp${childModel.className} = reactive({`,
-    renderChildTempDefaults(childModel),
-    '});',
-  ].join('\n');
-}
-
-function renderChildSection(childModel, childCount) {
-  const title = childModel.tableComment.replace(/'/g, "\\'");
-  const deleteExpression =
-    childCount > 1
-      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
-      : `deleteChild(obj, '${childModel.pk.attrName}')`;
-
-  return [
-    '          <el-col :span="24" class="mb20">',
-    `            <div class="mb10" style="font-weight: 600;">${title}</div>`,
-    `            <sc-form-table v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')">`,
-    childModel.visibleFields.map((field) => renderChildTableColumn(field, childModel.listName)).join('\n'),
-    '            </sc-form-table>',
-    '          </el-col>',
-  ].join('\n');
-}
-
-function renderChildFormListDefaults(children) {
-  if (!children.length) return '';
-  return children.map(renderChildListDefaultLine).join('\n');
-}
-
-function renderChildTempDeclarations(children) {
-  if (!children.length) return '';
-  return children.map(renderChildTempDeclaration).join('\n\n');
-}
-
-function renderChildResetListLines(children) {
-  if (!children.length) return '';
-  return children.map((childModel) => `    form.${childModel.listName} = [];`).join('\n');
-}
-
-function renderDictImportBlock(dictTypes) {
-  if (!dictTypes.length) return '';
-  return [
-    "import { useDict } from '/@/hooks/dict';",
-    `const { ${dictTypes.join(', ')} } = useDict(${dictTypes.map((item) => `'${item}'`).join(', ')});`,
-  ].join('\n');
-}
-
-function getDefaultOptionFieldWidthV2(field) {
-  if (field.formType === 'textarea') return '180';
-  return '120';
-}
-
-function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
-  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`];
-  const width = getDefaultOptionFieldWidthV2(field);
-
-  if (width !== '120') {
-    parts.push(`width: '${width}'`);
-  }
-
-  if (field.dictType) {
-    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  }
-
-  return `${indent}{ ${parts.join(', ')} },`;
-}
-
-function renderChildOptionGroupV2(model, childModel, dictRegistryRefs) {
-  return [
-    `    ${childModel.listName}: [`,
-    childModel.visibleFields
-      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
-      .join('\n'),
-    '    ],',
-  ].join('\n');
-}
-
-function renderTextMaxlengthAttrV2(field) {
-  if (!field.length) return '';
-  return ` :maxlength="${field.length}"`;
-}
-
-function renderTextareaMaxlengthAttrsV2(field) {
-  if (!field.length) return '';
-  return ` :maxlength="${field.length}" show-word-limit`;
-}
-
-function renderFormFieldV2(field) {
-  const prop = field.attrName;
-  const labelExpr = `getMasterFieldLabel('${prop}')`;
-  const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
-  const visibilityExpr = `isMasterFieldVisible('${prop}')`;
-
-  if (field.formType === 'select') {
-    return [
-      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
-      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-select v-model="form.${prop}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%">`,
-      `                <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
-      '              </el-select>',
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'number') {
-    const max = field.comment.includes('%') || field.comment.includes('濮ｆ柧绶?) ? ' :max="100"' : '';
-    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
-    return [
-      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
-      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} :placeholder="inputPlaceholder(${labelExpr})" style="width: 100%" />`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'datetime' || field.formType === 'date') {
-    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
-    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
-    return [
-      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
-      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-date-picker type="${pickerType}" :placeholder="selectPlaceholder(${labelExpr})" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"></el-date-picker>`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'textarea') {
-    return [
-      `          <el-col v-if="${visibilityExpr}" :span="24" class="mb20">`,
-      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-input type="textarea" v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextareaMaxlengthAttrsV2(field)} />`,
-      '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
-  return [
-    `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
-    `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-    `              <el-input v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextMaxlengthAttrV2(field)} />`,
-    '            </el-form-item>',
-    '          </el-col>',
-  ].join('\n');
-}
-
-function renderTableColumnV2(field, dictRegistryRefs) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  const parts = [`prop: '${field.attrName}'`, `label: '${label}'`];
-  const width = getDefaultOptionFieldWidthV2(field);
-
-  if (width !== '120') {
-    parts.push(`width: '${width}'`);
-  }
-
-  if (field.dictType) {
-    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  }
-
-  return `  { ${parts.join(', ')} },`;
-}
-
-function renderChildTableColumnV2(field, childListName) {
-  const rules = field.notNull ? ` :rules="[{ required: true, trigger: 'blur' }]"` : '';
-  const labelExpr = `getChildFieldLabel('${childListName}', '${field.attrName}')`;
-  const dictExpr = `getChildFieldMeta('${childListName}', '${field.attrName}')?.dictType`;
-
-  let control = `                  <el-input v-model="row.${field.attrName}"${renderTextMaxlengthAttrV2(field)} />`;
-  if (field.formType === 'select' && field.dictType) {
-    control = [
-      `                  <el-select v-model="row.${field.attrName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%">`,
-      `                    <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
-      '                  </el-select>',
-    ].join('\n');
-  } else if (field.formType === 'number') {
-    const max = field.comment.includes('%') || field.comment.includes('濮ｆ柧绶?) ? ' :max="100"' : '';
-    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
-    control = `                  <el-input-number v-model="row.${field.attrName}" :min="0"${max}${precision} style="width: 100%" />`;
-  } else if (field.formType === 'datetime' || field.formType === 'date') {
-    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
-    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
-    control = `                  <el-date-picker type="${pickerType}" v-model="row.${field.attrName}" :value-format="${formatName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%"></el-date-picker>`;
-  } else if (field.formType === 'textarea') {
-    control = `                  <el-input type="textarea" v-model="row.${field.attrName}"${renderTextareaMaxlengthAttrsV2(field)} />`;
-  }
-
-  return [
-    `            <el-table-column :label="${labelExpr}" prop="${field.attrName}">`,
-    '              <template #default="{ row, $index }">',
-    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
-    control,
-    '                </el-form-item>',
-    '              </template>',
-    '            </el-table-column>',
-  ].join('\n');
-}
-
-function renderChildSectionV2(childModel, childCount) {
-  const deleteExpression =
-    childCount > 1
-      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
-      : `deleteChild(obj, '${childModel.pk.attrName}')`;
-
-  return [
-    '          <el-col :span="24" class="mb20">',
-    `            <div class="mb10" style="font-weight: 600;">{{ childSectionTitle('${childModel.listName}') }}</div>`,
-    `            <sc-form-table v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')">`,
-    childModel.visibleFields.map((field) => renderChildTableColumnV2(field, childModel.listName)).join('\n'),
-    '            </sc-form-table>',
-    '          </el-col>',
-  ].join('\n');
-}
-
-function renderValidationRule(field) {
-  if (!field.notNull) return null;
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  return `  ${field.attrName}: [{ required: true, message: '${label}涓嶈兘涓虹┖', trigger: 'blur' }],`;
-}
-
-function renderFormRules(visibleFields) {
-  const lines = visibleFields.map(renderValidationRule).filter(Boolean);
-  return lines.join('\n');
-}
-
-function renderFormRulesV2(visibleFields) {
-  const lines = visibleFields
-    .filter((field) => field.notNull)
-    .map((field) => `  ${field.attrName}: [{ required: true, message: fieldRequiredMessage('${field.attrName}'), trigger: 'blur' }],`);
-  return lines.join('\n');
-}
-
-function buildReplacements(model, sharedSupport) {
-  const menuBaseId = Date.now();
-  const apiModulePath = `${model.moduleName}/${model.functionName}`;
-  const routePath = `${model.moduleName}/${model.functionName}`;
-  const permissionPrefix = `${model.moduleName}/${model.functionName}`.replace(/\//g, '_');
-  const dictRegistryRefs = sharedSupport.dictRegistry.keyByValue;
-  const i18nNamespace = buildI18nNamespace(model);
-
-  return {
-    TABLE_NAME: model.tableName,
-    TABLE_COMMENT: model.tableComment,
-    CLASS_NAME: model.className,
-    FUNCTION_NAME: model.functionName,
-    PK_ATTR: model.pk.attrName,
-    API_MODULE_PATH: apiModulePath,
-    API_PATH: apiModulePath,
-    VIEW_MODULE_PATH: routePath,
-    MENU_ROUTE_PATH: routePath,
-    I18N_NAMESPACE: i18nNamespace,
-    PERMISSION_PREFIX: permissionPrefix,
-    MENU_BASE_ID: menuBaseId,
-    MENU_BASE_ID_PLUS_1: menuBaseId + 1,
-    MENU_BASE_ID_PLUS_2: menuBaseId + 2,
-    MENU_BASE_ID_PLUS_3: menuBaseId + 3,
-      MENU_BASE_ID_PLUS_4: menuBaseId + 4,
-      MENU_BASE_ID_PLUS_5: menuBaseId + 5,
-      GENERATED_AT: new Date().toISOString(),
-      FORM_FIELDS: model.visibleFields.map(renderFormFieldV2).join('\n'),
-      TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumnV2(field, dictRegistryRefs)).join('\n'),
-      FORM_DEFAULTS: renderFormDefaults(model),
-      DICT_REGISTRY_IMPORT_BLOCK: model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';" : '',
-      MASTER_OPTION_FIELDS: model.visibleFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
-      CHILD_OPTION_GROUPS: model.children.map((childModel) => renderChildOptionGroupV2(model, childModel, dictRegistryRefs)).join('\n'),
-      FORM_RULES: renderFormRulesV2(model.visibleFields),
-      CHILD_FORM_LIST_DEFAULTS: renderChildFormListDefaults(model.children),
-      CHILD_TEMP_DECLARATIONS: renderChildTempDeclarations(model.children),
-      CHILD_RESET_LISTS: renderChildResetListLines(model.children),
-      CHILD_SECTIONS: model.children.map((childModel) => renderChildSectionV2(childModel, model.children.length)).join('\n'),
-    };
-  }
-
-function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
-  if (!hasRuntimeSupport(stylePreset)) throw new Error('Runtime templates are not implemented for style: ' + model.style);
-
-  const runtime = stylePreset.runtime;
-  const templateDir = path.resolve(__dirname, runtime.templateDir);
-  const replacements = buildReplacements(model, sharedSupport);
-  const formTemplate = fs.readFileSync(path.join(templateDir, runtime.files.form), 'utf8');
-  const listTemplate = fs.readFileSync(path.join(templateDir, runtime.files.list), 'utf8');
-  const optionsTemplate = fs.readFileSync(path.join(templateDir, runtime.files.options), 'utf8');
-  const apiTemplate = fs.readFileSync(path.join(templateDir, runtime.files.api), 'utf8');
-  const menuSqlTemplate = runtime.files.menuSql ? fs.readFileSync(path.join(templateDir, runtime.files.menuSql), 'utf8') : null;
-
-  const viewRoot = path.join(model.frontendPath, 'src', 'views', ...model.moduleName.split('/'), model.functionName);
-  const apiRoot = path.join(model.frontendPath, 'src', 'api', ...model.moduleName.split('/'));
-  const menuRoot = path.join(model.frontendPath, 'menu');
-
-  const files = [
-    { type: 'form', path: path.join(viewRoot, 'form.vue'), content: renderTemplate(formTemplate, replacements) },
-    { type: 'list', path: path.join(viewRoot, 'index.vue'), content: renderTemplate(listTemplate, replacements) },
-    { type: 'options', path: path.join(viewRoot, 'options.ts'), content: renderTemplate(optionsTemplate, replacements) },
-    { type: 'api', path: path.join(apiRoot, `${model.functionName}.ts`), content: renderTemplate(apiTemplate, replacements) },
-    {
-      type: 'i18nZh',
-      path: localeZhSupport.path,
-      content: localeZhSupport.content,
-      canWrite: localeZhSupport.isCompatible,
-      needsWrite: localeZhSupport.needsWrite,
-    },
-  ];
-
-  if (menuSqlTemplate) {
-    files.push({ type: 'menuSql', path: path.join(menuRoot, `${model.functionName}_menu.sql`), content: renderTemplate(menuSqlTemplate, replacements) });
-  }
-  return files;
-}
-
-function ensureArguments(input) {
-  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
-  for (const key of TOOL_SCHEMA.required) {
-    if (!input[key]) throw new Error(key + ' is required');
-  }
-
-  const style = String(input.style);
-  getStylePreset(style);
-
-  return {
-    designFile: input.designFile ? String(input.designFile) : null,
-    tableName: String(input.tableName),
-    style,
-    children: normalizeChildrenInput(input.children),
-    childTableName: input.childTableName ? String(input.childTableName) : null,
-    mainField: input.mainField ? String(input.mainField) : null,
-    childField: input.childField ? String(input.childField) : null,
-    relationType: input.relationType ? String(input.relationType) : '',
-    frontendPath: String(input.frontendPath),
-    moduleName: input.moduleName ? String(input.moduleName) : 'admin/test',
-    writeToDisk: input.writeToDisk === undefined ? true : Boolean(input.writeToDisk),
-    overwrite: input.overwrite === undefined ? true : Boolean(input.overwrite),
-  };
-}
-
-function maybeWriteFiles(files, writeToDisk, overwrite) {
-  if (!writeToDisk) return;
-  for (const file of files) {
-    if (file.canWrite === false) {
-      file.status = 'skipped';
-      continue;
-    }
-    if (file.needsWrite === false) {
-      file.status = 'unchanged';
-      continue;
-    }
-    if (!overwrite && fs.existsSync(file.path)) {
-      file.status = 'skipped';
-      continue;
-    }
-    fs.mkdirSync(path.dirname(file.path), { recursive: true });
-    fs.writeFileSync(file.path, file.content, 'utf8');
-    file.status = 'success';
-  }
-}
-
-function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, note) {
-  const relations = model.children.map((childModel) => ({
-    childTableName: childModel.tableName,
-    childTableComment: childModel.tableComment,
-    mainField: childModel.mainField.fieldName,
-    childField: childModel.childField.fieldName,
-    childListName: childModel.listName,
-    relationType: childModel.relationType || '',
-  }));
-  const selectedList = relations.map((relation) => formatRelationCandidate(relation));
-
-  return {
-    mode: 'local-template',
-    style: safeArgs.style,
-    styleLabel: stylePreset.label,
-    runtimeSupported: hasRuntimeSupport(stylePreset),
-    sourceFile: model.sourceFile,
-    designFile: model.designFile,
-    tableName: model.tableName,
-    tableComment: model.tableComment,
-    moduleName: model.moduleName,
-    writeToDisk: safeArgs.writeToDisk,
-    selectedTemplates: sharedTemplates,
-    files: files.map((file) => ({ type: file.type, path: file.path, bytes: Buffer.byteLength(file.content, 'utf8'), status: file.status || (safeArgs.writeToDisk ? 'success' : 'rendered') })),
-    relation: relations.length === 1 ? relations[0] : null,
-    relations,
-    relationResolution: model.children.length
-      ? {
-          status: 'provided',
-          tableName: safeArgs.tableName,
-          designFile: model.designFile,
-          source: 'arguments',
-          message:
-            model.children.length > 1
-              ? 'Direct child relations were provided by the caller. MCP skipped design-doc relation inference and generated a single main form with multiple child tables.'
-              : 'The relation was provided by the caller. MCP skipped design-doc relation inference and generated files directly.',
-          selected: selectedList.length === 1 ? selectedList[0] : null,
-          selectedList,
-          correctionEntry: {
-            fields: ['children', 'childTableName', 'mainField', 'childField'],
-            example: buildRetryArguments(safeArgs, model.designFile, model.children[0].tableName),
-          },
-        }
-      : null,
-    summary: {
-      totalFields: model.fields.length,
-      visibleFields: model.visibleFields.length,
-      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
-      skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
-      childCount: model.children.length,
-      childTables: model.children.map((childModel) => childModel.tableName),
-      childVisibleFields: model.children.reduce((sum, childModel) => sum + childModel.visibleFields.length, 0),
-    },
-    note,
-  };
-}
-
-async function handleToolCall(argumentsObject) {
-  const safeArgs = ensureArguments(argumentsObject);
-  const stylePreset = getStylePreset(safeArgs.style);
-  const model = buildModel(safeArgs);
-  const sharedTemplates = resolveSharedTemplates(stylePreset);
-  const sharedSupport = prepareSharedSupport(model.frontendPath, model.dictTypes);
-  const localeZhSupport = prepareZhCnLocaleFile(model);
-
-  if (!hasRuntimeSupport(stylePreset)) {
-    const manifest = buildManifest(model, safeArgs, stylePreset, sharedTemplates, [], 'Style mapping is declared, but runtime template rendering is not implemented yet for this style.');
-    return toolTextResult(JSON.stringify(manifest, null, 2));
-  }
-
-  const files = renderFiles(model, stylePreset, sharedSupport, localeZhSupport);
-  maybeWriteFiles(files, safeArgs.writeToDisk, safeArgs.overwrite);
-  maybeWriteSharedSupport(sharedSupport, safeArgs.writeToDisk);
-  const manifest = buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, buildSupportNote(sharedSupport, localeZhSupport));
-  return toolTextResult(JSON.stringify(manifest, null, 2));
-}
-
-async function onMessage(message) {
-  const { id, method, params } = message;
-  const isNotification = id === undefined || id === null;
-
-  if (method === 'initialize') {
-    writeMessage(successResponse(id, { protocolVersion: PROTOCOL_VERSION, capabilities: { tools: {} }, serverInfo: { name: SERVER_NAME, version: SERVER_VERSION } }));
-    return;
-  }
-
-  if (method === 'notifications/initialized') return;
-
-  // Silently ignore all other notifications (no id means no response expected).
-  if (isNotification) return;
-
-  if (method === 'ping') {
-    writeMessage(successResponse(id, {}));
-    return;
-  }
-
-  if (method === 'tools/list') {
-    writeMessage(successResponse(id, { tools: [{ name: TOOL_NAME, description: 'Generate Worsoft frontend files and menu SQL from a local Markdown design file with style-based local templates. In master_child_jump mode, the caller must provide either children[] or childTableName/mainField/childField.', inputSchema: TOOL_SCHEMA }] }));
-    return;
-  }
-
-  if (method === 'tools/call') {
-    if (!params || params.name !== TOOL_NAME) {
-      writeMessage(errorResponse(id, -32602, 'Unknown tool'));
-      return;
-    }
-    try {
-      const result = await handleToolCall(params.arguments || {});
-      writeMessage(successResponse(id, result));
-    } catch (error) {
-      const errorText = error && error.details ? JSON.stringify(error.details, null, 2) : String(error.message || error);
-      writeMessage(successResponse(id, { content: [{ type: 'text', text: errorText }], isError: true }));
-    }
-    return;
-  }
-
-  writeMessage(errorResponse(id, -32601, 'Method not found'));
-}
-
-function start() {
-  process.stdin.setEncoding('utf8');
-  let buffer = '';
-  process.stdin.on('data', (chunk) => {
-    buffer += chunk;
-    let newlineIndex = buffer.indexOf('\n');
-    while (newlineIndex >= 0) {
-      const raw = buffer.slice(0, newlineIndex).trim();
-      buffer = buffer.slice(newlineIndex + 1);
-      if (raw) {
-        try {
-          const message = JSON.parse(raw);
-          Promise.resolve(onMessage(message)).catch((error) => {
-            if (message && Object.prototype.hasOwnProperty.call(message, 'id')) {
-              writeMessage(errorResponse(message.id, -32603, error.message));
-            }
-          });
-        } catch (error) {
-          writeMessage(errorResponse(null, -32700, 'Parse error: ' + error.message));
-        }
-      }
-      newlineIndex = buffer.indexOf('\n');
-    }
-  });
-}
-
-start();
+const SERVER_VERSION = '0.1.11';
+const PROTOCOL_VERSION = '2024-11-05';
+const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
+const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
+const STYLE_CATALOG_PATH = path.join(__dirname, 'assets', 'style-catalog.json');
+const DEFAULT_DESIGN_FILE = path.resolve(__dirname, '..', 'sql', 'SQL 闁荤姳鐒﹀畷姗€顢橀崫銉﹀珰閻庢稒蓱椤?md');
+const STYLE_CATALOG = loadStyleCatalog();
+const DEFAULT_DICT_REGISTRY_KEYS = {
+  add_start_stop: 'COMMON_STATUS',
+  trade_standard_type: 'TRADE_STANDARD_TYPE',
+  trade_score_standard: 'TRADE_SCORE_STANDARD',
+};
+const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
+  show: boolean;
+  alwaysHide: boolean;
+  smart: boolean;
+  labelKey: string;
+  label?: string;
+  width: string;
+  dictType?: string;
+}
+
+export interface FieldConfig {
+  key: string;
+  labelKey?: string;
+  label?: string;
+  width?: string;
+  show?: boolean;
+  alwaysHide?: boolean;
+  smart?: boolean;
+  dictType?: string;
+}
+
+export interface CrudSchemaDefinition {
+  master: FieldConfig[];
+  children?: Record<string, FieldConfig[]>;
+}
+
+export interface CrudSchema {
+  master: Record<string, FieldMeta>;
+  children: Record<string, Record<string, FieldMeta>>;
+  filterTypes: Record<string, number>;
+  childFilterTypes: Record<string, Record<string, number>>;
+  allDictTypes: string[];
+}
+
+const DEFAULT_WIDTH = '120';
+
+export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
+  show: true,
+  alwaysHide: false,
+  smart: false,
+  labelKey,
+  width,
+});
+
+export const dictField = (labelKey: string, dictType: string, width = DEFAULT_WIDTH): FieldMeta => ({
+  ...field(labelKey, width),
+  dictType,
+});
+
+export const buildFilterTypes = (fields: Record<string, FieldMeta>) =>
+  Object.fromEntries(Object.entries(fields).filter(([, item]) => item.dictType).map(([key]) => [key, 30]));
+
+export const collectDictTypes = (...groups: Array<Record<string, FieldMeta>>) =>
+  Array.from(
+    new Set(
+      groups.flatMap((group) =>
+        Object.values(group)
+          .map((item) => item.dictType)
+          .filter(Boolean) as string[]
+      )
+    )
+  );
+
+const normalizeField = (item: FieldConfig): FieldMeta => ({
+  show: item.show ?? true,
+  alwaysHide: item.alwaysHide ?? false,
+  smart: item.smart ?? false,
+  labelKey: item.labelKey ?? item.label ?? item.key,
+  ...(item.label ? { label: item.label } : {}),
+  width: item.width ?? DEFAULT_WIDTH,
+  ...(item.dictType ? { dictType: item.dictType } : {}),
+});
+
+const toFieldMap = (fields: FieldConfig[]) =>
+  Object.fromEntries(fields.map((item) => [item.key, normalizeField(item)])) as Record<string, FieldMeta>;
+
+const buildSchema = (
+  master: Record<string, FieldMeta>,
+  children: Record<string, Record<string, FieldMeta>> = {}
+): CrudSchema => ({
+  master,
+  children,
+  filterTypes: buildFilterTypes(master),
+  childFilterTypes: Object.fromEntries(
+    Object.entries(children).map(([key, fields]) => [key, buildFilterTypes(fields)])
+  ),
+  allDictTypes: collectDictTypes(master, ...Object.values(children)),
+});
+
+export function createCrudSchema(master: Record<string, FieldMeta>, children?: Record<string, Record<string, FieldMeta>>): CrudSchema;
+export function createCrudSchema(definition: CrudSchemaDefinition): CrudSchema;
+export function createCrudSchema(
+  masterOrDefinition: Record<string, FieldMeta> | CrudSchemaDefinition,
+  children: Record<string, Record<string, FieldMeta>> = {}
+): CrudSchema {
+  if ('master' in masterOrDefinition && Array.isArray(masterOrDefinition.master)) {
+    const master = toFieldMap(masterOrDefinition.master);
+    const childGroups = Object.fromEntries(
+      Object.entries(masterOrDefinition.children ?? {}).map(([key, fields]) => [key, toFieldMap(fields)])
+    ) as Record<string, Record<string, FieldMeta>>;
+    return buildSchema(master, childGroups);
+  }
+
+  return buildSchema(masterOrDefinition as Record<string, FieldMeta>, children);
+}
+`;
+
+const TOOL_SCHEMA = {
+  type: 'object',
+  properties: {
+    designFile: { type: 'string', description: 'Absolute or relative Markdown design file path. Defaults to ../sql/SQL 闁荤姳鐒﹀畷姗€顢橀崫銉﹀珰閻庢稒蓱椤?md when omitted.' },
+    tableName: { type: 'string', description: 'Target main table name from the design file.' },
+    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Style id from assets/style-catalog.json.' },
+    children: {
+      type: 'array',
+      description: 'Optional direct child-table relations for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form.',
+      items: {
+        type: 'object',
+        properties: {
+          childTableName: { type: 'string', description: 'Child table name.' },
+          mainField: { type: 'string', description: 'Main table relation field.' },
+          childField: { type: 'string', description: 'Child table relation field.' },
+          relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
+        },
+        required: ['childTableName', 'mainField', 'childField'],
+        additionalProperties: false,
+      },
+    },
+    childTableName: { type: 'string', description: 'Child table name. Required when style=master_child_jump.' },
+    mainField: { type: 'string', description: 'Main table relation field. Required when style=master_child_jump.' },
+    childField: { type: 'string', description: 'Child table relation field. Required when style=master_child_jump.' },
+    relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
+    frontendPath: { type: 'string', description: 'Absolute frontend output root path.' },
+    moduleName: { type: 'string', description: 'Relative frontend module path, for example admin/test.' },
+    writeToDisk: { type: 'boolean', default: true, description: 'Whether to write generated files.' },
+    overwrite: { type: 'boolean', default: true, description: 'Whether to overwrite existing files. If false, existing files are skipped.' },
+  },
+  required: ['tableName', 'style', 'frontendPath'],
+  additionalProperties: false,
+};
+
+function loadStyleCatalog() {
+  return JSON.parse(fs.readFileSync(STYLE_CATALOG_PATH, 'utf8'));
+}
+
+function writeMessage(payload) {
+  process.stdout.write(JSON.stringify(payload) + '\n');
+}
+
+function successResponse(id, result) {
+  return { jsonrpc: '2.0', id, result };
+}
+
+function errorResponse(id, code, message) {
+  return { jsonrpc: '2.0', id, error: { code, message } };
+}
+
+function toolTextResult(text) {
+  return { content: [{ type: 'text', text }], isError: false };
+}
+
+function toCamelCase(value) {
+  return value.replace(/_([a-zA-Z0-9])/g, (_, letter) => letter.toUpperCase());
+}
+
+function toPascalCase(value) {
+  const camel = toCamelCase(value);
+  return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+
+function normalizeModuleName(moduleName) {
+  if (!moduleName) {
+    return 'admin/test';
+  }
+  return moduleName.replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
+}
+
+function toConstantCase(value) {
+  return String(value || '')
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+    .replace(/[^a-zA-Z0-9]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .toUpperCase();
+}
+
+function parseDictRegistryEntries(fileContent) {
+  const blockMatch = String(fileContent || '').match(/export const DictRegistry\s*=\s*{([\s\S]*?)}\s*as const;/);
+  if (!blockMatch) return [];
+
+  const entries = [];
+  const entryRegex = /^\s*([A-Z0-9_]+)\s*:\s*['"]([^'"]+)['"]\s*,?\s*$/gm;
+  let match = entryRegex.exec(blockMatch[1]);
+  while (match) {
+    entries.push({ key: match[1], value: match[2] });
+    match = entryRegex.exec(blockMatch[1]);
+  }
+  return entries;
+}
+
+function renderDictRegistryContent(entries) {
+  const lines = entries.map((entry) => `  ${entry.key}: '${entry.value}',`);
+  return [
+    'export const DictRegistry = {',
+    ...lines,
+    '} as const;',
+    '',
+    'export type DictRegistryKey = keyof typeof DictRegistry;',
+    'export type DictType = (typeof DictRegistry)[DictRegistryKey];',
+    '',
+  ].join('\n');
+}
+
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function parseExportDefaultObject(fileContent) {
+  const source = String(fileContent || '').replace(/^\uFEFF/, '').trim();
+  if (!source) return null;
+  try {
+    const executable = source.replace(/^export\s+default/, 'return');
+    return new Function(executable)();
+  } catch (error) {
+    return null;
+  }
+}
+
+function deepMergeMissing(target, source) {
+  if (!isPlainObject(source)) {
+    return target === undefined ? source : target;
+  }
+
+  const result = isPlainObject(target) ? { ...target } : {};
+  for (const [key, value] of Object.entries(source)) {
+    if (result[key] === undefined) {
+      result[key] = value;
+      continue;
+    }
+    if (isPlainObject(result[key]) && isPlainObject(value)) {
+      result[key] = deepMergeMissing(result[key], value);
+    }
+  }
+  return result;
+}
+
+function escapeTsString(value) {
+  return String(value).replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+
+function renderTsLiteral(value, indentLevel = 0) {
+  const indent = '  '.repeat(indentLevel);
+  const childIndent = '  '.repeat(indentLevel + 1);
+
+  if (typeof value === 'string') {
+    return `'${escapeTsString(value)}'`;
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    if (!value.length) return '[]';
+    return ['[', ...value.map((item) => `${childIndent}${renderTsLiteral(item, indentLevel + 1)},`), `${indent}]`].join('\n');
+  }
+  if (isPlainObject(value)) {
+    const entries = Object.entries(value);
+    if (!entries.length) return '{}';
+    return [
+      '{',
+      ...entries.map(([key, item]) => {
+        const renderedKey = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : `'${escapeTsString(key)}'`;
+        return `${childIndent}${renderedKey}: ${renderTsLiteral(item, indentLevel + 1)},`;
+      }),
+      `${indent}}`,
+    ].join('\n');
+  }
+  return 'null';
+}
+
+function renderExportDefaultContent(objectValue) {
+  return `export default ${renderTsLiteral(objectValue, 0)};\n`;
+}
+
+function getPreferredDictRegistryKey(dictType) {
+  return DEFAULT_DICT_REGISTRY_KEYS[dictType] || toConstantCase(dictType) || 'DICT_TYPE';
+}
+
+function buildUniqueDictRegistryKey(dictType, usedKeys, existingByKey) {
+  const preferred = getPreferredDictRegistryKey(dictType);
+  let candidate = preferred;
+  let index = 2;
+
+  while (usedKeys.has(candidate) && existingByKey.get(candidate) !== dictType) {
+    candidate = `${preferred}_${index}`;
+    index += 1;
+  }
+
+  return candidate;
+}
+
+function buildI18nNamespaceSegments(model) {
+  return [...model.moduleName.split('/').filter(Boolean), model.functionName];
+}
+
+function buildI18nNamespace(model) {
+  return buildI18nNamespaceSegments(model).join('.');
+}
+
+function removeFeatureCommonLocaleSections(localeObject, model) {
+  if (!isPlainObject(localeObject)) {
+    return localeObject;
+  }
+
+  const segments = buildI18nNamespaceSegments(model);
+  let cursor = localeObject;
+  for (let index = 0; index < segments.length; index += 1) {
+    const segment = segments[index];
+    if (!isPlainObject(cursor[segment])) {
+      return localeObject;
+    }
+    if (index === segments.length - 1) {
+      delete cursor[segment].placeholders;
+      delete cursor[segment].actions;
+      delete cursor[segment].messages;
+      return localeObject;
+    }
+    cursor = cursor[segment];
+  }
+
+  return localeObject;
+}
+
+function buildFieldLabelKey(model, field) {
+  return `${buildI18nNamespace(model)}.fields.${field.attrName}`;
+}
+
+function buildChildFieldLabelKey(model, childModel, field) {
+  return `${buildI18nNamespace(model)}.children.${childModel.listName}.fields.${field.attrName}`;
+}
+
+function buildChildSectionTitleKey(model, childModel) {
+  return `${buildI18nNamespace(model)}.children.${childModel.listName}.title`;
+}
+
+function buildLocaleLeaf(model) {
+  const leaf = {
+    title: model.tableComment,
+    fields: Object.fromEntries(model.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+  };
+
+  if (model.children.length) {
+    leaf.children = Object.fromEntries(
+      model.children.map((childModel) => [
+        childModel.listName,
+        {
+          title: childModel.tableComment,
+          fields: Object.fromEntries(childModel.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+        },
+      ])
+    );
+  }
+
+  return leaf;
+}
+
+function buildZhCnLocaleObject(model) {
+  const root = {};
+  const segments = buildI18nNamespaceSegments(model);
+  let cursor = root;
+
+  for (let index = 0; index < segments.length - 1; index += 1) {
+    const segment = segments[index];
+    cursor[segment] = cursor[segment] || {};
+    cursor = cursor[segment];
+  }
+
+  cursor[segments[segments.length - 1]] = buildLocaleLeaf(model);
+  return root;
+}
+
+function prepareZhCnLocaleFile(model) {
+  const localePath = path.join(model.frontendPath, 'src', 'i18n', 'biz', ...model.moduleName.split('/'), `${model.functionName}.zh-cn.ts`);
+  const exists = fs.existsSync(localePath);
+  const currentContent = exists ? readUtf8File(localePath) : '';
+  const currentObject = exists ? parseExportDefaultObject(currentContent) : null;
+  const generatedObject = buildZhCnLocaleObject(model);
+  const isCompatible = !exists || isPlainObject(currentObject);
+  const sanitizedCurrentObject = isCompatible ? removeFeatureCommonLocaleSections(currentObject || {}, model) : null;
+  const mergedObject = isCompatible ? deepMergeMissing(sanitizedCurrentObject || {}, generatedObject) : null;
+
+  return {
+    path: localePath,
+    frontendPath: model.frontendPath,
+    exists,
+    isCompatible,
+    namespace: buildI18nNamespace(model),
+    content: mergedObject ? renderExportDefaultContent(mergedObject) : '',
+    needsWrite: !exists || (isCompatible && renderExportDefaultContent(currentObject || {}) !== renderExportDefaultContent(mergedObject)),
+  };
+}
+
+function prepareDictRegistry(frontendPath, dictTypes) {
+  const registryPath = path.join(frontendPath, 'src', 'enums', 'dict-registry.ts');
+  const exists = fs.existsSync(registryPath);
+  const existingEntries = exists ? parseDictRegistryEntries(readUtf8File(registryPath)) : [];
+  const entries = existingEntries.map((entry) => ({ ...entry }));
+  const keyByValue = new Map(entries.map((entry) => [entry.value, entry.key]));
+  const existingByKey = new Map(entries.map((entry) => [entry.key, entry.value]));
+  const usedKeys = new Set(entries.map((entry) => entry.key));
+  let changed = !exists;
+
+  for (const dictType of dictTypes) {
+    if (!dictType || keyByValue.has(dictType)) continue;
+    const key = buildUniqueDictRegistryKey(dictType, usedKeys, existingByKey);
+    entries.push({ key, value: dictType });
+    keyByValue.set(dictType, key);
+    existingByKey.set(key, dictType);
+    usedKeys.add(key);
+    changed = true;
+  }
+
+  return {
+    path: registryPath,
+    entries,
+    keyByValue,
+    needsWrite: changed,
+  };
+}
+
+function ensureCrudSchemaSupportFile(frontendPath) {
+  const schemaPath = path.join(frontendPath, 'src', 'utils', 'crudSchema.ts');
+  const exists = fs.existsSync(schemaPath);
+  const currentContent = exists ? readUtf8File(schemaPath) : '';
+  const hasCoreShape =
+    currentContent.includes('export interface CrudSchemaDefinition') &&
+    currentContent.includes('export function createCrudSchema') &&
+    currentContent.includes('export interface FieldConfig');
+  const supportsLabelKey = currentContent.includes('labelKey');
+  const shouldUpgradeLegacy = exists && hasCoreShape && !supportsLabelKey;
+
+  return {
+    path: schemaPath,
+    content: DEFAULT_CRUD_SCHEMA_TEMPLATE,
+    exists,
+    isCompatible: hasCoreShape && supportsLabelKey,
+    needsWrite: !exists || shouldUpgradeLegacy,
+  };
+}
+
+function ensureDirectory(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function writeSupportFile(filePath, content) {
+  ensureDirectory(filePath);
+  fs.writeFileSync(filePath, content, 'utf8');
+}
+
+function prepareSharedSupport(frontendPath, dictTypes) {
+  const normalizedDictTypes = [...new Set((dictTypes || []).filter(Boolean))];
+  const dictRegistry = prepareDictRegistry(frontendPath, normalizedDictTypes);
+  const crudSchema = ensureCrudSchemaSupportFile(frontendPath);
+  return {
+    dictRegistry,
+    crudSchema,
+  };
+}
+
+function maybeWriteSharedSupport(sharedSupport, writeToDisk) {
+  if (!writeToDisk) return;
+
+  if (sharedSupport.crudSchema.needsWrite) {
+    writeSupportFile(sharedSupport.crudSchema.path, sharedSupport.crudSchema.content);
+  }
+
+  if (sharedSupport.dictRegistry.needsWrite) {
+    writeSupportFile(sharedSupport.dictRegistry.path, renderDictRegistryContent(sharedSupport.dictRegistry.entries));
+  }
+}
+
+function buildSupportNote(sharedSupport, localeZhSupport) {
+  const notes = [];
+
+  if (sharedSupport.crudSchema.exists && !sharedSupport.crudSchema.isCompatible) {
+    notes.push(
+      'Detected an existing src/utils/crudSchema.ts that does not match the expected helper signature. ' +
+        'MCP preserved the existing file and did not overwrite it. Generated pages now depend on that file being manually aligned.'
+    );
+  }
+
+  if (localeZhSupport.exists && !localeZhSupport.isCompatible) {
+    notes.push(
+      `Detected an existing ${path.relative(localeZhSupport.frontendPath, localeZhSupport.path).replace(/\\/g, '/')} that MCP could not parse. ` +
+        'The file was preserved and not updated, so new Chinese i18n keys may need to be merged manually.'
+    );
+  }
+
+  return notes.length ? notes.join(' ') : 'Runtime template rendering completed.';
+}
+
+function getDictRegistryReference(dictType, keyByValue) {
+  if (!dictType) return '';
+  const key = keyByValue.get(dictType) || getPreferredDictRegistryKey(dictType);
+  return `DictRegistry.${key}`;
+}
+
+function isAuditField(fieldName) {
+  return [
+    'id',
+    'tenant_id',
+    'version',
+    'create_time',
+    'update_time',
+    'create_user_id',
+    'update_user_id',
+    'create_user',
+    'update_user',
+    'create_pos_id',
+    'create_pos',
+    'create_dpt_id',
+    'create_dpt',
+    'create_ogn_id',
+    'create_ogn',
+    'create_psm_full_id',
+    'create_psm_full_name',
+    'update_psm_full_id',
+    'update_psm_full_name',
+    'del_flag',
+  ].includes(fieldName);
+}
+
+function findDictType(comment) {
+  return extractDictType(comment);
+  const match = comment.match(/(?:闁诲孩绋掗〃鍛村触閳х憢dict)[闂?\s]*([a-zA-Z0-9_]+)/i);
+}
+
+function mapFieldType(field) {
+  if (field.dictType) return 'select';
+  if (field.sqlType === 'DATETIME' || field.sqlType === 'TIMESTAMP') return 'datetime';
+  if (field.sqlType === 'DATE') return 'date';
+  if (['INT', 'BIGINT', 'DECIMAL', 'NUMERIC'].includes(field.sqlType)) return 'number';
+  if (field.sqlType === 'TEXT') return 'textarea';
+  if (field.sqlType === 'VARCHAR' && field.length && Number(field.length) > 64) return 'textarea';
+  return 'text';
+}
+
+function escapeForRegex(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function stripBom(text) {
+  return text.replace(/^\uFEFF/, '');
+}
+
+function readUtf8File(filePath) {
+  return stripBom(fs.readFileSync(filePath, 'utf8'));
+}
+
+function normalizeDictType(value) {
+  const normalized = String(value || '').trim();
+  if (!normalized || normalized === '-' || normalized === '/') {
+    return null;
+  }
+  return normalized.replace(/^['"`]+|['"`]+$/g, '');
+}
+
+function stripDictAnnotation(label) {
+  const text = String(label || '').trim();
+  if (!text) {
+    return '';
+  }
+  return text
+    .replace(/\s*[\(（][^()（）]*?(?:字典|dict)(?:[_\s-]*type)?[^()（）]*?[\)）]\s*/gi, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function extractDictType(text) {
+  const normalized = String(text || '').trim();
+  if (!normalized) {
+    return null;
+  }
+
+  const patterns = [
+    /(?:鐎涙鍚€|dict)(?:[_\s-]*type)?\s*[:閿涙瓥\s*([a-zA-Z0-9_-]+)/i,
+    /[\(閿涘溈\s*(?:鐎涙鍚€|dict)(?:[_\s-]*type)?\s*[:閿涙瓥?\s*([a-zA-Z0-9_-]+)\s*[\)閿涘、/i,
+  ];
+
+  for (const pattern of patterns) {
+    const match = normalized.match(pattern);
+    if (match && match[1]) {
+      return normalizeDictType(match[1]);
+    }
+  }
+
+  return null;
+}
+
+function resolveDictType(comment, explicitDictType) {
+  return normalizeDictType(explicitDictType) || extractDictType(comment);
+}
+
+function detectDictType(comment) {
+  return extractDictType(comment);
+}
+
+function splitLength(value) {
+  const normalized = String(value || '').trim();
+  if (!normalized || normalized === '-' || normalized === '/') {
+    return { length: '', scale: '' };
+  }
+  const parts = normalized.split(',').map((item) => item.trim()).filter(Boolean);
+  return { length: parts[0] || '', scale: parts[1] || '' };
+}
+
+function normalizeDefaultValue(value) {
+  const normalized = String(value || '').trim();
+  if (!normalized || normalized === '-' || normalized === '/') {
+    return '';
+  }
+  return normalized;
+}
+
+function parseRequiredFlag(value) {
+  const normalized = String(value || '').trim().toLowerCase();
+  return ['闂?, 'y', 'yes', '1', 'true', '闂婎偄娲ら幊搴ㄦ晲?].includes(normalized);
+}
+
+function parseMarkdownRow(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('|')) return [];
+  return trimmed
+    .slice(1, trimmed.endsWith('|') ? -1 : undefined)
+    .split('|')
+    .map((cell) => cell.trim());
+}
+
+function isMarkdownSeparatorRow(cells) {
+  return cells.length > 0 && cells.every((cell) => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, '')));
+}
+
+function findHeaderIndex(headers, patterns) {
+  return headers.findIndex((header) => patterns.some((pattern) => pattern.test(header)));
+}
+
+function findPrimaryKeyFromText(text, fields) {
+  const quotedMatch = text.match(/PRIMARY\s+KEY\s*\(\s*`?([a-zA-Z0-9_]+)`?\s*\)/i);
+  if (quotedMatch) {
+    return quotedMatch[1];
+  }
+
+  const commentPk = fields.find((field) => /婵炴垶鎸搁…鐑藉极?i.test(field.comment));
+  if (commentPk) {
+    return commentPk.fieldName;
+  }
+
+  const idField = fields.find((field) => field.fieldName === 'id');
+  if (idField) {
+    return idField.fieldName;
+  }
+
+  return fields[0] ? fields[0].fieldName : null;
+}
+
+function parseMarkdownTableSection(tableName, tableComment, sectionLines) {
+  const firstTableLineIndex = sectionLines.findIndex((line) => line.trim().startsWith('|'));
+  if (firstTableLineIndex < 0) {
+    throw new Error('Could not find markdown field table for ' + tableName);
+  }
+
+  const tableLines = [];
+  for (let index = firstTableLineIndex; index < sectionLines.length; index += 1) {
+    const line = sectionLines[index].trim();
+    if (!line.startsWith('|')) break;
+    tableLines.push(line);
+  }
+
+  const rows = tableLines.map(parseMarkdownRow).filter((cells) => cells.length > 0);
+  if (rows.length < 3) {
+    throw new Error('Markdown field table is incomplete for ' + tableName);
+  }
+
+  const headers = rows[0];
+  const dataRows = rows.slice(1).filter((cells) => !isMarkdownSeparatorRow(cells));
+  const fieldNameIndex = findHeaderIndex(headers, [/闁诲孩绋掗〃鍡涱敊瀹€鍕Е?, /闂佸憡甯楅〃鍛村箖?i, /field/i]);
+  const sqlTypeIndex = findHeaderIndex(headers, [/缂備緡鍋夐褔鎮?, /闂佽桨鑳舵晶妤€鐣垫担铏瑰暗閻犲洩灏欓埀?, /type/i]);
+  const lengthIndex = findHeaderIndex(headers, [/闂傚倵鍋撻柛顭戝枛椤?, /缂備緡鍠楅崕宕団偓?, /length/i]);
+  const requiredIndex = findHeaderIndex(headers, [/闂婎偄娲ら幊搴ㄦ晲?, /闂婎偄娲ら幊鎾舵?, /required/i]);
+  const defaultIndex = findHeaderIndex(headers, [/婵帗绋掗…鍫ヮ敇?, /default/i]);
+  const commentIndex = findHeaderIndex(headers, [/闁荤姴娲ら悺銊ノ?, /婵犮垼娉涘ú锕傚极?, /comment/i]);
+
+  const dictTypeIndex = findHeaderIndex(headers, [/闁诲孩绋掗〃鍛村触閳?, /dict/i, /dict_?type/i]);
+
+  if (fieldNameIndex < 0 || sqlTypeIndex < 0) {
+    throw new Error('Markdown field table headers are missing required columns for ' + tableName);
+  }
+
+  const fields = [];
+  for (const row of dataRows) {
+    const fieldName = String(row[fieldNameIndex] || '').trim();
+    if (!fieldName || fieldName === '-') continue;
+
+    const sqlType = String(row[sqlTypeIndex] || '').trim().toUpperCase();
+    if (!sqlType) continue;
+
+    const lengthRaw = lengthIndex >= 0 ? row[lengthIndex] : '';
+    const comment = String(commentIndex >= 0 ? row[commentIndex] : '').trim() || fieldName;
+    const explicitDictType = dictTypeIndex >= 0 ? row[dictTypeIndex] : '';
+    const { length, scale } = splitLength(lengthRaw);
+
+    fields.push({
+      fieldName,
+      attrName: toCamelCase(fieldName),
+      sqlType,
+      length,
+      scale,
+      comment,
+      dictType: resolveDictType(comment, explicitDictType),
+      notNull: requiredIndex >= 0 ? parseRequiredFlag(row[requiredIndex]) : false,
+      defaultValue: defaultIndex >= 0 ? normalizeDefaultValue(row[defaultIndex]) : '',
+    });
+  }
+
+  if (!fields.length) {
+    throw new Error('No fields were parsed from markdown table ' + tableName);
+  }
+
+  const sectionText = sectionLines.join('\n');
+  const pkName = findPrimaryKeyFromText(sectionText, fields);
+  const pkField = fields.find((field) => field.fieldName === pkName) || fields[0];
+  return { pkField, fields, tableComment };
+}
+
+function parseMarkdownDesignTables(markdownText) {
+  const lines = stripBom(markdownText).replace(/\r\n?/g, '\n').split('\n');
+  const tables = new Map();
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const heading = lines[index].trim();
+    const headingMatch = heading.match(/^###\s+\S+\s+([a-zA-Z0-9_]+)\s*[\(闂佹寧绋戝┃?[^)\n闂佹寧绋戦妴?)[\)闂佹寧绋戦妴?);
+    if (!headingMatch) continue;
+
+    const tableName = headingMatch[1];
+    const tableComment = headingMatch[2].trim();
+    const sectionLines = [];
+    let nextIndex = index + 1;
+    while (nextIndex < lines.length && !/^(##|###)\s+/.test(lines[nextIndex])) {
+      sectionLines.push(lines[nextIndex]);
+      nextIndex += 1;
+    }
+
+    tables.set(tableName, parseMarkdownTableSection(tableName, tableComment, sectionLines));
+    index = nextIndex - 1;
+  }
+
+  return tables;
+}
+
+function extractIdentifiersFromLine(line) {
+  return [...String(line || '').matchAll(/`?([a-zA-Z][a-zA-Z0-9_]*)`?/g)].map((match) => match[1]);
+}
+
+function stripMarkdownSyntax(text) {
+  return String(text || '')
+    .replace(/\*\*/g, '')
+    .replace(/`/g, '')
+    .replace(/\r\n?/g, '\n');
+}
+
+function parseMarkdownRelations(markdownText) {
+  const text = stripMarkdownSyntax(markdownText);
+  const blocks = [];
+  const headingRegex = /^(###|####)\s+(.+)$/gm;
+  let current = null;
+  let match = headingRegex.exec(text);
+
+  while (match) {
+    if (current) {
+      current.body = text.slice(current.start, match.index);
+      blocks.push(current);
+    }
+
+    current = {
+      title: match[2].trim(),
+      start: headingRegex.lastIndex,
+      body: '',
+    };
+    match = headingRegex.exec(text);
+  }
+
+  if (current) {
+    current.body = text.slice(current.start);
+    blocks.push(current);
+  }
+
+  const relations = [];
+  for (const block of blocks) {
+    const lines = block.body.split('\n').map((line) => line.trim()).filter(Boolean);
+    const mainLine = lines.find((line) => /(婵炴垶鎸诲Σ鎺楀Υ閸庡嫰鏌ｉ弽銊ュ姸闁?\s*[:闂佹寧绋掗悺?.test(line));
+    const childLine = lines.find((line) => /(婵炲濮村锕傚Υ閸庡嫰鎮楀☉娆忓闁?\s*[:闂佹寧绋掗悺?.test(line));
+    const fieldLine = lines.find((line) => /闂佺绻愰悿鍥ㄧ閸懇鍋撳☉娆樻畷妞ゆ柨顒竤*[:闂佹寧绋掗悺?.test(line));
+    if (!mainLine || !childLine || !fieldLine) continue;
+
+    const mainIdentifiers = extractIdentifiersFromLine(mainLine);
+    const childIdentifiers = extractIdentifiersFromLine(childLine);
+    const fieldIdentifiers = extractIdentifiersFromLine(fieldLine);
+    if (!mainIdentifiers.length || !childIdentifiers.length || fieldIdentifiers.length < 2) continue;
+
+    const relationTypeLine = lines.find((line) => /闂佺绻愮壕顓㈡焾鐎靛摜灏甸悹鍥皺閳ь剛锕*[:闂佹寧绋掗悺?.test(line));
+    relations.push({
+      title: block.title,
+      mainTableName: mainIdentifiers[0],
+      childTableName: childIdentifiers[0],
+      childField: fieldIdentifiers[0],
+      mainField: fieldIdentifiers[1],
+      relationType: relationTypeLine ? relationTypeLine.split(/[:闂佹寧绋掗悺?).slice(1).join(':').trim() : '',
+    });
+  }
+
+  return relations;
+}
+
+function parseMarkdownDesignFile(markdownText) {
+  return {
+    tables: parseMarkdownDesignTables(markdownText),
+    relations: [],
+  };
+}
+
+function parseTableFromMarkdownDesign(designDoc, tableName) {
+  const parsed = designDoc.tables.get(tableName);
+  if (!parsed) {
+    throw new Error('Could not find table definition for ' + tableName + ' in Markdown design file');
+  }
+  return parsed;
+}
+
+function buildQuestionMarkSegmentRegex(segment) {
+  return new RegExp('^' + escapeForRegex(segment).replace(/\\\?/g, '.') + '$', 'i');
+}
+
+function tryResolveGarbledPath(resolvedPath) {
+  if (!resolvedPath.includes('?')) {
+    return null;
+  }
+
+  const parsed = path.parse(resolvedPath);
+  const segments = resolvedPath.slice(parsed.root.length).split(path.sep).filter(Boolean);
+  let currentPath = parsed.root;
+
+  for (const segment of segments) {
+    const exactPath = path.join(currentPath, segment);
+    if (fs.existsSync(exactPath)) {
+      currentPath = exactPath;
+      continue;
+    }
+
+    if (!segment.includes('?') || !fs.existsSync(currentPath) || !fs.statSync(currentPath).isDirectory()) {
+      return null;
+    }
+
+    const matcher = buildQuestionMarkSegmentRegex(segment);
+    const matches = fs.readdirSync(currentPath).filter((name) => matcher.test(name));
+    if (matches.length !== 1) {
+      throw new Error(
+        'Source file path could not be resolved uniquely from garbled input: ' +
+          resolvedPath +
+          '. Matched entries: ' +
+          (matches.length ? matches.join(', ') : 'none')
+      );
+    }
+
+    currentPath = path.join(currentPath, matches[0]);
+  }
+
+  return fs.existsSync(currentPath) ? currentPath : null;
+}
+
+function resolveSourcePath(inputPath) {
+  const resolvedPath = path.resolve(inputPath);
+  if (fs.existsSync(resolvedPath)) {
+    return resolvedPath;
+  }
+
+  const recoveredPath = tryResolveGarbledPath(resolvedPath);
+  if (recoveredPath) {
+    return recoveredPath;
+  }
+
+  throw new Error('Source file does not exist: ' + resolvedPath);
+}
+
+function formatRelationCandidate(relation) {
+  return {
+    childTableName: relation.childTableName,
+    mainField: relation.mainField,
+    childField: relation.childField,
+    relationType: relation.relationType || '',
+  };
+}
+
+function getRelationCandidates(designDoc, tableName) {
+  return designDoc.relations
+    .filter((relation) => relation.mainTableName === tableName)
+    .map(formatRelationCandidate);
+}
+
+function buildRetryArguments(safeArgs, sourceFile, childTableName) {
+  const retryArguments = {
+    tableName: safeArgs.tableName,
+    style: safeArgs.style,
+    frontendPath: safeArgs.frontendPath,
+    moduleName: safeArgs.moduleName,
+    writeToDisk: safeArgs.writeToDisk,
+    overwrite: safeArgs.overwrite,
+  };
+
+  if (sourceFile) {
+    retryArguments.designFile = sourceFile;
+  }
+
+  if (safeArgs.children && safeArgs.children.length) {
+    retryArguments.children = safeArgs.children.map((relation) => ({
+      childTableName: relation.childTableName,
+      mainField: relation.mainField,
+      childField: relation.childField,
+      relationType: relation.relationType || '',
+    }));
+  }
+
+  if (childTableName) {
+    retryArguments.childTableName = childTableName;
+  }
+
+  if (safeArgs.mainField) {
+    retryArguments.mainField = safeArgs.mainField;
+  }
+
+  if (safeArgs.childField) {
+    retryArguments.childField = safeArgs.childField;
+  }
+
+  if (safeArgs.relationType) {
+    retryArguments.relationType = safeArgs.relationType;
+  }
+
+  return retryArguments;
+}
+
+function buildRelationCorrectionEntry(safeArgs, sourceFile, candidates, selectedChildTableName) {
+  return {
+    field: 'childTableName',
+    title: '婵炴垶鎹侀褔鎮哄▎鎴炲仒闁靛鍎辫ぐ鐘绘煠鏉堛劍鐓ｉ柟渚垮妼椤垽鏁愰崨顓炴辈闂?,
+    tableName: safeArgs.tableName,
+    style: safeArgs.style,
+    designFile: sourceFile,
+    description: candidates.length
+      ? 'If the current child relation is not the one you want, pass childTableName to choose a candidate from the design file.'
+      : 'No child relation was found. Check the 婵炴垶鎹侀濠勫垝閻樺灚鍋橀柕濞垮劚瑜扮娀鏌ゆ潏銊︻梿妞ゆ洍鏅犲?section in the design file.',
+    currentValue: selectedChildTableName || '',
+    options: candidates.map((item) => item.childTableName),
+    candidates,
+    example: candidates.length ? buildRetryArguments(safeArgs, sourceFile, candidates[0].childTableName) : buildRetryArguments(safeArgs, sourceFile, selectedChildTableName),
+    retryArguments: candidates.map((item) => buildRetryArguments(safeArgs, sourceFile, item.childTableName)),
+  };
+}
+
+function createRelationResolutionError(message, safeArgs, sourceFile, candidates, selectedChildTableName, status) {
+  const error = new Error(message);
+  error.details = {
+    type: 'relation_resolution',
+    status,
+    tableName: safeArgs.tableName,
+    designFile: sourceFile,
+    message,
+    candidates,
+    correctionEntry: buildRelationCorrectionEntry(safeArgs, sourceFile, candidates, selectedChildTableName),
+  };
+  return error;
+}
+
+function loadSourceDocument(safeArgs) {
+  const inputPath = safeArgs.designFile || DEFAULT_DESIGN_FILE;
+  const sourcePath = resolveSourcePath(inputPath);
+  const text = readUtf8File(sourcePath);
+  return {
+    path: sourcePath,
+    text,
+    designDoc: parseMarkdownDesignFile(text),
+  };
+}
+
+function normalizeChildrenInput(inputChildren) {
+  if (inputChildren === undefined || inputChildren === null) {
+    return [];
+  }
+  if (!Array.isArray(inputChildren)) {
+    throw new Error('children must be an array');
+  }
+  return inputChildren.map((item, index) => {
+    if (!item || typeof item !== 'object') {
+      throw new Error('children[' + index + '] must be an object');
+    }
+    const childTableName = item.childTableName ? String(item.childTableName) : '';
+    const mainField = item.mainField ? String(item.mainField) : '';
+    const childField = item.childField ? String(item.childField) : '';
+    const relationType = item.relationType ? String(item.relationType) : '';
+    const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !({ childTableName, mainField, childField })[field]);
+    if (missingFields.length) {
+      throw new Error('children[' + index + '] is missing required fields: ' + missingFields.join(', '));
+    }
+    return { childTableName, mainField, childField, relationType };
+  });
+}
+
+function resolveMarkdownChildRelations(sourceDocument, safeArgs) {
+  if (safeArgs.children && safeArgs.children.length) {
+    return safeArgs.children.map((relation) => ({
+      mainTableName: safeArgs.tableName,
+      childTableName: relation.childTableName,
+      mainField: relation.mainField,
+      childField: relation.childField,
+      relationType: relation.relationType || '',
+    }));
+  }
+
+  const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !safeArgs[field]);
+  if (missingFields.length) {
+    const message = 'master_child_jump requires either children[] or legacy relation fields. Missing: ' + missingFields.join(', ') + '.';
+    const error = new Error(message);
+    error.details = {
+      type: 'relation_input_required',
+      status: 'missing_required_relation_input',
+      tableName: safeArgs.tableName,
+      designFile: sourceDocument.path,
+      message,
+      requiredFields: ['children[] or childTableName/mainField/childField'],
+      correctionEntry: {
+        fields: ['children', 'childTableName', 'mainField', 'childField'],
+        example: {
+          ...buildRetryArguments(safeArgs, sourceDocument.path, safeArgs.childTableName || '<child_table_name>'),
+          children: [
+            {
+              childTableName: safeArgs.childTableName || '<child_table_name>',
+              mainField: safeArgs.mainField || '<main_field>',
+              childField: safeArgs.childField || '<child_field>',
+              relationType: safeArgs.relationType || '1:N',
+            },
+          ],
+          mainField: safeArgs.mainField || '<main_field>',
+          childField: safeArgs.childField || '<child_field>',
+        },
+      },
+    };
+    throw error;
+  }
+
+  return [
+    {
+      mainTableName: safeArgs.tableName,
+      childTableName: safeArgs.childTableName,
+      mainField: safeArgs.mainField,
+      childField: safeArgs.childField,
+      relationType: safeArgs.relationType || '',
+    },
+  ];
+}
+
+function getStylePreset(styleId) {
+  const preset = STYLE_CATALOG[styleId];
+  if (!preset) throw new Error('Unsupported style: ' + styleId);
+  return preset;
+}
+
+function resolveSharedTemplates(stylePreset) {
+  const selected = {};
+  for (const [kind, templateName] of Object.entries(stylePreset.templateFiles || {})) {
+    const templatePath = path.join(TEMPLATE_LIBRARY_ROOT, templateName);
+    selected[kind] = { name: templateName, path: templatePath, exists: fs.existsSync(templatePath) };
+  }
+  return selected;
+}
+
+function hasRuntimeSupport(stylePreset) {
+  return Boolean(stylePreset.runtime && stylePreset.runtime.supported && stylePreset.runtime.templateDir);
+}
+
+function normalizeFields(parsed) {
+  return parsed.fields.map((field) => ({ ...field, formType: mapFieldType(field), isAudit: isAuditField(field.fieldName) }));
+}
+
+function ensureFieldExists(fields, fieldName, tableName, role) {
+  const field = fields.find((item) => item.fieldName === fieldName);
+  if (!field) throw new Error(role + ' field "' + fieldName + '" was not found on table ' + tableName);
+  return field;
+}
+
+function buildChildModels(sourceDocument, safeArgs, mainParsed) {
+  if (safeArgs.style !== 'master_child_jump') return [];
+
+  const relations = resolveMarkdownChildRelations(sourceDocument, safeArgs);
+  return relations.map((relation) => {
+    const childParsed = parseTableFromMarkdownDesign(sourceDocument.designDoc, relation.childTableName);
+    const childFields = normalizeFields(childParsed);
+    const mainRelationField = ensureFieldExists(mainParsed.fields, relation.mainField, safeArgs.tableName, 'Main relation');
+    const childRelationField = ensureFieldExists(childParsed.fields, relation.childField, relation.childTableName, 'Child relation');
+    const childVisibleFields = childFields.filter(
+      (field) => field.fieldName !== childParsed.pkField.fieldName && !field.isAudit && field.fieldName !== relation.childField
+    );
+
+    return {
+      tableName: relation.childTableName,
+      tableComment: childParsed.tableComment,
+      className: toPascalCase(relation.childTableName),
+      functionName: toCamelCase(relation.childTableName),
+      listName: toCamelCase(relation.childTableName) + 'List',
+      pk: childParsed.pkField,
+      fields: childFields,
+      visibleFields: childVisibleFields,
+      mainField: mainRelationField,
+      childField: childRelationField,
+      relationType: relation.relationType,
+    };
+  });
+}
+
+function buildModel(safeArgs) {
+  const sourceDocument = loadSourceDocument(safeArgs);
+  const mainParsed = parseTableFromMarkdownDesign(sourceDocument.designDoc, safeArgs.tableName);
+  const fields = normalizeFields(mainParsed);
+  const visibleFields = fields.filter((field) => field.fieldName !== mainParsed.pkField.fieldName && !field.isAudit);
+  const gridFields = visibleFields.slice(0, 8);
+  const children = buildChildModels(sourceDocument, safeArgs, mainParsed);
+  const childDictTypes = children.flatMap((child) => child.visibleFields.map((field) => field.dictType).filter(Boolean));
+  const dictTypes = [...new Set([...visibleFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
+
+  return {
+    sourceFile: sourceDocument.path,
+    designFile: sourceDocument.path,
+    tableName: safeArgs.tableName,
+    tableComment: mainParsed.tableComment,
+    className: toPascalCase(safeArgs.tableName),
+    functionName: toCamelCase(safeArgs.tableName),
+    moduleName: normalizeModuleName(safeArgs.moduleName),
+    pk: mainParsed.pkField,
+    fields,
+    visibleFields,
+    gridFields,
+    dictTypes,
+    frontendPath: path.resolve(safeArgs.frontendPath),
+    style: safeArgs.style,
+    children,
+  };
+}
+
+function renderTemplate(templateText, replacements) {
+  let output = templateText;
+  for (const [key, value] of Object.entries(replacements)) {
+    output = output.split('{{' + key + '}}').join(String(value));
+  }
+  return output;
+}
+
+function renderFormField(field) {
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  const prop = field.attrName;
+
+  if (field.formType === 'select') {
+    return [
+      '          <el-col :span="12" class="mb20">',
+      `            <el-form-item label="${label}" prop="${prop}">`,
+      `              <el-select v-model="form.${prop}" placeholder="闁荤姴娲ㄩ崗姗€鍩€椤掆偓椤︽壆鈧?{label}" style="width: 100%">`,
+      `                <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      '              </el-select>',
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'number') {
+    const max = field.comment.includes('%') || field.comment.includes('濠殿噯绲鹃弻褏娆?) ? ' :max="100"' : '';
+    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
+    return [
+      '          <el-col :span="12" class="mb20">',
+      `            <el-form-item label="${label}" prop="${prop}">`,
+      `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} placeholder="闁荤姴娲ㄩ弻澶屾椤撱垹绀?{label}" style="width: 100%" />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'datetime' || field.formType === 'date') {
+    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
+    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
+    return [
+      '          <el-col :span="12" class="mb20">',
+      `            <el-form-item label="${label}" prop="${prop}">`,
+      `              <el-date-picker type="${pickerType}" placeholder="闁荤姴娲ㄩ崗姗€鍩€椤掆偓椤︽壆鈧?{label}" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"></el-date-picker>`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'textarea') {
+    return [
+      '          <el-col :span="24" class="mb20">',
+      `            <el-form-item label="${label}" prop="${prop}">`,
+      `              <el-input type="textarea" v-model="form.${prop}" placeholder="闁荤姴娲ㄩ弻澶屾椤撱垹绀?{label}" />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  return [
+    '          <el-col :span="12" class="mb20">',
+    `            <el-form-item label="${label}" prop="${prop}">`,
+    `              <el-input v-model="form.${prop}" placeholder="闁荤姴娲ㄩ弻澶屾椤撱垹绀?{label}" />`,
+    '            </el-form-item>',
+    '          </el-col>',
+  ].join('\n');
+}
+
+function renderTableColumn(field) {
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  if (field.dictType) {
+    return [
+      `        <el-table-column prop="${field.attrName}" label="${label}" show-overflow-tooltip>`,
+      '          <template #default="scope">',
+      `            <dict-tag :options="${field.dictType}" :value="scope.row.${field.attrName}" />`,
+      '          </template>',
+      '        </el-table-column>',
+    ].join('\n');
+  }
+  return `        <el-table-column prop="${field.attrName}" label="${label}" show-overflow-tooltip />`;
+}
+
+function renderChildTableColumn(field, childListName) {
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  const rules = field.notNull ? ` :rules="[{ required: true, trigger: 'blur' }]"` : '';
+
+  let control = `                  <el-input v-model="row.${field.attrName}" />`;
+  if (field.formType === 'select' && field.dictType) {
+    control = [
+      `                  <el-select v-model="row.${field.attrName}" placeholder="闁荤姴娲ㄩ崗姗€鍩€椤掆偓椤︽壆鈧?{label}" style="width: 100%">`,
+      `                    <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      '                  </el-select>',
+    ].join('\n');
+  } else if (field.formType === 'number') {
+    const max = field.comment.includes('%') || field.comment.includes('濠殿噯绲鹃弻褏娆?) ? ' :max="100"' : '';
+    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
+    control = `                  <el-input-number v-model="row.${field.attrName}" :min="0"${max}${precision} style="width: 100%" />`;
+  }
+
+  return [
+    `            <el-table-column label="${label}" prop="${field.attrName}">`,
+    '              <template #default="{ row, $index }">',
+    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
+    control,
+    '                </el-form-item>',
+    '              </template>',
+    '            </el-table-column>',
+  ].join('\n');
+}
+
+function renderOptionField(field) {
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  return `  ${field.attrName}: { show:true, alwaysHide:false, smart:false, label: '${label}', width: '120' },`;
+}
+
+function renderFilterType(field) {
+  if (!field.dictType) return null;
+  return `  ${field.attrName}: 30,`;
+}
+
+function renderDefaultLine(field) {
+  if (field.formType === 'number') return `  ${field.attrName}: 0,`;
+  return `  ${field.attrName}: '',`;
+}
+
+function renderFormDefaults(model) {
+  const lines = [`  ${model.pk.attrName}: '',`];
+  for (const field of model.visibleFields) lines.push(renderDefaultLine(field));
+  return lines.join('\n');
+}
+
+function renderChildTempDefaults(childModel) {
+  if (!childModel) return '';
+  return childModel.fields.map(renderDefaultLine).join('\n');
+}
+
+function renderChildListDefaultLine(childModel) {
+  return `  ${childModel.listName}: [],`;
+}
+
+function renderChildTempDeclaration(childModel) {
+  return [
+    `const childTemp${childModel.className} = reactive({`,
+    renderChildTempDefaults(childModel),
+    '});',
+  ].join('\n');
+}
+
+function renderChildSection(childModel, childCount) {
+  const title = childModel.tableComment.replace(/'/g, "\\'");
+  const deleteExpression =
+    childCount > 1
+      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
+      : `deleteChild(obj, '${childModel.pk.attrName}')`;
+
+  return [
+    '          <el-col :span="24" class="mb20">',
+    `            <div class="mb10" style="font-weight: 600;">${title}</div>`,
+    `            <sc-form-table v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')">`,
+    childModel.visibleFields.map((field) => renderChildTableColumn(field, childModel.listName)).join('\n'),
+    '            </sc-form-table>',
+    '          </el-col>',
+  ].join('\n');
+}
+
+function renderChildFormListDefaults(children) {
+  if (!children.length) return '';
+  return children.map(renderChildListDefaultLine).join('\n');
+}
+
+function renderChildTempDeclarations(children) {
+  if (!children.length) return '';
+  return children.map(renderChildTempDeclaration).join('\n\n');
+}
+
+function renderChildResetListLines(children) {
+  if (!children.length) return '';
+  return children.map((childModel) => `    form.${childModel.listName} = [];`).join('\n');
+}
+
+function renderDictImportBlock(dictTypes) {
+  if (!dictTypes.length) return '';
+  return [
+    "import { useDict } from '/@/hooks/dict';",
+    `const { ${dictTypes.join(', ')} } = useDict(${dictTypes.map((item) => `'${item}'`).join(', ')});`,
+  ].join('\n');
+}
+
+function getDefaultOptionFieldWidthV2(field) {
+  if (field.formType === 'textarea') return '180';
+  return '120';
+}
+
+function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
+  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`];
+  const width = getDefaultOptionFieldWidthV2(field);
+
+  if (width !== '120') {
+    parts.push(`width: '${width}'`);
+  }
+
+  if (field.dictType) {
+    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
+  }
+
+  return `${indent}{ ${parts.join(', ')} },`;
+}
+
+function renderChildOptionGroupV2(model, childModel, dictRegistryRefs) {
+  return [
+    `    ${childModel.listName}: [`,
+    childModel.visibleFields
+      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
+      .join('\n'),
+    '    ],',
+  ].join('\n');
+}
+
+function renderTextMaxlengthAttrV2(field) {
+  if (!field.length) return '';
+  return ` :maxlength="${field.length}"`;
+}
+
+function renderTextareaMaxlengthAttrsV2(field) {
+  if (!field.length) return '';
+  return ` :maxlength="${field.length}" show-word-limit`;
+}
+
+function renderFormFieldV2(field) {
+  const prop = field.attrName;
+  const labelExpr = `getMasterFieldLabel('${prop}')`;
+  const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
+  const visibilityExpr = `isMasterFieldVisible('${prop}')`;
+
+  if (field.formType === 'select') {
+    return [
+      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <el-select v-model="form.${prop}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%">`,
+      `                <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      '              </el-select>',
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'number') {
+    const max = field.comment.includes('%') || field.comment.includes('婵犳鍣徊楣冨蓟瑜忓▎?) ? ' :max="100"' : '';
+    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
+    return [
+      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} :placeholder="inputPlaceholder(${labelExpr})" style="width: 100%" />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'datetime' || field.formType === 'date') {
+    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
+    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
+    return [
+      `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <el-date-picker type="${pickerType}" :placeholder="selectPlaceholder(${labelExpr})" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"></el-date-picker>`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'textarea') {
+    return [
+      `          <el-col v-if="${visibilityExpr}" :span="24" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <el-input type="textarea" v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextareaMaxlengthAttrsV2(field)} />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  return [
+    `          <el-col v-if="${visibilityExpr}" :span="12" class="mb20">`,
+    `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+    `              <el-input v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextMaxlengthAttrV2(field)} />`,
+    '            </el-form-item>',
+    '          </el-col>',
+  ].join('\n');
+}
+
+function renderTableColumnV2(field, dictRegistryRefs) {
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  const parts = [`prop: '${field.attrName}'`, `label: '${label}'`];
+  const width = getDefaultOptionFieldWidthV2(field);
+
+  if (width !== '120') {
+    parts.push(`width: '${width}'`);
+  }
+
+  if (field.dictType) {
+    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
+  }
+
+  return `  { ${parts.join(', ')} },`;
+}
+
+function renderChildTableColumnV2(field, childListName) {
+  const rules = field.notNull ? ` :rules="[{ required: true, trigger: 'blur' }]"` : '';
+  const labelExpr = `getChildFieldLabel('${childListName}', '${field.attrName}')`;
+  const dictExpr = `getChildFieldMeta('${childListName}', '${field.attrName}')?.dictType`;
+
+  let control = `                  <el-input v-model="row.${field.attrName}"${renderTextMaxlengthAttrV2(field)} />`;
+  if (field.formType === 'select' && field.dictType) {
+    control = [
+      `                  <el-select v-model="row.${field.attrName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%">`,
+      `                    <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      '                  </el-select>',
+    ].join('\n');
+  } else if (field.formType === 'number') {
+    const max = field.comment.includes('%') || field.comment.includes('婵犳鍣徊楣冨蓟瑜忓▎?) ? ' :max="100"' : '';
+    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
+    control = `                  <el-input-number v-model="row.${field.attrName}" :min="0"${max}${precision} style="width: 100%" />`;
+  } else if (field.formType === 'datetime' || field.formType === 'date') {
+    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
+    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
+    control = `                  <el-date-picker type="${pickerType}" v-model="row.${field.attrName}" :value-format="${formatName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%"></el-date-picker>`;
+  } else if (field.formType === 'textarea') {
+    control = `                  <el-input type="textarea" v-model="row.${field.attrName}"${renderTextareaMaxlengthAttrsV2(field)} />`;
+  }
+
+  return [
+    `            <el-table-column :label="${labelExpr}" prop="${field.attrName}">`,
+    '              <template #default="{ row, $index }">',
+    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
+    control,
+    '                </el-form-item>',
+    '              </template>',
+    '            </el-table-column>',
+  ].join('\n');
+}
+
+function renderChildSectionV2(childModel, childCount) {
+  const deleteExpression =
+    childCount > 1
+      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
+      : `deleteChild(obj, '${childModel.pk.attrName}')`;
+
+  return [
+    '          <el-col :span="24" class="mb20">',
+    `            <div class="mb10" style="font-weight: 600;">{{ childSectionTitle('${childModel.listName}') }}</div>`,
+    `            <sc-form-table v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')">`,
+    childModel.visibleFields.map((field) => renderChildTableColumnV2(field, childModel.listName)).join('\n'),
+    '            </sc-form-table>',
+    '          </el-col>',
+  ].join('\n');
+}
+
+function renderValidationRule(field) {
+  if (!field.notNull) return null;
+  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  return `  ${field.attrName}: [{ required: true, message: '${label}婵炴垶鎸哥粔鐑藉礂濡崵鈻旈柧蹇撳帨閺?, trigger: 'blur' }],`;
+}
+
+function renderFormRules(visibleFields) {
+  const lines = visibleFields.map(renderValidationRule).filter(Boolean);
+  return lines.join('\n');
+}
+
+function renderFormRulesV2(visibleFields) {
+  const lines = visibleFields
+    .filter((field) => field.notNull)
+    .map((field) => `  ${field.attrName}: [{ required: true, message: fieldRequiredMessage('${field.attrName}'), trigger: 'blur' }],`);
+  return lines.join('\n');
+}
+
+function buildReplacements(model, sharedSupport) {
+  const menuBaseId = Date.now();
+  const apiModulePath = `${model.moduleName}/${model.functionName}`;
+  const routePath = `${model.moduleName}/${model.functionName}`;
+  const permissionPrefix = `${model.moduleName}/${model.functionName}`.replace(/\//g, '_');
+  const dictRegistryRefs = sharedSupport.dictRegistry.keyByValue;
+  const i18nNamespace = buildI18nNamespace(model);
+
+  return {
+    TABLE_NAME: model.tableName,
+    TABLE_COMMENT: model.tableComment,
+    CLASS_NAME: model.className,
+    FUNCTION_NAME: model.functionName,
+    PK_ATTR: model.pk.attrName,
+    API_MODULE_PATH: apiModulePath,
+    API_PATH: apiModulePath,
+    VIEW_MODULE_PATH: routePath,
+    MENU_ROUTE_PATH: routePath,
+    I18N_NAMESPACE: i18nNamespace,
+    PERMISSION_PREFIX: permissionPrefix,
+    MENU_BASE_ID: menuBaseId,
+    MENU_BASE_ID_PLUS_1: menuBaseId + 1,
+    MENU_BASE_ID_PLUS_2: menuBaseId + 2,
+    MENU_BASE_ID_PLUS_3: menuBaseId + 3,
+      MENU_BASE_ID_PLUS_4: menuBaseId + 4,
+      MENU_BASE_ID_PLUS_5: menuBaseId + 5,
+      GENERATED_AT: new Date().toISOString(),
+      FORM_FIELDS: model.visibleFields.map(renderFormFieldV2).join('\n'),
+      TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumnV2(field, dictRegistryRefs)).join('\n'),
+      FORM_DEFAULTS: renderFormDefaults(model),
+      DICT_REGISTRY_IMPORT_BLOCK: model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';" : '',
+      MASTER_OPTION_FIELDS: model.visibleFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
+      CHILD_OPTION_GROUPS: model.children.map((childModel) => renderChildOptionGroupV2(model, childModel, dictRegistryRefs)).join('\n'),
+      FORM_RULES: renderFormRulesV2(model.visibleFields),
+      CHILD_FORM_LIST_DEFAULTS: renderChildFormListDefaults(model.children),
+      CHILD_TEMP_DECLARATIONS: renderChildTempDeclarations(model.children),
+      CHILD_RESET_LISTS: renderChildResetListLines(model.children),
+      CHILD_SECTIONS: model.children.map((childModel) => renderChildSectionV2(childModel, model.children.length)).join('\n'),
+    };
+  }
+
+function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
+  if (!hasRuntimeSupport(stylePreset)) throw new Error('Runtime templates are not implemented for style: ' + model.style);
+
+  const runtime = stylePreset.runtime;
+  const templateDir = path.resolve(__dirname, runtime.templateDir);
+  const replacements = buildReplacements(model, sharedSupport);
+  const formTemplate = fs.readFileSync(path.join(templateDir, runtime.files.form), 'utf8');
+  const listTemplate = fs.readFileSync(path.join(templateDir, runtime.files.list), 'utf8');
+  const optionsTemplate = fs.readFileSync(path.join(templateDir, runtime.files.options), 'utf8');
+  const apiTemplate = fs.readFileSync(path.join(templateDir, runtime.files.api), 'utf8');
+  const menuSqlTemplate = runtime.files.menuSql ? fs.readFileSync(path.join(templateDir, runtime.files.menuSql), 'utf8') : null;
+
+  const viewRoot = path.join(model.frontendPath, 'src', 'views', ...model.moduleName.split('/'), model.functionName);
+  const apiRoot = path.join(model.frontendPath, 'src', 'api', ...model.moduleName.split('/'));
+  const menuRoot = path.join(model.frontendPath, 'menu');
+
+  const files = [
+    { type: 'form', path: path.join(viewRoot, 'form.vue'), content: renderTemplate(formTemplate, replacements) },
+    { type: 'list', path: path.join(viewRoot, 'index.vue'), content: renderTemplate(listTemplate, replacements) },
+    { type: 'options', path: path.join(viewRoot, 'options.ts'), content: renderTemplate(optionsTemplate, replacements) },
+    { type: 'api', path: path.join(apiRoot, `${model.functionName}.ts`), content: renderTemplate(apiTemplate, replacements) },
+    {
+      type: 'i18nZh',
+      path: localeZhSupport.path,
+      content: localeZhSupport.content,
+      canWrite: localeZhSupport.isCompatible,
+      needsWrite: localeZhSupport.needsWrite,
+    },
+  ];
+
+  if (menuSqlTemplate) {
+    files.push({ type: 'menuSql', path: path.join(menuRoot, `${model.functionName}_menu.sql`), content: renderTemplate(menuSqlTemplate, replacements) });
+  }
+  return files;
+}
+
+function ensureArguments(input) {
+  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
+  for (const key of TOOL_SCHEMA.required) {
+    if (!input[key]) throw new Error(key + ' is required');
+  }
+
+  const style = String(input.style);
+  getStylePreset(style);
+
+  return {
+    designFile: input.designFile ? String(input.designFile) : null,
+    tableName: String(input.tableName),
+    style,
+    children: normalizeChildrenInput(input.children),
+    childTableName: input.childTableName ? String(input.childTableName) : null,
+    mainField: input.mainField ? String(input.mainField) : null,
+    childField: input.childField ? String(input.childField) : null,
+    relationType: input.relationType ? String(input.relationType) : '',
+    frontendPath: String(input.frontendPath),
+    moduleName: input.moduleName ? String(input.moduleName) : 'admin/test',
+    writeToDisk: input.writeToDisk === undefined ? true : Boolean(input.writeToDisk),
+    overwrite: input.overwrite === undefined ? true : Boolean(input.overwrite),
+  };
+}
+
+function maybeWriteFiles(files, writeToDisk, overwrite) {
+  if (!writeToDisk) return;
+  for (const file of files) {
+    if (file.canWrite === false) {
+      file.status = 'skipped';
+      continue;
+    }
+    if (file.needsWrite === false) {
+      file.status = 'unchanged';
+      continue;
+    }
+    if (!overwrite && fs.existsSync(file.path)) {
+      file.status = 'skipped';
+      continue;
+    }
+    fs.mkdirSync(path.dirname(file.path), { recursive: true });
+    fs.writeFileSync(file.path, file.content, 'utf8');
+    file.status = 'success';
+  }
+}
+
+function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, note) {
+  const relations = model.children.map((childModel) => ({
+    childTableName: childModel.tableName,
+    childTableComment: childModel.tableComment,
+    mainField: childModel.mainField.fieldName,
+    childField: childModel.childField.fieldName,
+    childListName: childModel.listName,
+    relationType: childModel.relationType || '',
+  }));
+  const selectedList = relations.map((relation) => formatRelationCandidate(relation));
+
+  return {
+    mode: 'local-template',
+    style: safeArgs.style,
+    styleLabel: stylePreset.label,
+    runtimeSupported: hasRuntimeSupport(stylePreset),
+    sourceFile: model.sourceFile,
+    designFile: model.designFile,
+    tableName: model.tableName,
+    tableComment: model.tableComment,
+    moduleName: model.moduleName,
+    writeToDisk: safeArgs.writeToDisk,
+    selectedTemplates: sharedTemplates,
+    files: files.map((file) => ({ type: file.type, path: file.path, bytes: Buffer.byteLength(file.content, 'utf8'), status: file.status || (safeArgs.writeToDisk ? 'success' : 'rendered') })),
+    relation: relations.length === 1 ? relations[0] : null,
+    relations,
+    relationResolution: model.children.length
+      ? {
+          status: 'provided',
+          tableName: safeArgs.tableName,
+          designFile: model.designFile,
+          source: 'arguments',
+          message:
+            model.children.length > 1
+              ? 'Direct child relations were provided by the caller. MCP skipped design-doc relation inference and generated a single main form with multiple child tables.'
+              : 'The relation was provided by the caller. MCP skipped design-doc relation inference and generated files directly.',
+          selected: selectedList.length === 1 ? selectedList[0] : null,
+          selectedList,
+          correctionEntry: {
+            fields: ['children', 'childTableName', 'mainField', 'childField'],
+            example: buildRetryArguments(safeArgs, model.designFile, model.children[0].tableName),
+          },
+        }
+      : null,
+    summary: {
+      totalFields: model.fields.length,
+      visibleFields: model.visibleFields.length,
+      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
+      skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
+      childCount: model.children.length,
+      childTables: model.children.map((childModel) => childModel.tableName),
+      childVisibleFields: model.children.reduce((sum, childModel) => sum + childModel.visibleFields.length, 0),
+    },
+    note,
+  };
+}
+
+async function handleToolCall(argumentsObject) {
+  const safeArgs = ensureArguments(argumentsObject);
+  const stylePreset = getStylePreset(safeArgs.style);
+  const model = buildModel(safeArgs);
+  const sharedTemplates = resolveSharedTemplates(stylePreset);
+  const sharedSupport = prepareSharedSupport(model.frontendPath, model.dictTypes);
+  const localeZhSupport = prepareZhCnLocaleFile(model);
+
+  if (!hasRuntimeSupport(stylePreset)) {
+    const manifest = buildManifest(model, safeArgs, stylePreset, sharedTemplates, [], 'Style mapping is declared, but runtime template rendering is not implemented yet for this style.');
+    return toolTextResult(JSON.stringify(manifest, null, 2));
+  }
+
+  const files = renderFiles(model, stylePreset, sharedSupport, localeZhSupport);
+  maybeWriteFiles(files, safeArgs.writeToDisk, safeArgs.overwrite);
+  maybeWriteSharedSupport(sharedSupport, safeArgs.writeToDisk);
+  const manifest = buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, buildSupportNote(sharedSupport, localeZhSupport));
+  return toolTextResult(JSON.stringify(manifest, null, 2));
+}
+
+async function onMessage(message) {
+  const { id, method, params } = message;
+  const isNotification = id === undefined || id === null;
+
+  if (method === 'initialize') {
+    writeMessage(successResponse(id, { protocolVersion: PROTOCOL_VERSION, capabilities: { tools: {} }, serverInfo: { name: SERVER_NAME, version: SERVER_VERSION } }));
+    return;
+  }
+
+  if (method === 'notifications/initialized') return;
+
+  // Silently ignore all other notifications (no id means no response expected).
+  if (isNotification) return;
+
+  if (method === 'ping') {
+    writeMessage(successResponse(id, {}));
+    return;
+  }
+
+  if (method === 'tools/list') {
+    writeMessage(successResponse(id, { tools: [{ name: TOOL_NAME, description: 'Generate Worsoft frontend files and menu SQL from a local Markdown design file with style-based local templates. In master_child_jump mode, the caller must provide either children[] or childTableName/mainField/childField.', inputSchema: TOOL_SCHEMA }] }));
+    return;
+  }
+
+  if (method === 'tools/call') {
+    if (!params || params.name !== TOOL_NAME) {
+      writeMessage(errorResponse(id, -32602, 'Unknown tool'));
+      return;
+    }
+    try {
+      const result = await handleToolCall(params.arguments || {});
+      writeMessage(successResponse(id, result));
+    } catch (error) {
+      const errorText = error && error.details ? JSON.stringify(error.details, null, 2) : String(error.message || error);
+      writeMessage(successResponse(id, { content: [{ type: 'text', text: errorText }], isError: true }));
+    }
+    return;
+  }
+
+  writeMessage(errorResponse(id, -32601, 'Method not found'));
+}
+
+function start() {
+  process.stdin.setEncoding('utf8');
+  let buffer = '';
+  process.stdin.on('data', (chunk) => {
+    buffer += chunk;
+    let newlineIndex = buffer.indexOf('\n');
+    while (newlineIndex >= 0) {
+      const raw = buffer.slice(0, newlineIndex).trim();
+      buffer = buffer.slice(newlineIndex + 1);
+      if (raw) {
+        try {
+          const message = JSON.parse(raw);
+          Promise.resolve(onMessage(message)).catch((error) => {
+            if (message && Object.prototype.hasOwnProperty.call(message, 'id')) {
+              writeMessage(errorResponse(message.id, -32603, error.message));
+            }
+          });
+        } catch (error) {
+          writeMessage(errorResponse(null, -32700, 'Parse error: ' + error.message));
+        }
+      }
+      newlineIndex = buffer.indexOf('\n');
+    }
+  });
+}
+
+start();