# 背景
文件名：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/<类名>`
- 原因：保持跳转链接与最新路由结构一致
- 阻碍因素：无
- 状态：未确认

# 最终审查