abnerla/ai_paper/diagram-validator

图表输出校验器

校验 AI 输出的图表 JSON：剔除非法 ops、修复未闭合 mermaid 围栏、为缺失字段补默认值，提升 AI 改图的稳定性。

功能概述

AI生成的图表数据有时会包含格式错误或不规范的内容。本技能是一个后台校验型技能，在AI生成图表后自动：

• 检查并修复JSON格式错误
• 剔除非法的操作指令
• 修复未闭合的代码块
• 为缺失的字段补充默认值
• 确保图表数据的完整性和正确性

无需手动执行，启用后会自动在图表生成和编辑场景中生效。

主要功能

自动校验和修复

当AI生成或编辑图表时，本技能会自动执行以下校验：

1. JSON格式校验

• 检查JSON结构是否完整
• 修复常见的JSON格式错误
• 确保所有括号、引号正确闭合

2. 非法操作剔除

• 识别并移除非法的操作指令
• 过滤不支持的图表元素
• 确保只包含有效的图表操作

3. 代码块修复

• 检查Mermaid代码块是否正确闭合
• 修复缺失的开始或结束标记
• 确保代码块格式规范

4. 字段补全

• 为缺失的必需字段补充默认值
• 确保图表数据的完整性
• 避免因缺失字段导致的渲染错误

使用场景

场景1：AI生成图表时出错

问题：AI生成的图表无法正常显示

技能处理：

• 自动检测JSON格式错误
• 修复格式问题
• 确保图表能够正常渲染

场景2：图表编辑后格式混乱

问题：编辑图表后，格式变得混乱

技能处理：

• 校验编辑后的数据
• 修复格式问题
• 保持图表的稳定性

场景3：图表数据不完整

问题：图表缺少某些必需字段

技能处理：

• 识别缺失的字段
• 补充默认值
• 确保图表完整性

使用技巧

1. 保持启用：建议始终启用此技能，提升图表生成的稳定性
2. 检查结果：虽然技能会自动修复，但仍建议检查最终效果
3. 报告问题：如果发现无法修复的问题，及时反馈
4. 配合使用：与"图表领域专家"技能配合使用，效果更好

常见问题

Q: 这个技能需要手动执行吗？

A: 不需要。这是一个后台校验型技能，启用后会自动在图表生成和编辑场景中生效。

Q: 技能会修改我的图表内容吗？

A: 不会。技能只修复格式错误和补充缺失字段，不会改变图表的实际内容。

Q: 如果技能无法修复错误怎么办？

A: 技能会尽力修复常见错误，但无法处理所有情况。如果遇到无法修复的错误，可以尝试重新生成图表。

Q: 技能会影响图表生成速度吗？

A: 影响很小。校验过程非常快速，通常不会明显影响用户体验。

技术说明

校验流程

1. 接收AI输出：获取AI生成的图表数据
2. 格式检查：检查JSON格式是否正确
3. 内容校验：检查图表内容是否合法
4. 错误修复：自动修复发现的问题
5. 输出结果：返回修复后的图表数据

常见错误类型

JSON格式错误：

• 缺少逗号或多余逗号
• 引号未闭合
• 括号不匹配

非法操作：

• 不支持的图表类型
• 无效的属性值
• 错误的语法

代码块问题：

• Mermaid代码块未闭合
• 缺少开始或结束标记
• 格式不规范

字段缺失：

• 缺少必需的属性
• 缺少默认值
• 数据不完整

更新日志

v1.0.0 (2026-05-21)

• 初始版本发布
• 支持JSON格式校验
• 支持非法操作剔除
• 支持代码块修复
• 支持字段补全