📊 Diagram Generator

📊 流程图语法示例

flowchart TB
    title 电商订单处理流程
    
    subgraph Actor_0["👤 用户"]
        用户_0(([浏览商品]))
        用户_1([加入购物车])
        用户_2([点击结算])
        用户_3([完成支付])
    end
    
    subgraph Actor_1["🖥️ 系统"]
        系统_0{{验证库存}}
        系统_1([显示支付页面])
        系统_2[(创建订单)]
        系统_3[(扣减库存)]
    end
    
    用户_0 --> 用户_1
    用户_1 --> 用户_2
    用户_2 --> 系统_0
    系统_0 -- Yes --> 系统_1
    系统_0 -- No --> 系统_4([提示库存不足])
    系统_1 --> 用户_3
    用户_3 --> 系统_2
    系统_2 --> 系统_3
    
    classDef start fill:#10b981,color:white
    classDef decision fill:#f59e0b,color:white
    classDef process fill:#6366f1,color:white

↔️ 序列图语法示例

sequenceDiagram
    title POST /api/v1/auth/login
    
    participant U as 用户
    participant F as 前端
    participant B as 后端
    participant D as 数据库
    
    U->>F: 输入手机号和验证码
    activate F
    F->>B: POST /api/v1/auth/login
    activate B
    B->>D: 查询用户信息
    activate D
    D-->>B: 返回用户数据
    deactivate D
    B->>B: 验证验证码
    B->>D: 更新登录时间
    B-->>F: 返回 JWT Token
    deactivate B
    F->>U: 跳转首页
    deactivate F

🔄 状态图语法示例

stateDiagram-v2
    title 订单状态图
    
    [*] --> 待支付
    待支付 --> 已支付：用户支付成功\n更新支付状态
    待支付 --> 已取消：用户取消/超时\n释放库存
    已支付 --> 配货中：商家确认订单\n生成拣货单
    配货中 --> 已发货：打包完成\n打印快递单
    已发货 --> 运输中：快递公司揽收\n更新物流信息
    运输中 --> 已送达：客户签收\n更新签收状态
    已送达 --> 已完成：确认收货/7 天自动确认\n结算货款
    已支付 --> 退款中：用户申请退款\n创建退款单
    退款中 --> 已退款：退款审核通过\n原路退回
    已取消 --> [*]
    已完成 --> [*]
    已退款 --> [*]

📝 原型草图示例

+------------------------------------------------------------------------------+
|                             用户登录页                                        |
|                          用户身份验证入口                                      |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
| [首页]  [产品]  [服务]  [关于]  [登录/注册]                                  |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
|  ★ 用户登录                                                                  |
|                                                                              |
|  欢迎回来！请输入您的手机号和验证码进行登录。                                 |
|                                                                              |
|  < 请输入手机号（11 位） >                                                    |
|                                                                              |
|  [ 获取验证码 ]                                                               |
|                                                                              |
|  < 请输入 6 位验证码 >                                                        |
|                                                                              |
|  [ 登录 ]                                                                     |
|                                                                              |
|  还没有账号？立即注册 | 忘记密码？                                            |
|                                                                              |
|  • 微信登录                                                                   |
|  • 支付宝登录                                                                 |
|  • 微博登录                                                                   |
+------------------------------------------------------------------------------+

+------------------------------------------------------------------------------+
| © 2026 用户登录页 | 隐私政策 | 服务条款 | 联系我们 |                         |
+------------------------------------------------------------------------------+

🚀 安装依赖

# 安装 Anthropic SDK（如需 AI 增强功能）
pip install anthropic

# 设置 API Key（可选）
export ANTHROPIC_API_KEY="sk-ant-api03-..."

📝 基本用法

from diagram_generator import DiagramGenerator

# 1. 创建生成器
generator = DiagramGenerator(
    api_key="sk-ant-...",  # 或从环境变量读取
    enable_ai=True         # 启用 AI 增强
)

# 2. 生成流程图
flowchart = generator.generate_flowchart_from_process(
    process_name="订单处理流程",
    description="从下单到发货的完整流程",
    actors=["用户", "系统"],
    steps=[
        {"actor": "用户", "action": "下单", "type": "start"},
        {"actor": "系统", "action": "验证库存", "type": "decision"},
        {"actor": "系统", "action": "创建订单", "type": "database"}
    ],
    orientation="TB"
)

# 3. 导出文件
generator.export_to_file(flowchart, "order_flowchart.md", "md")