1. 实际应用场景描述

 

在剧本杀游戏中，主持人（DM）经常遇到以下问题：

 

- 玩家人数不确定，导致角色分配困难

- 不同剧本类型（推理、情感、阵营、欢乐）对角色性格、技能要求不同

- 玩家偏好不明确，容易出现“角色不适合玩家性格”的情况，影响游戏体验

- 新手玩家不知道自己适合什么角色，选角耗时长

 

剧本杀角色匹配工具的目标是：

 

- 输入玩家人数和剧本类型

- 自动推荐适配角色，并标注角色特点

- 帮助玩家快速选角，提升游戏沉浸感和流畅度

 

2. 痛点分析

 

1. 人数与角色数不匹配 → 需要动态调整推荐

2. 剧本类型与角色特性关联复杂 → 人工记忆难

3. 玩家偏好多样 → 需要多维度匹配（性格、推理能力、表演欲等）

4. 选角过程冗长 → 影响开局氛围

 

3. 核心逻辑讲解

 

处理流程：

 

1. 输入：玩家人数、剧本类型（推理/情感/阵营/欢乐）

2. 角色库：预设角色（含剧本类型适配度、性格标签、技能特点）

3. 匹配算法：

   - 根据剧本类型筛选高适配角色

   - 按人数截取推荐列表

   - 标注每个角色的特点（性格、技能、适合人群）

4. 输出：推荐角色列表 + 特点说明

 

数据结构：

 

- 

"roles"：角色字典（角色名 → 属性）

- 

"script_types"：剧本类型与角色适配度映射

- 

"recommendations"：最终推荐列表

 

4. Python 模块化代码

 

文件结构

 

murder_mystery_matcher/

├── data.py # 角色库与剧本类型数据

├── matcher.py # 匹配逻辑

├── utils.py # 工具函数

└── README.md # 使用说明

 

"data.py"

 

# data.py

# 角色库：角色名 -> {剧本类型适配度, 性格标签, 技能特点, 适合人群}

ROLES = {

    "侦探": {"types": ["推理"], "traits": ["冷静", "观察力强"], "skills": "线索分析", "fit_for": "逻辑思维强的玩家"},

    "女巫": {"types": ["阵营", "欢乐"], "traits": ["神秘", "掌控全局"], "skills": "特殊能力", "fit_for": "喜欢策略的玩家"},

    "恋人": {"types": ["情感"], "traits": ["感性", "深情"], "skills": "情感演绎", "fit_for": "表演欲强的玩家"},

    "杀手": {"types": ["阵营", "推理"], "traits": ["冷静", "果断"], "skills": "隐藏身份", "fit_for": "喜欢潜伏的玩家"},

    "富商": {"types": ["欢乐", "阵营"], "traits": ["自信", "幽默"], "skills": "资源调配", "fit_for": "外向型玩家"},

    "记者": {"types": ["推理", "情感"], "traits": ["好奇", "善于提问"], "skills": "信息搜集", "fit_for": "喜欢交流的玩家"},

    "医生": {"types": ["推理", "情感"], "traits": ["细心", "善良"], "skills": "急救知识", "fit_for": "稳重型玩家"},

    "警察": {"types": ["推理", "阵营"], "traits": ["正义", "果断"], "skills": "审讯", "fit_for": "领导力强的玩家"}

}

 

# 剧本类型列表

SCRIPT_TYPES = ["推理", "情感", "阵营", "欢乐"]

 

"utils.py"

 

# utils.py

def normalize_input(text):

    """标准化输入"""

    return text.strip().lower()

 

def validate_number_input(value, min_val, max_val):

    """验证数字输入范围"""

    try:

        num = int(value)

        if min_val <= num <= max_val:

            return num

        return None

    except ValueError:

        return None

 

"matcher.py"

 

# matcher.py

from data import ROLES, SCRIPT_TYPES

from utils import normalize_input, validate_number_input

 

