2026-11-01 13:47:16 +01:00
|
|
|
|
# Hinweise für Agenten
|
|
|
|
|
|
|
2026-11-10 17:09:11 +01:00
|
|
|
|
## Website und Downloads
|
2026-11-01 13:47:16 +01:00
|
|
|
|
|
2026-11-10 17:09:11 +01:00
|
|
|
|
- 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.)
|
2026-11-01 13:47:16 +01:00
|
|
|
|
|
2026-11-10 17:09:11 +01:00
|
|
|
|
## 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).
|
2026-11-01 14:15:16 +01:00
|
|
|
|
|
2026-11-03 23:48:01 +01:00
|
|
|
|
## 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.
|
|
|
|
|
|
|
2026-11-01 14:15:16 +01:00
|
|
|
|
## 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).
|
2026-11-01 15:47:55 +01:00
|
|
|
|
- **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.
|