Claude API 集成本地 Draw.io 客户端实战：打通云端与本地工作流

1次阅读

没有评论

共计 3117 个字符，预计需要花费 8 分钟才能阅读完成。

在日常开发和技术写作中，我们经常需要绘制流程图、架构图等技术图解。虽然云端 AI 如 Claude 能提供优秀的文本分析能力，但绘图工具如 Draw.io 通常需要本地安装使用。这就导致了工作流被割裂：

在 Claude 中分析需求后，需要手动打开 Draw.io 绘图
无法实现从 AI 分析结果直接生成或修改图表
团队协作时需要反复切换工具，效率低下

我们对比了几种可能的集成方案：

浏览器扩展方案
优点：无需额外安装，跨平台
缺点：权限受限，无法深度集成本地功能
桌面应用集成
优点：功能完整，性能好
缺点：开发成本高，跨平台兼容性差
本地服务桥接（最终选择）
优点：开发简单，跨平台，功能灵活
缺点：需要处理安全问题

我们创建一个本地 HTTP 服务作为 Claude API 和 Draw.io 之间的桥梁：

from flask import Flask, request, jsonify
import subprocess
import os

app = Flask(__name__)

@app.route('/open-drawio', methods=['POST'])
def open_drawio():
    data = request.json
    file_path = data.get('file_path')

    try:
        # Windows 系统下的示例
        if os.name == 'nt':
            subprocess.Popen(['draw.io', '--file', file_path])
        # MacOS 系统
        elif sys.platform == 'darwin':
            subprocess.Popen(['open', '-a', 'draw.io', file_path])
        # Linux 系统
        else:
            subprocess.Popen(['drawio', file_path])

        return jsonify({'status': 'success'})
    except Exception as e:
        return jsonify({'status': 'error', 'message': str(e)}), 500

if __name__ == '__main__':
    app.run(port=5000)

为确保安全，我们添加了简单的 Token 认证：

API_TOKENS = {'your-secure-token'}

@app.before_request
def check_token():
    if request.endpoint != 'open-drawio':
        return

    token = request.headers.get('X-API-TOKEN')
    if token not in API_TOKENS:
        return jsonify({'status': 'error', 'message': 'Unauthorized'}), 401

针对不同操作系统做了路径处理优化：

def normalize_path(file_path):
    """统一处理不同系统的路径格式"""
    if os.name == 'nt':  # Windows
        return file_path.replace('/', '\\')
    else:
        return file_path.replace('\\', '/')

以下是整合后的完整实现：

import os
import sys
import subprocess
from flask import Flask, request, jsonify

app = Flask(__name__)
API_TOKENS = {'your-secure-token'}

def normalize_path(file_path):
    """统一处理不同系统的路径格式"""
    if os.name == 'nt':  # Windows
        return file_path.replace('/', '\\')
    else:
        return file_path.replace('\\', '/')

@app.before_request
def check_token():
    if request.endpoint != 'open-drawio':
        return

    token = request.headers.get('X-API-TOKEN')
    if token not in API_TOKENS:
        return jsonify({'status': 'error', 'message': 'Unauthorized'}), 401

@app.route('/open-drawio', methods=['POST'])
def open_drawio():
    data = request.json
    file_path = data.get('file_path')

    if not file_path:
        return jsonify({'status': 'error', 'message': 'Missing file_path'}), 400

    try:
        file_path = normalize_path(file_path)

        # 检查文件是否存在
        if not os.path.exists(file_path):
            return jsonify({'status': 'error', 'message': 'File not found'}), 404

        # 根据不同系统调用 Draw.io
        if os.name == 'nt':  # Windows
            subprocess.Popen(['draw.io', '--file', file_path])
        elif sys.platform == 'darwin':  # MacOS
            subprocess.Popen(['open', '-a', 'draw.io', file_path])
        else:  # Linux
            subprocess.Popen(['drawio', file_path])

        return jsonify({'status': 'success'})
    except Exception as e:
        return jsonify({'status': 'error', 'message': str(e)}), 500

if __name__ == '__main__':
    app.run(port=5000)

除了基本的 Token 认证，还可以：

限制只接受来自 localhost 的连接
使用 HTTPS 加密通信
实现请求频率限制

from flask_limiter import Limiter
from flask_limiter.util import get_remote_address

limiter = Limiter(
    app,
    key_func=get_remote_address,
    default_limits=["100 per day", "10 per hour"]
)

我们的测试数据显示：