class MurderMysteryMatcher:

    def __init__(self):

        self.roles = ROLES

        self.script_types = SCRIPT_TYPES

 

    def recommend_roles(self, player_count, script_type):

        """推荐角色"""

        script_type = normalize_input(script_type)

        if script_type not in [t.lower() for t in self.script_types]:

            return [], f"不支持的剧本类型: {script_type}"

 

        # 筛选适配角色

        suitable_roles = []

        for role, attr in self.roles.items():

            if script_type in [t.lower() for t in attr["types"]]:

                suitable_roles.append({

                    "name": role,

                    "traits": attr["traits"],

                    "skills": attr["skills"],

                    "fit_for": attr["fit_for"]

                })

 

        # 按人数截取

        recommended = suitable_roles[:player_count]

        return recommended, None

 

    def print_recommendations(self, recommendations):

        """打印推荐结果"""

        if not recommendations:

            print("没有找到合适的角色推荐。")

            return

        print("\n=== 推荐角色列表 ===")

        for idx, role in enumerate(recommendations, 1):

            print(f"{idx}. {role['name']}")

            print(f" 性格: {', '.join(role['traits'])}")

            print(f" 技能: {role['skills']}")

            print(f" 适合: {role['fit_for']}\n")

 

# 示例

if __name__ == "__main__":

    matcher = MurderMysteryMatcher()

    while True:

        try:

            num_input = input("请输入玩家人数 (2-8): ")

            player_count = validate_number_input(num_input, 2, 8)

            if player_count is None:

                print("人数必须在2-8之间，请重新输入。")

                continue

            script_type = input("请输入剧本类型 (推理/情感/阵营/欢乐): ")

            recs, err = matcher.recommend_roles(player_count, script_type)

            if err:

                print(err)

            else:

                matcher.print_recommendations(recs)

            break

        except KeyboardInterrupt:

            print("\n退出程序。")

            break

 

5. README.md

 

# 剧本杀角色匹配工具

 

## 简介

本工具根据玩家人数和剧本类型，自动推荐适配角色并标注特点，帮助玩家快速选角，提升剧本杀游戏体验。

 

## 使用方法

1. 安装 Python 3.x

2. 下载本项目文件

3. 运行：

 

bash

 

python matcher.py

 

4. 输入玩家人数和剧本类型，查看推荐角色

 

## 功能特点

- 支持多种剧本类型

- 角色特点标注

- 人数自适应推荐

- 简单易用

 

## 适用场景

剧本杀主持人、玩家、桌游店

 

6. 使用说明

 

1. 运行 

"matcher.py"

2. 输入玩家人数（2-8人）

3. 输入剧本类型（推理/情感/阵营/欢乐）

4. 查看推荐角色及其特点

5. 可根据推荐结果进行选角

 

7. 核心知识点卡片

 

知识点 说明

数据建模 角色属性结构化存储

输入验证 数字范围与类型检查

匹配算法 基于剧本类型的筛选

列表切片 按人数截取推荐

模块化设计 数据、逻辑、工具分离

用户交互 命令行输入输出

 

8. 总结

 

本工具实现了剧本杀角色的快速匹配，解决了人数不确定、剧本类型与角色特性关联复杂、选角耗时长等痛点。

 

它的价值：

 

- 提升效率：秒级生成推荐

- 增强体验：角色特点明确，选角更精准

- 可扩展：可加入玩家偏好问卷、AI 推荐等

 

后续可扩展方向：

 

- 增加玩家偏好问卷，做个性化推荐

- 接入图形界面（Tkinter/Web）

- 加入角色图片与背景故事展示

- 支持自定义角色库

 

这个工具是高绩效创新团队在游戏化活动设计中的实用案例，能帮助团队提升活动组织效率与参与者满意度。

 

如果你愿意，可以下一步加上 图形界面（Tkinter） 和 玩家偏好问卷，让匹配更精准、体验更好。

 

利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！