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