在 AI 中使用 Schematex

import { renderResult } from 'schematex';

const result = renderResult(dsl, { type });
preview.innerHTML = result.svg;

if (!result.ok) {
  queueRepair(result.diagnostics);
}

import { streamText } from 'ai';
import { schematexTools } from 'schematex/ai/sdk';

const result = streamText({
  model: 'anthropic/claude-opus-4-7',
  tools: schematexTools,
  maxSteps: 5,
  system: `You write Schematex DSL. First call listDiagrams to pick a type.
Then call getSyntax and getExamples for that type. Write the DSL, then
call validateDsl and self-correct on errors before returning to the user.`,
  prompt: userMessage,
});

import { listDiagrams, getSyntax, getExamples, validateDsl, renderDsl } from 'schematex/ai';

import { buildPromptContext, validateDsl } from 'schematex/ai';

const ctx = buildPromptContext('genogram');          // 语法卡 + 精选示例
const system = `Generate only Schematex DSL.\n\n${ctx.text}`;
const dsl = await generate(system, userMessage);     // 你的单次模型调用

const check = validateDsl('genogram', dsl);          // 服务端必须校验
if (!check.ok) {
  // 一次修复 pass：用 check.errors[].message + .hint 重新提示
}

https://schematex.js.org/mcp

npm i -g @schematex/mcp
# 或
npx @schematex/mcp

{
  "mcpServers": {
    "schematex": {
      "command": "npx",
      "args": ["-y", "@schematex/mcp"]
    }
  }
}

1. listDiagrams()                          → 选择正确的类型
2. getSyntax({ type })                     → 获取规范生成语法
3. getExamples({ type, maxComplexity: 2 }) → 获取 few-shot 上下文
4. 编写 DSL
5. validateDsl({ type, dsl })
   ├─ ok:    将 DSL 返回给用户
   └─ error: 读取行/列/消息，修复，回到第 5 步
6. (可选) renderDsl({ type, dsl })         → 返回 SVG（如果应用自行渲染则跳过）

You generate Schematex DSL for diagrams. Always follow this procedure:

1. If you don't already know which diagram type matches the user's request,
   call listDiagrams and pick the best match.
2. Call getSyntax for the chosen type. Stay on the canonical path unless an
   advanced feature requires getSyntax({ type, detail: "reference" }).
3. Call getExamples (maxComplexity: 2) for few-shot context.
4. Write the DSL.
5. Call validateDsl. If ok:false, read the error's line, column, and message,
   fix the DSL, and call validateDsl again. Repeat up to 3 times.
6. Return the validated DSL to the user, inside a ```schematex code block.

{
  ok: false,
  status: 'invalid',     // 仅 renderDsl
  type: 'genogram' | null,
  svg: string,           // 仅 renderDsl：可见的诊断 fallback
  errors: [
    {
      line?: number;        // 1-based，若解析器有报告
      column?: number;
      source?: string;      // 出错的行文本
      message: string;      // 人类可读的描述
      hint?: string;
    }
  ]
}