XFEEDToolBox

【WinUI】XFE精英危险工具箱

公开

关注 0 Fork 0 Star 0

XFEstudio/XFEEDToolBox

Move native trade execution into the trade planning page

Replace the separate execution navigation entry with one automatic execution button beside the route planner. Recalculate the current request before execution and discard the previous route on calculation failure. Keep progress, next stop and confirmed service-adjusted profit on the same page, with cancellation on the initiating button. Read verified docked-commerce capabilities from the native handshake instead of the obsolete package manifest flag. Retain mandatory flight prerequisites before procurement; this does not claim SCO, escape-vector control or the complete trading journey has passed. Validation: WinUI Release build with zero warnings/errors; eight native capability regressions; background screenshots, OCR and read-only UI checks. No trade or flight actions were issued for UI verification.

5071580

XFE工作室室长 <mail@xfegzs.com>

提交于 2026-10-24 19:44

父提交 4056c6e

代码差异

11 个文件 +167 -23

Added XFEEDToolBox.Core/Execution/NativeTradeCapabilities.cs +27 -0

@@ -0,0 +1,27 @@

1 using System.Text.Json;

2 using XFEEDToolBox.Core.Native;

4 namespace XFEEDToolBox.Core.Execution;

6 public static class NativeTradeCapabilities

7 {

8 public static bool SupportsDockedTrade(JsonElement description) =>

9 description.ValueKind == JsonValueKind.Object

        && description.TryGetProperty("schema", out var schema) && schema.ValueKind == JsonValueKind.Number && schema.TryGetInt32(out var version) && version == 1

11 && Text(description, "name") == "XFEEDToolBox.Navigation"

12 && Flag(description, "verified")

13 && Text(description, "gameSha256") == NativeSystemLocationReader.GameSha256

14 && Flag(description, "commerceDockedReadiness")

15 && Flag(description, "cgCommodityBatches");

17 public static void RequireProductionFlight(JsonElement description)

18 {

19 if (!SupportsDockedTrade(description))

20 throw new NotSupportedException("当前游戏的原生交易接口尚未验证，采购尚未启动。");

21 if (!Flag(description, "supercruiseOverchargeControl") || !Flag(description, "interdictionEscapeControl"))

            throw new NotSupportedException("SCO温控、燃油控制和原始逃逸矢量尚未全部就绪，采购尚未启动。");

23 }

    private static bool Flag(JsonElement value, string name) => value.TryGetProperty(name, out var flag) && flag.ValueKind == JsonValueKind.True;

    private static string? Text(JsonElement value, string name) => value.TryGetProperty(name, out var text) && text.ValueKind == JsonValueKind.String ? text.GetString() : null;

27 }

Added XFEEDToolBox.Test/NativeTradeCapabilitiesTests.cs +41 -0

@@ -0,0 +1,41 @@

1 using System.Text.Json;

2 using XFEEDToolBox.Core.Execution;

3 using XFEEDToolBox.Core.Native;

4 using XFEExtension.NetCore.XUnit.Attributes;

6 namespace XFEEDToolBox.Test;

8 [TestFixture]

9 public class NativeTradeCapabilitiesTests

10 {

11 private static Dictionary<string, object> Handshake => new()

12 {

13 ["schema"] = 1, ["name"] = "XFEEDToolBox.Navigation", ["verified"] = true,

14 ["gameSha256"] = NativeSystemLocationReader.GameSha256,

15 ["commerceDockedReadiness"] = true, ["cgCommodityBatches"] = true

16 };

    private static bool Ready(Dictionary<string, object> value) => NativeTradeCapabilities.SupportsDockedTrade(JsonSerializer.SerializeToElement(value));

    [Test] public void VerifiedNativeCapabilitiesEnableTradeWithoutTheLegacyManifestFlag() => Check.Equal(true, Ready(Handshake));

20 [Test] public void AnUnverifiedInterfaceCannotEnableExecution()

21 { var value = Handshake; value["verified"] = false; Check.Equal(false, Ready(value)); }

22 [Test] public void AnotherGameBuildCannotEnableExecution()

23 { var value = Handshake; value["gameSha256"] = new string('0', 64); Check.Equal(false, Ready(value)); }

24 [Test] public void MissingBatchCapabilityCannotEnableExecution()

25 { var value = Handshake; value.Remove("cgCommodityBatches"); Check.Equal(false, Ready(value)); }

26 [Test] public void MissingDockedReadinessCannotEnableExecution()

27 { var value = Handshake; value["commerceDockedReadiness"] = false; Check.Equal(false, Ready(value)); }

28 [Test] public void AStringInsteadOfACapabilityIsNotAccepted()

29 { var value = Handshake; value["cgCommodityBatches"] = "true"; Check.Equal(false, Ready(value)); }

30 [Test] public void DockedCommerceAloneCannotStartAProductionFlight()

31 {

32 try { NativeTradeCapabilities.RequireProductionFlight(JsonSerializer.SerializeToElement(Handshake)); }

33 catch (NotSupportedException) { return; }

34 throw new InvalidOperationException("The original flight prerequisites were bypassed.");

35 }

36 [Test] public void ProductionFlightRequiresBothOriginalControlCapabilities()

37 {

38 var value = Handshake; value["supercruiseOverchargeControl"] = true; value["interdictionEscapeControl"] = true;

39 NativeTradeCapabilities.RequireProductionFlight(JsonSerializer.SerializeToElement(value));

40 }

41 }

