宫廷之声 - 角色扮演扩展

宫廷之声：角色扮演扩展 是一个独立的AI对话和角色扮演应用，适用于 十字军之王3 建立于以下基础之上 宫廷之声, 宫廷之声 2.0，以及 宫廷之声 - 社区版.
其核心在于，该应用让你能够利用《十字军之王3》游戏本身的信息，与游戏中的角色进行AI驱动的对话。角色可以根据自身的性格、关系、处境，以及VOTC从《十字军之王3》接收到的上下文来做出回应，而受支持的操作则可以在《十字军之王3》中确实需要发生某些事情时，将信息回传给游戏。
角色扮演扩展包在此基础上更进一步，更加侧重于长期战役、记忆、连续性、传说管理、写作控制、场景管理，并让玩家对对话的实际运作方式拥有更多掌控权。
这个项目最初启动，是因为我想找到更好的方式来保存自己参与战役中的信息。摘要虽然有用，但当一场战役积累了多年的自定义角色、关系、战争、地点、神器、派系、秘密和其他背景设定后，我想要一种更有条理的方式，能够记住特定信息，并且只在真正需要时才使用它们。
那成为了 世界卡牌.
从那以后，我不断遇到其他想改的东西。有时我想更好地控制某段内容的写法，有时我想重新生成回复又不想立刻丢掉旧的，有时我只想让群组里的某些角色回应，有时我想从一开始就更好地控制场景里到底有谁。
这个项目基本上是从逐个解决那些问题中发展而来的。
最初只是一个设定系统，最终却演变成了 VOTC-CE 角色扮演扩展，并且在远超作为某个特定社区版 Alpha 版本附加内容的合理规模后，它如今已成为一个独立的项目。
版本 1.0 是首款独立发行的 宫廷之声：角色扮演扩展.
你愿意 不 需要在安装VOTC-RE之前单独安装Voices of the Court - Community Edition。

AI 服务商 / 模型推荐

我个人使用 OpenRouter，如果你是AI服务提供商的新手，我建议你花几分钟时间学习如何设置OpenRouter账户。
基本流程很简单：在OpenRouter上创建一个账户，添加少量信用额度，创建一个API密钥，然后将该密钥粘贴到VOTC-RE内的OpenRouter部分。之后，你可以选择自己实际想要使用的任何受支持的模型。
你可以使用 玩家二 如果你愿意的话也可以，但我个人不推荐。相比其他可选方案，我用OpenRouter的效果要好得多。我无法真正推荐其他每一家服务商，因为我自己并没有全部用过，但我自己的战役用的就是OpenRouter。
是的，OpenRouter 需要花一点钱。不，它并不特别贵。实际费用完全取决于你选择的模型以及使用频率。
非常重要的一点是，很多VOTC-RE是 依赖模型的.
不同模型在对话质量、动作、格式、场景感知、写作风格、续写及其他系统方面的表现可能差异很大。一些较弱的模型可能会完全忽略某些指令，或表现糟糕到即使模组侧系统本身运行正常，某个功能看起来也像是坏了一样。
这基本上就是VOTC一直以来所处的现实： 劣质模型产出劣质结果.
如果配置的模型拒绝正确遵循指令，我这边能做的也很有限。我可以推荐更好的模型，并尽量让系统尽可能清晰可靠，但我无法强制每个提供商提供的每个模型都表现正常。

世界卡牌

世界卡牌是启动整个项目的系统。
有时你有一些重要的战役信息希望AI记住，但又不想把每个角色、地点、事件、阵营、关系、神器以及背景故事都永久塞进每一条提示词里。
世界卡让你只需编写一次这些信息，角色扮演扩展模组便会在其真正相关时将其带入AI的上下文中。
一张卡牌可包含名称、描述、类别/类型、触发词、可选的作者注释及其他信息。角色卡还可直接关联至CK3角色ID。
包括的分类有 角色、事件、地点、关系、物品和阵营，你也可以创建自己的自定义分类。
这意味着世界卡可以包含一个王朝的历史、一场古老的战争、一个自定义宗教、一件神器、一段秘密关系、一座城市、一个派系、一则预言、一场血仇、一个角色，或者基本上任何你希望AI在相关主题真正出现时能够理解的内容。
世界卡的设计是与对话摘要配合使用，而非取代它们。摘要适合用来记录对话中发生的事情。世界卡则更适合保存你特别希望保留的信息，并在相关人物、地点、事件或话题再次出现时随时可用。
对于较长的角色扮演战役，这两个系统配合得天衣无缝。

