From 970d3465f4454d010721a3c074f2b0417f6da5e0 Mon Sep 17 00:00:00 2001
From: tian <11429339@qq.com>
Date: Sat, 11 Apr 2026 23:17:21 +0800
Subject: [PATCH] Add a custom ribbon tab for logistics tools

---
 TransportPlugin.csproj                 |  13 ++++
 deploy-plugin.bat                      |  31 ++++++++++
 resources/TransportRibbon.xaml         |  23 +++++++
 resources/TransportRibbon_16.png       | Bin 0 -> 614 bytes
 resources/TransportRibbon_32.png       | Bin 0 -> 1292 bytes
 src/Commands/TransportRibbonHandler.cs |  79 +++++++++++++++++++++++++
 6 files changed, 146 insertions(+)
 create mode 100644 resources/TransportRibbon.xaml
 create mode 100644 resources/TransportRibbon_16.png
 create mode 100644 resources/TransportRibbon_32.png
 create mode 100644 src/Commands/TransportRibbonHandler.cs

diff --git a/TransportPlugin.csproj b/TransportPlugin.csproj
index 4bbb6e9..a41f577 100644
--- a/TransportPlugin.csproj
+++ b/TransportPlugin.csproj
@@ -165,6 +165,7 @@
     <Compile Include="src\Commands\SetLogisticsAttributeCommand.cs" />
     <Compile Include="src\Commands\StartAnimationCommand.cs" />
     <Compile Include="src\Commands\GenerateCollisionReportCommand.cs" />
+    <Compile Include="src\Commands\TransportRibbonHandler.cs" />
     <Compile Include="src\Commands\VoxelGridSDFTestCommand.cs" />
     <Compile Include="src\Commands\VoxelPathFindingTestCommand.cs" />
     <!-- Core - Animation System -->
@@ -522,6 +523,18 @@
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       <Link>resources\TransportPlugin.name.txt</Link>
     </None>
+    <None Include="resources\TransportRibbon.xaml">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <Link>TransportRibbon.xaml</Link>
+    </None>
+    <None Include="resources\TransportRibbon_16.png">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <Link>TransportRibbon_16.png</Link>
+    </None>
+    <None Include="resources\TransportRibbon_32.png">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      <Link>TransportRibbon_32.png</Link>
+    </None>
     <!-- Unit Cube NWC Model File -->
     <None Include="resources\unit_cube.nwc">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
diff --git a/deploy-plugin.bat b/deploy-plugin.bat
index 0c5a3cd..789d687 100644
--- a/deploy-plugin.bat
+++ b/deploy-plugin.bat
@@ -16,6 +16,11 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command ^
   "  'System.Data.SQLite.dll'," ^
   "  'Tomlyn.dll'" ^
   ");" ^
+  "$deployRootFiles = @(" ^
+  "  'TransportRibbon.xaml'," ^
+  "  'TransportRibbon_16.png'," ^
+  "  'TransportRibbon_32.png'" ^
+  ");" ^
   "$stalePluginFiles = @(" ^
   "  'Autodesk.Navisworks.Api.dll'," ^
   "  'NavisworksTransport.UnitTests.dll'," ^
@@ -63,6 +68,17 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command ^
   "  if (-not (Test-Path $sourceDll)) { throw ('Deployment source file missing: ' + $sourceDll) }" ^
   "  Copy-Item $sourceDll $targetDir -Force;" ^
   "}" ^
+  "foreach ($rootFileName in $deployRootFiles) {" ^
+  "  $sourceRootFile = Join-Path $buildDir $rootFileName;" ^
+  "  if (Test-Path $sourceRootFile) {" ^
+  "    Copy-Item $sourceRootFile $targetDir -Force;" ^
+  "    foreach ($locale in @('en-US','zh-CN')) {" ^
+  "      $localeDir = Join-Path $targetDir $locale;" ^
+  "      New-Item -ItemType Directory -Force -Path $localeDir | Out-Null;" ^
+  "      Copy-Item $sourceRootFile $localeDir -Force;" ^
+  "    }" ^
+  "  }" ^
+  "}" ^
   "if (Test-Path (Join-Path $buildDir 'resources')) {" ^
   "  New-Item -ItemType Directory -Force -Path (Join-Path $targetDir 'resources') | Out-Null;" ^
   "  Copy-Item (Join-Path $buildDir 'resources\\*') (Join-Path $targetDir 'resources') -Recurse -Force;" ^
