新增插件指引网页

Plugins/WPSCombatSystem/combat_plugin_battle.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Optional, Sequence
 
 from PWF.Convention.Runtime.GlobalConfig import ConsoleFrontColor, ProjectConfig
 
+from Plugins.WPSAPI import GuideEntry
 from .combat_plugin_base import WPSCombatBase
 
 
@@ -15,6 +16,69 @@ logger: ProjectConfig = ProjectConfig()
 class WPSCombatBattle(WPSCombatBase):
     """PVP对战插件"""
     
+    def get_guide_subtitle(self) -> str:
+        return "玩家间回合制对战指令集"
+
+    def collect_command_entries(self) -> Sequence[GuideEntry]:
+        return (
+            GuideEntry(
+                title="挑战",
+                identifier="挑战 <目标用户ID>",
+                description="向指定玩家发起 PVP 挑战。",
+                metadata={"别名": "challenge"},
+                icon="⚔️",
+                details=[
+                    {"type": "list", "items": ["不可挑战自己。", "挑战在超时前需对方接受，否则自动失效。"]},
+                ],
+            ),
+            GuideEntry(
+                title="接受挑战",
+                identifier="接受挑战 <挑战ID>",
+                description="接受待处理的挑战并初始化战斗。",
+                metadata={"别名": "accept"},
+                icon="✅",
+                details=[
+                    {"type": "steps", "items": ["输入挑战列表中的 ID。", "系统创建战斗记录并通知双方。"]},
+                ],
+            ),
+            GuideEntry(
+                title="拒绝挑战",
+                identifier="拒绝挑战 <挑战ID>",
+                description="拒绝尚未开始的挑战请求。",
+                metadata={"别名": "reject"},
+                icon="🚫",
+            ),
+            GuideEntry(
+                title="战斗动作",
+                identifier="战斗 <战斗ID> <技能名>",
+                description="在战斗中释放技能或执行普攻。",
+                metadata={"别名": "battle"},
+                icon="🌀",
+                details=[
+                    {"type": "list", "items": ["技能冷却与效果可在 `技能列表` 中查看。", "战斗为回合制，按顺序执行。"]},
+                ],
+            ),
+            GuideEntry(
+                title="投降",
+                identifier="投降 <战斗ID>",
+                description="主动认输并结束当前战斗。",
+                metadata={"别名": "surrender"},
+                icon="🏳️",
+            ),
+        )
+
+    def collect_guide_entries(self) -> Sequence[GuideEntry]:
+        return (
+            {
+                "title": "挑战生命周期",
+                "description": "挑战需在配置的超时前被接受，超时将自动失效。",
+            },
+            {
+                "title": "战斗指令",
+                "description": "战斗中按回合输入技能，系统根据属性与技能效果计算伤害。",
+            },
+        )
+
     def is_enable_plugin(self) -> bool:
         return True