Modified XFEEDToolBox/ViewModels/NavigationViewModel.cs +4 -4

@@ -1,4 +1,4 @@

1 using CommunityToolkit.Mvvm.ComponentModel;

2 2 using CommunityToolkit.Mvvm.Input;

3 3 using XFEEDToolBox.Core.Models;

4 4 using XFEEDToolBox.Core.Navigation;

@@ -79,7 +79,7 @@ public partial class ToolboxViewModel

79 79 RefreshNavigationStartHint();

80 80 StartNavigationCommand.NotifyCanExecuteChanged();StopNavigationCommand.NotifyCanExecuteChanged();

81 81

            StartGameCommand.NotifyCanExecuteChanged();RelogGameCommand.NotifyCanExecuteChanged();RestartGameCommand.NotifyCanExecuteChanged();

82 StartPlanCommand.NotifyCanExecuteChanged();

82 RefreshTradePlanCommands();

83 83 });

84 84 }

85 85 partial void OnNavigationDestinationChanged(string value){if(initialized)RefreshNavigation(CurrentPlayer);}

@@ -238,7 +238,7 @@ public partial class ToolboxViewModel

238 238 if(!CanStartNavigation())return;

239 239

        using var startStop=CancellationTokenSource.CreateLinkedTokenSource(lifetime.Token);navigationStartStop=startStop;

240 240 NavigationActive=true;RefreshNavigationStartHint();StopNavigationCommand.NotifyCanExecuteChanged();

241

        StartGameCommand.NotifyCanExecuteChanged();StartPlanCommand.NotifyCanExecuteChanged();RelogGameCommand.NotifyCanExecuteChanged();RestartGameCommand.NotifyCanExecuteChanged();

241

        StartGameCommand.NotifyCanExecuteChanged();RefreshTradePlanCommands();RelogGameCommand.NotifyCanExecuteChanged();RestartGameCommand.NotifyCanExecuteChanged();

242 242 LogNavigation("启动导航",$"收到启动请求：{NavigationDestination.Trim()}");

243 243 try

244 244 {

@@ -252,7 +252,7 @@ public partial class ToolboxViewModel

252 252 catch(OperationCanceledException)when(lifetime.IsCancellationRequested){}

253 253

        catch(OperationCanceledException)when(startStop.IsCancellationRequested){NavigationStatus="自动导航已停止。";NavigationStatusSeverity=InfoBarSeverity.Warning;LogNavigation("导航取消",NavigationStatus);}

254 254

        catch(Exception e){NavigationStatus=e.Message;NavigationStatusSeverity=InfoBarSeverity.Error;LogNavigation("导航未启动",e.Message);}

255

        finally{navigationStartStop=null;NavigationActive=false;RefreshNavigationStartHint();StartGameCommand.NotifyCanExecuteChanged();StartNavigationCommand.NotifyCanExecuteChanged();StopNavigationCommand.NotifyCanExecuteChanged();StartPlanCommand.NotifyCanExecuteChanged();RelogGameCommand.NotifyCanExecuteChanged();RestartGameCommand.NotifyCanExecuteChanged();}

255

        finally{navigationStartStop=null;NavigationActive=false;RefreshNavigationStartHint();StartGameCommand.NotifyCanExecuteChanged();StartNavigationCommand.NotifyCanExecuteChanged();StopNavigationCommand.NotifyCanExecuteChanged();RefreshTradePlanCommands();RelogGameCommand.NotifyCanExecuteChanged();RestartGameCommand.NotifyCanExecuteChanged();}

256 256 }

257 257 private bool CanStopNavigation()=>NavigationActive;

258 258

    [RelayCommand(CanExecute=nameof(CanStopNavigation))] private void StopNavigation(){navigationStartStop?.Cancel();runtime.Navigator.Stop();}

Modified XFEEDToolBox/ViewModels/PluginViewModel.cs +13 -3

@@ -1,3 +1,4 @@

1 using XFEEDToolBox.Core.Execution;

1 2 using System.Diagnostics;

2 3 using System.Text.RegularExpressions;

3 4 using CommunityToolkit.Mvvm.ComponentModel;

@@ -66,7 +67,16 @@ public partial class ToolboxViewModel

66 67

                        await runtime.BindFlightDriverAsync(new NativeFlightControlDriver(game.Id,state.Installation!.GameSha256,()=>runtime.Player,()=>runtime.Settings.NavigationFuelReserve,

67 68

                            new NativeGameInputChannel(game.Id,state.Installation.GameSha256,Path.Combine(AppContext.BaseDirectory,"PluginPackage"))),lifetime.Token);

68 69 }

                PluginTradeReady=!state.PendingRemoval&&hello.Loaded&&hello.Active&&hello.SupportsTrade&&pluginManager.Package().SupportsTrade;

                if (!state.PendingRemoval && hello.Loaded && hello.Active && runtime.FlightDriver is NativeFlightControlDriver tradeFlight)

