From caf0cf1420d6462f1faa01cfa9339426793d0589 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=90=9D=E5=8D=9C?= <dev@saasshop.local>
Date: Thu, 19 Mar 2026 08:26:34 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=B7=A5=E5=85=B7=E5=8C=BA?=
 =?UTF-8?q?=E5=BF=AB=E9=80=9F=E5=AF=BC=E8=88=AA=E4=BD=BF=E7=94=A8=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/platform_orders/index.blade.php     |  1 +
 ...olGridJumpLinksShouldHaveUsageNoteTest.php | 33 +++++++++++++++++++
 2 files changed, 34 insertions(+)
 create mode 100644 tests/Feature/AdminPlatformOrderIndexToolGridJumpLinksShouldHaveUsageNoteTest.php

diff --git a/resources/views/admin/platform_orders/index.blade.php b/resources/views/admin/platform_orders/index.blade.php
index 0a34a72..ae25b22 100644
--- a/resources/views/admin/platform_orders/index.blade.php
+++ b/resources/views/admin/platform_orders/index.blade.php
@@ -1200,6 +1200,7 @@
         <div class="muted muted-xs mb-10" data-role="po-tools-grid-intro" aria-label="平台订单工具区说明">当前工具区承载导出、批量治理与失败标记清理，请先缩小筛选范围再执行动作；也可使用上方快速定位导航直达目标工具组。</div>
         <div class="actions gap-10 mb-10" data-role="po-tools-grid-jump-links" aria-label="平台订单工具区快速定位导航">
             <a class="btn btn-secondary btn-sm" data-role="po-tools-jump-export" aria-label="定位到导出工具组" href="#po-tools-export">导出</a>
+            <span class="muted muted-xs" data-role="po-tools-grid-jump-links-note">快速定位只负责跳转到工具组，不会直接执行动作。</span>
             <a class="btn btn-secondary btn-sm" data-role="po-tools-jump-batch-activate" aria-label="定位到批量同步订阅工具组" href="#batch-activate-subscriptions">批量同步</a>
             <a class="btn btn-secondary btn-sm" data-role="po-tools-jump-batch-bmpa" aria-label="定位到批量标记支付并生效工具组" href="#po-tools-batch-bmpa">批量BMPA</a>
             <a class="btn btn-secondary btn-sm" data-role="po-tools-jump-batch-mark-activated" aria-label="定位到批量仅标记为已生效工具组" href="#po-tools-batch-mark-activated">批量仅生效</a>
diff --git a/tests/Feature/AdminPlatformOrderIndexToolGridJumpLinksShouldHaveUsageNoteTest.php b/tests/Feature/AdminPlatformOrderIndexToolGridJumpLinksShouldHaveUsageNoteTest.php
new file mode 100644
index 0000000..ee08882
--- /dev/null
+++ b/tests/Feature/AdminPlatformOrderIndexToolGridJumpLinksShouldHaveUsageNoteTest.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AdminPlatformOrderIndexToolGridJumpLinksShouldHaveUsageNoteTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function loginAsPlatformAdmin(): void
+    {
+        $this->seed();
+
+        $this->post('/admin/login', [
+            'email' => 'platform.admin@demo.local',
+            'password' => 'Platform@123456',
+        ])->assertRedirect('/admin');
+    }
+
+    public function test_platform_orders_tool_grid_jump_links_should_have_usage_note(): void
+    {
+        $this->loginAsPlatformAdmin();
+
+        $res = $this->get('/admin/platform-orders');
+        $res->assertOk();
+
+        $html = (string) $res->getContent();
+        $this->assertStringContainsString('data-role="po-tools-grid-jump-links-note"', $html);
+        $this->assertStringContainsString('快速定位只负责跳转到工具组，不会直接执行动作。', $html);
+    }
+}