feat(uxassist): generate blueprint production descriptions

Add native blueprint description generation with proliferation controls, separate power categories, and steady-state material and research reporting.

Distinguish necessary coproducts from overbuild and fractional headroom, with regression checks and updated architecture documentation.

Validation: 464 ProductionCheck checks and Release builds of UXAssist, CheatEnabler, and UniverseGenTweaks.
This commit is contained in:
soarqin committed 2026-10-11 03:13:07 +08:00
1 parent 8696a80a66
commit 307bb4740d
16 files changed
+2294 -51

No files matched your search

+112 -17
View File
@@ -59,19 +59,26 @@ public sealed class FactoryBlackBoxAnalyzer
var diagnostics = new List<ProductionDiagnostic>(request.CaptureDiagnostics);
var groups = new List<ProductionGroupFlow>();
var processGroups = new List<BlackBoxProcessGroup>();
var grossProduction = new SortedDictionary<int, double>();
var grossConsumption = new SortedDictionary<int, double>();
var producers = new Dictionary<int, List<int>>();
var consumers = new Dictionary<int, List<int>>();
var smallestProducer = new Dictionary<int, double>();
var hasResearchMatrixSink = false;
var uncertainDemandItems = new HashSet<int>();
var selectedIds = new HashSet<int>();
var skippedSelection = diagnostics.Any(diagnostic =>
diagnostic.Code == ProductionDiagnosticCode.InvalidRequest ||
diagnostic.Code == ProductionDiagnosticCode.UnknownItem ||
diagnostic.Code == ProductionDiagnosticCode.DataNotReady);
var unknownDemand = skippedSelection;
var materialComplete = !skippedSelection;
var powerComplete = !skippedSelection;
var consumptionWatts = 0.0;
var factoryPowerComplete = !skippedSelection;
var logisticsPowerComplete = !skippedSelection;
var totalPowerKnown = !skippedSelection;
var factoryConsumptionWatts = 0.0;
var logisticsConsumptionWatts = 0.0;
var generationWatts = 0.0;
var chargingWatts = 0.0;
var dischargingWatts = 0.0;
@@ -84,7 +91,9 @@ public sealed class FactoryBlackBoxAnalyzer
diagnostics.Add(new ProductionDiagnostic(ProductionDiagnosticCode.InvalidRequest,
"A selected building has an invalid count."));
materialComplete = false;
powerComplete = false;
factoryPowerComplete = false;
logisticsPowerComplete = false;
unknownDemand = true;
continue;
}
@@ -101,7 +110,9 @@ public sealed class FactoryBlackBoxAnalyzer
"The selected building is not supported by the catalog.",
buildingItemId: snapshot.BuildingItemId));
materialComplete = false;
powerComplete = false;
factoryPowerComplete = false;
logisticsPowerComplete = false;
unknownDemand = true;
continue;
}
@@ -113,7 +124,9 @@ public sealed class FactoryBlackBoxAnalyzer
"A research-mode lab cannot also run a manufacturing recipe.",
recipeId: snapshot.RecipeId, buildingItemId: snapshot.BuildingItemId));
materialComplete = false;
powerComplete = false;
factoryPowerComplete = false;
logisticsPowerComplete = false;
unknownDemand = true;
continue;
}
@@ -132,8 +145,8 @@ public sealed class FactoryBlackBoxAnalyzer
else
logisticsWatts = chargePowerWatts * snapshot.Count;
if (logisticsWatts.HasValue) consumptionWatts += logisticsWatts.Value;
else powerComplete = false;
if (logisticsWatts.HasValue) logisticsConsumptionWatts += logisticsWatts.Value;
else logisticsPowerComplete = false;
groups.Add(new ProductionGroupFlow(null, snapshot.Count, 0, snapshot.Count, snapshot.Count,
logisticsWatts, logisticsWatts, Array.Empty<KeyValuePair<int, double>>(),
Array.Empty<KeyValuePair<int, double>>()));
@@ -149,7 +162,7 @@ public sealed class FactoryBlackBoxAnalyzer
{
var idleWatts = (building.Kind == ProductionBuildingKind.Auxiliary
? building.WorkingPowerWatts : building.IdlePowerWatts) * snapshot.Count;
consumptionWatts += idleWatts;
factoryConsumptionWatts += idleWatts;
groups.Add(new ProductionGroupFlow(null, snapshot.Count, 0, snapshot.Count, snapshot.Count,
idleWatts, idleWatts, Array.Empty<KeyValuePair<int, double>>(),
Array.Empty<KeyValuePair<int, double>>()));
@@ -164,25 +177,53 @@ public sealed class FactoryBlackBoxAnalyzer
"The selected building's recipe is missing.", recipeId: snapshot.RecipeId,
buildingItemId: snapshot.BuildingItemId));
materialComplete = false;
powerComplete = false;
factoryPowerComplete = false;
unknownDemand = true;
continue;
}
if (snapshot.SpeedFactor.HasValue) building = building.WithSpeedFactor(snapshot.SpeedFactor.Value);
var mode = request.ProliferationEnabled
? FullProliferationMode(building, snapshot) : ProliferationMode.None;
if (IsResearchModeLab(building, snapshot) && _catalog.MaximumProliferationLevel == 0)
mode = ProliferationMode.None;
var researchMatrixSink = IsResearchModeLab(building, snapshot) &&
snapshot.OperatingParameters.TryGetValue("ResearchMatrixSink", out var sinkSetting) &&
sinkSetting == 1 && _catalog.ResearchMatrixItemIds.Count > 0;
if (researchMatrixSink) hasResearchMatrixSink = true;
if (!_evaluator.TryEvaluate(_catalog, recipe, building, mode,
mode == ProliferationMode.None ? 0 : _catalog.MaximumProliferationLevel,
snapshot.OperatingParameters, out var process, out var diagnostic))
{
diagnostics.Add(diagnostic);
if (building.Kind != ProductionBuildingKind.RenewableGenerator) materialComplete = false;
powerComplete = false;
if (building.Kind != ProductionBuildingKind.RenewableGenerator && !researchMatrixSink)
materialComplete = false;
if (recipe != null) uncertainDemandItems.UnionWith(recipe.Inputs.Keys);
else if (building.Kind != ProductionBuildingKind.Miner &&
building.Kind != ProductionBuildingKind.Collector &&
building.Kind != ProductionBuildingKind.RenewableGenerator && !researchMatrixSink)
unknownDemand = true;
if (TryGetConsumptionWithoutMaterials(building, snapshot, diagnostic, mode,
out var knownWatts))
{
if (!IsResearchModeLab(building, snapshot)) totalPowerKnown = false;
factoryConsumptionWatts += knownWatts;
groups.Add(new ProductionGroupFlow(null, snapshot.Count, 0, snapshot.Count, snapshot.Count,
knownWatts, knownWatts, Array.Empty<KeyValuePair<int, double>>(),
Array.Empty<KeyValuePair<int, double>>()));
}
else
{
totalPowerKnown = false;
factoryPowerComplete = false;
}
continue;
}
if (diagnostic != null) diagnostics.Add(diagnostic);
if (!process.PowerKnown) powerComplete = false;
if (!process.PowerKnown) totalPowerKnown = false;
if (process.WorkingPowerWatts < 0 || double.IsNaN(process.WorkingPowerWatts) ||
double.IsInfinity(process.WorkingPowerWatts * snapshot.Count)) factoryPowerComplete = false;
var cycleRate = process.CyclesPerBuildingPerMinute;
var output = Scale(process.OutputsPerCycle, cycleRate * snapshot.Count);
var input = Scale(process.InputsPerCycle, cycleRate * snapshot.Count);
@@ -205,7 +246,7 @@ public sealed class FactoryBlackBoxAnalyzer
}
var watts = process.WorkingPowerWatts * snapshot.Count;
consumptionWatts += watts;
factoryConsumptionWatts += watts;
generationWatts += process.GenerationWatts * snapshot.Count;
chargingWatts += process.AccumulatorChargingWatts * snapshot.Count;
dischargingWatts += process.AccumulatorDischargingWatts * snapshot.Count;
@@ -217,8 +258,13 @@ public sealed class FactoryBlackBoxAnalyzer
process.DysonSphereRequirementWatts * snapshot.Count,
cycleRate * snapshot.Count * process.LaunchesPerCycle,
cycleRate * snapshot.Count * process.ResearchHashesPerCycle));
processGroups.Add(new BlackBoxProcessGroup(process, snapshot));
}
var matrixSinkItems = hasResearchMatrixSink
? new HashSet<int>(_catalog.ResearchMatrixItemIds) : new HashSet<int>();
var classifications = BlackBoxMaterialClassifier.Classify(processGroups, grossProduction, grossConsumption,
materialComplete, uncertainDemandItems, unknownDemand, matrixSinkItems, out var steadyStateBalance);
var flows = new List<ProductionItemFlow>();
var allItems = new SortedSet<int>(grossProduction.Keys);
allItems.UnionWith(grossConsumption.Keys);
@@ -228,22 +274,32 @@ public sealed class FactoryBlackBoxAnalyzer
var consumed = grossConsumption.TryGetValue(itemId, out var c) ? c : 0;
var net = produced - consumed;
var threshold = smallestProducer.TryGetValue(itemId, out var single) ? single : 0;
var isFinalProduct = produced > 1e-9 && consumed <= 1e-9;
var classification = classifications[itemId];
var isFinalProduct = classification.IsFinalProduct;
flows.Add(new ProductionItemFlow(itemId, produced, consumed, 0, 0, 0,
Math.Max(0, net), Math.Max(0, -net), isFinalProduct,
!isFinalProduct && consumed > 1e-9 && net > 1e-9 && threshold > 0 &&
classification.IsIntermediate && !matrixSinkItems.Contains(itemId) &&
net > 1e-9 && threshold > 0 &&
net + 1e-9 >= threshold,
threshold, producers.TryGetValue(itemId, out var producing) ? producing : Array.Empty<int>(),
consumers.TryGetValue(itemId, out var usingItem) ? usingItem : Array.Empty<int>()));
consumers.TryGetValue(itemId, out var usingItem) ? usingItem : Array.Empty<int>(),
classification.IntermediateShortage, classification.OverbuildSurplus,
classification.CoproductSurplus,
steadyStateBalance == null ? null : Math.Max(0, -steadyStateBalance[itemId]),
classification.IsResearchProduct));
}
var powerComplete = factoryPowerComplete && logisticsPowerComplete && totalPowerKnown;
var consumptionWatts = factoryConsumptionWatts + logisticsConsumptionWatts;
var power = powerComplete ? new ProductionPower(consumptionWatts, consumptionWatts, generationWatts,
chargingWatts, dischargingWatts, dysonRequirementWatts,
ProductionPowerScope.SelectedFacilities) : null;
var status = materialComplete && powerComplete && diagnostics.Count == 0
? ProductionStatus.Complete : materialComplete || powerComplete || groups.Count > 0
? ProductionStatus.Partial : ProductionStatus.Failed;
return new ProductionReport(status, materialComplete, powerComplete, flows, groups, diagnostics, power);
return new ProductionReport(status, materialComplete, powerComplete, flows, groups, diagnostics, power,
new ProductionPowerBreakdown(factoryConsumptionWatts, logisticsConsumptionWatts,
factoryPowerComplete, logisticsPowerComplete));
}
private static ProliferationMode FullProliferationMode(ProductionBuilding building,
@@ -272,6 +328,45 @@ public sealed class FactoryBlackBoxAnalyzer
}
}
private bool TryGetConsumptionWithoutMaterials(ProductionBuilding building,
ProductionBuildingSnapshot snapshot, ProductionDiagnostic diagnostic, ProliferationMode mode,
out double watts)
{
watts = 0;
if (IsResearchModeLab(building, snapshot))
{
var multiplier = 1.0;
if (mode != ProliferationMode.None)
{
if (mode != ProliferationMode.ExtraProducts) return false;
if (_catalog.MaximumProliferationLevel > 0 &&
!_catalog.TryGetProliferation(_catalog.MaximumProliferationLevel,
out _, out _, out multiplier)) return false;
}
watts = building.WorkingPowerWatts * multiplier * snapshot.Count;
return watts > 0 && !double.IsNaN(watts) && !double.IsInfinity(watts);
}
if (diagnostic?.Code != ProductionDiagnosticCode.MissingOperatingParameter) return false;
if (building.Kind == ProductionBuildingKind.Collector) return true;
if (building.Kind != ProductionBuildingKind.Miner) return false;
var speed = snapshot.OperatingParameters.TryGetValue("MachineSpeedFactor", out var capturedSpeed)
? capturedSpeed : 1;
if (speed <= 0 || double.IsNaN(speed) || double.IsInfinity(speed)) return false;
var ratio = speed * speed;
watts = (building.WorkingPowerWatts * ratio + building.IdlePowerWatts * (1 - ratio)) * snapshot.Count;
return watts >= 0 && !double.IsNaN(watts) && !double.IsInfinity(watts);
}
private static bool IsResearchModeLab(ProductionBuilding building, ProductionBuildingSnapshot snapshot)
{
return building.Kind == ProductionBuildingKind.Ordinary &&
building.Category == ProductionRecipeCategory.Research && snapshot.RecipeId == 0 &&
snapshot.OperatingParameters.TryGetValue("ResearchMode", out var researchMode) && researchMode == 1;
}
private static Dictionary<int, double> Scale(IReadOnlyDictionary<int, double> flows, double factor)
{
return flows.ToDictionary(entry => entry.Key, entry => entry.Value * factor);