结构与逻辑图生成器

目标与适用范围

从文本、JSON、集合定义或日志生成流程图、思维导图、组织架构图、树状图、韦恩图、ASCII 目录树与时序图。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 先把来源材料整理成流程步骤、大纲、层级 JSON、集合定义、缩进列表或结构化日志。

• 在选工具前明确用途：头脑风暴、文档说明、事故复盘，还是面向业务方的解释。

• 决策点: 你要展示哪一种关系？. 决策路径用流程图，想法发散用思维导图，层级关系用组织架构图或树状图，集合交叠用韦恩图，按时间发生的服务调用用时序图。

• 决策点: 输出需要是视觉图、纯文本，还是可进代码库的图表源码？. 演示材料优先用渲染图；README 和终端场景适合 ASCII 树；需要随文档版本管理时，优先保留 Mermaid 或 PlantUML 输出。

按步骤完成工作流

1. 梳理流程与想法

先处理人能读懂的逻辑：用流程图表达决策路径，用思维导图把头脑风暴笔记拆成主题与子主题。 使用 flowchart-maker, mindmap-maker.

2. 从结构化数据生成层级图

把团队、产品、分类或系统层级转成组织架构图或树状图，并在分享前检查父子关系是否准确。 使用 org-chart-maker, tree-diagram-generator.

3. 说明集合交集与可复制文本结构

用韦恩图展示集合交叠，用 ASCII 树把缩进大纲转成适合 README、工单和架构说明的纯文本树。 使用 venn-diagram-maker, ascii-tree-from-indented-list.

4. 从日志还原服务顺序

当来源是事件证据时，把结构化服务日志转成 Mermaid 或 PlantUML 时序图，并保留评审所需的参与方、耗时和错误信息。 使用 log-sequence-diagram-converter.

交付前验收结果

• 所选图形类型与要解释的关系匹配，而不是把无关数据硬塞进熟悉图形。
• 每个节点、分支、集合或参与方都能回溯到输入文本、JSON、列表或日志证据。
• 最终图对目标读者可读，并有足够标签，能独立放进文档或评审材料。

常见问题

• 这和图表生成器有什么不同？ 这个工作流处理结构与逻辑关系，不处理定量序列。它解释流向、层级、交叠、大纲形状和服务顺序，而不是画数值趋势。
• 一份混乱的规划笔记应该先用哪个工具？ 如果笔记像想法大纲，先用思维导图生成器；如果已经包含条件、状态或步骤流转，就先用流程图生成器。
• 这个工作流能用于工程事故复盘吗？ 可以。日志转时序图工具能从结构化日志还原跨服务顺序，流程图和树状图则能补充控制路径或依赖结构说明。
• 什么时候该用 ASCII 树？ 当结果必须以纯文本保持可读时使用，尤其适合仓库目录、文档大纲、工单评论和终端友好的交接材料。