This project introduces "Graph Code," a Python DSL for defining node graphs, addressing challenges in maintenance, collaboration, and AI integration. It targets developers and AI users seeking a code-centric workflow for complex graph manipulation, particularly for systems like Genshin Impact's Qianxing Sandbox, offering automated layout and precise script-driven editor integration.

How It Works

Node graph logic is expressed as Python classes ("Graph Code"). An engine parses, validates, and auto-layouts this code. Automation scripts then translate these structures into precise actions within a target editor, often by simulating mouse inputs. This approach leverages code's benefits for AI interaction, versioning, and refactoring, while auto-layout enhances readability.

Quick Start & Requirements

• OS: Windows 10/11 (Chinese interface, 4K/2K resolution recommended).
• Display: Specific resolutions (1080p, 2K, 4K) and scaling (100%, 125%) supported; others may cause issues.
• Python: 3.10 - 3.12 (3.10.x recommended); 3.13 incompatible due to dependency constraints.
• Prerequisites: Visual C++ runtime.
• Install: Clone repo, then pip install -r requirements.txt -c constraints.txt.
• Run UI: python -X utf8 -m app.cli.run_app.
• Community: BUG feedback QQ group: 1073774505.

Highlighted Details

• Graph Code Paradigm: Node graphs defined via Python classes for code-centric workflows.
• AI Integration: Enables AI-driven debugging, refactoring, and generation.
• Automation: Auto-layout for readability; scripts automate graph construction in target editors via simulated input.
• Validation Engine: Checks node existence, connections, and parameter types.
• Target Editor: Specifically for Genshin Impact's Qianxing Sandbox (UGC editor).

Maintenance & Community

Project is Beta, expecting rapid API/rule changes. Feedback via QQ group (1073774505). Repository uses an "exhibition-style" distribution.

Licensing & Compatibility

Licensed under GNU General Public License v3.0 (GPLv3). This copyleft license requires derivative works to also be GPLv3, potentially restricting integration with proprietary code. Commercial use requires careful review of GPLv3 obligations.

Limitations & Caveats

Beta status targets Windows 10/11 with specific display configurations. Automation is tightly coupled to Genshin Impact's Qianxing Sandbox UGC editor, using simulated input with inherent risks. UI is view-only; modifications must be in Python source files.