71 {

72 try

73 {

                        var capabilities = await new NativeCommerceChannel(tradeFlight.ProcessId).CallAsync(new { op = "describe" }, lifetime.Token);

75 PluginTradeReady = NativeTradeCapabilities.SupportsDockedTrade(capabilities);

76 }

77 catch (OperationCanceledException) when (lifetime.IsCancellationRequested) { throw; }

78 catch (Exception error) { runtime.Log("交易接口", error.Message); }

79 }

70 80

                PluginNavigationReady=!state.PendingRemoval&&hello.Loaded&&hello.Active&&hello.SupportsNavigation&&pluginManager.Package().SupportsNavigation&&runtime.FlightDriver is not null;

71 81

                PluginStatusText=$"插件已加载 · PID {game.Id} · {hello.Version}\n"+(hello.Active?"基础通信可用。\n"+(PluginNavigationReady?"自动导航驱动已就绪。":"等待进入飞行状态并完成原生遥测握手。")+"\n"+(PluginTradeReady?"自动贸易接口已就绪。":"自动贸易与底层重进适配尚未完成。"):"插件已停用，加载文件等待游戏退出后清理。");

72 82

                NavigationNativeStatus=PluginNavigationReady?"原生导航已连接：姿态、实时热量、恒星边界、目标锁定和充能等待联锁。":hello.Active?"插件已加载，等待飞行状态和原生遥测。":"插件已停用。";

@@ -127,9 +137,9 @@ public partial class ToolboxViewModel

127 137 if(!PluginNavigationReady||runtime.FlightDriver is not NativeFlightControlDriver driver)

128 138

            throw new InvalidOperationException("插件导航接口尚未就绪，工具箱暂不发出贸易或飞行指令。");

129 139 var hello=await new NavigationPipeClient(driver.ProcessId).CallAsync(new{op="describe"},lifetime.Token);

130

        if(!hello.TryGetProperty("commerceDockedReadiness",out var docking)||docking.ValueKind!=System.Text.Json.JsonValueKind.True

131

            ||!hello.TryGetProperty("cgCommodityBatches",out var batches)||batches.ValueKind!=System.Text.Json.JsonValueKind.True)

140 if(!NativeTradeCapabilities.SupportsDockedTrade(hello))

132 141 throw new NotSupportedException("当前插件尚未提供经过验证的停靠交易接口。");

142 NativeTradeCapabilities.RequireProductionFlight(hello);

133 143 PluginTradeReady=true;

134 144 }

135 145 }

Modified XFEEDToolBox/ViewModels/ToolboxViewModel.cs +21 -8

@@ -126,8 +126,10 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

126 126 [ObservableProperty] public partial int ExecutionModeIndex { get; set; }

127 127

    [ObservableProperty] public partial string ExecutionHint { get; set; } = "模拟演练只展示步骤，不向游戏发送输入。";

128 128 [ObservableProperty] public partial string RunStatus { get; set; } = "等待路线";

129 [ObservableProperty] public partial string RunMessage { get; set; } = "先计算路线，再选择执行方式。";

129

    [ObservableProperty] public partial string RunMessage { get; set; } = "选择起点和参数，点击自动执行即可开始；也可先预览路线。";

130 130 [ObservableProperty] public partial string ActualProfit { get; set; } = "0 Cr";

131 [ObservableProperty] public partial string ProfitLabel { get; set; } = "已确认净利润";

132

    [ObservableProperty] public partial string ProfitDetails { get; set; } = "按实际成交和停靠服务回执更新。";

131 133 [ObservableProperty] public partial double RunPercent { get; set; }

132 134 [ObservableProperty] public partial string NextDestination { get; set; } = "—";

133 135 [ObservableProperty] public partial string JournalDirectory { get; set; } = "";

@@ -189,9 +191,12 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

189 191

        RunStatus = progress.State switch { RunState.Running => "执行中", RunState.Paused => "已暂停", RunState.Completed => "已完成", RunState.Stopped => "已停止", RunState.Failed => "需要处理", _ => "等待路线" };

190 192 RunMessage = progress.Message;

191 193 ActualProfit = $"{progress.ActualProfit:N0} Cr";

194 ProfitLabel = progress.IsSimulation ? "模拟预计净收益" : "已确认净利润";

195 var costs = progress.Accounting;

196

        ProfitDetails = progress.IsSimulation ? "规划估计值，未发生实际交易。" : $"燃油 {costs.Fuel:N0} · 维修 {costs.Repairs:N0} · 补给 {costs.Rearm:N0} · 其他支出 {costs.OtherExpenses:N0} Cr\n在途货物成本 {costs.CargoInvestment:N0} Cr · 现金变动 {costs.CashChange:+#,0;-#,0;0} Cr";

192 197

        RunPercent = progress.State == RunState.Completed ? 100 : progress.TotalLegs == 0 ? 0 : (progress.Leg - 1d) / progress.TotalLegs * 100;