版本1.0 — 宫廷之声：角色扮演扩展

1.0版本是Roleplay Expanded最终成为独立应用程序的标志。
版本号重新从 1.0 因为这是独立项目的首个版本，而不是旧版VOTC-CE插件的又一次编号更新。
最大的变化是 VOTC-CE 2.1.1-alpha.1 不再需要.
我决定做出这个转变有几个原因。
随着时间的推移，我看到越来越多的人在社区版更新、不同版本、安装差异，或者仅仅是让角色扮演扩展所依赖的确切版本正常运行方面遇到困难。这就造成了一种情况：我可能花了大量时间构建某个东西，但仍然有人无法使用它，因为我自己的项目之外的一些东西发生了变化。
与此同时，Roleplay Expanded 本身也变得越来越庞大。它不再只是为世界卡修改一两个文件，而是在管理对话状态、写作控制、重试、角色卡、世界卡、消息、场景、动作、信件、提供商集成、续写、UI 系统，以及越来越多相互关联的其他系统。
最终，围绕一个我无法控制的特定Alpha版本继续构建所有这些内容，对我来说已经不再合理了。
转为独立发布意味着我可以维护一个统一的 Roleplay Expanded 应用，让人下载的就是我用来测试功能的同一版本，并由我自己决定项目何时真正需要更新。
有效 不 抹除项目的上游历史。如果没有最初的VOTC、VOTC 2.0、社区版以及那些为这些项目做出贡献的人，Roleplay Expanded就不会存在。
独立转换版本的意义在于，对于角色扮演扩展包如今的发展方向而言，能够直接掌控自己的分支显然更加合理。
1.0版本还引入了若干重要系统，这些系统在旧的3.5版本中并不存在。
重写信件系统
私人信件系统已大幅重做。
信件本应让角色在无法面对面交谈时进行沟通，但旧系统在追踪确切的发件人、收件人、已存信件、回复以及当前信件状态时，可能会变得不可靠。
重写后的系统将每封信件与其所属的具体通信内容绑定得更加严格。发件人与收件人信息、存储记录、回复以及应用侧的信件状态会一并处理，而不是松散地假设最新可用的信件数据就一定是正确的。
目标不是把Letters变成完全不同的东西，而只是让现有概念变得可靠得多。
继续此回复
角色扮演扩展现已包含 继续此回复.
这与当日对话延续不同。
当日继续功能让你可以在同一游戏日期稍后回到已有的对话。
继续此回复可让刚刚回复的角色继续说话，无需你发送另一条虚假或无意义的玩家消息来让他们继续说下去。
续篇会继续沿用同一个角色和当前对话，而不是假装玩家说了他们实际根本没说过的话。
扩展场景角色管理器
场景演员阵容已在原版基础上扩展。
角色扮演扩展可以刷新玩家当前在CK3地点实际可用的角色，并允许将附近合适的角色加入当前对话。
添加某人会使他们成为场景中的实际参与者，而不只是把另一张头像放到屏幕上。他们可以参与响应器逻辑、提示词、世界卡上下文、续写，以及与活跃角色相关的其他系统。
角色可以被移除，之后重新添加时，他们之前贡献的对话或历史记录不会丢失。
对话场景控制
对话场景系统也得到了扩展。
内置对话场景可以在对话进行中更换，而无需假装玩家在CK3中的实际位置发生了变化。
在适当情况下，可以通过续写保留当前对话场景，使AI和视觉场景保持一致。
也支持自定义对话背景，适合那些只想在对话后面放自己图片的人。这些自定义图片仅用于视觉效果，不会自动作为图像上下文发送给 AI。
对话导演
这 对话导演 提供了一种单独引导当前场景方向的方式，而无需假装这些指令是由你的玩家角色亲口说出的。
这对于控制即时场景走向、情节或其他引导非常有用，同时又能将这些指令与普通对话区分开来。
回复长度
角色扮演扩展现在包含直接 回复长度 控制。
你可以根据想要的对话类型，使用默认、短、中、长或自定义指令。
它和写作风格、对话导演、世界卡以及常规对话上下文协同工作，而不是取代这些系统。
独立界面
应用本身也已围绕此进行了重做 VOTC-RE.
角色扮演扩展模组现已拥有独立的应用程序标识、品牌形象、配置样式、强调色、界面框架选项、独立用户数据位置、Discord链接、Nexus链接以及完整的独立展示界面。
这并非旨在抹去项目的历史或假装上游工作不存在。上游的署名和许可已在下文中有意保留并加以扩充。
这只是意味着独立应用程序现在实际上表现为 宫廷之声：角色扮演扩展.