@@ -70,6 +86,10 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command ^
   "" ^
   "$sourceFiles = @();" ^
   "foreach ($dllName in $deployDllNames) { $sourceFiles += Get-Item (Join-Path $buildDir $dllName) }" ^
+  "foreach ($rootFileName in $deployRootFiles) {" ^
+  "  $sourceRootFile = Join-Path $buildDir $rootFileName;" ^
+  "  if (Test-Path $sourceRootFile) { $sourceFiles += Get-Item $sourceRootFile }" ^
+  "}" ^
   "if (Test-Path (Join-Path $buildDir 'resources')) {" ^
   "  $sourceFiles += Get-ChildItem (Join-Path $buildDir 'resources') -File;" ^
   "}" ^
@@ -82,6 +102,17 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command ^
   "    throw ('Deployment verification failed for ' + $sourceFile.Name + ': source=' + $sourceFile.LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss.fff') + ' (' + $sourceFile.Length + '), target=' + $targetInfo.LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss.fff') + ' (' + $targetInfo.Length + ')');" ^
   "  }" ^
   "  Write-Host ('Verified ' + $sourceFile.Name + ': ' + $targetInfo.LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss.fff'));" ^
+  "  if ($deployRootFiles -contains $sourceFile.Name) {" ^
+  "    foreach ($locale in @('en-US','zh-CN')) {" ^
+  "      $localeTargetFile = Join-Path (Join-Path $targetDir $locale) $sourceFile.Name;" ^
+  "      if (-not (Test-Path $localeTargetFile)) { throw ('Deployment verification failed: missing locale target file ' + $localeTargetFile) }" ^
+  "      $localeTargetInfo = Get-Item $localeTargetFile;" ^
+  "      if ($sourceFile.Length -ne $localeTargetInfo.Length -or $sourceFile.LastWriteTime -ne $localeTargetInfo.LastWriteTime) {" ^
+  "        throw ('Deployment verification failed for locale copy ' + $localeTargetFile);" ^
+  "      }" ^
+  "      Write-Host ('Verified ' + $locale + '\\' + $sourceFile.Name + ': ' + $localeTargetInfo.LastWriteTime.ToString('yyyy-MM-dd HH:mm:ss.fff'));" ^
+  "    }" ^
+  "  }" ^
   "}" ^
   "" ^
   "Write-Host 'Plugin deployed successfully!';"
diff --git a/resources/TransportRibbon.xaml b/resources/TransportRibbon.xaml
new file mode 100644
index 0000000..d0188d7
--- /dev/null
+++ b/resources/TransportRibbon.xaml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RibbonControl
+    xmlns="clr-namespace:Autodesk.Windows;assembly=AdWindows"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:local="clr-namespace:Autodesk.Navisworks.Gui.Roamer.AIRLook;assembly=navisworks.gui.roamer">
+  <RibbonTab x:Uid="RibbonTab_Transport" Id="ID_TransportTab" Title="物流路径规划" KeyTip="WL">
+    <RibbonPanel x:Uid="RibbonPanel_TransportMain">
+      <RibbonPanelSource x:Uid="RibbonPanelSource_TransportMain" Title="物流路径规划" KeyTip="G">
+        <local:NWRibbonButton
+            x:Uid="RibbonButton_OpenLogisticsPanel"
+            Id="OpenLogisticsPanel"
+            Orientation="Vertical"
+            Size="Large"
+            ShowText="True"
+            Text="物流路径&#xA;规划"
+            ToolTip="打开物流路径规划面板"
+            Image="TransportRibbon_16.png"
+            LargeImage="TransportRibbon_32.png"
+            KeyTip="P" />
+      </RibbonPanelSource>
+    </RibbonPanel>
+  </RibbonTab>
+</RibbonControl>
diff --git a/resources/TransportRibbon_16.png b/resources/TransportRibbon_16.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d75f301fdd84c1a188fdb9c0c7586c9147102ad
GIT binary patch
literal 614
zcmV-s0-61ZP)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV00001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D0sBcrK~y+T&5})M
zlR*%MbCRAsd-E!uyy#8DgCK$+SWv;gB4RuUIf<eks)ANe+KS0+X;h+Vlim5WEs04R
z3ig}XFEN@l)*qs6;}3{Ri6}8(XjWEH=+}DI=eV=)JF`1)An@M;=mr7lp+Nd36h8;W
zp=flX!+&oH5lL$VvKEp_AX8ZJF_5GHc}gfQf#a_8YyJ>T<X3^@r$X@^+ZmAG19DwB
z`h!4vn@A4=DE4d<zxF4;M&^$~QAHqqj-Y!H91a2U+1uH{hM|o{>E4;%d-;N28xYbx
z4oFS=PJ!HrD82i4Z9}!avh$^vO%^Y-PnPA^N7uSr-u1pciwzXlA;Fo5q#Z(0V}$xT
z*G`)iwzhfhUDx(Ex^^yGF#~cm-a5V4RIXgU={J}JMR}0!!Px!ycRTKlN{`p|?D75s
zvzh9aTJ22uu4h2;EkK?TNGBE<L=>$T$X~7w7w|}l+fJ#w7Mx9uO&9mI=JmGbsoaaB
zfV3b`mq1O93&mR(8CW36<@1HqgI!g<(32_~+i@t9FzK<d5lEi^X+9RC)k4wSvYDui
zhk|x=r*J6;=-Kep1+oF;rf|3jN%t@yrI+n)F%z3QUgr+QhlWR9*$~;y*z<lz?*vCb
z0ZCK#kNmnN*g*A5PS~{yM;k!h0(3|J8lZp54~4u_`V#b!`Tzg`07*qoM6N<$f(05B
A*#H0l

