rinkplanner/AGENTS.md
torsten e28f8976f2 feat: Windows-Installer-Pipeline (NSIS, per-user)
- tools/setup_windows_installer.sh richtet NSIS lokal ohne Root ein
- tools/export_windows_installer.sh baut die EXE und
  build/windows/rinkplanner-setup.exe; --no-export nutzt die vorhandene EXE
- tools/windows_installer.nsi: per-user Installation nach
  %LOCALAPPDATA%\Programs\Rinkplanner, Startmenü-/Desktop-Verknüpfung,
  Uninstaller, keine Adminrechte
- tools/make_windows_icon.py erzeugt das Installer-Icon aus app_icon.png
- docs/builds.md und AGENTS.md dokumentieren Pipeline und aktuelle
  Website-Struktur (Subdomain als einzige Seite)
2026-11-10 17:09:11 +01:00

2.8 KiB
Raw Blame History

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.