dayuan.jiang
23d5c83b0d
The canvas now fills the window and the chat floats on its right. draw.io is served from our own origin (public/drawio, downloaded at build time and checked against the release's SHA-256), so the app can drive the editor directly: - every AI change becomes a version card with a thumbnail; compare, restore or undo it, and Ctrl+Z on the canvas takes an AI change back in one step - shapes the AI just changed are highlighted on the canvas - selected shapes appear as a chip and are sent to the model - the app's own canvas toolbar, shape library and page tabs replace draw.io's chrome - new start screen, session rename and switcher, open .drawio files - settings split into Models & keys, Appearance, Advanced and About - phones switch between canvas and chat - dark mode keeps the diagram on a white sheet and no longer flashes With an external draw.io (NEXT_PUBLIC_DRAWIO_BASE_URL) the app falls back to draw.io's own toolbar and the features above that need same origin are off. The chat logic moved from the 1500-line chat panel into a chat engine plus small UI components; zustand holds canvas, versions, settings and UI state.
2.6 KiB
Frequently Asked Questions (FAQ)
1. Cannot Export PDF
Problem: Web version redirects to convert.diagrams.net/node/export when exporting PDF, then nothing happens
Cause: Embedded Draw.io doesn't support direct PDF export, it relies on external conversion service which doesn't work in iframe
Solution: Export as image (PNG) first, then print to PDF
Related Issues: #539, #125
2. Cannot Access embed.diagrams.net (Offline/Intranet Deployment)
Problem: Intranet environment shows "Cannot find server IP address for embed.diagrams.net"
Key Point: The app now ships with its own copy of draw.io, served from /drawio, so the browser no longer needs embed.diagrams.net. If you still see this error, the image was built with NEXT_PUBLIC_DRAWIO_BASE_URL=https://embed.diagrams.net (the old Dockerfile default). Rebuild without that build argument. See Offline Deployment.
NEXT_PUBLIC_* environment variables are build-time variables, they get bundled into JS code. Runtime settings don't work!
To keep a separate draw.io server instead, pass it via args at build time:
# docker-compose.yml
services:
drawio:
image: jgraph/drawio:latest
ports: ["8080:8080"]
next-ai-draw-io:
build:
context: .
args:
- NEXT_PUBLIC_DRAWIO_BASE_URL=http://your-server-ip:8080/
ports: ["3000:3000"]
env_file: .env
Intranet Users: Modify Dockerfile and build image on external network, then transfer to intranet
Related Issues: #295, #317
3. Self-hosted Model Only Thinks But Doesn't Draw
Problem: Locally deployed models (e.g., Qwen, LiteLLM) only output thinking process, don't generate diagrams
Possible Causes:
- Model too small - Small models struggle to follow tool calling instructions correctly, recommend 32B+ parameter models
- Tool calling not enabled - Model service needs tool use configuration
Solution: Enable tool calling, e.g., vLLM:
python -m vllm.entrypoints.openai.api_server \
--model Qwen/Qwen3-32B \
--enable-auto-tool-choice \
--tool-call-parser hermes
Related Issues: #269, #75
4. "No Image Provided" After Uploading Image
Problem: After uploading an image, the system shows "No image provided" error
Possible Causes:
- Model doesn't support vision (e.g., Kimi K2, DeepSeek, Qwen text models)
Solution:
- Use vision-capable models: GPT-5.2, Claude 4.5 Sonnet, Gemini 3 Pro
- Models with
visionorvlin name support images - Update to latest version (v0.4.9+)
Related Issues: #324, #421, #469