# Hinweise für Agenten ## Website und Downloads - Die Rinkplanner-Seite liegt nur noch unter `rinkplanner.programmschmiede.de/index.html`. `programmschmiede.de/rinkplanner.html` leitet per Root-`.htaccess` (301) dorthin um; keine zweite Kopie anlegen. - Builds liegen unter `programmschmiede.de/rinkplanner/download/`. Die Download-Links in der Subdomain-Seite sind absolut (`https://programmschmiede.de/rinkplanner/download/...`). - Beim macOS-Build `rinkplanner.zip` und `start_rinkplanner.command` mit hochladen. **Das Start-Skript nicht zippen** – es wird direkt als `.command` abgelegt. (Stand 2026-10-31 so vom Nutzer gewünscht.) ## Windows-Installer - `./tools/setup_windows_installer.sh` richtet NSIS lokal unter `~/.local/share/rinkplanner-toolchain` ein (kein Root). - `./tools/export_windows_installer.sh` baut `build/windows/rinkplanner-setup.exe`; `--no-export` nutzt die vorhandene `rinkplanner.exe`. - Der Installer ist per-user (kein Admin) und unsigniert (SmartScreen). ## Dateiformat und Release-Check - Neue Kürdateien werden als JSON gespeichert (`RoutineFile`). `.tres` ist nur noch Legacy-Import und wird vor dem Laden per Whitelist geprüft; nicht wieder als neues Speicherformat einführen. - Vor einem Release `./tools/check_export.sh` laufen lassen. Es baut den Linux-Export, startet ihn headless und prüft Autoload, Testausschluss und die Skater-Texturen. Die GLB muss vorher per `tools/sync_assets.sh --sync` vorliegen. ## MCP-Werkzeuge - **Godot:** `godot-mcp` steuert das Projekt über `--project rinkplanner/rinkplanner`. Die Live-Editor-Werkzeuge brauchen das Addon `rinkplanner/addons/godot_ai_bridge` (Port 6550, startet mit dem Editor). - `godot_ai_bridge` ist eine Kopie aus `/opt/godot-mcp` **mit lokalem Patch**. Beim Neukopieren den Patch aus `docs/findings-2026-11-01-godot-ai-bridge.md` erneut anwenden, sonst meldet jeder `--import`-Lauf „6 ObjectDB instances leaked at exit". - **Blender:** `mcp-for-blender` über `uvx`, Addon in `~/.config/blender/5.2/scripts/addons/blender_mcp.py` (Port 9876). - **fal:** Remote-Server `https://mcp.fal.ai/mcp-relay` (Streamable HTTP) mit `Authorization: Bearer {env:FAL_KEY}` in `opencode.jsonc`. Kein OAuth nötig – der Relay akzeptiert den API-Key als Bearer, der Browser-Login scheitert dagegen oft am lokalen Callback-Port. Der Key liegt in `~/.config/environment.d/90-fal.conf` (Modus 600), im systemd-Format; `~/.bashrc` sourct dieselbe Datei vor dem Interaktiv-Guard. Meldet fal `needs authentication`, fehlt dem OpenCode-Dienst die Variable: `systemctl --user import-environment FAL_KEY && opencode service restart`. Nach einer Key-Rotation ebenso: Datei anpassen, import-environment, Neustart. `run_model` und `submit_job` lösen kostenpflichtige Generierungen aus – vorher Modell und Preis nennen und die Zustimmung abwarten.