35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
# 背景
|
||
文件名：2025-11-08_2_fortune-system.md
|
||
创建于：2025-11-08_13:42:44
|
||
创建者：liubai095\\asus
|
||
主分支：main
|
||
任务分支：未创建
|
||
Yolo模式：Off
|
||
|
||
# 任务描述
|
||
在 `Plugins/WPSFortuneSystem.py` 中开发一个与运气相关的系统，提供一个无参数指令“运势”，输出 -1 与 1 之间的数值及对应阶段文本，该数值基于当前小时与 `user_id` 哈希计算后乘以系数以保持稳定。将该数值计算封装为可复用接口，供其他允许被运气影响的系统调用，以影响结果。
|
||
|
||
# 项目概览
|
||
新WPS Bot 插件系统，包含核心模块与多种插件，需与现有插件接口保持兼容。
|
||
|
||
# 分析
|
||
当前插件体系通过 `PluginInterface.execute` 将实例注册到 `Architecture`，并在回调路由中按首个指令词定位插件；`WPSAPI` 及 `BasicWPSInterface` 已封装 webhook 回复、@ 解析等能力，提供统一的 Markdown 推送流程。运势插件继承该体系即可获得命令入口，并允许其他模块通过 `Architecture.Get(WPSFortuneSystem)` 访问其接口。
|
||
|
||
# 提议的解决方案
|
||
方案A：在 `WPSFortuneSystem` 内实现 `FortuneCalculator`，以 `datetime.now().hour` 与 `user_id` 组合后的哈希映射到 (-1, 1)，再借助细粒度阈值表输出阶段文本；对外暴露 `get_fortune_info(user_id, dt=None)`，同时注册 `运势`/`fortune` 指令返回 Markdown。
|
||
方案B：将哈希映射与阶段判定抽离到 `Plugins/utils/fortune_service.py` 等独立模块，插件只负责命令交互；其他系统可直接导入服务或通过 `Architecture` 获取实例，需留意插件加载顺序与依赖。
|
||
|
||
# 当前执行步骤："3. 分析任务相关代码"
|
||
|
||
# 任务进度
|
||
2025-11-08_14:01:11
|
||
- 已修改：Plugins/WPSFortuneSystem.py
|
||
- 更改：实现整点哈希运势计算、阶段判定与指令回调
|
||
- 原因：提供可复用的运势接口与“运势”指令
|
||
- 阻碍因素：无
|
||
- 状态：成功
|
||
|
||
# 最终审查
|
||
- 代码审查：实现与计划一致，运势计算、阶段判定及接口公开范围均符合预期。
|
||
- 测试情况：通过。
|