193 198 NextDestination = Plan?.Legs.ElementAtOrDefault(Math.Max(0, progress.Leg - 1))?.To.DisplayName ?? "—";

194 StartPlanCommand.NotifyCanExecuteChanged(); CalculateCommand.NotifyCanExecuteChanged();

199 RefreshTradePlanCommands(); CalculateCommand.NotifyCanExecuteChanged();

195 200 });

196 201

197 202 public async Task InitializeAsync()

@@ -234,12 +239,19 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

234 239 FittedModules.Apply(value?.Modules ?? []);

235 240

        SelectedShipSummary = value == null ? "没有飞船装配记录。" : $"{value.DisplayName} · {value.Ident}\n{value.Location} · {value.ConfigurationStatus}\n货舱 {value.CargoCapacity?.ToString() ?? "—"} t · 日志最大跳距 {value.MaxJumpRange?.ToString("F2") ?? "—"} ly · 重购 {value.Rebuy?.ToString("N0") ?? "—"} Cr\n最大跳距不是满载跳距，规划时仍需按载重校准。";

236 241 }

237 partial void OnPlanChanged(RoutePlan? value) => StartPlanCommand.NotifyCanExecuteChanged();

242 partial void OnPlanChanged(RoutePlan? value)

243 {

244 RefreshTradePlanCommands();

245 if (RunActive) return;

246 RunStatus = value?.Legs.Count > 0 ? "待执行" : "等待路线";

247

        RunMessage = value?.Legs.Count > 0 ? "路线已准备，点击自动执行开始跑商。" : "选择起点和参数，点击自动执行即可开始；也可先预览路线。";

248 NextDestination = value?.Legs.FirstOrDefault()?.To.DisplayName ?? "—";

249 }

238 250 partial void OnExecutionModeIndexChanged(int value) => ExecutionHint = value switch

239 251 {

240 252 0 => "模拟演练只展示步骤，不向游戏发送输入。",

241 253 1 => "你在游戏中操作；工具按 Journal 自动确认买入、到站、卖出并推进路线。",

242

        _ => "自动贸易必须安装并加载游戏插件；当前通信版本尚未启用未校准的原生交易和飞行。"

254 _ => "自动执行由工具箱完成采购、航行、出售及站内维护，并核对实际回执。"

243 255 };

244 256

245 257 public void ShowError(string message) => dispatcher.TryEnqueue(() => { ErrorMessage = message; HasError = true; });

@@ -341,10 +353,10 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

341 353 partial void OnSessionBusyChanged(bool value)

342 354 {

343 355

        StartGameCommand.NotifyCanExecuteChanged(); RelogGameCommand.NotifyCanExecuteChanged(); RestartGameCommand.NotifyCanExecuteChanged();

344 StartPlanCommand.NotifyCanExecuteChanged(); CalculateCommand.NotifyCanExecuteChanged();

356 RefreshTradePlanCommands(); CalculateCommand.NotifyCanExecuteChanged();

345 357 StartNavigationCommand.NotifyCanExecuteChanged();

346 358 }

347

    partial void OnRunActiveChanged(bool value) { StartGameCommand.NotifyCanExecuteChanged(); RelogGameCommand.NotifyCanExecuteChanged(); RestartGameCommand.NotifyCanExecuteChanged();StartNavigationCommand.NotifyCanExecuteChanged(); }

359

    partial void OnRunActiveChanged(bool value) { RefreshTradePlanCommands(); StartGameCommand.NotifyCanExecuteChanged(); RelogGameCommand.NotifyCanExecuteChanged(); RestartGameCommand.NotifyCanExecuteChanged();StartNavigationCommand.NotifyCanExecuteChanged(); }

348 360 private bool CanManageSession() => initialized && !DemoMode && !RunActive && !SessionBusy&&!NavigationActive;

349 361 private bool CanRelog() => CanManageSession() && sessions.CanRelog;

350 362

    [RelayCommand(CanExecute = nameof(CanManageSession))] private Task StartGameAsync() => RunSessionAsync(SessionOperation.Start);

@@ -400,6 +412,7 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

400 412 private bool CanImportData() => !IsBusy;

401 413 partial void OnIsBusyChanged(bool value)

402 414 {

415 RefreshTradePlanCommands();

403 416 CalculateCommand.NotifyCanExecuteChanged();ImportSystemCommand.NotifyCanExecuteChanged();

404 417 ImportSpanshCommand.NotifyCanExecuteChanged();ImportCaptureCommand.NotifyCanExecuteChanged();

405 418 }

@@ -457,13 +470,13 @@ public partial class ToolboxViewModel : ViewModelBase, IDisposable

457 470

            if (ExecutionModeIndex is < 0 or > 2) throw new InvalidOperationException("请选择有效的执行方式。");

458 471 var nativeDriver=ExecutionModeIndex==2?await CreateNativeTradeDriverAsync(Plan,token):null;

459 472 token.ThrowIfCancellationRequested();

460 AppShellPage.Current?.Navigate(typeof(ExecutionPage));

473 AppShellPage.Current?.Navigate(typeof(PlannerPage));

461 474 RunActive = true;

