用Python+Flask打造可视化武侠人物关系图生成器：从零到一的实战全记录

一、缘起：一个程序小白的奇妙探索之旅

作为一个接触Python仅13天的编程萌新，我曾以为开发一个完整的应用是遥不可及的事情。但在DeepSeek的帮助下，我竟用短短半天时间完成了一个本地化武侠人物关系图生成器的开发！这个工具不仅能批量管理门派和人物，还能自动生成关系图并导出Excel表格，整个过程充满了挑战与惊喜。

本文将完整记录我的开发过程，手把手带你用Python+Flask实现这个有趣的项目，最终效果如下：

初始界面

网页界面，可直接预览图形，导出EXCEL，下载PNG和PDF文件

二、制作思路：如何化繁为简

核心需求
- 批量添加门派和人物
- 可视化展示人物关系
- 支持增删改查操作
- 导出结构化数据
技术选型
- Flask：轻量级Web框架，快速搭建后端服务
- Graphviz：专业关系图绘制工具
- openpyxl：Excel文件生成库
- HTML+JavaScript：前端交互实现
架构设计

三、准备工作：配置开发环境

基础工具
- Python 3.8+
- VS Code/PyCharm
- 浏览器（推荐Chrome）
安装依赖库
```
pip install flask graphviz openpyxl
```
Graphviz安装
- Windows：官网下载安装包
- Mac：brew install graphviz
- Linux：sudo apt-get install graphviz

四、实战开发：七步打造完整系统

步骤1：创建项目结构

📁 Novel-Relationship-Generator
├── 📁 static
│   └── 📁 output        # 存放生成图片
├── 📁 templates
│   └── index.html      # 前端页面
└── app.py              # 主程序

步骤2：编写后端核心（app.py）

from flask import Flask, render_template, request, jsonify, send_file
from graphviz import Digraph
import re
from openpyxl import Workbook

app = Flask(__name__)

# 数据存储
characters = []
sects = ["武当派", "少林派", "峨眉派", "嵩山派"]  # 初始门派
relations = []
sect_descriptions = {
    "武当派": "以柔克刚的内家拳法",
    "少林派": "天下武功出少林",
    "峨眉派": "女子为主的武林门派",
    "嵩山派": "五岳剑派之首"
}
char_descriptions = {}

# 此处省略接口代码（与前文相同）...

if __name__ == "__main__":
    app.run(debug=True)

步骤3：前端页面开发（templates/index.html）

<!-- 门派添加模块 -->
<form id="add-sects-form">
    <label>批量添加门派（支持逗号/分号/空格分隔）：</label>
    <textarea name="sects" rows="3" placeholder="示例：华山派,日月神教"></textarea>
    <button type="submit">添加门派</button>
</form>

<!-- 人物关系展示区 -->
<div class="right-panel">
    <h2>武林门派谱</h2>
    <div id="characters-list">
        <!-- 动态加载门派及人物 -->
    </div>
</div>

步骤4：添加示例数据

# 示例人物数据
characters.extend([
    {"name": "张三丰", "sect": "武当派"},
    {"name": "宋远桥", "sect": "武当派"},
    {"name": "空闻大师", "sect": "少林派"},
    {"name": "灭绝师太", "sect": "峨眉派"},
    # 可继续添加其他人物...
])

# 示例关系数据
relations.extend([
    {"from": "张三丰", "to": "宋远桥", "label": "师徒"},
    {"from": "空闻大师", "to": "张三丰", "label": "故交"},
    # 添加更多关系...
])

步骤5：实现关系图生成

@app.route("/generate_graph", methods=["POST"])
def generate_graph():
    dot = Digraph(comment="武林关系图")
    dot.attr(rankdir="LR", nodesep="0.3")
    
    # 添加门派分组
    for sect in sects:
        with dot.subgraph(name=f"cluster_{sect}") as sub:
            sub.attr(label=sect, style="filled", color="lightgrey")
            for char in characters:
                if char["sect"] == sect:
                    sub.node(char["name"], shape="box")
    
    # 绘制关系线
    for rel in relations:
        dot.edge(rel["from"], rel["to"], label=rel["label"])
    
    dot.render("static/output/relationship.gv", format="png")
    return jsonify({"status": "success"})

步骤6：导出Excel功能

@app.route("/export_excel")
def export_excel():
    wb = Workbook()
    ws = wb.active
    ws.append(["序号", "门派", "门派简介", "人物", "人物简介"])
    
    row_num = 1
    for sect in sects:
        desc = sect_descriptions.get(sect, "")
        members = [c for c in characters if c["sect"] == sect]
        
        for i, char in enumerate(members):
            char_desc = char_descriptions.get(char["name"], "")
            if i == 0:
                ws.append([row_num, sect, desc, char["name"], char_desc])
            else:
                ws.append([row_num, sect, "", char["name"], char_desc])
            row_num += 1
    
    wb.save("武林人物表.xlsx")
    return send_file("武林人物表.xlsx")