游戏 AI / 系统课时
把任务状态映射成可读事实
把任务状态映射成可读事实
玩家询问 NPC“任务还差哪一步”时,模型需要看到真实阶段和目标进度,却不能替游戏服务判断任务是否完成。这里把权威任务快照转换成简短事实,同时保留任务、阶段、目标和交付 NPC 的稳定标识,供对话引用和业务回查。
学习目标
- 从同一份任务快照提取阶段、状态、目标进度与完成条件。
- 将可读短句和稳定 ID 一起交给 NPC 对话服务。
- 验证进度异常、阶段切换及模型越权时的处理边界。
从权威快照读取任务进度
任务服务负责维护 questId、stageId、status、objectives 和 revision。NPC 对话服务只读取已经提交的状态;阶段名称与完成规则从可信任务配置中按 ID 查出,不能采信玩家输入的“我已经做完了”。一次读取应拿到同一版本的数据,避免阶段已切换而目标进度仍来自旧快照。
例如任务 quest-104 处在 stage-02:需要集齐 3 枚哨兵徽章,目前进度为 2/3,状态是 active。NPC 可以说“还差一枚徽章”,却不能说“现在可以领奖”。即使进度变成 3/3,也要等待游戏服务明确把状态推进到 ready_to_turn_in。

用白名单构造事实包
事实包分为 refs 和 facts:前者保留供服务端回查的稳定 ID,后者只放玩家当前能听懂的短句。状态用受控枚举翻译,目标用“已完成数/要求数”表达;未知状态或非法进度直接拒绝映射,而不是让模型自行补全。
下面使用 Python 3.10+ 标准库演示。示例输入代表服务端已校验且从同一版本取得的记录;实际项目中还需在读取层验证玩家对任务的访问权限。
import json
STATUS_TEXT = {
"not_started": "未接取",
"active": "进行中",
"ready_to_turn_in": "可交付",
"completed": "已完成",
"failed": "失败",
}
def build_facts(quest: dict) -> dict:
status = quest["status"]
if status not in STATUS_TEXT:
raise ValueError("未知任务状态,拒绝生成事实")
lines = [f"当前阶段:{quest['stageName']}",
f"任务状态:{STATUS_TEXT[status]}"]
goal_ids = []
for goal in quest["objectives"]:
done, total = goal["done"], goal["total"]
# 拒绝越界进度,不能把坏数据交给模型解释。
if not (isinstance(done, int) and isinstance(total, int)
and total > 0 and 0 <= done <= total):
raise ValueError("目标进度非法")
lines.append(f"{goal['name']}:{done}/{total}")
goal_ids.append(goal["objectiveId"])
lines.append(f"完成条件:{quest['completionRule']}")
return {
"revision": quest["revision"],
"refs": {
"questId": quest["questId"],
"stageId": quest["stageId"],
"objectiveIds": goal_ids,
"turnInNpcId": quest["turnInNpcId"],
},
"status": status,
"facts": lines,
}
quest = {
"revision": 41,
"questId": "quest-104",
"stageId": "stage-02",
"stageName": "收集哨兵徽章",
"status": "active",
"objectives": [
{"objectiveId": "objective-badge", "name": "哨兵徽章", "done": 2, "total": 3}
],
"completionRule": "集齐3枚徽章后向北门守卫交付",
"turnInNpcId": "npc-warden-01",
}
print(json.dumps(build_facts(quest), ensure_ascii=False, indent=2))预期输出:
{
"revision": 41,
"refs": {
"questId": "quest-104",
"stageId": "stage-02",
"objectiveIds": [
"objective-badge"
],
"turnInNpcId": "npc-warden-01"
},
"status": "active",
"facts": [
"当前阶段:收集哨兵徽章",
"任务状态:进行中",
"哨兵徽章:2/3",
"完成条件:集齐3枚徽章后向北门守卫交付"
]
}这里的 quest-104 等 ID 是示例中的固定标识;正式运行应使用任务服务返回的真实 ID。revision 用来识别快照版本,不能由模型生成或递增。若游戏支持多语言,只替换 facts 中的展示语句,不应翻译 refs 中的 ID。
限制事实在对话中的用途
将上述事实作为只读参考加入 NPC 提示,并要求回复只引用已有进度,不猜测隐藏目标、奖励和解锁条件。对于当前输入,合格台词可以是“你已有两枚徽章,再找到一枚,然后回来交给我”;“任务已完成,奖励已经到账”则与 active 状态冲突,应由服务端输出校验或业务规则阻止。
如果玩家选择“交任务”,后端必须使用 questId、stageId 重新读取权威状态并运行交付逻辑。不能从 NPC 台词中解析“已完成”来发放奖励,也不能把模型返回的 objectiveId 当作可信写入指令;对话事实只说明世界状态,不授予修改权限。
验证阶段变化与异常数据
验收时依次覆盖三种输入,观察状态字段与文字是否一致:
- 将
done改成3,保留status=active:进度应显示 3/3,但状态仍是“进行中”,不能自动改成“可交付”。 - 由任务服务正式推进到
ready_to_turn_in并产生新revision:状态文本才变为“可交付”,四类稳定 ID 不应因文案变化而改写。 - 将
done设成4、total保持3:映射函数应抛出ValueError,对话服务应停止使用这份事实并记录异常,而不是编出合理进度。
这一映射适用于任务咨询、剧情条件解释和交付前提示。真正改变进度或奖励的操作仍必须经过游戏服务的状态机与权限校验。