462 475 await runtime.Runner.RunAsync(Plan, (ExecutionMode)ExecutionModeIndex, nativeDriver, token);

463 476 }

464 477 catch(OperationCanceledException){runtime.Log("执行","执行已取消。");}

465 478 catch (Exception e) { ShowError(e.Message); }

466

        finally { RunActive = false; StartPlanCommand.NotifyCanExecuteChanged(); CalculateCommand.NotifyCanExecuteChanged(); }

479 finally { RunActive = false; RefreshTradePlanCommands(); CalculateCommand.NotifyCanExecuteChanged(); }

467 480 }

468 481 [RelayCommand] private void PauseRun() => runtime.Runner.Pause();

469 482

    [RelayCommand] private void ResumeRun() { try { runtime.Runner.Resume(); } catch (Exception e) { ShowError(e.Message); } }

Added XFEEDToolBox/ViewModels/TradePlanExecutionViewModel.cs +30 -0

@@ -0,0 +1,30 @@

1 using CommunityToolkit.Mvvm.Input;

2 using XFEEDToolBox.Core.Presentation;

4 namespace XFEEDToolBox.ViewModels;

6 public partial class ToolboxViewModel

7 {

8 private bool CanExecuteTradePlan() => SelectedStart is not null && CanCalculate() && !NavigationActive

9 && !DemoMode && !Environment.GetCommandLineArgs().Contains("--offline-preview");

11 partial void OnSelectedStartChanged(StationLiveRow? value) => RefreshTradePlanCommands();

13 private void RefreshTradePlanCommands()

14 {

15 StartPlanCommand.NotifyCanExecuteChanged();

16 ExecuteTradePlanCommand.NotifyCanExecuteChanged();

17 }

19 [RelayCommand(CanExecute = nameof(CanExecuteTradePlan))]

20 private async Task ExecuteTradePlanAsync(CancellationToken cancellationToken)

21 {

22 if (!CanExecuteTradePlan()) return;

23 ExecutionModeIndex = 2;

24 Plan = null;

25 SelectedLeg = null;

26 await CalculateAsync(cancellationToken);

27 if (cancellationToken.IsCancellationRequested || HasError || Plan?.Legs.Count is not > 0) return;

28 await StartPlanAsync(cancellationToken);

29 }

30 }

Modified XFEEDToolBox/Views/AppShellPage.xaml +2 -3

@@ -39,9 +39,8 @@

39 39

                    <NavigationViewItem Content="舰队与装配" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.ShipPage"/>

40 40

                    <NavigationViewItem Content="模块改装" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.EngineeringPage"/>

41 41 </NavigationViewItem.MenuItems></NavigationViewItem>

                <NavigationViewItem Content="贸易与执行" SelectsOnInvoked="False"><NavigationViewItem.Icon><FontIcon Glyph="&#xE707;"/></NavigationViewItem.Icon><NavigationViewItem.MenuItems>

                    <NavigationViewItem Content="跑商规划" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.PlannerPage"/>

                    <NavigationViewItem Content="执行控制" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.ExecutionPage"/>

                <NavigationViewItem Content="贸易" SelectsOnInvoked="False"><NavigationViewItem.Icon><FontIcon Glyph="&#xE707;"/></NavigationViewItem.Icon><NavigationViewItem.MenuItems>

                    <NavigationViewItem Content="跑商" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.PlannerPage"/>

45 44 </NavigationViewItem.MenuItems></NavigationViewItem>

46 45

                <NavigationViewItem Content="工具维护" SelectsOnInvoked="False"><NavigationViewItem.Icon><FontIcon Glyph="&#xE713;"/></NavigationViewItem.Icon><NavigationViewItem.MenuItems>

47 46

                    <NavigationViewItem Content="读取验收" add:NavigationAddition.NavigateTo="XFEEDToolBox.Views.ReadPage"/>

Modified XFEEDToolBox/Views/ExecutionPage.xaml +2 -2

@@ -8,7 +8,7 @@

8 8

                    <TextBlock Text="{x:Bind ViewModel.RunMessage, Mode=OneWay}" TextWrapping="Wrap" FontSize="16"/><ProgressBar Value="{x:Bind ViewModel.RunPercent, Mode=OneWay}" Maximum="100"/>

9 9

                    <Grid ColumnSpacing="18"><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions><StackPanel Spacing="7"><TextBlock Text="下一站" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.NextDestination, Mode=OneWay}" TextWrapping="Wrap" FontWeight="SemiBold"/></StackPanel><StackPanel Grid.Column="1" Spacing="7"><TextBlock Text="模拟估计 / 实际交易差额" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.ActualProfit, Mode=OneWay}" FontSize="23" Foreground="{StaticResource TealBrush}"/></StackPanel></Grid>

