卡拉迪亚灵魂注入器AI语音同步模组SmartTalkAI

# SmartTalkAI 模组使用指南 (SmartTalkAI Mod Manual)

**版本**: 1.0.0 (适配 Bannerlord 1.3.13)  

**最后更新**: 2026-01-22

SmartTalkAI 是一个革命性的《骑马与砍杀2：霸主》模组，它利用大语言模型（LLM）赋予 NPC 真正的智能。NPC 不再是只会复读固定台词的机器人，而是拥有记忆、情感、并能根据对话内容实际改变游戏世界的鲜活角色。

—

## 🌟 核心功能 (Core Features)

### 1. 真正的智能对话

*   **无限的对话内容**：基于 OpenAI 接口（支持 GPT-4o, DeepSeek, Claude 等），NPC 根据自身背景、性格、所属势力和当前局势生成独一无二的回复。

*   **身份感知**：NPC 知道他是谁（国王、领主、流浪者），知道你在哪里（城镇、野外），也知道你们现在的关系。

*   **情感系统**：NPC 会愤怒、开心或悲伤，并配合相应的面部表情和肢体动作。

### 2. 永久记忆系统 (Memory System)

*   **数据库存储**：内置 SQLite 数据库，完整记录你与每一位 NPC 的过往交互。

*   **连续性体验**：如果你上次羞辱了一位领主，下次见面他会记得并表现出敌意；如果你资助过一位流浪者，他会感激你。

### 3. 行为交互系统 (Action System) – 模组的灵魂

对话不仅仅是文字，NPC 可以根据聊天内容**实际执行游戏指令**：

*   **💰 金钱交易**

    *   **索要金币**：NPC 可以勒索你，或者接受你的贿赂（实际扣除玩家金币）。

    *   **赠予金币**：富有的领主可能会赏赐你金币（实际增加玩家金币）。

   

*   **❤️ 关系变动**

    *   **动态好感度**：对话融洽时好感度上升，言语冒犯时好感度下降。关系变化会即时通知并影响后续互动。

*   **⚔️ 军事指令**

    *   **跟随玩家 (`FOLLOW_PLAYER`)**：你可以说服盟友领主率领他的军团跟随你，护送你或一起出征。

    *   **停止跟随 (`STOP_FOLLOW`)**：随时解散跟随你的部队。

    *   **进攻目标 (`ATTACK_PARTY` / `ATTACK_SETTLEMENT`)**：指挥盟友进攻特定的敌方部队或围攻城镇/城堡。

    *   **宣战 (`DECLARE_WAR_ON`)**：如果你是国王或有足够影响力，可以说服国王对某国宣战。

    *   **直接开战 (`ATTACK_PLAYER`)**：如果你激怒了野外的领主，对话可能直接破裂并进入战斗。

*   **🤝 招募与联姻**

    *   **招募同伴 (`JOIN_PLAYER`)**：对于酒馆里的流浪者，通过对话打动他们，无需看属性表，直接邀请入队。

    *   **联姻 (`MARRY`)**：向领主求娶其子女，通过真诚的对话获得岳父/岳母的认可。

### 4. 高度可配置 (MCM Integration)

*   **模型自由切换**：支持所有兼容 OpenAI 格式的 API（如 DeepSeek, ChatGPT, 本地 LLM）。

*   **自定义提示词**：可以在设置中微调 System Prompt，改变所有 NPC 的说话风格。

*   **沉浸式设置**：支持隐藏调试日志，只保留纯净的对话体验。

—

## 🚀 安装与配置 (Installation & Config)

1.  **前置需求**：

    *   Bannerlord v1.3.13

    *   Harmony

    *   ButterLib

    *   UIExtenderEx

    *   Mod Configuration Menu (MCM) v5

2.  **安装步骤**：

    *   将 `SmartTalkAI` 文件夹放入游戏根目录的 `Modules` 文件夹中。

    *   启动游戏启动器，勾选 `SmartTalkAI`。

    *   **确保加载顺序**：在所有前置 MOD 之后，Native 模块之后。

3.  **首次运行配置**：

    *   进入游戏主菜单 -> `Mod Options` (模组选项) -> `SmartTalkAI`。

    *   **API 设置**：

        *   `API Base URL`: 输入你的 API 地址 (例如 `https://api.deepseek.com` 或 `https://api.openai.com/v1`)。

        *   `API Key`: 输入你的密钥。

        *   `Model Name`: 输入模型名称 (推荐 `deepseek-chat` 或 `gpt-4o`)。

    *   点击测试连接，保存设置。

4.  **启动 Python 后端 (语音与数据库核心)**：

    *   **这一步至关重要！** 如果不启动后端，你将无法听到语音，且数据库记忆功能可能受限。

    *   打开文件夹：`Mount & Blade II Bannerlord\Modules\SmartTalkAI\python\`

    *   双击运行 **`start_backend.bat`**。

    *   **保持黑色控制台窗口开启**：在游戏过程中不要关闭这个窗口。

    *   **注意目录位置**：后端程序必须位于 `Modules\SmartTalkAI\python` 目录下运行。它会在该目录下生成 `TempVoice` 和 `NewsVoices` 文件夹来存储语音文件。如果你的后端放在其他地方，游戏将无法读取生成的语音文件，导致 NPC “张嘴不出声”。

—

## 🎮 使用技巧 (Tips)

*   **像真人一样聊天**：不要只把 NPC 当作任务板。试着赞美他们的家族，谈论当前的战争局势，或者单纯地聊聊家常。

*   **利用记忆**：如果你想招募一个领主，先建立良好的关系。多聊几次，送点钱，他会记得你的慷慨。

*   **发布命令**：

    *   想让盟友跟随？直接说：“带上你的部队跟我走，我们需要集结。”

    *   想宣战？直接对国王说：“瓦兰迪亚太嚣张了，我们必须向他们宣战！”

    *   想结婚？直接问：“听说你有个女儿/儿子，我想求婚。”

—

## 🛠️ 故障排除 (Troubleshooting)

*   **NPC 不说话/卡住**：

    *   检查网络连接和 API Key 是否正确。

    *   检查 `SmartTalkAI_LLM_Debug.log` (位于 `Documents/Mount and Blade II Bannerlord/Configs/SmartTalkAI/`) 查看详细报错。

*   **命令未执行**：

    *   确保你的对话意图足够清晰。LLM 需要明确理解你的意图才会生成指令。

    *   例如：“给我钱”可能不奏效，但“我是你的国王，这是你应交的税款！”效果更好。

付费模组付款后加QQ179396505获取模组。可反馈增加更多实用功能。附送白嫖API，TTS。