在互动叙事类应用中，任务管理功能非常重要的，它不仅能引导玩家推进剧情，还能通过及时的反馈增强沉浸感。本文将详细介绍 StoryEcho 项目中任务系统的完整开发过程，分享我在设计、实现和优化过程中的思考与实践。
一、系统设计概览
设计目标
在开发任务系统时，我们确立了以下几个核心目标：
1.区分主线任务和支线任务，主线推动剧情，支线丰富世界
2.任务进度实时更新，玩家能清晰了解当前状态
3.任务触发、进度更新、任务完成都要有明确的视觉反馈，如弹窗，任务百分比显示，划掉已完成任务等。
二、后端任务系统实现
2.1 任务数据结构设计
首先定义清晰的任务数据结构：
# 主线任务定义 MAIN_QUESTS = [ { "id": "main_001", "name": "进入迷雾森林", "description": "探索森林入口，找到进入森林深处的路径", "type": "main", "order": 1, "objectives": [ {"id": "obj_001", "description": "与老猎人对话", "completion_hint": "talk:老猎人"}, {"id": "obj_002", "description": "查看古老石碑", "completion_hint": "action:view_stone"}, {"id": "obj_003", "description": "选择一条路径进入", "completion_hint": "action:choose_path"} ], "rewards": {"exp": 100, "gold": 50}, "next_quest": "main_002" } ]2.2 任务管理器核心实现
任务管理器是整个系统的核心，负责任务的初始化、触发检查、进度更新和奖励发放：
class QuestManager: def __init__(self): self.main_quests = {q["id"]: q for q in MAIN_QUESTS} self.side_quests = {q["id"]: q for q in SIDE_QUESTS} self.all_quests = {**self.main_quests, **self.side_quests} def check_quest_triggers(self, state, intent, target, scene_id, relationships): """检查是否有新任务可触发""" # 支持NPC对话触发 # 支持场景进入触发 # 支持特定动作触发 # 支持好感度条件触发触发机制设计：支持多种触发条件组合，比如支线任务“精灵公主的烦恼”需要同时满足“与艾莉西亚对话”和“好感度≥20”两个条件，实现多剧情玩法同时可以避免任务误触发。
2.3 目标完成检测
目标完成检测是任务系统的关键环节，我实现了多种检测方式：
def _check_objective_complete(self, hint, intent, target, scene_id, inventory, relationships, attributes): hint_type = parts[0] hint_value = parts[1] if hint_type == "talk": return intent == "talk" and target == hint_value elif hint_type == "scene": return scene_id == hint_value elif hint_type == "action": return intent == hint_value elif hint_type == "collect": return collected_count >= required_count elif hint_type == "attribute": return attributes.get(attr_name, 0) >= int(required_value) elif hint_type == "affinity": return relationships.get(npc_name, 0) >= int(required_value)这种设计使得任务目标可以灵活地与游戏状态交互，支持对话、场景移动、物品收集、属性检查、好感度等多种完成条件。
2.4 任务进度更新与通知
任务进度更新时，系统不仅更新内部状态，还生成详细的通知消息供前端展示：
if quest_update["updates"] or quest_update["completed_quest"]: notification_messages = [] for update in quest_update["updates"]: if "objective_description" in update: notification_messages.append({ "type": "objective_complete", "quest_name": update["quest_name"], "message": f"完成目标: {update['objective_description']}" }) elif update.get("type") == "next_quest": notification_messages.append({ "type": "next_quest_unlock", "quest_name": update["quest_name"], "message": f"新主线任务已解锁: {update['quest_name']}" }) state["last_quest_update"] = { "type": "quest_progress", "data": quest_update, "notifications": notification_messages }三、前端任务界面优化
3.1 任务日志面板
上一篇博客有提到我们做了一个初步的前端页面，在进行详细功能分工之后，我又进一步调整了前端页面的布局，将主线任务，支线任务，已完成任务分离开来。
3.2 任务通知弹窗实现与任务状态实时更新
为了给玩家及时的任务反馈，我实现了带有动画的任务通知弹窗：
同时，在任务日志中会更新任务完成进度条并划掉已完成任务：
四、总结与展望
本次功能开发其实还有一些不足，比如任务触发较为生硬，对于部分任务，如果玩家没有能够输出一模一样的关键词会有无法触发的可能，这是我们后期整合代码后要进行的优化，以及后续我们会考虑实现更多功能比如任务提示追踪之类的。
以上就是这段时间实现的内容。
：Web安全入门)
