gt7-tuner（GT7 调谐器）

GT7 Tuner — Gran Turismo 7 AI Tuning Assistant

Turn any GT7 car into a weapon. Send a screenshot, get a pro tune.

Prerequisites

⚠️ You need a GT Pro Tune account (https://app.gtprotune.com/)

• Free accounts have limited features
• Pro account recommended ($4.99/month) — unlocks full suspension/transmission calculations, Image Analyzer, and Race Engineer
• Sign up at https://app.gtprotune.com/register
• Store your credentials securely (never log or echo them)

When to Use

• User wants to tune a car in Gran Turismo 7
• User sends a screenshot/photo of their GT7 car settings
• User mentions GT Pro Tune, car setup, suspension, gearing, or tuning
• User says something like "tune my [car] for [track]"
• Any Gran Turismo 7 tuning-related request

How It Works

The Quick Flow

1. User sends a photo of their GT7 settings screen (from TV/monitor)
2. Agent reads the values using vision (OCR) — PP, weight, HP, tire compound, etc.
3. Agent confirms values with user (confidence check — only use values that are clearly readable)
4. Agent fills GT Pro Tune via agent-browser automation
5. Agent reads the calculated tune and reports it back
6. User applies the tune in GT7

Photo OCR Pipeline

When the user sends a GT7 screenshot (photo of TV screen):

1. Read the image with vision capabilities
2. Extract all visible values: PP, weight (kg or lbs), HP, torque, tire compound, etc.
3. For each value, assess confidence:

- High confidence (>95%): use directly - Low confidence: ask user to confirm or re-send a clearer photo

1. Convert units if needed (kg → lbs, kW → HP, Nm → ft-lb)
2. Present extracted values to user for confirmation before proceeding

Tips for better photos:

• Take the photo straight-on (reduce angle)
• Minimize screen glare/reflections
• Ensure the full settings screen is visible
• PS5 screenshots via Share button → PS App are ideal (pixel-perfect)

GT Pro Tune Web App

Login

agent-browser open "https://app.gtprotune.com/login"
# Fill email and password fields, click Login
# Credentials must be stored securely — NEVER log, echo, or display them

Important: Angular Input Handling

GT Pro Tune is built with Angular 17. When filling form fields:

• Use agent-browser fill @ref "value" followed by agent-browser press "Tab" — this triggers Angular's change detection
• Do NOT use eval/DOM manipulation to set values — Angular's reactive forms won't detect the changes
• For dropdowns (ngb-typeahead): type the search text, wait for results, then use eval to click the matching option
• For select elements: use agent-browser select @ref "value"

App Structure

Tab 1: Car/Track Settings

Tab 2: Suspension Settings

Tab 3: Transmission Settings

Vehicle Selection (Angular Typeahead)

agent-browser click @e15                    # Focus vehicle search
agent-browser keyboard type "F8 Tributo"    # Type car name (spaces may cause CDP errors — use partial names)
sleep 2                                     # Wait for dropdown
agent-browser eval "(function(){var items=document.querySelectorAll('ngb-typeahead-window button');var match=Array.from(items).find(function(e){return e.textContent.includes('F8 Tributo')});if(match){match.click();return 'selected'}return 'not found'})()"

Reading Results

After filling all three tabs, the app calculates:

Suspension output table:

• Anti-Roll Bar (Front/Rear)
• Damper Compression (Front/Rear)
• Damper Extension (Front/Rear)
• Spring Rate (Front/Rear)
• Camber Angle (Front/Rear)
• Toe Angle (Front/Rear)

Transmission output table:

• Final Gear Ratio
• Individual Gear Ratios (1st through 7th+)

Differential output table:

• Initial Torque (Front/Rear)
• Acceleration (Front/Rear)
• Deceleration (Front/Rear)

Image Analyzer (Premium Feature)

GT Pro Tune has a built-in Image Analyzer that can extract dyno data from GT7 screenshots:

agent-browser click @e7  # Image Analyzer button
# Upload a screenshot of the dyno/power graph from GT7

Driving Style Presets

When the user describes a driving style, translate to suspension parameters:

Unit Conversions

• Weight: 1 kg = 2.20462 lbs
• Torque: 1 kgf·m = 7.233 ft-lb / 1 Nm = 0.7376 ft-lb
• Power: 1 PS ≈ 0.9863 HP (close enough to use interchangeably for GT7)

GT7 Tuning Knowledge

See references/gt7-tuning-knowledge.md for:

• Latest patch changes affecting tuning (1.55, 1.66)
• Current meta (post-patch suspension, tire, LSD guidelines)
• GT7-specific physics quirks vs real-world racing
• Track-specific tuning workflows

Notes

• All 581 GT7 cars are supported
• Units: weight in lb, height in mm, speed in MPH, torque in ft-lb
• The app calculates optimal settings — we input specs, it outputs the tune
• GT7 Race Engineer (AI feature) requires a separate subscription tier
• Always verify calculated tunes with a few laps in-game and adjust based on feel