NewWPSBot/.tasks/2025-11-12_3_plugin-illustrated-guide.md

背景

文件名：2025-11-12_3_plugin-illustrated-guide.md 创建于：2025-11-12_19:34:38 创建者：liubai095\asus 主分支：main 任务分支：未创建 Yolo模式：Off

任务描述

为 Plugins 目录下的插件实例类补充 generate_router_illustrated_guide 所需图鉴内容，覆盖指令、物品、配方与指引信息。

项目概览

NewWPSBot 插件体系基于 PWF 核心模块提供的插件接口，Plugins 目录包含多套子系统（炼金、背包、花园等），需确保图鉴内容与各系统已有功能保持一致。

分析

已确认 PWF/CoreModules/plugin_interface.py 新增 generate_router_illustrated_guide 接口，默认返回 None，需要在各插件实现中补充网页渲染函数。Plugins/WPSAPI.py 定义基础 WPSAPI/BasicWPSInterface，大部分业务插件继承于此。当前插件依赖链条大致为：WPSAPI → 核心系统（WPSBackpackSystem, WPSConfigAPI, WPSStoreSystem, WPSFortuneSystem, WPSAlchemyGame 等）→ 领域子系统（菜园、战斗、水晶等）→ 命令子插件（如菜园种植/收获/偷取、战斗冒险/装备/营地等）。各子系统内部大量复用 garden_models, combat_models, crystal_models 等数据定义，需要在图鉴构建时引用既有配置与枚举确保口径一致。WPSStoreSystem, WPSCombatSystem, WPSGardenSystem, WPSAlchemyGame 均在 wake_up 阶段注册指令与物品/配方，需综合其注册内容和服务方法生成指令说明、物品清单、流程提示。后续还需梳理 .tasks 历史记录以了解已实现的攻略需求，避免遗漏新增指令。

提议的解决方案

待进入 INNOVATE 模式后补充。

当前执行步骤："1. 研究插件架构"

任务进度

2025-11-12_20:33:53

• 已修改：Plugins/WPSAPI.py Plugins/WPSBackpackSystem.py Plugins/WPSConfigSystem.py Plugins/WPSStoreSystem.py Plugins/WPSFortuneSystem.py Plugins/WPSAlchemyGame.py Plugins/WPSGardenSystem/garden_plugin_base.py Plugins/WPSGardenSystem/garden_plugin_plant.py Plugins/WPSGardenSystem/garden_plugin_harvest.py Plugins/WPSGardenSystem/garden_plugin_remove.py Plugins/WPSGardenSystem/garden_plugin_view.py Plugins/WPSGardenSystem/garden_plugin_steal.py Plugins/WPSCrystalSystem/crystal_plugin_base.py Plugins/WPSCombatSystem/combat_plugin_base.py Plugins/WPSCombatSystem/combat_plugin_adventure.py Plugins/WPSCombatSystem/combat_plugin_battle.py Plugins/WPSCombatSystem/combat_plugin_camp.py Plugins/WPSCombatSystem/combat_plugin_equipment.py Plugins/WPSCombatSystem/combat_plugin_heal.py Plugins/WPSCombatSystem/combat_plugin_status.py
• 更改：在 WPSAPI 基类构建图鉴数据模型与 Markdown 渲染模板，并为核心系统与各子插件补充指令、物品与流程说明
• 原因：实现 generate_router_illustrated_guide 所需的图鉴内容结构
• 阻碍因素：无
• 状态：未确认 2025-11-12_21:45:41
• 已修改：Plugins/WPSAPI.py
• 更改：引入 Apple Store 风格的 HTML 渲染模板，返回 HTMLResponse 并扩展图鉴条目字段以支持图标、徽章等视觉元素
• 原因：提升图鉴网页展示效果并支持富样式渲染
• 阻碍因素：无
• 状态：未确认 2025-11-12_22:21:28
• 已修改：Plugins/WPSBackpackSystem.py Plugins/WPSGardenSystem/garden_plugin_base.py Plugins/WPSGardenSystem/garden_plugin_plant.py Plugins/WPSGardenSystem/garden_plugin_harvest.py Plugins/WPSGardenSystem/garden_plugin_remove.py Plugins/WPSGardenSystem/garden_plugin_view.py Plugins/WPSGardenSystem/garden_plugin_steal.py Plugins/WPSAlchemyGame.py Plugins/WPSCombatSystem/combat_plugin_base.py Plugins/WPSCombatSystem/combat_plugin_adventure.py Plugins/WPSCombatSystem/combat_plugin_battle.py Plugins/WPSCombatSystem/combat_plugin_equipment.py Plugins/WPSCombatSystem/combat_plugin_camp.py Plugins/WPSCombatSystem/combat_plugin_heal.py Plugins/WPSCombatSystem/combat_plugin_status.py
• 更改：为背包、菜园、炼金与战斗系统图鉴补充详细条目，枚举各物品、配方与指令步骤，并在页面中渲染完整细节
• 原因：解决仅展示概览的问题，让图鉴列出全部物品和操作细节
• 阻碍因素：无
• 状态：未确认 2025-11-12_22:37:49
• 已修改：Plugins/WPSAPI.py
• 更改：补充类关系跳转功能，图鉴页面可展示父类链与子类列表并跳转至对应插件页面
• 原因：便于从页面直接浏览继承体系
• 阻碍因素：无
• 状态：未确认 2025-11-12_22:43:53
• 已修改：Plugins/WPSAPI.py
• 更改：适配插件路由改成 /ClassName，更新图鉴类关系链接为 /api/<类名>
• 原因：保持跳转链接与最新路由结构一致
• 阻碍因素：无
• 状态：未确认

最终审查