10 10 <Border Height="1" Background="{StaticResource PanelStrokeBrush}"/>

                    <RadioButtons Header="执行方式" SelectedIndex="{x:Bind ViewModel.ExecutionModeIndex,Mode=TwoWay}"><x:String>模拟演练</x:String><x:String>日志领航 · 玩家操作，按事件推进</x:String><RadioButton Content="自动贸易 · 接口校准中" IsEnabled="{x:Bind ViewModel.PluginTradeReady,Mode=OneWay}"/></RadioButtons>

                    <RadioButtons Header="执行方式" SelectedIndex="{x:Bind ViewModel.ExecutionModeIndex,Mode=TwoWay}"><x:String>模拟演练</x:String><x:String>日志领航 · 玩家操作，按事件推进</x:String><RadioButton Content="自动贸易" IsEnabled="{x:Bind ViewModel.PluginTradeReady,Mode=OneWay}"/></RadioButtons>

12 12 <TextBlock Text="{x:Bind ViewModel.ExecutionHint, Mode=OneWay}" Style="{StaticResource MutedText}"/>

13 13

                    <CommandBar Background="Transparent" DefaultLabelPosition="Right"><AppBarButton Icon="Play" Label="开始" controls:AsyncAction.Command="{x:Bind ViewModel.StartPlanCommand}" controls:AsyncAction.CancelCommand="{x:Bind ViewModel.StopRunCommand}"/><AppBarButton Icon="Pause" Label="暂停" Command="{x:Bind ViewModel.PauseRunCommand}"/><AppBarButton Icon="Forward" Label="继续" Command="{x:Bind ViewModel.ResumeRunCommand}"/></CommandBar>

14 14 </StackPanel></Border>

@@ -17,7 +17,7 @@

17 17 </StackPanel>

18 18 <StackPanel Grid.Column="1" Spacing="18">

19 19

                <Border Style="{StaticResource CardStyle}"><StackPanel Spacing="14"><TextBlock Text="导航助手" Style="{StaticResource SectionTitle}"/><TextBlock Text="复制目的星系后，在游戏星图中规划并确认燃料和航线。工具显示的跳数为估算。" Style="{StaticResource MutedText}"/><Button Content="复制目的星系" Command="{x:Bind ViewModel.CopyDestinationCommand, Mode=OneWay}" HorizontalAlignment="Stretch"/><Button Content="导出路线与货单" Command="{x:Bind ViewModel.ExportPlanCommand, Mode=OneWay}" HorizontalAlignment="Stretch"/></StackPanel></Border>

                <Border Style="{StaticResource CardStyle}"><StackPanel Spacing="12"><TextBlock Text="只读验收" Style="{StaticResource SectionTitle}"/><TextBlock Text="Journal 领航从起始站点停靠开始，按实际买卖和靠港事件推进。模拟演练使用路线估计收益。" Style="{StaticResource MutedText}"/><TextBlock Text="当前版本不启动原生挂钩或自动飞行。买卖与导航由玩家在游戏内操作。" Style="{StaticResource MutedText}"/><TextBlock Text="数据读取和路线规划不依赖分辨率、窗口焦点或键鼠绑定。" Foreground="{StaticResource AccentBrush}" TextWrapping="Wrap" FontSize="12"/></StackPanel></Border>

                <Border Style="{StaticResource CardStyle}"><StackPanel Spacing="12"><TextBlock Text="只读验收" Style="{StaticResource SectionTitle}"/><TextBlock Text="Journal 领航从起始站点停靠开始，按实际买卖和靠港事件推进。模拟演练使用路线估计收益。" Style="{StaticResource MutedText}"/><TextBlock Text="自动贸易由工具箱执行买卖、航行与站内维护，并核对实际游戏回执。" Style="{StaticResource MutedText}"/><TextBlock Text="数据读取和路线规划不依赖分辨率、窗口焦点或键鼠绑定。" Foreground="{StaticResource AccentBrush}" TextWrapping="Wrap" FontSize="12"/></StackPanel></Border>

21 21

                <Border Style="{StaticResource CardStyle}"><StackPanel Spacing="12"><TextBlock Text="近期事件" Style="{StaticResource SectionTitle}"/><ItemsControl ItemsSource="{x:Bind ViewModel.Activity, Mode=OneWay}" MaxHeight="330"><ItemsControl.ItemTemplate><DataTemplate x:DataType="live:ActivityLiveRow"><StackPanel Spacing="4" Margin="0,0,0,13"><TextBlock Text="{x:Bind TimeDisplay, Mode=OneWay}" FontSize="10" Foreground="{StaticResource TealBrush}"/><TextBlock Text="{x:Bind Message, Mode=OneWay}" Style="{StaticResource MutedText}" FontSize="12"/></StackPanel></DataTemplate></ItemsControl.ItemTemplate></ItemsControl></StackPanel></Border>

22 22 </StackPanel>

23 23 </Grid>

Modified XFEEDToolBox/Views/PlannerPage.xaml +18 -2

@@ -1,6 +1,6 @@

1 1

<Page x:Class="XFEEDToolBox.Views.PlannerPage" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:models="using:XFEEDToolBox.Core.Models" xmlns:controls="using:XFEEDToolBox.Controls">