literal 0
HcmV?d00001

diff --git a/resources/TransportRibbon_32.png b/resources/TransportRibbon_32.png
new file mode 100644
index 0000000000000000000000000000000000000000..5118b173931b55cd546047cbed108f9f4669f4f0
GIT binary patch
literal 1292
zcmV+n1@roeP)<h;3K|Lk000e1NJLTq001BW001Be1^@s6b9#F800001b5ch_0Itp)
z=>Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D1ffYpK~z{r?N(h(
z990x<;!7X(sTfT(@j+iqnivx?z}i>|sa1&D1khNbCT*%UR<Wg|YAruDhQtSw!rn{V
zNK7d(_l~V;F+kbE&bgQ6Uw+zB-CeeHOI!Jk@>3`?=FBqdF#MJfpZJoS?985fzH`s{
z?m4q<+ZML)knpJ9M~R|k5hgBDF78qeQ<TGBglUb0YX?hI`LuJ-rh#(EAsmLvIMfg(
z1_&3YN|`uJ6gWYd=qC*7D1#7T;yaJWyWP2e!*DC`9OXiy<1>}ovy_QW%!J(r2?-Zo
z!hA1bplE}??KT?%rrUCcq!<VW<g`P0s{C<ga8>>|D`*VHX}4~ePSD{(I<dx-$r6(Y
zPsv3Eo|<x@QU)iZq>yv9F1vn4yb6XdF{hmWR!^Boar#~tqG|sxjZ_tFq*|+`3`GZ5
z2^W2o%TA)o9?HcveBWOCRoH+;!&;+|T8IBROSUFV!J(L9s@JYi20CTXM-}a~n?X8N
z<tx^5E0Bg+81iLI+5?ya*MlRC!GcmQe{yoH2)s%dH41Ja#U8>y5GFgEwsyE~=uft^
zAL_FQaJ}ta<E&DAd*J&or*9T!yNz%5ubm0A)`~c9ici&cVnAgojFd6RcG_ClS7khs
z6d3zpf2d{xNs&C_Pn-Ld=NU$BMr`T1=@rhsOF%d@P$q&_-7vM75lpkw)<VLc#tW~9
z+Zs~`n+#kZ`+FxoZ|ZLtC^|g8D1hVX)6Tt1K$#pRDjbVFn<^K<dyN@IsO~8(`D?@L
zils6kY&@163g=nmd&6x|c<J{^QZ2e7g`cv;0c6M+(Mq69%>P_@<$3EFyI)If-aq!*
z-jQ!#jt}Zj;r}oHF_Zenpok#(n}gaImV$6;P%aE3dtcmqZe}x*kDWSX7`d4{7m+Oo
z%EcsM;(hBGg&6U@H){{zzSyOwgu2gNZaZETY{|G+-kWb^hHH(Kf$ODdt>e#7E@rST
zTRx&46!aL$YH%x}hcNJ4&jmGIKQ{W0-gl}SN$u}s$AO9Xpq><MU~mgdXZfJKxq>L-
zZj59#py&wG>d`@g4D3kn2^D7rFY1=MhvnYU>>HK+*0Z(dAZgAOGPYyqBMfd~|1kY=
z_<?fKfY;f{wJh-J;T1&HpQyjq`Btd;4%RpArf=RA82%)2Kz}?wpugDL`eBnjfN8P2
z6Zg9n?KI(H2%A-OK#9-rFst37CBQ!4<^6&O{Fx(GeGjyE&F5e0F2~M?^I*9CohN3*
z?hYiMg<XNx+We2GDvnYvrwP-h&<EO@2jW6L)QFz+?kRBA_uIO@al%D}a2O#RMp5O~
zB3%4UxQw`&HcGjiI(uI3KtD)o&J<N!Tm5$EkSOf|JOI~h@r9P6g;}3M@S}vokV($O
zn3-y>9W-YI7qM<<HZcY#7kgg^bVw+%2QUT6-PVj)EtU2Ox-hcU)$CV<;dRAXS(x#?
zcKeqL=R$aLbL!cymmR2f6rBAFYD4790Y$fv_8O{a)s#yW-<kj6$X4MDWfEt<XVX5%
zmIG$N9M4=EHwCChTdteIwE2akXjz+f>Md;H|G>Zg<_plA@L>`F0000<MNUMnLSTY;
C-DwyA

literal 0
HcmV?d00001

diff --git a/src/Commands/TransportRibbonHandler.cs b/src/Commands/TransportRibbonHandler.cs
new file mode 100644
index 0000000..95278f6
--- /dev/null
+++ b/src/Commands/TransportRibbonHandler.cs
@@ -0,0 +1,79 @@
+using System;
+using Autodesk.Navisworks.Api.Plugins;
+using NavisworksTransport.Utils;
+
+namespace NavisworksTransport.Commands
+{
+    [Plugin("TransportRibbonHandler", "NavisworksTransport",
+        DisplayName = "物流路径规划工具栏",
+        ToolTip = "物流路径规划工具栏命令")]
+    [RibbonLayout("TransportRibbon.xaml")]
+    [RibbonTab("ID_TransportTab", DisplayName = "物流路径规划")]
+    [Command("OpenLogisticsPanel",
+        DisplayName = "物流路径规划",
+        ToolTip = "打开物流路径规划面板",
+        LoadForCanExecute = true)]
+    public class TransportRibbonHandler : CommandHandlerPlugin
+    {
+        private const string MainDockPanePluginKey = "NavisworksTransport.Main.Tian";
+        private const string OpenLogisticsPanelCommandId = "OpenLogisticsPanel";
+        private const string TransportRibbonTabId = "ID_TransportTab";
+
+        public override int ExecuteCommand(string commandId, params string[] parameters)
+        {
+            try
+            {
+                if (!string.Equals(commandId, OpenLogisticsPanelCommandId, StringComparison.OrdinalIgnoreCase))
+                {
+                    LogManager.Warning($"[Ribbon] 未知命令: {commandId}");
+                    return 1;
+                }
+
+                var pluginRecord = Autodesk.Navisworks.Api.Application.Plugins.FindPlugin(MainDockPanePluginKey) as DockPanePluginRecord;
+                if (pluginRecord == null)
+                {
+                    throw new InvalidOperationException($"未找到物流路径规划面板插件: {MainDockPanePluginKey}");
+                }
+
+                var dockPane = pluginRecord.LoadPlugin() as DockPanePlugin;
+                if (dockPane == null)
+                {
+                    throw new InvalidOperationException("物流路径规划面板加载失败");
+                }
+
+                dockPane.Visible = true;
+                dockPane.ActivatePane();
+                LogManager.Info("[Ribbon] 已通过正式工具栏打开物流路径规划面板");
+                return 0;
+            }
+            catch (Exception ex)
+            {
+                LogManager.Error($"[Ribbon] 执行命令失败: {ex.Message}", ex);
+                return 1;
+            }
+        }
+
+        public override CommandState CanExecuteCommand(string commandId)
+        {
+            if (string.Equals(commandId, OpenLogisticsPanelCommandId, StringComparison.OrdinalIgnoreCase))
+            {
+                return new CommandState
+                {
+                    IsEnabled = true,
+                    IsVisible = true
+                };
+            }
+
+            return new CommandState
+            {
+                IsEnabled = false,
+                IsVisible = false
+            };
+        }
+
+        public override bool CanExecuteRibbonTab(string ribbonTabId)
+        {
+            return string.Equals(ribbonTabId, TransportRibbonTabId, StringComparison.OrdinalIgnoreCase);
+        }
+    }
+}