新增插件指引网页

Plugins/WPSGardenSystem/garden_plugin_plant.py

@@ -2,16 +2,54 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Optional, Sequence
 
 from PWF.Convention.Runtime.Architecture import Architecture
 
+from Plugins.WPSAPI import GuideEntry
 from Plugins.WPSBackpackSystem import WPSBackpackSystem
 
 from .garden_plugin_base import WPSGardenBase
 
 
 class WPSGardenPlant(WPSGardenBase):
+    def get_guide_subtitle(self) -> str:
+        return "种植作物并分配地块"
+
+    def collect_command_entries(self) -> Sequence[GuideEntry]:
+        return (
+            GuideEntry(
+                title="种植",
+                identifier="种植 <种子> [地块序号]",
+                description="在指定地块种下一颗种子，默认选取下一个空地。",
+                metadata={"别名": "plant"},
+                icon="🌱",
+                details=[
+                    {
+                        "type": "steps",
+                        "items": [
+                            "确认背包中持有对应种子。",
+                            "可选：指定地块序号（正整数），否则使用下一个空地。",
+                            "系统校验库存并写入菜园数据库，生成成熟计时。",
+                        ],
+                    },
+                    "种植成功后立即扣除种子数量并返回成熟时间。",
+                ],
+            ),
+        )
+
+    def collect_guide_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "指令格式",
+                "description": "`种植 <种子ID|名称> [地块序号]`，默认选择下一个空地。",
+            },
+            {
+                "title": "库存校验",
+                "description": "会检查背包种子数量，不足时返回提示而不消耗资源。",
+            },
+        )
+
     def wake_up(self) -> None:
         super().wake_up()
         self.register_plugin("plant")