需求

你需要 十字军之王3，提供的 VOTC_RE CK3组件，那 宫廷之声：角色扮演扩展应用，以及受支持的 AI/提供商配置。
你愿意 不 需要单独安装《宫廷之声 - 社区版》。
VOTC-RE应用程序、CK3组件、便携版以及相应的源代码托管在官方 VOTC-RE itch.io 页面:
https://daddyd1999.itch.io/votc-re
你可以下载 安装程序, 便携应用, CK3 组件，以及 对应的源包 从那一页开始。
无论你选择哪个应用程序版本，都仍需在十字军之王 III 启动器中安装并启用 CK3 组件。

安装

安装方式与旧版插件不同，因为您不再需要将 Roleplay Expanded 文件放入另一个 VOTC 安装目录中。
这 VOTC-RE 应用已从官方 itch.io 页面下载:
https://daddyd1999.itch.io/votc-re
有两种安装该应用程序的方法。
设置版本
从 itch.io 页面下载 VOTC_RE_1.0_Setup.exe 然后运行它。
安装程序会安装独立的VOTC-RE应用程序，并安装所需的 VOTC_RE CK3组件，并创建常规应用程序快捷方式。
安装完成后，打开十字军之王3启动器，并确保 VOTC_RE 在开始游戏前，请确保你的游戏集中已启用。
这是最简单的安装方法，也是我推荐大多数人使用的方法。
便携版
如果你不想使用安装程序，请下载 VOTC_RE_1.0_APP.zip 来自同一个itch.io页面。
把它解压到你真正打算保留并启动它的地方 VOTC-RE.exe 直接。
便携版用户还必须下载随附的 VOTC_RE CK3 组件，将其放入《十字军之王3》的常规模组目录中，并通过CK3启动器启用。
你只需要一种申请方法： 设置或便携版请勿同时安装两者。
无论你使用哪种申请方式， VOTC_RE CK3 组件必须安装并启用 这样CK3和独立应用程序就能正确通信了。
之后，在VOTC-RE中配置您偏好的AI提供商，如有必要请确保您的十字军之王III用户文件夹路径正确，启动CK3，并使用正常的 对话 对角色进行交互。安装前，如果你想看看它的运行效果和顺序，可以看看这个简短又粗糙的演示视频。：  宫廷之声：角色扮演扩展演示

支持 / Discord

如果你遇到了真正的漏洞、安装问题、对话问题、信件问题、世界卡问题，或者你只是想在下下载前问一些关于这个项目的问题，欢迎加入VOTC-RE Discord：
https://discord.gg/wNmGZQtyJJ
我会在力所能及的范围内帮忙。
不过，我想把期望说得非常清楚。
这是一个充满热情的项目。我有自己的工作，项目之外也有自己的生活，其他可能来社区帮忙的人也一样。我不会整天坐在 Discord 里等消息，你也不该一进来就指望每次提问都能立刻得到回复。
你很可能得等到我真的有空回复的时候。
如果我知道怎么帮忙，而且有时间去做，我非常乐意帮忙。
欢迎提出功能请求。角色扮演扩展内容之所以如此丰富，是因为我自己在玩游戏时想到 我希望VOTC也能做到这一点，所以总有机会让真正有用的建议最终成为项目的一部分。

鸣谢、署名与项目沿革

