新增插件指引网页

Plugins/WPSGardenSystem/garden_plugin_steal.py

@@ -2,17 +2,55 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Optional, Sequence
 
 from PWF.Convention.Runtime.Architecture import Architecture
 
 from PWF.CoreModules.database import get_db
+from Plugins.WPSAPI import GuideEntry
 from Plugins.WPSBackpackSystem import WPSBackpackSystem
 
 from .garden_plugin_base import WPSGardenBase
 
 
 class WPSGardenSteal(WPSGardenBase):
+    def get_guide_subtitle(self) -> str:
+        return "偷取其他用户成熟果实的互动指令"
+
+    def collect_command_entries(self) -> Sequence[GuideEntry]:
+        return (
+            GuideEntry(
+                title="偷取",
+                identifier="偷取 <用户> <地块序号>",
+                description="从其他用户的成熟作物中偷取果实。",
+                metadata={"别名": "steal"},
+                icon="🕵️",
+                details=[
+                    {
+                        "type": "steps",
+                        "items": [
+                            "输入目标用户 ID 或昵称，以及成熟地块序号。",
+                            "系统校验目标用户菜园与成熟状态。",
+                            "成功后获得 1 个果实并通知对方被偷记录。",
+                        ],
+                    },
+                    "同一地块可多次被不同用户偷取，超限后将提示果实不足。",
+                ],
+            ),
+        )
+
+    def collect_guide_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "指令格式",
+                "description": "`偷取 <用户ID|昵称> <地块序号>`，不可针对自己。",
+            },
+            {
+                "title": "通知机制",
+                "description": "成功偷取后会向目标用户推送警报消息，包含剩余果实数量。",
+            },
+        )
+
     def wake_up(self) -> None:
         super().wake_up()
         self.register_plugin("steal")