新增插件指引网页

Plugins/WPSCrystalSystem/crystal_plugin_base.py

@@ -53,6 +53,54 @@ class WPSCrystalSystem(WPSAPI):
             key.lower(): value for key, value in DEFAULT_CRYSTAL_EXCHANGE_ENTRIES.items()
         }
 
+    def get_guide_subtitle(self) -> str:
+        return "水晶养成、颜色淬炼与兑换拓展系统"
+
+    def get_guide_metadata(self) -> Dict[str, str]:
+        return {
+            "颜色数量": str(len(self._colors)),
+            "水晶物品": str(len(self._items)),
+            "兑换项目": str(len(self._exchange_entries)),
+        }
+
+    def collect_command_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "水晶",
+                "identifier": "水晶",
+                "description": "查看系统配置或执行变色与兑换等操作。",
+                "metadata": {"别名": "crystal"},
+            },
+        )
+
+    def collect_item_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "基础水晶物品",
+                "description": f"{len(self._items)} 个水晶组件，可由背包/商店系统持有与交易。",
+            },
+            {
+                "title": "颜色链路",
+                "description": f"{len(self._colors)} 条变色链（包含等待阶段与最终融合）。",
+            },
+        )
+
+    def collect_guide_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "变色流程",
+                "description": "`水晶 变色 <颜色>` 进入等待流程，完成后获得对应水晶部件。",
+            },
+            {
+                "title": "兑换指令",
+                "description": "`水晶 兑换 <ID>` 消耗配置好的材料换取奖励物品。",
+            },
+            {
+                "title": "菜园扩展",
+                "description": "系统会向菜园注册水晶树作物，使果实与水晶体系互相联动。",
+            },
+        )
+
     # ------------------------------------------------------------------ #
     # Plugin lifecycle
     # ------------------------------------------------------------------ #