2 2

    <Grid RowSpacing="20" Padding="0,8,0,0"><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="*"/></Grid.RowDefinitions>

        <Grid><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions><StackPanel Spacing="6"><TextBlock Text="TRADE ROUTE OPTIMIZER" Style="{StaticResource Eyebrow}"/><TextBlock Text="跑商规划" Style="{StaticResource PageTitle}"/><TextBlock Text="从当前资金出发，比较混合货单、多站航线和往返环线。" Style="{StaticResource MutedText}"/></StackPanel><Button Grid.Column="1" Content="读取玩家参数" Command="{x:Bind ViewModel.UsePlayerValuesCommand}" VerticalAlignment="Center" Padding="18,10"/></Grid>

        <Grid><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions><StackPanel Spacing="6"><TextBlock Text="TRADE PLANNER" Style="{StaticResource Eyebrow}"/><TextBlock Text="跑商" Style="{StaticResource PageTitle}"/><TextBlock Text="从当前资金出发，比较混合货单、多站航线和往返环线。" Style="{StaticResource MutedText}"/></StackPanel><Button Grid.Column="1" Content="读取玩家参数" Command="{x:Bind ViewModel.UsePlayerValuesCommand}" VerticalAlignment="Center" Padding="18,10"/></Grid>

4 4

        <Grid Grid.Row="1" ColumnSpacing="20"><Grid.ColumnDefinitions><ColumnDefinition Width="310"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions>

5 5

            <Border Style="{StaticResource CardStyle}" Padding="18,18,12,0"><ScrollViewer VerticalScrollBarVisibility="Auto"><StackPanel Spacing="16" Padding="0,0,6,20">

6 6 <TextBlock Text="01 / 舰船与资金" Style="{StaticResource Eyebrow}"/>

@@ -31,9 +31,25 @@

31 31

                <StackPanel Orientation="Horizontal" Spacing="12"><ProgressRing Width="20" Height="20" IsActive="{x:Bind ViewModel.IsBusy, Mode=OneWay}"/></StackPanel>

32 32 </StackPanel></ScrollViewer></Border>

33 33

            <ScrollViewer Grid.Column="1" VerticalScrollBarVisibility="Auto"><StackPanel Spacing="16" Padding="0,0,8,20">

34 <Border x:Name="TradeRunCard" Style="{StaticResource CardStyle}" Padding="20">

35 <StackPanel Spacing="14">

                        <Grid ColumnSpacing="16"><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions>

                            <StackPanel Spacing="6"><TextBlock Text="本次执行" Style="{StaticResource Eyebrow}"/><TextBlock Text="{x:Bind ViewModel.RunStatus, Mode=OneWay}" FontSize="23" FontWeight="SemiBold"/></StackPanel>

                            <Button x:Name="ExecuteTradePlanButton" Grid.Column="1" Content="自动执行" AutomationProperties.Name="自动执行跑商路线" Style="{StaticResource PrimaryButton}" MinWidth="132" VerticalAlignment="Center" controls:AsyncAction.Command="{x:Bind ViewModel.ExecuteTradePlanCommand}" controls:AsyncAction.CancelCommand="{x:Bind ViewModel.StopRunCommand}"/>

39 </Grid>

40 <TextBlock Text="{x:Bind ViewModel.RunMessage, Mode=OneWay}" TextWrapping="Wrap"/>

41 <ProgressBar Value="{x:Bind ViewModel.RunPercent, Mode=OneWay}" Maximum="100"/>

                        <Grid ColumnSpacing="20"><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions>

                            <StackPanel Spacing="6"><TextBlock Text="下一站" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.NextDestination, Mode=OneWay}" FontWeight="SemiBold" TextWrapping="Wrap"/></StackPanel>

                            <StackPanel Grid.Column="1" Spacing="6"><TextBlock Text="{x:Bind ViewModel.ProfitLabel, Mode=OneWay}" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.ActualProfit, Mode=OneWay}" Foreground="{StaticResource TealBrush}" FontSize="21"/><TextBlock Text="{x:Bind ViewModel.ProfitDetails, Mode=OneWay}" Style="{StaticResource MutedText}" FontSize="11"/></StackPanel>

45 </Grid>

                        <TextBlock Text="自动完成采购、航行、出售及站内维护，按实际回执更新进度和收益。启动时核对连接、船舶、实时价格及资金。" Style="{StaticResource MutedText}" FontSize="12"/>

47 </StackPanel>

48 </Border>

34 50

                <Grid ColumnSpacing="12"><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="*"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions><Border Style="{StaticResource CardStyle}" Padding="18"><StackPanel Spacing="10"><TextBlock Text="预计净利润" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.PlanProfit, Mode=OneWay}" FontSize="21" Foreground="{StaticResource TealBrush}" FontWeight="SemiBold"/></StackPanel></Border><Border Grid.Column="1" Style="{StaticResource CardStyle}" Padding="18"><StackPanel Spacing="10"><TextBlock Text="预计小时收益" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.PlanHourly, Mode=OneWay}" FontSize="21" FontWeight="SemiBold"/></StackPanel></Border><Border Grid.Column="2" Style="{StaticResource CardStyle}" Padding="18"><StackPanel Spacing="10"><TextBlock Text="预计耗时" Style="{StaticResource MutedText}"/><TextBlock Text="{x:Bind ViewModel.PlanDuration, Mode=OneWay}" FontSize="21" FontWeight="SemiBold"/></StackPanel></Border></Grid>