宫廷之声：角色扮演扩展版若无前人的项目与贡献者，便不会有今日之存在。
VOTC-RE 是一个衍生项目。独立运行意味着 VOTC-RE 不再需要依赖另一个 VOTC 安装即可运行；它可以 不 意味着上游系统、代码、提示词、CK3集成或其他继承的工作突然变成了我的。
宫廷原声 / AliChat
全部归功于原作 宫廷之声 / AliChat 感谢开发者和贡献者创建了CK3转AI对话框架，本项目系列的一切最终都建立在此基础之上。
特别鸣谢 杜隆德 / 德墨忒尔29 以及其他原始贡献者，他们的工作奠定了该应用、CK3集成、对话流程、游戏数据处理、行动框架、提供商支持、提示词，以及被后续版本继承的其他基础。
原VOTC源文件：
https://github.com/Demeter29/Voices_of_the_Court
宫廷之声 2.0
归功于 杜伦德 以及所有其他继续并扩展了该项目的贡献者，他们通过 宫廷之声2.0.
VOTC 2.0 源：
https://github.com/Voices-of-the-Court/VOTC
宫廷之声 2.0 - 社区版
大量功劳也要归于 安德罗先生电脑, 鲤思源233, zhaowendao2005、中国VOTC开发社区，以及更广泛的 宫廷之声 2.0 - 社区版 团队及贡献者群体。
额外感谢翻译者、测试者、维护者及其他贡献者，他们的工作被纳入或帮助维护了社区版传承。
VOTC-CE 来源及其自身的贡献者/致谢历史：
https://github.com/Z-Jianxin/Voices_of_the_Court_Community
VOTC CK3 mod 源码：
https://github.com/Voices-of-the-Court/votc_mod
角色扮演扩展最初是作为以下内容的附加组件/衍生品而存在的 VOTC-CE 2.1.1-alpha.1.
独立版本不再需要将社区版作为单独安装项，但它仍然源自该代码库并为其衍生作品。我不会仅因原版VOTC/VOTC-CE系统、界面代码、后端架构、提示词、CK3集成、游戏数据系统、提供方系统或其他上游材料被包含在Roleplay Expanded中、被其修改或随其分发，就主张对这些内容的所有权。
宫廷之声：角色扮演扩展
我的工作涵盖了以下新增和改动内容： 世界卡牌, VOTC-CE 角色扮演扩展，以及独立 VOTC-RE.
其中包括角色扮演扩展世界卡与角色卡系统、战役手册、卡牌生成新增内容、写作风格控制、可保存的回复重试、续写系统、全局消息、场景角色新增内容、生成起始手册、世界卡激活改动、额外CK3动作、信件系统工作、对话导演、回复长度控制、独立UI/品牌工作，以及本页记录的其他角色扮演扩展功能。
当这些系统修改或基于上游代码进行构建时，上游的底层权利和许可义务仍然有效。VOTC-RE的目的是在先前工作的基础上进行构建和扩展，而不是将上游工作重新标记为源自此处。
如果我遗漏了任何其作品确实存在于VOTC-RE中的上游贡献者，请带着相关来源或提交记录联系我，我会更正署名。machiavelli — VOTC-CE维护者/开发者。

授权

VOTC-RE 的发布受适用于其衍生材料的许可证约束。
VOTC项目系列包含根据以下许可证分发的软件 GNU通用公共许可证第三版（GPLv3） 及原产于以下地区的材料 知识共享署名-相同方式共享 4.0 国际许可协议 (CC BY-SA 4.0).
适用GPL覆盖的部分仍受GPLv3约束。适用CC BY-SA的材料仍受其适用许可及署名/相同方式共享要求的约束。
我自己的项目描述、权限、品牌或分发条款中，没有任何内容意图移除、缩小或覆盖适用的上游开源许可证已授予的权利。
对于受GPL覆盖的材料，接收者保留GPLv3赋予的权利，包括根据许可条款检查、修改和再分发该受覆盖材料的权利。
其他作者创作的内容仍归该作者所有，并受其发布时所用许可协议的约束。
任何单独拥有且明确标识为单独授权的原创艺术作品、标识、品牌资产或其他可明确分离的材料，仍受该材料所述许可或授权的约束。本 不 适用于上游 GPL/CC 覆盖的素材，或上游许可证已授予重用和再分发权利的代码。
本软件按“原样”提供，不附带任何担保，包括对适销性或特定用途适用性的默示担保。
分布式版本对应的VOTC-RE源码可在应用程序下载页面一并获取：
https://daddyd1999.itch.io/votc-re
GPLv3：
https://www.gnu.org/licenses/gpl-3.0.html
CC BY-SA 4.0：
https://creativecommons.org/licenses/by-sa/4.0/

权限

对于 上游或开源材料，请遵循适用于该材料的许可协议。
对于 GPL 覆盖的代码，遵循GPLv3。
对于 CC BY-SA 覆盖的材料，遵循CC BY-SA 4.0及其署名/相同方式共享要求。
对于其他贡献者或作者拥有的材料，请遵循该人员适用的许可和权限。
如果我另行以不同条款分发原始美术作品、标志、品牌或其他可明确分离的资产，则这些另行条款仅适用于那些被单独标识的资产。它们不会覆盖或限制已就上游受GPL/CC约束材料授予的权利。
如果你不确定某个文件或资源属于哪个类别，请联系我，我会尝试确认其来源。

