软件架构图生成器

解决软件架构图生成的痛点

在软件开发和文档编写过程中，绘制清晰的架构图是必不可少的一步。传统方法依赖手工绘制或使用图形工具，不仅耗时耗力，而且难以保证架构的准确性和专业性。特别是在申请软件著作权时，需要提交符合规范的架构图和文档，许多开发者面临生成困难。此外，在技术方案评审或系统重构分析中，快速可视化系统结构有助于沟通和决策。该技能旨在自动化这一过程，输入文本描述即可输出高质量的架构图和设计文档。

核心能力与工作流程

技能采用异步处理架构，通过五个核心阶段实现自动化生成：

• 意图深度解析：分析输入的软件说明书或软著文本，识别系统架构风格，例如 B/S 架构、微服务或前后端分离模式。
• 结构化抽取：基于识别到的架构风格，从文本中提取系统层级（如表现层、业务逻辑层、数据访问层）和核心组件，并建立依赖关系。
• Mermaid 代码生成：根据抽取的层级和组件，自动生成符合 Mermaid 语法的架构图源代码，便于后续渲染和编辑。
• 专业评审与建议：模拟架构师视角，对抽取的结构进行评审，生成架构分析报告，并提供高可用性、可扩展性等方面的优化建议。
• 文档融合与图像渲染：将分析报告、优化建议和 Mermaid 代码融合为完整的架构设计文档，同时调用图像渲染服务生成高清架构图，通过异步轮询获取图片地址。

整个流程以异步方式执行，提交任务后返回唯一 task_id，通过轮询获取结果，确保实时反馈进度。

适用边界与注意事项

该技能适用于需要从文本生成架构图的场景，如编写设计文档、软著申报或技术评审。但需注意以下边界：

• 输入文本 raw_text 为必填项，应尽可能完整描述软件功能、架构模式和技术栈，以保证解析准确度。
• 所有任务强制异步执行，不支持同步模式，用户需通过 task_id 轮询查询结果。
• 生成的架构图宽高比支持 1:1、3:4、4:3、16:9、9:16，默认为 16:9，可根据应用场景调整。
• 技能依赖 ShowAPI 服务，需要配置 showapi_appkey 凭证，注册账号后获取。