35 51

                <Border Style="{StaticResource CardStyle}" Padding="0"><Grid><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="245"/></Grid.RowDefinitions><TextBlock Text="{x:Bind ViewModel.PlanInfo, Mode=OneWay}" TextWrapping="Wrap" Margin="20,18,20,0" FontWeight="SemiBold"/><controls:RouteMap Grid.Row="1" Plan="{x:Bind ViewModel.Plan, Mode=OneWay}"/></Grid></Border>

                <Grid><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions><TextBlock Text="逐站货单" Style="{StaticResource SectionTitle}" VerticalAlignment="Center"/><StackPanel Grid.Column="1" Orientation="Horizontal" Spacing="8"><Button Content="导出 JSON" Command="{x:Bind ViewModel.ExportPlanCommand}"/><Button Content="进入执行台 →" Click="OpenExecution"/></StackPanel></Grid>

                <Grid><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions><TextBlock Text="逐站货单" Style="{StaticResource SectionTitle}" VerticalAlignment="Center"/><StackPanel Grid.Column="1" Orientation="Horizontal" Spacing="8"><Button Content="导出 JSON" Command="{x:Bind ViewModel.ExportPlanCommand}"/></StackPanel></Grid>

37 53

                <ListView ItemsSource="{x:Bind ViewModel.Plan.Legs, Mode=OneWay}" SelectedItem="{x:Bind ViewModel.SelectedLeg, Mode=TwoWay}" HorizontalContentAlignment="Stretch" MaxHeight="650" SelectionMode="Single"><ListView.ItemTemplate><DataTemplate x:DataType="models:TradeLeg"><Border Background="{StaticResource PanelBrush}" CornerRadius="8" Padding="16" Margin="0,0,0,8"><Grid RowSpacing="10"><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/></Grid.RowDefinitions><Grid><Grid.ColumnDefinitions><ColumnDefinition Width="*"/><ColumnDefinition Width="Auto"/></Grid.ColumnDefinitions><TextBlock Text="{x:Bind Title}" FontWeight="SemiBold" TextTrimming="CharacterEllipsis"/><TextBlock Grid.Column="1" Text="{x:Bind ProfitDisplay}" Foreground="{StaticResource TealBrush}" Margin="10,0,0,0"/></Grid><TextBlock Grid.Row="1" Text="{x:Bind Systems}" Style="{StaticResource MutedText}"/><TextBlock Grid.Row="2" Text="{x:Bind CargoSummary}" TextWrapping="Wrap" Foreground="{StaticResource AccentBrush}"/><TextBlock Grid.Row="3" Text="{x:Bind Metrics}" Style="{StaticResource MutedText}" FontSize="11"/></Grid></Border></DataTemplate></ListView.ItemTemplate></ListView>

38 54

                <Border Background="{StaticResource PanelAltBrush}" CornerRadius="8" Padding="18"><StackPanel Spacing="10"><TextBlock Text="计算依据与限制" FontWeight="SemiBold"/><TextBlock Text="{x:Bind ViewModel.PlanWarnings, Mode=OneWay}" Style="{StaticResource MutedText}" FontSize="12"/></StackPanel></Border>

39 55 </StackPanel></ScrollViewer>

Modified XFEEDToolBox/Views/PlannerPage.xaml.cs +0 -1

@@ -4,5 +4,4 @@ public sealed partial class PlannerPage : Page

4 4 {

5 5 public ToolboxViewModel ViewModel => App.ViewModel;

6 6

    public PlannerPage() { InitializeComponent(); NavigationCacheMode = Microsoft.UI.Xaml.Navigation.NavigationCacheMode.Required; }

    private void OpenExecution(object sender, RoutedEventArgs e) => AppShellPage.Current!.Navigate(typeof(ExecutionPage));

8 7 }

Added docs/AUTOMATIC-TRADE-UI.md +9 -0

@@ -0,0 +1,9 @@

1 # 跑商页自动执行

路线规划和执行集中在“贸易 → 跑商”。页面显示一个“自动执行”按钮，点击后按当前参数计算路线，核对原生接口与船舶状态，再由工具箱执行原生贸易。无需进入另一个执行台或选择模拟模式；单独计算路线仍可用于预览。

执行期间在同页显示状态、进度、下一站、已确认净利润和实际燃油、维修、补给等支出。原按钮在操作期间提供取消。打开页面只呈现已有数据，不会自动计算、采购或起飞。

界面的停靠交易就绪状态来自只读原生 `describe` 握手，要求正确协议、已核验游戏 SHA-256、停靠服务就绪能力和批量交易能力，避免旧发布清单的 `supportsTrade=false` 错误禁用新接口。实际执行仍需完成原生交易预检，并在采购之前核对 SCO 温控与燃油控制、原始逃逸矢量能力。入口可见不等于这些飞行验收已完成。

本次验证覆盖八项能力检查回归、WinUI Release 构建和后台界面检查；不把界面验证计为一次飞行或交易。