这个项目是如何走到今天的

这个项目从我最初制作到现在已经发生了很大变化，所以我想简单记录一下每个主要阶段实际是什么样子。
版本 1 — 世界卡
第一个版本仅被称为 世界卡牌.
版本1完全专注于上述基于触发器的设定系统。创建角色、事件、地点、关系、物品、派系或自定义类别，为卡片设置触发条件和描述，当这些信息变得相关时，就可以发送给AI。
那基本上就是整个模组了。
最初出现这种情况，是因为仅靠摘要并不总能满足我参与的那种战役，尤其是当角色背后已有多年历史和自定义设定时。
版本2.5 — 世界卡牌
名字留了下来 世界卡牌，但系统本身变得大多了。
世界卡 书籍 它们被添加是为了让不同的战役可以拥有各自的背景设定库，而不是每个存档都共享一个全局集合。导入功能已支持单个文件、多个文件、文件夹以及嵌套文件夹。角色卡获得了直接 CK3角色ID绑定，自动角色卡生成功能已添加并带有重复保护，并且 用AI生成 已添加到世界卡牌编辑器。
那时这个模组已经是一个相当出色且更完整的世界卡牌系统，但仍然明显以世界卡牌为核心。
3.0版本 — VOTC-CE角色扮演扩展
版本3之后，这就不再属实了。
世界牌仍然得到完全支持，但我开始添加一些与世界牌本身基本无关、而是改善更广泛角色扮演体验的系统。
这就是世界卡牌的由来 VOTC-CE 角色扮演扩展版.
版本3已添加 写作风格控制，实时消息编辑/删除，角色卡年龄同步， 可保存的响应重试次数，同日对话延续，手动NPC回合，选择由谁回应，世界卡图片/缩略图，UI强调色自定义，以及若干较小的对话与体验优化。
到那时，这个项目显然已不再只是World Cards了。
版本3.5 — VOTC-CE角色扮演扩展
3.5版本再次大幅推进了角色扮演扩展内容。
它补充道 更美好的世界卡激活, 场景角色管理器, 全局消息, 生成入门手册，包括额外的CK3行动 授予/亏欠人情，移除特质，调整恐惧，以及对可保存重试、操作、提供商集成和更广泛对话系统的进一步改进。
3.5版本成为旧版的最后一个主要版本 VOTC-CE 角色扮演扩展 附加内容。
那个旧版本现在被视为项目的旧版。已经使用它的用户如果愿意可以继续使用，我并不是说如果有简单值得修复的问题我永远不会做极小的修补，但主动开发将不再分散在两个完全不同的应用架构之间。
独立版VOTC-RE是项目从此继续推进的方向。
版本1.0 — 独立版VOTC-RE
1.0版本是本页面所述独立应用程序的首个公开发布版本。
它将Roleplay Expanded通过世界卡和VOTC-CE附加版本开发的所有内容整合进一个独立应用中，同时新增了重写的信件系统、继续此回复、扩展的场景角色功能、对话场景控制、对话导演、回复长度控制、独立界面与品牌标识，以及上述其他新系统。

计划更新

我绝对打算继续开发 宫廷之声：角色扮演扩展.
这并不意味着这会成为一个每天或持续更新的项目。
等我有真正觉得值得发布的内容时会更新。
这是一个出于热爱而制作的项目，我希望它能一直保持这样。我不希望维护它变成另一份全职工作，让我觉得仅仅因为过了几天就必须推出更新。
还有一些事情我最终想尝试，包括更深入的全局消息集成、进一步改进场景角色、更好的多角色互动、更多的提供商/API选项，以及可能让NPC自己发起对话。
我以前尝试过让NPC主动发起对话，但对实现效果不太满意，所以没有把它放进1.0版本。如果以后能让它达到我真正满意的效果，我可能会重新考虑这个功能。
这些都不应被视为保证的发布日期或承诺。
独立开发让我在项目未来的方向上拥有更大的自由，但基本开发规则仍然与我当初发布World Cards时相同：
添加真正实用的功能，同时不影响现有正常运作的部分