This commit is contained in:
2026-05-02 05:35:16 +09:00
parent 57aeba4bb8
commit e40a2a568e
36 changed files with 3198 additions and 411 deletions

View File

@@ -25,7 +25,7 @@ Use this skill to make the smallest safe change to a cut-related workflow, then
- Use [validation-workflow.md](references/validation-workflow.md) for command selection.
- For a scoped live pass, prefer `scripts/validate-cut.ps1`.
- For scene-level snapshots or raw object checks, use `tools/KarismaTcpProbe` directly.
- If live Karisma or `T3_Cut` is unavailable, still run the build and document the missing external dependency.
- If live Karisma or the fixed `D:\Elect2026\T3_Cut` root is unavailable, still run the build and document the missing external dependency.
4. Report the result in operational terms.
- Name the files changed.
@@ -35,7 +35,7 @@ Use this skill to make the smallest safe change to a cut-related workflow, then
## Repo Notes
- Treat the repo as the source of truth for cut metadata and validation helpers.
- Treat `T3_Cut` as an external dependency that may contain the real scene or asset causing the issue.
- Treat `D:\Elect2026\T3_Cut` as the fixed external dependency that may contain the real scene or asset causing the issue.
- Prefer targeted validation with a template or cut filter instead of sweeping the whole catalog unless the user asks for a broad audit.
- Reuse existing `tools/KarismaTcpProbe/scene-ops/*.json` fixtures when they match the symptom instead of inventing a new validation format.

View File

@@ -19,7 +19,7 @@ Use this reference to decide where a cut-related change belongs.
- `Tornado3_2026Election/Services/FormatCatalogService.cs`: template and cut catalog.
- `Tornado3_2026Election/Services/KarismaSceneResolver.cs`: resolve the actual `.tscn` or `_loop.tscn` path.
- `Tornado3_2026Election/Services/KarismaSceneVariableCatalog.cs`: scene-variable discovery and lookup cache.
- `Tornado3_2026Election/Services/TornadoPathResolver.cs`: default and normalized `T3_Cut` path handling.
- `Tornado3_2026Election/Services/TornadoPathResolver.cs`: fixed `D:\Elect2026\T3_Cut` path handling.
- `Tornado3_2026Election/Services/CutThumbnailAssetCatalog.cs`: project thumbnail asset locations.
## Runtime apply logic

View File

@@ -10,11 +10,10 @@ dotnet build Tornado3_2026Election.slnx
## 2. Run scoped live validation for a cut or template
Use the local wrapper when Karisma and `T3_Cut` are available.
Use the local wrapper when Karisma and `D:\Elect2026\T3_Cut` are available. The root is fixed; do not pass a custom image root.
```powershell
powershell -ExecutionPolicy Bypass -File plugins/cut-design-debugger/skills/cut-design-debugger/scripts/validate-cut.ps1 `
-ImageRootPath 'C:\Path\To\T3_Cut' `
-Filter '1-2위_ani_광역단체장'
```
@@ -31,7 +30,7 @@ Use this when the problem is visual and you already know the exact `.tscn` scene
```powershell
dotnet run --project tools/KarismaTcpProbe/KarismaTcpProbe.csproj -- `
--save-scene-image `
--scene 'C:\Path\To\T3_Cut\SomeScene.tscn' `
--scene 'D:\Elect2026\T3_Cut\SomeScene.tscn' `
--output artifacts\scene-captures\some-scene.png
```
@@ -42,7 +41,7 @@ Use this when the issue is about values, visibility, or style updates for known
```powershell
dotnet run --project tools/KarismaTcpProbe/KarismaTcpProbe.csproj -- `
--validate-scene-values `
--scene 'C:\Path\To\T3_Cut\SomeScene.tscn' `
--scene 'D:\Elect2026\T3_Cut\SomeScene.tscn' `
--operations tools/KarismaTcpProbe/scene-ops/1-2위_ani_광역단체장_style.json `
--output artifacts\scene-validation\style.md
```
@@ -52,6 +51,5 @@ dotnet run --project tools/KarismaTcpProbe/KarismaTcpProbe.csproj -- `
```powershell
dotnet run --project tools/KarismaTcpProbe/KarismaTcpProbe.csproj -- `
--inspect-tscn-folder `
--root 'C:\Path\To\T3_Cut' `
--output artifacts\scene-inspection\inspection.md
```

View File

@@ -10,6 +10,7 @@ param(
$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot "..\..\..\..\..")).Path
$probeProject = Join-Path $repoRoot "tools\KarismaTcpProbe\KarismaTcpProbe.csproj"
$fixedImageRootPath = "D:\Elect2026\T3_Cut"
if ([string]::IsNullOrWhiteSpace($OutputPath))
{
@@ -27,11 +28,6 @@ $commandArgs = @(
"--between-delay-ms", $BetweenDelayMs.ToString()
)
if (-not [string]::IsNullOrWhiteSpace($ImageRootPath))
{
$commandArgs += @("--image-root", $ImageRootPath)
}
if (-not [string]::IsNullOrWhiteSpace($Filter))
{
$commandArgs += @("--filter", $Filter)
@@ -49,7 +45,12 @@ if ($IncludeVideoWall)
Write-Host "Running live-cut validation..."
Write-Host "Repo Root : $repoRoot"
Write-Host "Image Root: $fixedImageRootPath"
Write-Host "Output : $OutputPath"
if (-not [string]::IsNullOrWhiteSpace($ImageRootPath))
{
Write-Host "ImageRootPath parameter ignored; fixed root is used."
}
if (-not [string]::IsNullOrWhiteSpace($Filter))
{
Write-Host "Filter : $Filter"